Skip to main content

O que são webhooks

Webhooks permitem que a Cordialy notifique seu sistema quando eventos acontecem — sem você precisar fazer polling à API. São ideais para sincronização em tempo real com CRMs, ERPs e automações. Configure em Plataforma → Integrações → Webhooks.

Eventos disponíveis

Formato do payload

Todos os eventos seguem a mesma estrutura:

Payload por evento

Validar a assinatura

Cada requisição inclui o header X-Cordialy-Signature com um HMAC-SHA256 do payload assinado com seu Webhook Secret. Valide sempre antes de processar:
Sempre valide a assinatura antes de processar o evento. Sem validação, qualquer pessoa pode enviar dados falsos para seu endpoint.

Retry automático

Se seu endpoint retornar status diferente de 2xx, a Cordialy tentará reenviar com backoff exponencial: Após 5 tentativas sem sucesso, o evento é descartado.

Boas práticas

Retorne 200 OK imediatamente e processe o evento em background. Endpoints lentos causam timeouts e retries desnecessários.
Por causa dos retries, o mesmo evento pode chegar mais de uma vez. Use o message_id ou lead_id + timestamp como chave de deduplicação.
O endpoint precisa ser HTTPS com certificado válido. HTTP ou certificados autoassinados são rejeitados.