Autenticação necessáriaAssinatura do hub de webhooks do WhatsApp (
cv-whatsapp-webhooks) nos headers
X-Cv-Hub-SignatureeX-Cv-Hub-Timestamp:sha256=seguido do HMAC-SHA256 de
{timestamp}.{url}.{corpo}com o App Secret da Meta, ondeurlé a URL completa da
chamada (https://{ambiente}.cvcrm.com.br/api/v1/comunicador/conta/WPP/{identificador}).
O header Authorization não é usado. Assinatura ausente, divergente da URL ou do corpo, ou
com timestamp a mais de 300 segundos do relógio do servidor é recusada.
Chamado pelo hub que recebe os webhooks da Meta, com o account_update repassado sem
alteração (uma alteração por chamada). Eventos tratados:
PARTNER_REMOVED: o número saiu da API oficial — desconectado pelo app WhatsApp
Business (motivo emdisconnection_info.reason) ou parceiro removido da conta;ACCOUNT_OFFBOARDED: troca de aparelho ou novo registro do número no app;ACCOUNT_RECONNECTED: reconexão automática concluída.
O hub repassa o evento a todos os números da conta comercial. PARTNER_REMOVED só é
aplicado ao canal cujo telefone corresponde ao phone_number do evento (sem
phone_number, vale para o canal). ACCOUNT_OFFBOARDED e ACCOUNT_RECONNECTED não trazem
o número e só são aplicados a canal conectado em Coexistence.
Desconectado, o canal fica nao_autenticado com o motivo e o envio de mensagens é
bloqueado até a reconexão. Os demais eventos, e os de outro número, são ignorados e
respondem sucesso.
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
401Assinatura do hub ausente, inválida ou expirada
500Erro inesperado
