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

# Entendendo as Tags de Contato do WhatsApp

## Resumo[​](#resumo "Link direto para o Resumo")

**Tags Adicionadas Automaticamente pelo Sistema:**

| Tag                               | Quando é Adicionada            | Propósito                                                    |
| --------------------------------- | ------------------------------ | ------------------------------------------------------------ |
| `wa: +1234567890`                 | Cada mensagem                  | Roteia mensagens através de um número específico de WhatsApp |
| `inbound whatsapp`                | Primeira mensagem recebida     | Identifica contatos que iniciaram a conversa                 |
| `fb-ad-lead-whatsapp`             | Clique em anúncio do Facebook  | Rastreia a atribuição de anúncios do Facebook                |
| `instagram-ad-lead-whatsapp`      | Clique em anúncio do Instagram | Rastreia a atribuição de anúncios do Instagram               |
| `another-device-replied-whatsapp` | Resposta de outro dispositivo  | Rastreia o uso de múltiplos dispositivos                     |
| `whatsapp group`                  | Membro de grupo                | Identifica contatos de grupos                                |

**Pontos-Chave:**

* As tags são adicionadas automaticamente - nenhum trabalho manual é necessário
* As tags de número de WhatsApp garantem a continuidade da conversa
* As tags de origem permitem um poderoso rastreamento de atribuição
* Use tags para segmentação e campanhas direcionadas
* O sistema mantém as tags limpas e precisas automaticamente

# Entendendo as Tags de Contato do WhatsApp

## Visão Geral[​](#visão-geral "Link direto para a Visão Geral")

Nossa integração de WhatsApp gerencia automaticamente as tags de contato no seu CRM para rastrear origens de mensagens, associações de números de WhatsApp e interações de usuários. Este documento explica quais tags são adicionadas, quando são adicionadas e por que são importantes para o seu negócio.

## Categorias de Tags[​](#categorias-de-tags "Link direto para as Categorias de Tags")

### 1. Tags de Associação de Número de WhatsApp[​](#1-tags-de-associação-de-número-de-whatsapp "Link direto para 1. Tags de Associação de Número de WhatsApp")

**Formato:** `wa: +1234567890`

**Propósito:** Rastrear qual número de telefone de WhatsApp está associado a cada contato para um roteamento inteligente de mensagens.

**Quando é Adicionada:**

* Quando um contato envia a primeira mensagem para o seu número de WhatsApp (durante a criação do contato a partir de mensagens recebidas)
* Quando você envia uma mensagem para um contato a partir de um número de WhatsApp específico
* Quando a substituição manual é usada (padrão `{WA#N}`) para trocar qual número usar para um contato
* Quando você envia uma mensagem diretamente ao contato pelo seu telefone.

**Como Funciona:**

* **Limpeza Automática:** As tags antigas de número de WhatsApp são removidas automaticamente quando você usa um número diferente
* **Tag Ativa Única:** Apenas uma tag de número de WhatsApp existe por contato a qualquer momento
* **Roteamento Inteligente:** As mensagens futuras para esse contato usarão automaticamente o número marcado na tag

**Exemplo:**

```text theme={null}
Contact initially has: "wa: +12125551234"You send a message from: +19175559999 (via phone)Contact now has: "wa: +19175559999" (old tag automatically removed)
```

**Por Que Isso Importa:**

* Mantém a continuidade da conversa com o mesmo número
* Evita confusão para os seus contatos
* Garante uma identidade de remetente consistente
* Permite o roteamento inteligente de mensagens enviadas

***

### 2. Tags de Origem da Mensagem[​](#2-tags-de-origem-da-mensagem "Link direto para 2. Tags de Origem da Mensagem")

#### 2.1 Tag de WhatsApp Recebido[​](#21-tag-de-whatsapp-recebido "Link direto para 2.1 Tag de WhatsApp Recebido")

**Tag:** `inbound whatsapp`

**Propósito:** Identificar contatos que iniciaram a conversa enviando uma mensagem para você primeiro.

**Quando é Adicionada:**

* Aplicada automaticamente quando um novo contato envia a primeira mensagem de WhatsApp para você
* Adicionada apenas uma vez, quando o contato é criado

**Por Que Isso Importa:**

* **Segmentação:** Filtre facilmente contatos que entraram em contato com você vs. aqueles que você contatou primeiro
* **Qualidade do Lead:** Contatos que iniciam a conversa geralmente indicam maior intenção e engajamento
* **Automação:** Dispare workflows específicos para contatos de entrada vs. de saída

***

#### 2.2 Tags de Origem Click-to-WhatsApp (CTWA)[​](#22-tags-de-origem-click-to-whatsapp-ctwa "Link direto para 2.2 Tags de Origem Click-to-WhatsApp (CTWA)")

**Tags:**

* `fb-ad-lead-whatsapp` - O contato veio de Anúncios do Facebook
* `instagram-ad-lead-whatsapp` - O contato veio de Anúncios do Instagram

**Propósito:** Rastrear qual plataforma de anúncios gerou a conversa de WhatsApp.

**Quando é Adicionada:**

* Detectada automaticamente quando alguém clica no seu anúncio do Facebook ou Instagram e inicia uma conversa de WhatsApp
* Aplicada quando o contato é criado ou envia a primeira mensagem

**Por Que Isso Importa:**

* **Atribuição:** Saiba exatamente qual campanha de anúncios gerou cada lead
* **Rastreamento de ROI:** Meça o retorno sobre o investimento por plataforma de anúncios
* **Otimização de Orçamento:** Identifique qual plataforma gera melhor engajamento
* **Análise de Campanhas:** Compare o desempenho do Facebook vs. Instagram
* **Retargeting:** Crie públicos personalizados com base na origem do anúncio

**Exemplo de Contexto do Anúncio:**

Quando alguém clica no seu anúncio, pode ver estas informações no anúncio:

```text theme={null}
Ad Title: "Start Your US Company From Anywhere"Description: "Register in Hours with Legal LLC!"Platform: Facebook
```

Essas informações ajudam você a entender qual mensagem ressoou com o contato.

***

### 3. Tags de Interação[​](#3-tags-de-interação "Link direto para 3. Tags de Interação")

#### 3.1 Tag de Resposta de Outro Dispositivo[​](#31-tag-de-resposta-de-outro-dispositivo "Link direto para 3.1 Tag de Resposta de Outro Dispositivo")

**Tag:** `another-device-replied-whatsapp`

**Propósito:** Rastrear quando você ou sua equipe responde a um contato a partir de um dispositivo diferente do seu CRM (como o app móvel do WhatsApp ou o WhatsApp Web).

**Quando é Adicionada:**

* Aplicada automaticamente quando uma mensagem é enviada de outro dispositivo do WhatsApp
* Adicionada cada vez que uma resposta é enviada fora do CRM

**Por Que Isso Importa:**

* **Parar o Bot de IA:** Interrompe as respostas automáticas do bot de IA durante a intervenção manual
* **Rastreamento Multicanal:** Entenda quando os membros da equipe usam o WhatsApp diretamente

**Cenários de Exemplo:**

* Um representante de vendas responde com urgência pelo próprio telefone
* Um membro da equipe de suporte trata uma escalação pelo WhatsApp Web
* Resposta de emergência fora do horário comercial pelo dispositivo móvel

***

### 4. Tags Relacionadas a Grupos[​](#4-tags-relacionadas-a-grupos "Link direto para 4. Tags Relacionadas a Grupos")

#### 4.1 Tag de Grupo de WhatsApp[​](#41-tag-de-grupo-de-whatsapp "Link direto para 4.1 Tag de Grupo de WhatsApp")

**Tag:** `whatsapp group`

**Propósito:** Identificar contatos que são usados como proxy para Grupos de WhatsApp. Esses contatos conteriam a conversa do Grupo.

**Quando é Adicionada:**

* Quando você adiciona um grupo de WhatsApp aos seus grupos permitidos

**Por Que Isso Importa:**

* **Segmentação:** Separe membros de grupos de contatos individuais
* **Conformidade:** Garanta que as mensagens de grupo sigam as regulamentações
* **Direcionamento:** Crie campanhas específicas para grupos ou exclua grupos de transmissões

***

## Uso de Tags no Roteamento de Mensagens[​](#uso-de-tags-no-roteamento-de-mensagens "Link direto para o Uso de Tags no Roteamento de Mensagens")

### Como as Tags Controlam o Roteamento de Mensagens[​](#como-as-tags-controlam-o-roteamento-de-mensagens "Link direto para Como as Tags Controlam o Roteamento de Mensagens")

As tags desempenham um papel crucial em determinar qual número de WhatsApp envia mensagens aos seus contatos:

**Roteamento por Tag de Contato (Prioridade 2 no nosso sistema de roteamento):**

Quando um contato tem uma tag de número de WhatsApp (`wa: +1234567890`), o sistema:

* Sempre usará esse número de WhatsApp específico para mensagens enviadas
* Manterá a continuidade da conversa
* Garantirá uma identidade de remetente consistente
* Mostrará um erro se esse número estiver desconectado

**Benefícios:**

* **Continuidade da Conversa:** Os contatos sempre veem o mesmo número respondendo a eles
* **Construção de Relacionamento:** Uma identidade consistente gera confiança
* **Controle Manual:** Você pode substituir manualmente qual número usar
* **Roteamento Previsível:** Saiba exatamente qual número será usado

**Tratamento de Erros:**

Se o número da tag não estiver conectado, você verá:

```text theme={null}
Error 104: Whatsapp number +12125551234 is not connected.Either connect the number or remove the tag "wa:+12125551234" from the contact!
```

***

## Análises e Relatórios de Tags[​](#análises-e-relatórios-de-tags "Link direto para Análises e Relatórios de Tags")

### Segmentos e Relatórios Úteis[​](#segmentos-e-relatórios-úteis "Link direto para Segmentos e Relatórios Úteis")

**Rastrear o Desempenho de Campanhas de Anúncios:**

Crie um segmento com a tag `fb-ad-lead-whatsapp` para:

* Calcular a taxa de conversão dos anúncios do Facebook
* Medir a atribuição de receita por plataforma
* Comparar o desempenho dos criativos dos anúncios
* Otimizar o investimento em anúncios com base nos resultados

**Medir o Engajamento de Entrada:**

Crie um segmento com a tag `Inbound Whatsapp` para:

* Rastrear o tempo de primeira resposta para leads de entrada
* Medir a qualidade e a duração das conversas
* Calcular a taxa de conversão de leads de entrada
* Identificar as fontes de entrada com melhor desempenho

**Monitorar o Uso de Múltiplos Dispositivos:**

Crie um segmento com a tag `another-device-replied-whatsapp` para:

* Calcular a taxa de intervenção manual
* Identificar contatos que exigem atenção pessoal
* Rastrear os padrões de resposta dos membros da equipe
* Medir a eficácia da automação

**Insights de Mensagens de Grupo:**

Crie um segmento com a tag `whatsapp group` para:

* Rastrear métricas de engajamento do grupo
* Analisar o desempenho de grupos vs. individual
* Otimizar a estratégia de comunicação de grupos

***

## 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%20Understanding%20WhatsApp%20Contact%20Tags.)
* Email: [**support@goghl.ai**](mailto:support@goghl.ai)
