# Integration with Slack ### Overview Integrating MangoApps with Slack offers an efficient solution for extending the reach of company communications beyond the intranet. By enabling notifications of company posts and alerts to public Slack channels, administrators can enhance communication strategies and ensure vital information reaches employees wherever they are.

With a focus on security considerations, testing protocols, and best practices for rollout, MangoApps and Slack integration promises streamlined communication pathways and strengthened engagement across platforms. This guide will lead you through two main steps: setting up Slack and then integrating it with MangoApps through the Notifications configurations menu. This guide is intended for users with at least domain admin level permissions within MangoApps and companies with an active Slack account. *** ### Setting Up Slack Channels To begin, ensure your company has an active subscription to Slack and that your Slack workspace includes **public** channels. These channels can be set to public by navigating to the **channel settings** and selecting the appropriate option.

**Add Members to Public Channels** By default, public channels include all members, but administrators can manually add new members if necessary by clicking on **Add People** from the **Members** tab.

**Enable Notifications** Click the bell icon to set the notifications for these channels. It is recommended to choose **All Messages** to ensure that all important updates, including MangoApps posts, are received.

**Update App Label** Optionally, update the app label for your MangoApps domain within Slack to align with your company branding. This can be done by hovering over the MangoApps app logo in Slack and clicking on **Go to App**.

*** ### Configuring MangoApps To begin, login to your MangoApps domain using your preferred sign-in method.

Once logged in, access the options menu using your profile picture located in the top right corner. Click or hover your mouse cursor over it to access the dropdown menu.

From the options menu, select the **Manage Domain** option. This option will **only** be visible to user/s with **Network Admin** permissions.

Slack integration for post notifications in public Slack channels can be enabled from the MangoApps admin setting for **Notifications**. Once in the Admin portal, navigate to the **Notifications** settings located along the left hand side navigation menu.

Enable Slack integration under the **Notifications** section **External App Notifications**.

This will prompt you to log in to your Slack account and authorize MangoApps to post notifications. Once your Slack credentials are authenticated, grant permissions to the app to post into public Slack channels.

**Select Default Public Channel** Optionally, after permissions are granted, select the default channel you would like MangoApps to publish posts to within Slack if a specific channel has not be chosen when a user creates a post.

*** ### Creating and Sharing Posts Post can only be made to Slack using this method as long as they meet the following criteria: * The **audience** is selected as **Everyone** * The **post type** is a **Company Post** or an **Alert**. With these restrictions, only users with permissions to fulfill the above are capable of making posts from MangoApps to Slack. **Create a Company Post** From the Post module or from within the universal compose button dropdown menu, construct your post or alert. For information on creating Posts in MangoApps, click [here](https://guides.mangoapps.com/user-guide/posts).

**Enable Slack Notification** Before publishing the post, ensure the Slack notification is enabled from the right hand menu. By default, this setting is turned **OFF**. Choose the appropriate Slack channel for the notification from the dropdown menu. **Publish the Post** Upon publishing, the post will appear in the MangoApps Posts module and as a new post within the selected Slack channel.

{% hint style="danger" %} This external app notification will **only** work for Company posts or Company alerts and not for posts/alerts created in Groups, Departments, Projects {% endhint %} *** ### Managing Previous Posts To share previously published posts on Slack, start by going to the post in MangoApps. Click on the 3-dot Action menu next to **Post Tools.** Select **Share on Slack** and choose the public Slack channel where you want to share the post.

**Promote and Share Team Posts** In a similar method, Team admins can also promote team posts to company posts and share them on Slack channels.

*** ### End User Experience For end users, Slack notifications will appear in designated channels on both Slack web and mobile applications. Mobile users will receive push notifications and can view highlighted channels with new messages #### On Slack Web Users will receive company post notifications on the designated Slack channels.

#### On Slack Mobile Mobile users (iOS and Android) will get push notifications and can view highlighted channels with new messages.

*** ### Testing Considerations We recommend the following when setting up the integration for testing: * Ensure all available Slack channels are listed for selection to set a default. * Public channels are set up to be used to share company communications, and notifications should be set to **All Messages** on these channels. {% hint style="warning" %} Note that MangoApps notifications are outbound only; replies cannot be made from Slack. {% endhint %} *** ### Security Considerations Ensure the MangoApps domain administrator has access to the Slack account for initial setup. For specific privacy information, please refer to the [MangoApps Privacy Policy](https://www.mangoapps.com/privacy-policy). #### Data Deletion A MangoApps Domain Administrator or Slack Workspace Admin has the ability to delete MangoApps data from specific Slack channels. Alternatively, a data deletion request can be sent to our support team at . *** ### Rollout Recommendations and Best Practices After completing integration testing and launching the app for your company, inform Slack users about the new MangoApps notifications. Consider creating a dedicated public Slack channel for these notifications. This will streamline company communication and ensure that everyone stays informed. *** Congratulations! You have completed the integration setup. By following these steps, your organization can effectively integrate Slack with MangoApps, ensuring seamless and efficient communication across both platforms. --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://guides.mangoapps.com/integrations-guide/workspace/integration-with-slack.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.