Slack

Connect Batida to Slack to receive incident notifications, use slash commands, and automatically create dedicated channels per incident.

Setup

Batida uses Slack OAuth to connect to your workspace.

1. Go to Settings > Integrations > Slack in the Batida dashboard.

2. Click Connect Slack. You will be redirected to Slack's OAuth consent screen.

3. Grant the following bot token scopes:

   • chat:write -- post messages and create channels
   • channels:manage -- auto-create incident channels
   • commands -- register slash commands
   • users:read -- resolve responder names

4. Authorize the app and return to Batida. The connection status should show Connected.

Workspace requirements

You need to be a Slack workspace admin (or have permission to install apps) to complete the OAuth flow.

Incident notifications

Batida sends notifications for every incident lifecycle event:

• Opened -- severity, title, assigned responder, channel link, and auto-created Slack channel.
• Status Changed -- previous and new status with changed-by user Slack mention.
• Resolved -- duration, resolved-by user with Slack mention, and severity.
• Commander Assigned -- DM to the assigned commander with incident link and View button.
• Escalation Handoff -- DM to next on-call with incident details, escalation level, SLA target, and View button.
• Shift Start Reminder -- DM 15 minutes before shift with active incident count and dashboard link.
• Handoff -- shift summary with outgoing/incoming responder, active incidents, and MTTR stats.

Notifications include action buttons for acknowledging, escalating, and resolving directly from Slack.

Slash commands

Command	Description
/batida <title>	Open an incident (defaults to SEV2; use --severity N for SEV1-SEV4).
/batida note <text>	Add a timeline note to the incident in the current channel.
/batida postmortem	Create a postmortem from the resolved incident in the current channel.
/batida rotation list	List all on-call rotations.
/batida rotation create	Create a new on-call rotation.
/batida rotation who	Show who is currently on call.
/batida rotation next	Show who is on call next.
/batida rotation add-shift	Add a shift to an existing rotation.
/batida rotation remove-shift	Remove a shift from a rotation.
/batida rotation generate	Generate a rotation schedule.

Slash commands are available in any channel once the integration is enabled.

Auto-created channels

When an incident is opened, Batida can automatically create a Slack channel named #inc-{id}-{slug}. This channel becomes the coordination hub for that incident.

All responders are automatically invited, and every timeline update is posted to the channel.

Configure auto-creation under Settings > Integrations > Slack > Channel Settings:

• Auto-create: toggle on/off
• Channel naming pattern: defaults to inc-{{id}}-{{slug}}

Escalation notifications

When an incident is escalated to a higher severity tier, a special notification is sent to the escalation channel configured in your team settings. This message includes the incident details and a direct link to acknowledge.

Troubleshooting

• "App not found": Ensure the OAuth flow completed successfully. Reconnect from the integration settings.
• Missing slash commands: Slack may take up to a minute to register new commands after authorization. If commands are still missing after a few minutes, disconnect and reconnect the integration.
• Bot cannot create channels: Verify the channels:manage scope was granted during OAuth.