Slack

Conecte o Batida ao Slack para receber notificações de incidentes, usar comandos slash e criar automaticamente canais dedicados por incidente.

Configuração

O Batida utiliza Slack OAuth para se conectar ao seu workspace.

1. Vá em Configurações > Integrações > Slack no painel do Batida.

2. Clique em Conectar Slack. Você será redirecionado para a tela de consentimento OAuth do Slack.

3. Conceda os seguintes scopes ao bot:

   • chat:write -- postar mensagens e criar canais
   • channels:manage -- criar automaticamente canais de incidente
   • commands -- registrar comandos slash
   • users:read -- resolver nomes de respondentes

4. Autorize o app e retorne ao Batida. O status da conexão deve exibir Conectado.

Requisitos do workspace

Você precisa ser admin do workspace do Slack (ou ter permissão para instalar apps) para completar o fluxo OAuth.

Notificações de incidentes

O Batida envia notificações para cada evento do ciclo de vida do incidente:

• Aberto -- severidade, título, respondente atribuído, link do canal e criação automática do canal Slack.
• Status Alterado -- status anterior e novo com menção Slack do usuário que alterou.
• Resolvido -- duração, resolvedor com menção Slack e severidade.
• Comandante Atribuído -- DM para o comandante atribuído com link do incidente e botão View.
• Passagem de Escalonamento -- DM para o próximo plantonista com detalhes do incidente, nível de escalonamento, meta de SLA e botão View.
• Lembrete de Início de Turno -- DM 15 minutos antes do turno com contagem de incidentes ativos e link do dashboard.
• Passagem de Turno -- resumo do turno com plantonista de saída/entrada, incidentes ativos e estatísticas de MTTR.

As notificações incluem botões de ação para reconhecer, escalar e resolver diretamente pelo Slack.

Comandos slash

Comando	Descrição
/batida <título>	Abre um incidente (padrão SEV2; use --severity N para SEV1-SEV4).
/batida note <texto>	Adiciona uma nota na timeline do incidente no canal atual.
/batida postmortem	Cria um postmortem a partir do incidente resolvido no canal atual.
/batida rotation list	Lista todas as escalas de plantão.
/batida rotation create	Cria uma nova escala de plantão.
/batida rotation who	Mostra quem está de plantão no momento.
/batida rotation next	Mostra quem será o próximo plantonista.
/batida rotation add-shift	Adiciona um turno a uma escala existente.
/batida rotation remove-shift	Remove um turno de uma escala.
/batida rotation generate	Gera uma agenda de escala.

Os comandos slash ficam disponíveis em qualquer canal assim que a integração é ativada.

Criação automática de canais

Quando um incidente é aberto, o Batida pode criar automaticamente um canal no Slack chamado #inc-{id}-{slug}. Esse canal se torna o hub de coordenação do incidente.

Todos os respondentes são convidados automaticamente, e cada atualização da timeline é postada no canal.

Configure a criação automática em Configurações > Integrações > Slack > Configurações de Canal:

• Criação automática: ativar/desativar
• Padrão de nome do canal: padrão é inc-{{id}}-{{slug}}

Notificações de escalonamento

Quando um incidente é escalado para um nível de severidade superior, uma notificação especial é enviada ao canal de escalonamento configurado nas definições da equipe. Essa mensagem inclui os detalhes do incidente e um link direto para reconhecer.

Troubleshooting

• "App não encontrado": Verifique se o fluxo OAuth foi completado com sucesso. Reconecte pelas configurações de integração.
• Comandos slash ausentes: O Slack pode levar até um minuto para registrar novos comandos após a autorização. Se ainda estiverem ausentes após alguns minutos, desconecte e reconecte a integração.
• Bot não consegue criar canais: Verifique se o scope channels:manage foi concedido durante o OAuth.