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 P1 a P4. 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 /incident 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 (P1--P4)	P2
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.
• Executivo -- 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": "P2",
  "type": "technical",
  "description": "Conexoes do banco principal estao em 100% da capacidade. Novas conexoes estao expirando.",
  "commander_id": "usr_abc123"
}

Resposta (201 Created):

{
  "id": "inc_xyz789",
  "title": "Pool de conexoes com banco de dados esgotado",
  "status": "investigating",
  "severity": "P2",
  "type": "technical",
  "commander_id": "usr_abc123",
  "created_at": "2026-04-20T14:30:00Z",
  "url": "https://app.batida.io/incidents/inc_xyz789"
}

Parametros

Parametro	Tipo	Obrigatorio	Descricao
title	string	sim	Titulo do incidente
severity	string	sim	P1, P2, P3 ou P4
type	string	sim	Categoria do incidente
description	string	nao	Notas iniciais
commander_id	string	nao	ID do Comandante

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