GitHub

Crie automaticamente issues no GitHub quando incidentes são abertos, atualize labels na mudança de status, feche issues ao resolver e adicione comentários da timeline.

Configuração

1. Vá em Configurações > Integrações > GitHub no painel do Batida.
2. Clique em Conectar GitHub para autorizar via OAuth. Você será redirecionado para a página de autorização do GitHub.
3. Selecione o repositório (ou repositórios) onde os issues de incidentes devem ser criados.
4. Conceda os scopes repo e issue quando solicitado.
5. Retorne ao Batida e confirme a conexão.

Repositório: sua-org/rastreamento-incidentes
Scopes:      repo, public_repo, read:org

Acesso à organização

Se o repositório pertence a uma organização do GitHub, garanta que o GitHub App do Batida tenha sido aprovado por um admin da organização. As requisições aparecerão nas configurações de apps instalados da organização.

Criação automática de issues

Quando um incidente é aberto, o Batida cria um issue no GitHub com:

Campo do Batida	Campo do issue GitHub
Título do incidente	Título do issue
Descrição	Corpo do issue (renderizado como Markdown)
Severidade	Label (severity:critical, severity:high, ...)
Equipe	Label (team:backend, team:infra, ...)

O corpo do issue inclui um link de volta para a página do incidente no Batida e uma tabela resumo com os metadados principais.

Exemplo de corpo do issue

## Incidente Batida: Pico de latência na API

| Campo | Valor |
|-------|-------|
| **ID** | INC-42 |
| **Severidade** | crítica |
| **Status** | investigando |
| **Atribuído** | @jane |
| **Aberto em** | 2026-04-20 14:30 UTC |

[Ver incidente no Batida](https://app.batida.io/incidents/42)

Atualização de labels por mudança de status

Quando o status de um incidente muda, o Batida atualiza as labels do issue do GitHub:

Status no Batida	Label adicionada	Label removida
Investigando	status:investigando	Todas as outras labels status:*
Identificado	status:identificado	status:investigando
Monitorando	status:monitorando	status:identificado
Resolvido	status:resolvido	Todas as outras labels status:*

O issue também é fechado quando o incidente é resolvido.

Comentários da timeline

Cada entrada da timeline adicionada no Batida é postada como comentário no issue do GitHub, incluindo autor, timestamp e conteúdo da mensagem.

Troubleshooting

• "Repositório não encontrado": Verifique se o app tem acesso ao repositório selecionado. Confira a lista de apps instalados no GitHub.
• Labels não criadas: O Batida cria labels no primeiro incidente. Se a criação falhar, verifique as permissões do repositório (scope repo é necessário).
• Issues não fechando: Garanta que o token do GitHub não expirou. Reautorize pela página de configurações de integração.