Slack — Notifications, /mango Commands, Must-read Messages and Channel Posts

Slack

1. What it is

Connecting Slack lets MangoApps meet people where they already chat. They get MangoApps notifications in Slack, use /mango commands to raise tickets or recognize a colleague, and approve recognition nominations from the message itself. Admins can also post a notice about a Communication (a sign-in link to read it) and shared items to Slack channels.

Once you turn it on, the MangoApps app also sends each person a private Slack message when a must-read is waiting on them. They can acknowledge it there.

• Enablement: an administrator connects your Slack workspace once, then chooses app by app what Slack may do. Must-read messages, Share and Ask AI each have their own switch.
• What it is not: asking Slackbot about MangoApps work (“what needs me this shift?”) is a separate feature, controlled in Admin → Security → Connectors. See AI Assistants.

2. Standing it up

1. Go to Admin → Organization → Integrations, choose Manage Messaging & Sharing, then Connect Slack on the Slack card. Sign in to Slack as someone allowed to add apps to your workspace, and approve.
   If Connect Slack is greyed out, MangoApps hasn’t finished setting up Slack for your environment. Contact support.
2. Open the Slack page (Configure). Under Add App, pick an app and tick what it may do:
   • Slash Commands: its /mango commands work in Slack.
   • Notifications: its notifications are sent to Slack.
   • Channel Posting: it can post to a channel. Communications needs a channel chosen here.
     Click Register App, and repeat for each app. The Commands card on the right shows which commands are now on.
3. Optionally choose a Default Channel, and whether Share may post to Slack channels.
4. Optionally turn on Send must-reads as direct messages on the Must-read messages card (see §3). You don’t need to add an app under Add App for this.
5. Tell your people. The Tell your employees card has a message ready to copy and send. Nothing in Slack announces the connection on its own.
6. To check it works, type /mango help in any Slack channel. You should see the commands you turned on. Test Connection at the top of the page checks that MangoApps can still reach your workspace.

3. How it fits together

People are matched by work email. MangoApps finds a person by the email on their Slack profile, which must match their MangoApps email. Only people who are active in your organization are matched. Someone who can’t be matched can still type /mango help but can’t raise tickets or give recognition. They also get no must-read messages in Slack; they still see the item in MangoApps.

A command runs only when two things are true. Its app was added with Slash Commands ticked, and the person has access to that app in MangoApps. /mango help lists exactly the commands that person can use.

Replies are private. Every /mango reply is visible only to the person who typed it, even in a busy channel.

Buttons act for the person who clicks. Approve and Decline on a nomination card check that the clicker is allowed to decide. When it works, the card changes in place to show the outcome and the buttons disappear. When it doesn’t, only the clicker sees why.

The app’s Home tab. Opening the MangoApps app in Slack shows each person the commands they can use.

Must-read messages are direct messages. A must-read is anything that asks a person to acknowledge, confirm or complete it. When Send must-reads as direct messages is on, the MangoApps app messages each person privately in Slack when one of these is sent:

What is sent	Who gets a message	What the message carries
A must-read post	Each person asked to acknowledge it	Summary, link and an Acknowledge button
A broadcast that asks for acknowledgement	Each person it was sent to	Summary, link and an Acknowledge button
A Sites page published with Ask readers to confirm they’ve read it	Each reader asked to confirm	Summary and a link only
A SOP published for people to complete	Each person assigned to complete it	Summary, due date and a link only

A Sites page is confirmed, and a SOP completed, on its own page in MangoApps. That is why they arrive as a link and never with an Acknowledge button.

For example: HR publishes a must-read post, “Updated uniform policy”, to the Warehouse team. Each person on that team who hasn’t acknowledged it gets a Slack message from the MangoApps app. It shows the title, who it’s from, a short summary, Acknowledge and Open in MangoApps. Clicking Acknowledge records the acknowledgement in MangoApps. The message then changes to “✓ You acknowledged this.”

A few rules decide who is messaged, and when:

• Only people still owed it. Anyone who has already acknowledged, confirmed or completed it is skipped. So is its author. The same person is never messaged twice about the same ask on one connection. A Sites page republished with a new ask counts as a new one.
• The item’s own delivery rules apply. A broadcast set to Only people currently on shift never messages someone who is off shift. One set to Defer off-shift people to their next shift holds their message until that shift starts. Unless a broadcast is critical, Right to Disconnect (off-shift protection) holds its message back too, as it does for Sites pages and SOPs. A must-read post is sent straight away, like its push notification. Anyone held back still finds the item in MangoApps.
• A SOP follows SOP Hub’s own switch. It is messaged only while Tell Employees When a New Procedure Needs Completing is on in SOP Hub settings.
• Each person reads it in their own language. The labels and buttons use the display language on the person’s profile. The title and summary use the language they would read the item in within MangoApps, where a translation exists. Otherwise the original is shown.
• The summary is written by AI. The message footer says so.
• The button belongs to one person. If someone else clicks it, they are told it was sent to someone else, and nothing is recorded. The button works for 30 days; after that it points the person to MangoApps.

The switch is per connection. It is set separately on the Slack page and the Microsoft Teams page. A person reachable in both, with both switched on, gets a message in each.

Ask AI in Slack. Off by default. When an admin ticks Let people ask Ask AI in Slack on the Slack page’s Ask AI card, people can type /mango ask followed by a question for a private answer. They can also message the MangoApps app directly, or @mention it in a channel to get an answer in the thread. Direct messages and @mentions need permissions Slack connections made before this feature don’t have: the card says so, and an admin reconnects Slack to approve them. If the card says Not available yet, MangoApps hasn’t finished setting up its Slack app for your environment. Answers use the person’s own MangoApps access and need Ask AI to be available to them. In a channel, personal questions (pay, leave, reviews and the like) are not answered, and nothing is changed; the reply says to ask privately. A change that someone asks for privately shows a card with Approve and Decline. Only the person who asked can approve it, it expires after 10 minutes, and it works once.

4. Running it

Supporting your people’s /mango commands

Command	What it does	Needs
/mango help	Lists the commands you can use	Always available
/mango ask [question]	Asks Ask AI; only you see the answer	Ask AI turned on for Slack, and Ask AI available to you
/mango ticket [description]	Raises a Service Desk ticket	Service Desk
/mango mytickets	Shows your open tickets	Service Desk
/mango ticket_status [ID]	Shows one ticket’s status	Service Desk
/mango recognize [email] [message]	Recognizes a colleague	Recognition
/mango myrecognition	Your recognition summary	Recognition
/mango leaderboard	The recognition leaderboard	Recognition

Changing what an app may do in Slack

1. Open Admin → Organization → Integrations → Manage Messaging & Sharing → Slack (Configure).
2. Under Add App, pick the same app and tick the features it should have now.
3. Click Register App. Registered Apps shows the new set of features.

The ✕ beside an app under Registered Apps removes it from Slack.

Turning must-read messages on or off

1. Open the Slack page (Configure).
2. On the Must-read messages card, switch Send must-reads as direct messages.

Turning it off stops new messages. People still acknowledge from MangoApps as before. If the card shows Turn on Communications, Sites or SOP Hub first, none of those apps is on for your organization yet.

Disconnecting

Disconnect (on the Slack page, or the Messaging page) stops everything above. Connecting again brings back the apps and settings you had.

5. Settings

All on Admin → Organization → Integrations → Manage Messaging & Sharing → Slack (its Configure button).

Setting	Where	Default	What it changes
Slash Commands	Add App	On	The app’s /mango commands run in Slack
Notifications	Add App	On	The app’s notifications are sent to Slack
Channel Posting	Add App	Off	The app may post to a channel
Default Channel	Settings card	None	Where an app’s notifications go when it has no channel of its own
Allow Share to Slack channels	Settings card	Off	People can send a ticket, account or post to a Slack channel with Share
Only offer channels the sender belongs to	Settings card, under Who can be sent a record	Off	Channels the sender isn’t in are shown but can’t be picked
Let people ask Ask AI in Slack	Ask AI card	Off	People can ask Ask AI with /mango ask, a direct message or an @mention
Send must-reads as direct messages	Must-read messages card	Off	Each person owed a must-read gets it as a private Slack message

The Add App defaults are how the checkboxes start each time you register an app.

6. More help

• Microsoft Teams: the same features in Teams, including must-read messages.
• AI Assistants: Slackbot, Claude, ChatGPT and Microsoft 365 Copilot.
• Notifications: what MangoApps sends and to whom.
• Ask AI — the assistant answers questions about Slack from these articles.