Notifications
Getting told the things that need you — in your team's channels, in the app, and on your phone.
Peractor tells people about the moments that need a human, and stays quiet otherwise. A phase succeeding is not news; a run waiting on you is.
What Peractor tells you about
| Kind | When |
|---|---|
| Gate | A run parked for your review. |
| Question | An agent asked you something. |
| Interactive | A step is waiting for you to talk to it and end it. |
| Completed · Failed | A run settled. |
| Reviewed | Somebody else approved a run you started, or asked for changes on it. |
| Stopped | Somebody else canceled a run you started. |
| Assigned | Somebody put a task on you. |
| Mentioned | Somebody named you in a comment. |
| Commented | A task you follow has a new comment. |
| Joined | Somebody accepted an invitation to your organization. Sent to admins. |
| Invite | You were invited to an organization. The one you cannot switch off — until you accept it, you have no other way to find it. |
Each kind is a switch in your own notification settings, per organization, grouped as Runs, Tasks and Organization: Settings → Notifications on the phones and the dashboard, the This Mac pane on the Mac, and Your notifications in the editor. A kind added in a later release starts switched on. There is an Inbox in the apps with an unread badge, so nothing depends on a push getting through.
Your team's channels
Configure notifiers in Settings → Notifications. Every configured one posts, together.
| Provider | Connects with | Notes |
|---|---|---|
| Slack | Add to Slack (OAuth) | One thread per run; images render inline. Pick a public channel, or invite the bot to a private one. |
| Discord | Add to Discord (OAuth) | Channel chosen on Discord's consent screen; coloured embeds. |
| Telegram | Bot token + chat id | Threaded replies per run, photo previews. |
| Microsoft Teams | Workflows webhook URL | Adaptive Cards with the linked issue and status colour. |
| Google Chat | Space webhook URL | Threaded per run. |
| Mattermost | Webhook URL and channel | The self-hosted favourite. |
| Webhook | Any URL | Posts structured JSON per milestone — build anything. |
Each has a Test button that posts a real message before you commit. Slack and Discord are OAuth only — one click installs the app, with no token form to fill.
You can configure more than one of the same provider — a general channel and a releases channel — and name them separately in a notify step.
What gets posted
Runs thread where the platform allows it: a "started" root message, then milestones as replies — ready for review, approved, changes requested with the note, done, failed, canceled — plus any published artifacts as inline images.
Your workflows can add their own messages at exact moments with a notify step, and that step can compose its message from what the run actually did rather than posting a fixed sentence.
Push on your phone
The iOS and Android apps get native push for the moments that need a human, and tapping one opens the page it is about — the run (on the gate, question or step it names), the task (on the comment), your invitations, or your organization's members — signed in as the right account and moved to the right organization and project, even if you have several on the device. The Mac and the dashboard's bell land in the same places.
iOS asks for notification permission the first time a run actually waits on you, not at install. Self-hosters enable each platform independently.