Criando incidentes

Voce pode criar incidentes atraves da aplicacao web do Batida, da API ou de integracoes como Slack e PagerDuty. Esta pagina cobre o fluxo de criacao manual e a referencia da API.

Criando pela interface web

1. Navegue ate Incidentes na barra lateral.
2. Clique no botao Novo Incidente no canto superior direito.
3. Preencha os campos obrigatorios:
   • Titulo -- um resumo curto e descritivo do problema.
   • Severidade -- escolha de SEV1 a SEV4. Na duvida, comece mais alto e rebaixe conforme obter mais informacoes.
   • Tipo -- selecione a categoria: tecnico, seguranca, juridico, compliance, PR ou executivo.
4. Opcionalmente, adicione uma descricao inicial e atribua um Comandante.
5. Clique em Criar.

TIP

Use o comando /batida <título> no Slack para criar incidentes sem sair do chat. O Batida vai postar um link para o novo incidente no canal.

Campos obrigatorios

Campo	Descricao	Exemplo
Titulo	Resumo conciso da disrupcao	Gateway de pagamento retornando erros 500
Severidade	Nivel de prioridade (SEV1--SEV4)	SEV2
Tipo	Categoria do incidente	Tecnico

Tipos de incidente

Escolha o tipo que melhor descreve a situacao:

• Tecnico -- quedas de servico, degradacao de performance, falhas de infraestrutura.
• Seguranca -- possiveis violacoes, vulnerabilidades, acesso nao autorizado.
• Juridico -- solicitacoes legais, avisos regulatorios, obrigacoes de compliance.
• Compliance -- violacoes de politica, achados de auditoria, lacunas regulatorias.
• PR -- questoes de percepcao publica, incidentes em redes sociais, pedidos de imprensa.
• Exec -- escalonamentos de clientes, escalas VIP, preocupacoes estrategicas.

Referencia da API

Criar um incidente

POST /api/v1/incidents
Authorization: Bearer <token>
Content-Type: application/json

Corpo da requisicao:

{
  "title": "Pool de conexoes com banco de dados esgotado",
  "severity": 2,
  "incident_type": "technical"
}

Resposta (201 Created):

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "title": "Pool de conexoes com banco de dados esgotado",
  "status": "investigating",
  "severity": 2,
  "incident_type": "technical",
  "created_at": "2026-04-20T14:30:00Z"
}

Parametros

Parametro	Tipo	Obrigatorio	Descricao
title	string	sim	Titulo do incidente
severity	integer	sim	Inteiro de 1 (mais alto) a 4
incident_type	string	sim	Categoria do incidente

Para informacoes sobre definicoes de severidade, veja Niveis de severidade. Para criacao automatica de incidentes via sistemas de alerta, veja Webhooks de alerta.