# Como funcionam identificadores de entrada

Identificadores de entrada são formas de entender a aquisição do seu público na plataforma de WhatsApp. Atualmente existem diversas possibilidades através de links customizados, campanhas e API, como mostrado abaixo.

# Atendimentos Receptivos Orgânicos

Para atendimentos receptivos orgânicos é possível montar identificadores de entrada, como explicado abaixo. As formas podem ser trabalhadas de forma individual ou combinada.

Para visualizar relatórios após o uso de identificadores, consulte [este artigo](https://docs.convert.app.br/doc/kpis-EUKdkhheth#h-atendimentos-por-identificador-de-entrada).

## **Cabeçalho**

* **Descrição:** Os cabeçalhos são as propriedades que vem quando há um anúncio click-to-whatsapp na Meta. Oficialmente eles não são suportados, mas através de uma engenharia reversa, conseguimos entender como eles funcionam e utilizar.
* **🟢 Prós:**
  * Mais difícil do cliente apagar
  * Mais discreto
  * Utiliza módulo de identificadores de entrada
* **🔴 Contras:**
  * Não suportados no App Desktop
  * Não tem suporte oficial da Meta, então podem parar de funcionar
  * Precisam estar bem configurados para funcionar
* **Exemplos:**
  * Link
    * <https://api.whatsapp.com/send/?phone=555421037000&text=&type=phone_number&app_absent=0&source_url=%23site_organico&context=%23site_organico&icebreaker=>
    * Imagem no WhatsApp (não fica muito bonito, mas pelo menos não ocupa o espaço da mensagem)

 ![](https://s3.us-east-2.amazonaws.com/convert-company-outline/uploads/7afba0e4-20f3-42be-87cd-11b427ca64bd/b0d308e1-83f7-47c1-a679-d299d0ba60e2/image.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIAWNEQDAE74GWO55AJ%2F20260922%2Fus-east-2%2Fs3%2Faws4_request&X-Amz-Date=20260922T151500Z&X-Amz-Expires=86400&X-Amz-Signature=24249c45687fd61a87365e8ac91b14fb5f5028f51c12c7ac3dd344c29f0cc81f&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject " =556x165")

## Mensagem inicial iniciada com #

* **Descrição:** O texto é o jeito mais simples de fazer, basicamente você gera um texto e o Omni entende que mensagens iniciadas com aquele texto vão gerar identificador de entrada.
* **Como o Omni entende:** O Omni entende como identificador sempre que a mensagem inicial começar com # até o primeiro espaço, e o identificador não precisa ser previamente criado.
* **🟢 Prós:**
  * Suporte universal, contanto que o cliente não apague, vai funcionar
  * É um parâmetro documentado e mantido pela Meta
* **🔴 Contras:**
  * Muita chance de cliente apagar
  * Aparece na mensagem, podendo causar confusão
* **Exemplos:**
  * **👍 Válidos**
    * #SITE Olá, vim pelo site e quero saber sobre
    * #ANUNCIO_123 Olá, vim do anúncio e quero saber sobre
  * **👎 Inválidos**
    * SITE Olá vim pelo site e quero saber mais
    * #CAMPANHA DE MARKETING - Quero saber mais *(n*este caso até é válido, mas o identificador será apenas CAMPANHA)
* **Exemplos:**
  * Link
    * <https://api.whatsapp.com/send/?phone=555421037000&text=%23site_anuncio%20-%20Ol%C3%A1%2C%20queria%20saber%20mais&type=phone_number&app_absent=0&source_url=site&context=site&icebreaker=%23site_anuncio%20-%20Ol%C3%A1%2C%20queria%20saber%20mais>
    * Imagem no WhatsApp
    * ![](https://s3.us-east-2.amazonaws.com/convert-company-outline/uploads/7afba0e4-20f3-42be-87cd-11b427ca64bd/91445f90-bdaf-4e22-8ac4-7d9033a3d99f/image.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIAWNEQDAE74GWO55AJ%2F20260922%2Fus-east-2%2Fs3%2Faws4_request&X-Amz-Date=20260922T151500Z&X-Amz-Expires=86400&X-Amz-Signature=13a6e73166397573b27cc0f9fb9dd653911f14bca106cfe2792d81e9d3288f25&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject " =686x163")

## Combinação Entre Cabeçalho e #

* **Descrição:** Essa possibilidade nada mais é do que gerar um link customizado contendo tanto um cabeçalho quanto uma mensagem, servindo como um fallback caso o cliente remova a mensagem ou o cabeçalho ou até mesmo se o cabeçalho não for suportado.
* **🟢 Prós:**
  * Tem o suporte de ambos
* **🔴 Contras:**
  * Cuidado para que o identificador seja o mesmo e esteja url encodado, pois se não não vai agrupar nos relatórios.
* **Exemplos:**
  * Link
  * Imagem no WhatsApp

## Suporte por Plataforma

Atualização em 08/01/26

| Plataforma | SomenteCabeçalho | SomenteMensagem | Cabeçalho +Mensagem |
|:----------:|:----------------:|:---------------:|:-------------------:|
| Desktop App | 🔴               | 🟢              | 🟡 (só msg)         |
| Andoid App | 🔴               | 🟢              | 🟡 (só msg)         |
| iOS App    | 🔴               | 🟢              | 🟡 (só msg)         |
| WhatsApp Web | 🟢               | 🟢              | 🟢                  |


:::warning
A tabela abaixo não é mais válida, a partir de testes em 08/01/26.

:::

| ~~Plataforma~~ | ~~Somente~~~~Cabeçalho~~ | ~~Somente~~~~Mensagem~~ | ~~Cabeçalho +~~~~Mensagem~~ |
|:----------:|:----------------:|:---------------:|:-------------------:|
| ~~Desktop App~~ | ~~🔴~~           | ~~🟢~~          | ~~🟢~~              |
| ~~Andoid App~~ | ~~🟢~~           | ~~🟢~~          | ~~🟢~~              |
| ~~iOS App~~ | ~~🟢~~           | ~~🟢~~          | ~~🟢~~              |
| ~~WhatsApp Web~~ | ~~🟢~~           | ~~🟢~~          | ~~🟢~~              |

Pelo que percebeu-se em meus testes em 10/10/25, o Desktop não recebe em nenhuma situação os cabeçalhos, não importa como o link seja montado, por isso um fallback bom é criar o link com o mesmo cabeçalho e mensagem inicial.

## Parâmetros

Os parâmetros disponíveis no link são:

* phone
  * Número de telefone no padrão internacional, sem +.
  * Ex: 555421037000
* text
  * Texto para popular a mensagem quando abrir o whatsapp (Deve ser [URL Encoded](https://www.urlencoder.org/))
  * Ex: %23SITE%20Ol%C3%A1%2C%20quero%20saber%20mais%20sobre%20X
* type
  * Não sei o que faz, mas convém mandar com o tipo phone
  * Ex: phone
* app_absent
  * É o link que renderiza a tela caso a pessoa não tenha o app 0 ou 1
  * Ex: 0
* source_url
  * É o link do “anúncio”, na verdade é o identificador em si (Deve ser [URL Encoded](https://www.urlencoder.org/))
  * Ex: %23site_organico
* context
  * Parece ter o mesmo comportamento do source_url, porém para funcionar no mobile é necessário. É o link do “anúncio”, na verdade é o identificador em si (Deve ser [URL Encoded](https://www.urlencoder.org/))
  * Ex: %23site_organico
* icebreaker
  * Texto para popular a mensagem quando abrir o whatsapp (Deve ser [URL Encoded](https://www.urlencoder.org/))
  * Ex: %23SITE%20Ol%C3%A1%2C%20quero%20saber%20mais%20sobre%20X

## Link Montado

O link montado através dos parâmetros deve ficar parecido com o exemplo abaixo (claro que tudo em uma linha só, ali foi só quebrado para facilitar a visualização)


:::warning
**Importante:**

* Os caracteres especiais devem ser url encodados
* O número deve ser no formato 555421037000 (sem +)

:::

**Exemplo:**

```ini
https://api.whatsapp.com/send/?
  phone=555421037000&
  text=%23site_organico%20-%20Ol%C3%A1%2C%20queria%20saber%20mais&
  type=phone_number&
  app_absent=0&
  source_url=%23site_organico&
  context=%23site_organico&
  icebreaker=%23site_organico%20-%20Ol%C3%A1%2C%20queria%20saber%20mais
```

# Atendimentos Receptivos com Anúncio


:::warning
TODO: Ainda será montado na documentação

:::

# Atendimentos Ativos


:::warning
TODO: Ainda será montado na documentação

:::

---

**Documents**

- [Manuais de produtos](https://docs.convert.app.br/s/7287dde1-b04f-4cad-9d2b-72f5c721e7d1/doc/manuais-de-produtos-9Zwzl1ufq8)
- [Treinamentos em vídeo](https://docs.convert.app.br/s/7287dde1-b04f-4cad-9d2b-72f5c721e7d1/doc/treinamentos-em-video-RtQVBvFmgW)
- [Versões de produtos](https://docs.convert.app.br/s/7287dde1-b04f-4cad-9d2b-72f5c721e7d1/doc/versoes-de-produtos-TH4Y8GFXxO)