Pular para o conteúdo principal
  • Adiciona tags ao contato para que você identifique instantaneamente leads de anúncios
  • Salva os metadados do anúncio em campos personalizados do contato (somente Meta Ads)
  • Anexa todos os metadados disponíveis do anúncio à primeira mensagem de WhatsApp
Isso facilita ver qual anúncio gerou o lead, criar automações e atribuir receita às campanhas.

O Que É Adicionado?

1. Tags de Contato (Meta Ads)

Para leads de Meta Click-to-WhatsApp, adicionamos automaticamente:
  • instagram-ad-lead-whatsapp – quando o lead vem de um anúncio do Instagram
  • fb-ad-lead-whatsapp – quando o lead vem de um anúncio do Facebook
Use essas tags em listas inteligentes, workflows, pipelines e relatórios.

2. Detalhes do Anúncio Anexados à Mensagem

Junto com a mensagem do lead, anexamos os metadados do anúncio diretamente na mensagem de WhatsApp:
Hola, me interesa el tratamiento Plasma IQsourceApp: facebooksourceType: adsourceId: 1234567890campaignName: Plasma IQ Lead Gen – MXadSetName: Lookalike 1% – Women 25–45adName: Video Test 3 – Hook AmediaType: VIDEO...
Os campos exatos dependem do que a Meta/Google enviam. Encaminhamos tudo o que recebemos para que você não perca dados de atribuição.

Campos Personalizados (Meta Ads - Novo Recurso)

Quando um contato envia mensagem através de um anúncio da Meta, extraímos automaticamente os dados do anúncio e os salvamos como campos personalizados no contato. Isso permite rastrear qual anúncio, campanha e plataforma gerou cada lead diretamente no seu CRM.

Como Funciona

1
O contato clica em um anúncio da Meta → o WhatsApp abre → ele envia uma mensagem
2
A Meta anexa os metadados do anúncio a essa mensagem
3
Nosso sistema extrai os metadados e os salva em campos personalizados
4
Se um campo personalizado existir → ele é preenchido
5
Se não existir → é ignorado silenciosamente
Nenhuma configuração é necessária do nosso lado. Você só precisa criar os campos personalizados que quiser.

Campos Personalizados Disponíveis

Crie os campos em Configurações → Campos Personalizados → Adicionar Campo. A chave do campo deve corresponder exatamente:
Exemplo de configuração de campo personalizado
Nome do campoTipoDescriçãoExemplo
source_appTextoPlataforma em que o anúncio foi veiculadofacebook, instagram
source_urlTextoURL do anúncio/publicaçãohttps://www.instagram.com/p/DSYeWccjKJP/
source_idTextoID único do anúncio na Meta120240271425200365
titleTextoTítulo/manchete do anúncio¡Oportunidad Única!
bodyTexto (Grande)Texto do corpo do anúncioTexto completo do anúncio
source_typeTextoTipo de origemad
media_typeTextoFormato da mídiaIMAGE, VIDEO
ctwa_clidTextoID de rastreamento de cliqueAfe9mAvBPUVos1-QSGjl4h...
greeting_message_bodyTexto (Grande)Mensagem de saudação automáticaHola, gracias por tu interés...

Instruções de Configuração

1
Vá para Configurações → Campos Personalizados → Adicionar Campo
2
Crie os campos que desejar usando as chaves exatas acima
3
Escolha o tipo de campo apropriado (Texto ou Texto Grande)
4
Salve
Pronto. Na próxima vez que um contato enviar mensagem via anúncio da Meta, os campos serão preenchidos automaticamente.

Notas Importantes

  • Crie apenas os campos que você quiser. A maioria dos usuários só precisa de source_app, source_url, source_id e title
  • Os campos são atualizados a cada mensagem CTWA. Novos dados de anúncio sobrescrevem os valores anteriores
  • Funciona para Facebook e Instagram. O campo source_app indica qual plataforma
  • Sem impacto na funcionalidade existente. A anexação ao corpo da mensagem continua funcionando como antes

Como Usar Esses Dados em Workflows

Usando Tags

  • Gatilho: Tag de Contato Adicionada → fb-ad-lead-whatsapp OU instagram-ad-lead-whatsapp
  • Ações:
    • Criar Oportunidade em um pipeline específico
    • Atribuir a um representante de vendas
    • Enviar uma sequência de follow-up personalizada
    • Notificar a equipe via Slack/Email

Usando Campos Personalizados (Recomendado)

Exemplo 1: Rotear por plataforma
  • Gatilho: Contato Criado ou Atualizado
  • Filtro: Campo Personalizado source_app = instagram
  • Ações:
    • Atribuir ao especialista de Instagram
    • Enviar uma mensagem de boas-vindas específica para Instagram
    • Adicionar ao pipeline de leads do Instagram
Exemplo 2: Segmentação avançada
  • Gatilho: Contato Criado
  • Filtro: Campo Personalizado title contém Retargeting
  • Ações:
    • Enviar follow-up baseado em urgência
    • Adicionar ao pipeline de leads quentes
    • Agendar uma ligação imediata

Usando o Conteúdo da Mensagem

Analise os dados anexados à mensagem usando webhooks ou ferramentas de automação (n8n, Make, Zapier) para extrair os nomes de campanha/conjunto de anúncios/anúncio e fazer roteamento avançado.

Onde Ver Esses Dados

Campos Personalizados do Contato:
1
Vá para Contatos
2
Abra um contato vindo de um anúncio da Meta
3
Role até a seção Campos Personalizados
4
Veja os campos do anúncio preenchidos
Mensagem da Conversa:
1
Vá para Conversas
2
Abra uma conversa vinda de um anúncio
3
Veja a primeira mensagem
4
Confira os metadados anexados no final

Requisitos de Conexão

Para que as mensagens de Meta Ads sincronizem de forma confiável:
  • O telefone deve estar online com internet ativa
  • O app do WhatsApp deve estar em execução (pode estar em segundo plano)
  • Conexão estável recomendada (WiFi ou dados móveis confiáveis)
Se o seu telefone estiver offline, as mensagens podem atrasar ou não sincronizar. Use um dispositivo dedicado para o número da sua empresa para garantir sincronização 24/7.

Requisitos

  • Campanha da Meta ou do Google configurada como Click-to-WhatsApp
  • Número de WhatsApp conectado através da nossa plataforma
  • Para campos personalizados: crie os campos no CRM com as chaves correspondentes
  • Telefone online com conexão estável

Melhores Práticas

  • Nomeie as campanhas com clareza – Use nomes significativos (ex.: MX | Plasma IQ | IG Story | Warm) para facilitar a identificação
  • Crie os campos personalizados necessários – A maioria dos usuários só precisa de source_app, source_url, source_id, title
  • Construa workflows dedicados – Roteie leads do Facebook, Instagram e Google de formas diferentes
  • Use tags para organização – Combine tags de anúncios com tags internas (hot-lead, consult-booked)
  • Mantenha o telefone conectado – Internet estável garante a entrega de mensagens em tempo real

Perguntas Frequentes

Sim. As tags os diferenciam:
  • fb-ad-lead-whatsapp → Facebook
  • instagram-ad-lead-whatsapp → Instagram
O campo personalizado source_app também mostra facebook ou instagram.
Sim, para anúncios Google Click-to-WhatsApp. Os dados do anúncio são anexados ao corpo da mensagem.
Nota: Os campos personalizados estão disponíveis atualmente apenas para Meta Ads. Os dados do Google aparecem somente no corpo da mensagem.
Não. Crie apenas os campos que você quiser. Os mais comuns são source_app, source_url, source_id e title. Os campos que você não criar são ignorados.
Os campos personalizados são preenchidos apenas em novas mensagens. Contatos existentes não serão atualizados retroativamente. Se eles clicarem em um novo anúncio e enviarem mensagem novamente, os campos serão preenchidos nesse momento.
A adição de tags e a anexação à mensagem estão sempre ativas para preservar os dados de atribuição. Os campos personalizados são opcionais - não os crie se não quiser usá-los.
Não. Tags, campos personalizados e detalhes de anúncio só se aplicam a anúncios Click-to-WhatsApp da Meta/Google. Mensagens orgânicas não são afetadas.
O WhatsApp coloca a mensagem na fila e a entrega quando o seu telefone estiver online. No entanto, a sincronização com o CRM pode atrasar. Mantenha seu telefone conectado para entrega em tempo real.
Sim. Crie listas inteligentes filtrando por source_app, title ou qualquer outro campo personalizado para segmentar leads de anúncios.
Sim. Os campos personalizados são exportados junto com os demais dados do contato.

Suporte

Se você precisar de ajuda com a configuração ou o onboarding: