SendApp Docs
Entrar

Webhooks de saída: como funcionam

O SendApp chama o seu servidor quando algo acontece na sua conta: chega ou sai uma mensagem, o WhatsApp atualiza o estado de uma mensagem, uma campanha começa ou termina, um modelo do WhatsApp é aprovado ou rejeitado, é feita uma marcação. Configura-se em Configurações → Webhook: até 10 endereços, cada um com a sua conta de IA e os seus eventos.
Cada chamada é um pedido POST com corpo JSON e os cabeçalhos X-SendApp-Event, X-SendApp-Delivery (o id único da entrega), X-SendApp-Attempt e X-SendApp-Signature.
Verifique a assinatura: X-SendApp-Signature vale t=<timestamp>,v1=<HMAC-SHA256 de "timestamp.corpo">, calculado com a chave secreta do webhook (Configurações → Webhook → Mostrar a chave de assinatura). Recuse pedidos com um timestamp com mais de 5 minutos.
Responda com um código 2xx em 10 segundos: caso contrário, tentamos de novo após 1, 5 e 30 minutos. Um código 4xx (exceto 408 e 429) não é repetido. Após 20 entregas falhadas seguidas, o webhook é desligado: volte a ligá-lo em Configurações → Webhook.
Cada entrega tem um delivery_id único, igual em todas as tentativas: use-o para ignorar duplicados. A ordem de chegada não é garantida: para ordenar os eventos use occurred_at (e timestamp para os estados).
O corpo contém sempre event, occurred_at, account_ref, training_token (a conta de IA) e delivery_id. account_ref identifica a sua conta e não é uma chave: o corpo nunca contém a sua chave API. Fotografias, áudios, vídeos e documentos chegam como links, nunca como ficheiros.
Em Configurações → Webhook pode enviar um teste de cada evento: chega com "test": true. O histórico mostra cada entrega com o corpo enviado e a resposta do seu servidor.

Parâmetros

8 · 0 obrigatórios
message.received opcional
Um cliente escreve-lhe, em qualquer canal.
message.sent opcional
Sai uma mensagem: IA, operador, campanha, automação, API.
message.status opcional
Uma mensagem do WhatsApp foi entregue, lida ou não entregue (com o código de erro da Meta).
campaign.started opcional
Uma campanha começa a enviar.
campaign.completed opcional
Uma campanha terminou, com os seus números.
campaign.failed opcional
Uma campanha parou por causa de um erro.
template.status_changed opcional
Um modelo do WhatsApp foi aprovado, rejeitado, posto em pausa ou desativado, com o motivo.
booking.* / voice.* opcional
As marcações da Agenda e as chamadas da Voice AI: os mesmos endereços, a mesma assinatura.
Precisa de ajuda com a integração? info@sendapp.live