🔒 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.

{
  "object": "whatsapp_business_account",
  "entry": [
    {
      "id": "102290129340398",
      "changes": [
        {
          "field": "account_update",
          "value": {
            "event": "PARTNER_REMOVED",
            "phone_number": "5511999998888",
            "waba_info": {
              "waba_id": "102290129340398"
            },
            "disconnection_info": {
              "reason": "PRIMARY_INACTIVITY",
              "initiated_by": "SYSTEM"
            }
          }
        }
      ]
    }
  ]
}

{
  "sucesso": true
}