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 e link para a timeline do incidente.
• Atualizado -- mudanças de status, mudanças de severidade e novos comentários na timeline.
• Resolvido -- resumo da resolução e duração total.

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

Comandos slash

Comando	Descrição
/batida open <título>	Abre um novo incidente com o título informado.
/batida list	Lista incidentes ativos da sua equipe.
/batida update <id> <mensagem>	Adiciona um comentário na timeline de um incidente.

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.