Recebe eventos de ligação da API oficial do WhatsApp

🔒

Autenticação necessária

Assinatura do hub de webhooks do WhatsApp (cv-whatsapp-webhooks), como em
/conta/{origem}/{servico}: headers X-Cv-Hub-Signature e X-Cv-Hub-Timestamp, com a
URL desta rota na assinatura.

Chamado pelo hub com o campo calls da Meta repassado sem alteração (uma alteração por
chamada, sem nova tentativa). Eventos tratados:

  • calls[].event = connect: traz a resposta SDP, publicada no nó do chat (ligacao.sdp)
    para o navegador do atendente;
  • statuses[] com type: call: RINGING (chamando), ACCEPTED (atendida) e
    REJECTED (recusada); a SDP publicada fica no nó até a ligação acabar;
  • calls[].event = terminate: encerra a ligação (COMPLETED com duration = atendida;
    sem duração = não atendida; FAILED = falha) e grava o evento no chat.

A ligação é localizada pelo id da Meta ou, no connect que chega antes de o CV gravar
o id, pelo biz_opaque_callback_data. Ligação encerrada não muda mais: evento atrasado
ou repetido é ignorado. Cada evento é isolado; o que falha vai para o CVIO
(comunicador_webhook_ligacao) e a rota responde 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}.{url}.{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
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json