Help for owners
Our Slack bot stopped posting messages
Short answer
Slack's posting method returns a named error for each cause: not_in_channel, channel_not_found, is_archived, invalid_auth, token_revoked or missing_scope. A bot also goes quiet when the app is uninstalled or the installing user is deactivated, or when it posts faster than about one message per second per channel.
Does this sound like your situation?
- Alerts or reports that used to appear in a channel no longer show up.
- The bot is still listed in the workspace but says nothing.
- It stopped after a colleague left the company.
- It stopped after the channel was renamed, archived or made private.
- Some messages arrive and others are missing during busy periods.
Why does this happen?
The bot is not in the channel, or the channel changed
Slack's reference documents not_in_channel, channel_not_found and is_archived as separate errors. A private channel, or one that was archived or recreated, is a common trigger.
Confirmed by docs.slack.dev
The token was revoked
Slack says tokens do not expire, but they are revoked when a workspace owner fully uninstalls the app, a user removes their configuration, or the authenticating user's account is deactivated. After that the bot token stops working, the bot user is removed and incoming webhooks tied to it are removed.
Confirmed by docs.slack.dev
The token lacks a permission
Posting needs the chat:write scope. Posting to a public channel without joining it needs chat:write.public. Slack returns missing_scope when the token does not have what the call needs.
Confirmed by docs.slack.dev
The app posts too fast
Slack states an app may generally post about one message per second to a channel, and that exceeding limits returns HTTP 429 with a Retry-After header telling the app how long to wait. Short bursts are allowed, sustained excess is limited.
Confirmed by docs.slack.dev
The app was built on one person's login
When the user who installed the app leaves and their account is deactivated, the token tied to them is revoked and the app can look uninstalled.
Confirmed by docs.slack.dev
What can I do about it today?
- Find the last message the bot postedNote the date and channel. It narrows down what changed, such as a person leaving or a channel being renamed.
- Look at the app in your workspaceAsk a workspace admin whether the app is still installed and who installed it. Do not remove and reinstall it yet.
- Check the channelIs it archived, renamed, or now private? Is the bot a member?
- Send the exact error to whoever maintains the botThe bot's logs normally contain one of the named errors. That single word usually tells the whole story.
- Do not share any token or password in chatTokens start with letters such as xoxb or xoxp. If one was pasted anywhere public, tell your developer so it can be replaced.
When should I bring someone in?
- The token was revoked and nobody knows where the app's code runs.
- Alerts matter to operations or customers and gaps are unacceptable.
- The bot works in tests but drops messages during busy periods.
How do I handle it?
- Read the error Slack returnedI check the app's logs for the exact error, the time of the first failure and the channel involved.
- Check the install and the ownerI look at which user installed the app, which scopes it has, and whether that account still exists.
- Repair and move off a personal loginI fix the cause, and where the app hangs on one person's account I plan the reinstall under a team-owned account with a named admin.
- Queue and slow down postingMessages go through a small queue that respects Retry-After and groups noisy bursts, so none are dropped.
- Tell someone when posting failsA failed post is logged and raises a message to a different channel or email, so silence is never the only signal.
The price depends on what I find, so I quote in writing after a short discovery call. Tell me what is happening and I reply within 24 hours.
What do owners ask about this?
Do Slack tokens expire?
Slack documents that tokens do not expire. They are revoked in specific cases such as an owner uninstalling the app or the installing user being deactivated.
Is it safe to reinstall the app?
Often yes, but a reinstall issues new tokens. The old code must be updated with them, or it keeps failing. Ask the maintainer to plan it.
How many messages can a bot send?
Slack says an app may generally post about one message per second per channel, with workspace limits too. Sustained excess is rate limited.
Sources
How was this page made?
I drafted this page with AI assistance from the official documents listed under Sources. Found a mistake? Tell me.