Connecting Slack needs the Manage brands permission in the organization. If you belong to more than one organization, check that you selected the right one. Ask a user with that permission to connect the Slack workspace, and once it's connected, users with the Manage brand permission can set up Slack for their brands.
Send brand notifications to Slack
Updated 3 weeks ago
Connect Metricool to Slack and each brand can post its alerts (approvals, failed posts, expired connections and more) to the Slack channel you choose. Everyone in that channel sees them, whether or not they have a Metricool account.
Setting it up has two parts. First, you connect a Slack workspace to your organization, once. Then, for each brand, you configure the channel that receives the alerts, the events to send, and the language of the messages.
Slack notifications run in parallel to your regular Metricool notifications, which still follow your permissions in Metricool and your personal notification preferences. You keep getting your emails and in-app notifications. The recipients of a Slack alert are determined by the Slack channel, not by brand permissions: anyone in the channel sees it, even without access to the brand, and having permissions on a brand doesn't deliver it to you unless you're in the channel.
Before you start
Slack notifications are included in paid plans, except the AppSumo plan. If your organization moves to the Free plan, Metricool stops all Slack sending and keeps your connections, so sending resumes when you upgrade again. White label and integrator end clients can't use Slack notifications.
To connect, disconnect, or delete a Slack workspace, you need the Manage brands permission in the organization.
To create, edit, pause, or delete a brand's Slack destination, you need the Manage brand permission on that brand. You can only choose from workspaces already connected to the organization.
You need a Slack account that is allowed to install apps in the workspace.
Free Slack workspaces can have up to 10 installed apps. If your workspace already has 10, remove one before you install the Metricool app.
Part 1: Connect a Slack workspace to your organization
Connect a workspace once and every brand in your organization can use it. You can connect several workspaces, for example your agency's own and a client's.
Go to Organization settings > Integrations. If you belong to more than one organization, select the organization first.
In the Slack card, click Connect.
On the Slack page that opens, choose the workspace where you want to use Metricool.
Review the permissions and click Allow.
Slack lists what Metricool is asking for: to view content and info about channels, conversations, and your workspace, and to perform actions in channels and conversations. Metricool uses these permissions to send messages, to post in public channels without being added to them, and to see the list of channels (public ones, and private ones where the app has been added). The workspace then appears in the list with who connected it, the date, how many brands use it, and its status. Active means it works, Pending means it's waiting for a Slack administrator to approve the app, and an error status means the connection failed, for example because the app was uninstalled from Slack.
Workspaces that need admin approval
Some Slack workspaces require an administrator to approve every new app. In that case, Connect sends a request to your Slack administrator instead of installing the app, and Slack tells you inside Slack when it's approved or rejected.
Until you come back with a finished connection, the workspace shows as Pending, and you can't pick it for a brand. After the administrator approves the app, click Connect on that row to complete the connection.
To discard a pending connection, open the ⋮ menu at the end of its row, select Delete, and confirm with Delete connection. Metricool removes the connection and any Slack destinations configured for it, and you can't recover them.
Disconnect or delete a workspace
Disconnecting pauses everything and can be undone, while deleting removes the setup for good. In Organization settings > Integrations, open the ⋮ menu at the end of the workspace's row and select Disconnect or Delete. Both need the Manage brands permission in the organization.
Action | What happens |
|---|---|
Disconnect | Metricool stops sending to that workspace and the row shows Disconnected. Every destination keeps its channel, events, and language. Click Reconnect on the row and everything works again as before. |
Delete | Metricool removes the connection and every Slack destination configured for it, in all brands. The brand settings are lost and you can't recover them. If you connect the workspace again, you need to set up each brand's destination again. |
Both actions ask you to confirm. Confirm a deletion with Delete connection. You can also delete a workspace that is already disconnected, from the same ⋮ menu.
Deleting or disconnecting in Metricool doesn't uninstall the app from Slack. If you uninstall the app from Slack itself, the connection fails for every Metricool organization that uses that workspace, not only yours, and each of them needs to reconnect.
Troubleshoot the connection
If you can't find Integrations, the workspace shows an error status, or Slack asks for more permissions, use the matching answer below.
I can't see Integrations in my organization
The connection to the workspace was lost
The app was uninstalled from Slack or its authorization was revoked. The workspace shows an error status, and every destination that uses it stops sending. Go to Organization settings > Integrations and reconnect the workspace from its row. Your destinations keep their settings and resume sending.
Metricool needs additional permissions in Slack
A Slack administrator limited the app's permissions, or the app needs new ones. Reconnect the workspace and accept the permissions. If a Slack security policy blocks the app, ask your Slack administrator to review it.
Part 2: Configure a brand's channel, notifications, and language
Do this for each brand that should post to Slack. Each brand has one Slack destination: a channel plus the events sent to it. Several brands can send to the same channel, and every message names the brand it comes from. The channel you choose decides who receives the alerts, whatever their permissions in Metricool. You don't connect Slack again for each brand, because brands reuse the workspaces connected to the organization.
Go to Brand settings, select the brand from the dropdown at the top, and open the Integrations tab.
In the Slack card, click Set up destination.
Under Slack workspace, choose the workspace. If the list is empty, a user with the Manage brands permission needs to connect one first.
Under Channel, search for the channel and select it. The list includes public channels and the private channels where the Metricool app has been added.
Under Events to send, select the events you want. All are selected by default, and Select all selects or clears the whole list.
Under Message language, choose the language of the messages. It defaults to your own language and applies to every message in the channel, whoever reads it. It doesn't change the language of Metricool.
Click Save destination.
When you save, Metricool posts a welcome message in the channel to confirm it works. The message lists the events the channel will receive. The Slack card then shows the destination with its status (Active), workspace, channel, number of events, language, and who created it and when. To check the connection at any time, click Test connection on the card, and Metricool sends a test message to the selected channel.
Use a private channel
Metricool can post in any public channel without an invitation, but it needs to be added to private channels. In the private channel, type /invite @Metricool.
Choose the events to send
Choose any combination of these seven events for each brand.
Event | When Metricool sends it |
|---|---|
Post approved | A reviewer approves a post. |
Post rejected | A reviewer rejects a post. The message includes their comment. |
New note on a post | Someone leaves a note on a post. The message includes the note. |
Post published with warnings | A post is published, but the social network returned warnings. |
Post failed to publish | A post couldn't be published. The message includes the reason from the social network when available. |
Manual post ready to publish | A post is ready for you to publish manually. |
Account connection expired | The connection to a social account expired or was disconnected. |
For what each event means in Metricool, see Types of notifications in Metricool.
What a Slack message includes
Metricool sends one message per event, as soon as the event happens, in the order the events occur. Messages are informational: you can't approve, reject, or reply from Slack.
The status, the brand name, and the social networks involved.
What happened, and who did it when it applies. If a user hasn't set a profile name, Slack shows the part of their email before the @, so full email addresses are never shown in the channel.
A preview of the post: the first lines of text and a thumbnail of the first image. For videos, the thumbnail only, because Slack doesn't play them inside the message.
The publication date and time of the post, and the comment or note when the event has one.
A button that takes you to Metricool: View in Metricool opens the post, View note opens the note, and Reconnect account opens the connected accounts screen for a disconnected social network. People without access to the brand see the login or no-access screen.
Change, pause, or delete a destination
Click Edit on the Slack card to change the channel, the events, or the language. To send a brand's notifications to a different channel, edit the existing destination. Open the ⋮ menu to select Pause notifications or Delete. Here, Delete removes only this brand's destination. To remove a workspace from the whole organization, see "Disconnect or delete a workspace" in Part 1.
While a destination is paused, the status shows Paused and a banner on the card says notifications are paused. Metricool keeps all the settings and sends nothing to Slack until you click Resume in the banner.
Troubleshoot a destination
When a destination can't send, it shows Error in the brand's Slack section with the reason and the fix, and Metricool stops trying to send to it. The answers below cover private, archived, deleted, and restricted channels, and delayed messages.
Metricool isn't in this channel
The channel is private and the Metricool app isn't in it, or it was removed. Type /invite @Metricool in the channel, then click Test connection.
The channel is archived
Unarchive the channel in Slack or choose another channel for the brand. After you unarchive it, click Test connection, because the destination keeps showing as archived until you do.
The channel no longer exists
Edit the destination and choose another channel.
Slack doesn't allow posting in the channel
A channel or workspace setting blocks the app, for example a read-only channel, a thread-only channel, or an administrator restriction. Check the channel's permissions in Slack or choose another channel.
Messages arrive late or a warning about limits appears
Free Slack workspaces can limit how many messages arrive in a short time. Metricool shows a warning in the brand's Slack section and keeps retrying. If Slack has a temporary problem, Metricool also retries for several hours before it drops the message.
Limits to know
Each brand has one Slack destination.
Messages are informational only, with no approval or reply actions in Slack.
If you delete a brand and later recover it, its Slack destinations come back with the same settings. If the channel changed in the meantime, it's treated like any other sending error.
Related articles