Skip to main content

​
Health check

A API expõe um endpoint público, sem autenticação, que responde 200 quando está no ar:
Use esse endpoint no seu monitoramento. Ele indica que a API está respondendo; não verifica a disponibilidade da Meta nem do provedor de envio.

​
Dependências externas

Um envio passa por mais de um sistema: Quando a falha está no provedor ou na Meta, a mensagem aparece com status: FAILED e o motivo em reason. Veja Erros de envio para os códigos.

​
Resiliência do seu lado

  • Idempotência: envie Idempotency-Key em POST /v1/messages. Se a sua requisição cair no meio e você retentar, a mesma chave devolve a mensagem original em vez de criar outra.
  • Retry com backoff: retente falha de rede e respostas 5xx. Em 429, espere o tempo indicado em Retry-After.
  • Webhooks: a Arara retenta a entrega de eventos que o seu endpoint não aceitou em 30s, 2min, 15min, 1h e 4h. Ver Webhooks.

​
Reportar problema

Suspeita de instabilidade:

Suporte

suporte@ararahq.com. Inclua o id da mensagem (ara_msg_...), o horário e a resposta recebida.

Dashboard

Abra um chamado pelo painel.

​
Próximos passos

Webhooks com retry

Como deixar o seu lado resiliente a incidente curto.

Erros

Códigos de erro da API e como tratar cada um.