Saiba qual anúncio do Facebook ou Instagram gerou uma conversa no WhatsApp

Saber qual anúncio do Facebook ou Instagram gerou uma conversa no WhatsApp é automático no Deskwoot: cada anúncio de Clique para WhatsApp envia os dados de referência da Meta para a sua caixa de entrada junto com a primeira mensagem, e o Deskwoot salva todo o contexto do anúncio na conversa, no contato e pela API.

O que é capturado

Toda vez que um visitante clica em um anúncio de Clique para WhatsApp e envia a primeira mensagem, a Meta anexa um objeto referral ao webhook de entrada. Nós salvamos tudo na conversa:

Tipo de origem. Ou ad ou post, dependendo de o clique ter vindo de um anúncio pago ou de um botão "Enviar mensagem" em uma publicação do Facebook ou Instagram.
ID do anúncio ou da publicação. O objeto da Meta que gerou o clique, útil para agrupar conversas por anúncio nos seus relatórios.
ID do clique (ctwa_clid). O identificador de cada clique que você pode comparar com os relatórios do Meta Ads e devolver à API de Conversões.
Título e corpo. O texto exato do anúncio que o visitante viu no momento do clique.
URL de origem. Um link direto de volta para o anúncio ou a publicação no Facebook.
Tipo de mídia mais URL da imagem ou do vídeo. A criação que o visitante estava vendo quando clicou.

Onde encontrar isso no Deskwoot

Abra qualquer conversa do WhatsApp. O painel de informações à direita mostra um cartão verde Veio de um anúncio do WhatsApp sempre que a conversa começou a partir de um anúncio de Clique para WhatsApp. Se a mesma pessoa clicar em outro anúncio enquanto a conversa ainda estiver aberta, a nova atribuição substitui o cartão visível e a anterior fica preservada em conversation.customAttributes.whatsappReferralHistory.

A referência mais recente também é espelhada no contato em customAttributes.lastWhatsappReferral, então a atribuição permanece disponível para qualquer conversa futura da mesma pessoa.

Como obter os dados pela API

Os dados são expostos nos endpoints padrão de conversa e de contato em customAttributes:

GET /api/v1/accounts/<accountId>/conversations/<id>
{
  "id": "...",
  "customAttributes": {
    "whatsappReferral": {
      "sourceUrl": "https://fb.me/2abc123def",
      "sourceId": "120203456789012345",
      "sourceType": "ad",
      "headline": "Patch Video Ad",
      "body": "Get our new patch with 30% off this week",
      "ctwaClid": "AAabcdEFGHijklMNOPqrstUVWxyz1234567890",
      "capturedAt": "2026-05-01T19:39:41Z"
    }
  }
}

Como enviar os dados para o seu CRM ou plataforma de anúncios

Configure uma assinatura de webhook em Configurações, Webhooks, Novo, e escolha o evento conversation.created. Agora cada payload carrega o mesmo formato customAttributes.whatsappReferral, então você pode enviar o ID do clique e o ID do anúncio para o HubSpot, o Pipedrive, o Notion, o Google Sheets, ou de volta para a API de Conversões da Meta para otimização de ciclo fechado.

Limites que você precisa conhecer

A Meta só anexa o objeto referral à primeira mensagem de uma sessão originada por anúncio. Nós o capturamos na primeira mensagem e o mantemos. As mensagens seguintes da mesma conversa não o carregam.
Conversas que não começaram a partir de um anúncio (chats orgânicos, respostas manuais, cliques em links não ligados a um anúncio) não mostram o cartão. Esse é o comportamento correto, já que não há nada a atribuir.
O recurso exige o canal WhatsApp Cloud API. O WhatsApp via Twilio não expõe o mesmo payload.