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

# Configuração de Webhooks

> Como configurar webhooks outbound para receber status de mensagens

Configure um endpoint HTTP para receber notificações em tempo real sobre o status de entrega das mensagens RCS.

## Configurando pelo Dashboard

1. Acesse [**Configurações**](https://hub-campaign.convertt.ai/settings) > **Webhook de Status**
2. Insira a **URL do webhook** (deve usar HTTPS)
3. (Opcional) Configure um **secret** para verificação de assinatura
4. Escolha o **escopo**:
   * **Todas as campanhas**: Recebe webhooks de campanhas disparadas pelo dashboard e pela API
   * **Apenas campanhas via API**: Recebe webhooks apenas de campanhas disparadas pela API
5. Ative o webhook e clique em **Salvar**
6. Use o botão **Testar Webhook** para verificar a conectividade

## Requisitos do Endpoint

Seu endpoint de webhook deve:

* Aceitar requisições **POST** com body JSON
* Estar acessível via **HTTPS**
* Responder com status **2xx** em até **10 segundos**
* Ser **idempotente** (o mesmo evento pode ser enviado mais de uma vez)

## Headers Enviados

| Header                | Descrição                                          |
| --------------------- | -------------------------------------------------- |
| `Content-Type`        | `application/json`                                 |
| `User-Agent`          | `RCS-Convertt-Webhook/1.0`                         |
| `X-Webhook-Signature` | HMAC-SHA256 do body (apenas se secret configurado) |

## Política de Retry

Se seu endpoint retornar erro (status >= 500) ou timeout:

* **5 tentativas** automáticas com backoff exponencial
* Após 5 falhas, o evento vai para a Dead Letter Queue (DLQ)
* Eventos falhados podem ser consultados nos [**Logs de Webhook**](https://hub-campaign.convertt.ai/settings) no dashboard

## Cache

Alterações podem levar até 5 minutos para serem aplicadas em eventos já em processamento.