> ## Documentation Index
> Fetch the complete documentation index at: https://help.goghl.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Tags e Detalhes de Anúncios Meta e Google

> Quando alguém clica em um  ou em um  e envia uma mensagem para você, o GoGHL automaticamente:

* **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:

```text theme={null}
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

<Steps>
  <Step>
    O contato clica em um anúncio da Meta → o WhatsApp abre → ele envia uma mensagem
  </Step>

  <Step>
    A Meta anexa os metadados do anúncio a essa mensagem
  </Step>

  <Step>
    Nosso sistema extrai os metadados e os salva em campos personalizados
  </Step>

  <Step>
    Se um campo personalizado existir → ele é preenchido
  </Step>

  <Step>
    Se não existir → é ignorado silenciosamente
  </Step>
</Steps>

> 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:

<Frame>
  <img src="https://mintcdn.com/goghl/JZJa2MoUHOf9Nw9w/images/features/assets/images/Field-name-4f2bacd9e86fc39fa7868ef972a50256.png?fit=max&auto=format&n=JZJa2MoUHOf9Nw9w&q=85&s=77e0777f4544371660e269954601e255" alt="Exemplo de configuração de campo personalizado" width="2880" height="1622" data-path="images/features/assets/images/Field-name-4f2bacd9e86fc39fa7868ef972a50256.png" />
</Frame>

| 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

<Steps>
  <Step>
    Vá para **Configurações → Campos Personalizados → Adicionar Campo**
  </Step>

  <Step>
    Crie os campos que desejar usando as chaves exatas acima
  </Step>

  <Step>
    Escolha o tipo de campo apropriado (**Texto** ou **Texto Grande**)
  </Step>

  <Step>
    Salve
  </Step>
</Steps>

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:**

<Steps>
  <Step>
    Vá para **Contatos**
  </Step>

  <Step>
    Abra um contato vindo de um anúncio da Meta
  </Step>

  <Step>
    Role até a seção **Campos Personalizados**
  </Step>

  <Step>
    Veja os campos do anúncio preenchidos
  </Step>
</Steps>

**Mensagem da Conversa:**

<Steps>
  <Step>
    Vá para **Conversas**
  </Step>

  <Step>
    Abra uma conversa vinda de um anúncio
  </Step>

  <Step>
    Veja a primeira mensagem
  </Step>

  <Step>
    Confira os metadados anexados no final
  </Step>
</Steps>

***

## 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

<AccordionGroup>
  <Accordion title="Isso funciona tanto para Facebook quanto para Instagram?">
    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`.
  </Accordion>

  <Accordion title="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.
  </Accordion>

  <Accordion title="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.
  </Accordion>

  <Accordion title="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.
  </Accordion>

  <Accordion title="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.
  </Accordion>

  <Accordion title="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.
  </Accordion>

  <Accordion title="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.
  </Accordion>

  <Accordion title="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.
  </Accordion>

  <Accordion title="Posso exportar contatos com esses campos?">
    Sim. Os campos personalizados são exportados junto com os demais dados do contato.
  </Accordion>
</AccordionGroup>

***

## Suporte[​](#suporte "Link direto para o Suporte")

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

* Suporte no WhatsApp: [Conversar no WhatsApp](https://wa.me/+12267248710?text=Hi%2C%20I%20need%20help%20with%20Meta%20and%20Google%20Ad%20Tags%20%26%20Details.)
* Email: [**support@goghl.ai**](mailto:support@goghl.ai)