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.
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.
This external app notification will only work for Company posts or Company alerts and not for posts/alerts created in Groups, Departments, Projects
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.
Note that MangoApps notifications are outbound only; replies cannot be made from Slack.
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.
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 support@mangoapps.com.
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.
Last updated
