Webhook

A integração Webhook envia eventos do seu projeto Sendeasy (mensagens recebidas/enviadas, status de entrega, eventos da Meta repassados, mudanças de ticket etc.) para uma URL HTTPS sua.

Escopos

Webhooks podem ser configurados em dois escopos:

Geral — recebe eventos de todos os canais da empresa.
Por canal específico — recebe eventos apenas do canal escolhido (WhatsApp, Email, SMS, Facebook ou Instagram).

Os dois escopos coexistem e podem ser combinados livremente.

Além dos eventos próprios da Sendeasy, todos os eventos recebidos da Meta (WhatsApp Business, Facebook, Instagram) são repassados automaticamente para o seu webhook — incluindo account_alerts, phone_number_quality_update, template_category_update, message_template_status_update, business_capability_update, flows, e qualquer campo novo que a Meta venha a lançar.

A referência completa de eventos, com payloads e links para a documentação oficial da Meta, está em Webhooks (Server).

Histórico de envios

Toda entrega é persistida e pode ser auditada na própria plataforma em Configurações → Integrações → Webhook → Histórico de envios:

Filtros: evento, status (pending, processing, retrying, success, failed), data inicial e final.
Detalhes por entrega: payload enviado, lista de tentativas com HTTP status, duração, response body e mensagem de erro.
Replay manual: reenvio de uma entrega específica com um clique.
Auto-refresh: enquanto houver entregas pending/processing, a tela atualiza a cada 3s.

Autenticação

Cada webhook pode ter um bearer token opcional. Quando configurado, a Sendeasy envia Authorization: Bearer <token> em todo POST. Use isso para validar a origem das chamadas no seu endpoint.

Tempo de resposta e retry

A Sendeasy aguarda até 30s por uma resposta 2xx do seu endpoint. Em caso de timeout, erro de conexão ou status 5xx, a entrega é marcada como retrying e reprocessada automaticamente pelo BullMQ (com backoff exponencial). Devolva 2xx o quanto antes e faça o trabalho pesado em background.

Onde configurar

Os webhooks são configurados em Configurações → Integrações → Webhook dentro da sua conta Sendeasy. Lá você cria, ativa/desativa, regenera token, remove integrações e abre o histórico de cada uma.