Configurando pelo Dashboard
- Acesse Configurações > Webhook de Status
- Insira a URL do webhook (deve usar HTTPS)
- (Opcional) Configure um secret para verificação de assinatura
- 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
- Ative o webhook e clique em Salvar
- 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 no dashboard