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 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. Ler os dados pela API exige um token de API, que só o plano Enterprise pode criar:

GET /api/v1/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

Os webhooks de saída do Deskwoot (Configurações > Webhooks) não incluem os dados do anúncio. Eventos como Conversa atualizada ou Conversa resolvida trazem o ID da conversa. Use esse ID para ler a conversa pela API, como mostrado acima, e depois envie customAttributes.whatsappReferral (ID do clique e 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.
• O cartão do anúncio nos detalhes da conversa faz parte do plano Business ou superior. Ler os dados pela API exige o plano Enterprise.

Perguntas frequentes