Microsoft Teams

Receba notificações de incidentes no Microsoft Teams usando adaptive cards. A configuração é feita via URL de webhook -- sem OAuth ou instalação de app necessária.

Configuração

1. No Microsoft Teams, abra o canal onde deseja receber notificações de incidentes.
2. Clique no ícone + para adicionar um conector e procure por Incoming Webhook.
3. Dê um nome (ex.: "Incidentes Batida") e clique em Criar.
4. Copie a URL do webhook gerada.
5. No Batida, vá em Configurações > Integrações > Microsoft Teams.
6. Cole a URL do webhook e clique em Salvar e Testar.

https://seu-tenant.webhook.office.com/webhookb2/...

Múltiplos canais

Você pode adicionar várias URLs de webhook para rotear notificações para diferentes canais do Teams. Por exemplo, envie incidentes de severidade alta para #incidentes-criticos e alertas de baixa severidade para #incidentes-triagem.

Notificações com Adaptive Cards

O Batida envia notificações como Microsoft Adaptive Cards, que renderizam conteúdo interativo rico diretamente na mensagem do Teams.

Cada notificação inclui:

• Título do incidente com badge de severidade (codificado por cor)
• Status (investigando, identificado, monitorando, resolvido)
• Respondente atribuído e equipe
• Timestamp do evento
• Botões de ação para reconhecer, escalar e resolver

Exemplo de payload de notificação

O Batida envia a seguinte estrutura de Adaptive Card via webhook:

{
  "type": "message",
  "attachments": [
    {
      "contentType": "application/vnd.microsoft.card.adaptive",
      "content": {
        "type": "AdaptiveCard",
        "version": "1.4",
        "body": [
          {
            "type": "TextBlock",
            "text": "INC-42: Pico de latência na API",
            "weight": "Bolder",
            "size": "Large"
          },
          {
            "type": "TextBlock",
            "text": "Severidade: crítica | Status: investigando",
            "isSubtle": true
          }
        ],
        "actions": [
          {
            "type": "Action.OpenUrl",
            "title": "Ver Incidente",
            "url": "https://app.batida.io/incidents/42"
          }
        ]
      }
    }
  ]
}

Tipos de eventos

As notificações são enviadas para os seguintes eventos de incidente:

Evento	Descrição
Aberto	Novo incidente criado
Atualizado	Status ou severidade alterados
Comentado	Nova entrada na timeline
Resolvido	Incidente marcado como resolvido
Escalado	Nível de severidade aumentado

Troubleshooting

• Nenhuma mensagem aparecendo: Verifique se a URL do webhook está correta e não expirou. Vá nas configurações do conector no Teams e regenere a URL se necessário.
• Cards não renderizando: Certifique-se de que seu cliente do Teams esteja atualizado. Adaptive Cards v1.4 é suportado no Teams desktop e web.
• Erros de timeout: Webhooks do Teams têm limite de uma mensagem por segundo por canal. Se você tiver um volume alto de alertas, considere distribuir entre múltiplas URLs de webhook.