Recebe evento de conta da API oficial do WhatsApp (desconexão ou reconexão do número)

🔒

Autenticação necessária

Assinatura do hub de webhooks do WhatsApp (cv-whatsapp-webhooks) nos headers
X-Cv-Hub-Signature e X-Cv-Hub-Timestamp: sha256= seguido do HMAC-SHA256 de
{timestamp}.{url}.{corpo} com o App Secret da Meta, onde url é 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 em disconnection_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.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
string
required

Origem da conversa. Use WPP para WhatsApp.

string
required

Identificador do canal: o phone_number_id do número na Meta.

Body Params
Headers
string
required

sha256= seguido do HMAC-SHA256 de {X-Cv-Hub-Timestamp}.{corpo} com o App Secret da Meta.

string
required

Instante da assinatura, em segundos Unix.

Responses

401

Assinatura do hub ausente, inválida ou expirada

500

Erro inesperado

Language
Credentials
Bearer
JWT
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json