- 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
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 Instagramfb-ad-lead-whatsapp– quando o lead vem de um anúncio do Facebook
2. Detalhes do Anúncio Anexados à Mensagem
Junto com a mensagem do lead, anexamos os metadados do anúncio diretamente na mensagem de WhatsApp: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
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:
| Nome do campo | Tipo | Descrição | Exemplo |
|---|---|---|---|
source_app | Texto | Plataforma em que o anúncio foi veiculado | facebook, instagram |
source_url | Texto | URL do anúncio/publicação | https://www.instagram.com/p/DSYeWccjKJP/ |
source_id | Texto | ID único do anúncio na Meta | 120240271425200365 |
title | Texto | Título/manchete do anúncio | ¡Oportunidad Única! |
body | Texto (Grande) | Texto do corpo do anúncio | Texto completo do anúncio |
source_type | Texto | Tipo de origem | ad |
media_type | Texto | Formato da mídia | IMAGE, VIDEO |
ctwa_clid | Texto | ID de rastreamento de clique | Afe9mAvBPUVos1-QSGjl4h... |
greeting_message_body | Texto (Grande) | Mensagem de saudação automática | Hola, gracias por tu interés... |
Instruções de Configuração
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_idetitle - 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_appindica 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-whatsappOUinstagram-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
- Gatilho: Contato Criado
- Filtro: Campo Personalizado
titlecontémRetargeting - 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:
Mensagem da Conversa:
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
Isso funciona tanto para Facebook quanto para Instagram?
Isso funciona tanto para Facebook quanto para Instagram?
Sim. As tags os diferenciam:
fb-ad-lead-whatsapp→ Facebookinstagram-ad-lead-whatsapp→ Instagram
source_app também mostra facebook ou instagram.Isso funciona para Google Ads?
Isso funciona para Google Ads?
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.
Preciso criar todos os campos personalizados?
Preciso criar todos os campos personalizados?
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.E se eu criar os campos depois que os leads já chegaram?
E se eu criar os campos depois que os leads já chegaram?
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.
Posso desativar isso?
Posso desativar isso?
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.
Isso funciona para mensagens orgânicas?
Isso funciona para mensagens orgânicas?
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.
E se meu telefone estiver offline quando alguém clicar no meu anúncio?
E se meu telefone estiver offline quando alguém clicar no meu anúncio?
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.
Posso usar campos personalizados em listas inteligentes?
Posso usar campos personalizados em listas inteligentes?
Sim. Crie listas inteligentes filtrando por
source_app, title ou qualquer outro campo personalizado para segmentar leads de anúncios.Posso exportar contatos com esses campos?
Posso exportar contatos com esses campos?
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:- Suporte no WhatsApp: Conversar no WhatsApp
- Email: support@goghl.ai

