> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aciona.me/llms.txt
> Use this file to discover all available pages before exploring further.

# Respostas do webhook

> Códigos HTTP retornados pelo endpoint de ingestão e o que fazer com cada um.

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

```bash theme={null}
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

<Note>
  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.
</Note>

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](/pt-br/solucao-de-problemas/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                          |

<Warning>
  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.
</Warning>