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

# Status e disponibilidade

> Como verificar se a API da Arara está no ar, o que fazer quando um envio falha por instabilidade e como reportar um problema.

## Health check

A API expõe um endpoint público, sem autenticação, que responde `200` quando está no ar:

```bash theme={null}
curl https://api.ararahq.com/health
```

```json theme={null}
{
  "status": "UP",
  "timestamp": "2026-09-15T14:30:00Z",
  "service": "arara-api"
}
```

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:

| Componente | Papel |
| - | - |
| **API da Arara** | Recebe a requisição, valida, cobra e enfileira |
| **Provedor de envio e Meta** | Entregam a mensagem no WhatsApp |
| **Webhooks de saída** | Avisam o seu backend sobre status, respostas e eventos do número |

Quando a falha está no provedor ou na Meta, a mensagem aparece com `status: FAILED` e o motivo em `reason`. Veja [Erros de envio](/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](/webhooks).

## Reportar problema

Suspeita de instabilidade:

<CardGroup cols={2}>
  <Card title="Suporte" icon="envelope" href="mailto:suporte@ararahq.com">
    [suporte@ararahq.com](mailto:suporte@ararahq.com). Inclua o `id` da mensagem (`ara_msg_...`), o horário e a resposta recebida.
  </Card>

  <Card title="Dashboard" icon="gauge" href="https://app.ararahq.com">
    Abra um chamado pelo painel.
  </Card>
</CardGroup>

## Próximos passos

<CardGroup cols={2}>
  <Card title="Webhooks com retry" icon="rotate-right" href="/webhooks">
    Como deixar o seu lado resiliente a incidente curto.
  </Card>

  <Card title="Erros" icon="triangle-exclamation" href="/erros">
    Códigos de erro da API e como tratar cada um.
  </Card>
</CardGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.