Respostas do webhook - aciona.me

Todas as fontes usam o mesmo endpoint de ingestão e os mesmos códigos de resposta.

POST https://ingress.aciona.me/webhooks/<idDaFonte>
X-Aciona-Token: <tokenDaFonte>

Códigos

Código	Significado	O que fazer
`202`	Alerta aceito e registrado. Processamento assíncrono.	Nada. Confirme o acionamento no painel.
`400`	Payload inválido ou campos obrigatórios ausentes.	Valide o JSON renderizado pelo template da ferramenta.
`401`	Token ausente, inválido ou de outra fonte.	Confira o header `X-Aciona-Token`; rotacione se necessário.
`403`	Fonte de alerta inativa.	Reative a fonte em Fontes de alerta.
`404`	Identificador de fonte inexistente.	Confira a URL completa.
`413`	Corpo acima do limite (padrão 1 MB).	Reduza os campos enviados no template.
`429`	Volume de requisições acima do aceito.	Agrupe alertas na origem antes de enviar.
`5xx`	Erro do lado do aciona.me.	Deixe a ferramenta retentar; se persistir, contate o suporte.

O que é persistido em cada caso

Requisições recusadas com 400, 401, 403, 404 e 413 não persistem nada. Não há registro do alerta para consultar depois — se você precisa de rastro, olhe o log da ferramenta de origem.

Um 202 significa que o alerta foi registrado. Ele pode, em seguida:

Criar um acionamento;
Ser agregado a um acionamento aberto;
Resolver um acionamento aberto (fontes com auto-resolução);
Ser descartado, quando o estado enviado não é acionável.

Veja Alerta sem acionamento.

Comportamento de retentativa das ferramentas

Ferramenta	Retenta em
Datadog	Apenas `5xx`
New Relic	Erros consecutivos podem colocar o destination em snooze automático
Alertmanager	Reenvia no próximo `repeat_interval`
Grafana	Conforme a política de notificação
Zabbix	Conforme a configuração de retry da media type
CloudWatch (via Lambda)	Conforme a configuração de retry da função

Erros 4xx normalmente não são reenviados. Um token errado significa alertas perdidos até que alguém corrija a configuração — vale monitorar as falhas de entrega no lado da ferramenta.

⌘I