How to get a Slack message when your AI agent needs you
Create a Slack incoming webhook, add it in the PeerBand dashboard under Webhooks with the Slack format, and pick the statuses you care about. No code runs in between: PeerBand posts the one-line message straight to Slack.
Create the Slack webhook
- Go to Slack's app settings and create an app for your workspace.
- Turn on Incoming Webhooks and add a new webhook to the channel you want, for example #agents.
- Copy the webhook URL. It starts with
https://hooks.slack.com/services/.
Add it to PeerBand
- In the dashboard, open Webhooks and press + Add webhook.
- Set Channel name to
slack-alerts(lowercase letters, digits and dashes). - Choose the Slack format and paste the URL.
- Pick Events: Status changes and Agent notes are a good start. The default statuses are idle and blocked.
- Choose all machines, or only some.
- Save. PeerBand sends a test message and the webhook turns Active once Slack accepts it.
What arrives
Each event is one line naming the machine, the agent and what happened, for example:
PeerBand · office-pc · claude (api) is blocked
Notes from peerband notify arrive with their text. Webhooks never include terminal output.
When something goes wrong
The webhook's Recent deliveries list shows each attempt with its HTTP status. Failed deliveries are retried for about 27 hours. If Slack keeps rejecting them, PeerBand disables the webhook and shows why. Fix it and press Resume.
Questions
Can different machines post to different Slack channels?
Yes. Add one webhook per Slack channel and pick the machines for each. You can have up to 10 webhooks.
Can agents post to a specific Slack channel?
Yes. The webhook's name is a channel: an agent runs peerband notify --channel slack-alerts "…" to post only there.