What's new, 21 October 2026: A customer who sends several messages before the bot's first reply no longer gets the opening sequence of a Chat Flow twice
WASync · Developers

Campanha e conjunto de anúncios nas conversas vindas de anúncios

Dê ao WASync um token do Meta Ads e toda conversa que começa em um anúncio Click-to-WhatsApp leva a campanha, o conjunto de anúncios e o anúncio nos campos UTM do lead ou do negócio, com os nomes na linha do tempo.

Quando um cliente escreve para você a partir de um anúncio Click-to-WhatsApp, o WhatsApp informa ao WASync qual foi o anúncio, e nada mais. O WASync grava isso no lead ou no negócio: UTM_SOURCE = facebook, UTM_MEDIUM = ctwa, o id do anúncio em UTM Campaign e o id do clique em UTM Content, além dos campos UF_CRM_CTWA_*.

Para gerar relatórios por campanha e por conjunto de anúncios, você precisa dos dois ids que o Meta não envia junto com a mensagem. O WASync pode consultá-los na sua conta de anúncios se você fornecer um token do seu próprio Business Manager. Com o token configurado, os campos UTM seguem a convenção do próprio Meta:

CampoValor
UTM Campaignid da campanha
UTM Termid do conjunto de anúncios
UTM Contentid do anúncio

O id do clique continua em UF_CRM_CTWA_CLID, e a nota na linha do tempo do registro mostra os nomes: Campanha: «Préstamos octubre» (1202…), Conjunto de anúncios: «Profes» (1202…), Anúncio: «FACSIS IA» 1202….

1. Crie um token de usuário do sistema com ads_read

Em Meta Business Suite → Configurações do negócio:

  1. Usuários → Usuários do sistema → Adicionar. Dê um nome, por exemplo, Wasync attribution (o Meta recusa nomes com várias letras maiúsculas); a função Funcionário é suficiente.
  2. Abra o usuário do sistema → Atribuir ativos → Contas de anúncios → marque a conta de anúncios que veicula seus anúncios Click-to-WhatsApp → conceda a permissão Ver desempenho (leitura é suficiente).
  3. Gerar token → o Meta pede um app do seu próprio portfólio e lista apenas as permissões que esse app tem. Você precisa de um app com o produto Marketing API: escolha um que você já tenha ou crie um uma única vez em developers.facebook.com (Criar app → tipo Empresa → Adicionar produto → Marketing API). Depois defina a expiração como Nunca, marque somente ads_read e copie o token. O Meta o mostra uma única vez.

2. Cole o token no WASync

Abra o app WASync no Bitrix24 → Configurações → o cartão Campanha e conjunto de anúncios nas conversas vindas de anúncios. Cole o token e clique em Salvar token. O WASync o armazena criptografado e nunca mais o exibe.

Para testar, cole o id numérico de um dos seus anúncios (no Gerenciador de Anúncios, na coluna ID do anúncio) e clique em Testar: o cartão mostra a campanha, o conjunto de anúncios e o anúncio que o WASync gravaria.

Salve o token uma vez; Testar mostra o que uma conversa desse anúncio levaria.

O que muda e o que não muda

  • Somente as novas conversas vindas de anúncios recebem os três ids; os registros atribuídos antes do token mantêm o que já têm.
  • Um registro que já tem um UTM Source de outro canal nunca é sobrescrito; os campos UF_CRM_CTWA_* são sempre gravados.
  • Cada anúncio é consultado uma vez e lembrado por um dia, então uma campanha com milhares de conversas custa uma única requisição ao Meta.
  • Se o Meta recusar a consulta (token expirado, anúncio de outra conta de anúncios), a conversa é atribuída como antes, apenas com o id do anúncio, e nada mais deixa de funcionar.
  • Remova o token a qualquer momento com Remover token; o WASync volta a gravar apenas o id do anúncio.

Relacionado: Registros do CRM e linha do tempo.

Esta página foi útil?

On this page