# Como transferir parâmetros e tags UTM

{% hint style="info" %}
Plataformas como Instagram, Facebook, WhatsApp e Telegram implementam esse mecanismo por meio do `visit_key` parâmetro.
{% endhint %}

**Suporte a deep link**\
A maioria dos mensageiros (como Instagram, Facebook, Telegram) oferece suporte a deep links. No entanto, outros não.

**Alternativa para o WhatsApp**\
Embora o WhatsApp não ofereça deep linking nativo, você ainda pode passar parâmetros e tags UTM. Para isso, insira uma variável especial no texto da mensagem pré-preenchida que aparece para o usuário depois que ele clica no seu link. (Este método será abordado em detalhes mais adiante.)

**Armazenamento de parâmetros**\
Todos os parâmetros passados são salvos como variáveis do cliente dentro do sistema.

**Estrutura e tipos de parâmetros**\
Um parâmetro é um **par nome-valor**. Dependendo da origem, os parâmetros podem ser:

* **Estáticos:** Você define o valor exato a ser transmitido.
  * **Exemplo:** `utm_term=webinar1` (onde `utm_term` é o nome e `webinar1` é o valor estático).
* **Dinâmicos:** A plataforma de anúncios (por exemplo, Google Ads, Facebook Ads) insere automaticamente os dados relevantes no momento do clique.
  * **Exemplo:** `term={palavra-chave}` — aqui, o `{palavra-chave}` espaço reservado é substituído dinamicamente pelo termo de pesquisa real que acionou o anúncio.

#### Como usar esses parâmetros em um site

Todos os parâmetros enviados ao seu site serão convertidos em variáveis de negócio assim que o cliente iniciar o bot. Isso inclui tags UTM e outros rótulos.

**Para obter o link do seu site**, vá para a seção **"Sites"** seção.

<div data-with-frame="true"><figure><img src="/files/f5eef3331328b0ed3c05df98b4b5356f98671cfc" alt="" width="563"><figcaption></figcaption></figure></div>

Exemplo de adição de tags UTM a um link de site:

`https://mavibot.ai/st/black_friday_mavibot?utm_source=test_wi_me&utm_medium=cpc&utm_campaign=id_campaign&utm_content=registration`

Os parâmetros e rótulos serão enviados ao bot e salvos como variáveis do cliente.

<div data-with-frame="true"><figure><img src="/files/42ae9187709fd393d0ee3ff4ef538d2648c5bea4" alt=""><figcaption></figcaption></figure></div>

#### Como usar esses parâmetros sem um site

Você pode usar **links proxy** para passar parâmetros diretamente. Assim que o bot for iniciado por meio de tal link, todos os dados transmitidos serão salvos como variáveis de negócio.

**O formato do link com parâmetros deve ser o seguinte:**

**Estrutura do link proxy**

Um link proxy parametrizado consiste em duas partes:

1. **URL base** (o próprio link proxy): `https://mavibot.ai/r/mavibot_1`
2. **String de consulta** (seus parâmetros): `?param1=value1&param2=value2`

**Exemplo: adicionando tags UTM a um link do Telegram**

Aqui está um exemplo de um link direto de um site para o Telegram com parâmetros UTM:

<https://mavibot.ai/r/mavibot_1?utm_medium=cpc&utm_source=yandex&utm_term=key_phrase&utm_content=HappyNY#ancor>

<div data-with-frame="true"><figure><img src="/files/77e91d3e021abe33b901bb6e77d7c25af8717c2e" alt=""><figcaption></figcaption></figure></div>

<div data-with-frame="true"><figure><img src="/files/d2578e3c62409d9166e08b114413f4807da14bc4" alt=""><figcaption></figcaption></figure></div>

**Links diretos de mensageiros em "Sites"**

Esta seção exibe links clicáveis para todos os mensageiros integrados ao seu sistema.

## Recursos do WhatsApp

Como o WhatsApp não oferece suporte a deep links, você deve adicionar uma variável especial à mensagem de abertura do bot. O bot usará essa variável para identificar os parâmetros com os quais o WhatsApp foi iniciado.

**A variável: `#{visit_key}`**

Quando um usuário clica no seu link do WhatsApp, esse espaço reservado será substituído automaticamente por um código numérico único contendo os parâmetros enviados.

<div data-with-frame="true"><figure><img src="/files/5b5403665c450303e730974c23ab2e6431d9fe42" alt=""><figcaption></figcaption></figure></div>

"Sites" → Site → Configurações da página do site → Mensageiros → Configurações do WhatsApp

Quando um usuário acessa o WhatsApp a partir do seu site (ou por meio de um link de mensageiro nas configurações do site), o `#{visit_key}` espaço reservado é substituído por um código numérico único.

<div data-with-frame="true"><figure><img src="/files/f1e3ae4e162a6e10cbf8bc272e0b951c19a9d106" alt="" width="375"><figcaption></figcaption></figure></div>

## Inscrição no Instagram

**Evolução do rastreamento de parâmetros**

* **Método anterior (`#{visit_key}`):**
* O `#{visit_key}` a variável era usada ao colocá-la na **"Mensagem inicial do WhatsApp"**. Isso permitia rastrear os parâmetros de inicialização das interações no Instagram.
* **Método atual (deep links com parâmetros de referência):**

Agora você pode passar parâmetros de referência diretamente por meio de deep links do Instagram, oferecendo maior flexibilidade e controle.

**Benefícios de usar parâmetros de referência:**

Com parâmetros de referência, você pode:

* **Rastrear campanhas** ao vincular cliques a fontes ou canais específicos.
* **Atribuir usuários** ao conectar um visitante do Instagram a uma sessão ou conta no seu aplicativo externo.
* **Personalizar jornadas** ao direcionar os usuários para conteúdo segmentado ou recursos específicos dentro da sua conta do Instagram.

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXcc5PLfQg8uf4gvxZZ406aRwpoDcBtDJzqbOOthnQ2fjKIQ8UHr8NTFUVl5vkbPN541vIv5lvbRxhEn0n7FSDt-g7NYwodzJg09vzSowpMRTQaSrNwbBf3XTCpYuT2rKbDUAjADeg?key=9cFsqYH0-lPo60eUI7iEQg" alt=""><figcaption><p>Deep link do Instagram</p></figcaption></figure>

O parâmetro REF\_PARAM é transmitido ao servidor por meio de um webhook.

Exemplo: <https://ig.me/m/mavibotai?ref=mavi>

Você pode copiar o link do seu bot do Instagram na seção "Canais".

O link tem a seguinte aparência: <https://ig.me/m/\\>\<account\_login\_instagram> \*

<div data-with-frame="true"><figure><img src="/files/262269a15d613ab663db238f6cfdbd8528f03c3d" alt=""><figcaption></figcaption></figure></div>

O link tem a seguinte aparência: <https://ig.me/m/\\>\<account\_login\_instagram>\*

Adicione o parâmetro ao link copiado:?ref=\<seu parâmetro>&#x20;

Depois, você pode usar o link com o parâmetro ref para inserir usuários no bot do Instagram.

O parâmetro será transmitido SOMENTE no primeiro contato do usuário com sua conta (bot).

## Tags UTM na seção Analytics

Você pode visualizar estatísticas sobre tags UTM na seção "Analytics"

Vá para a seção "Analytics" e selecione a aba "Clientes".

<div data-with-frame="true"><figure><img src="/files/22c30581eb4a50a6436a4347b712789716ade85d" alt="" width="563"><figcaption></figcaption></figure></div>

Clique no botão "Adicionar widget".

<div data-with-frame="true"><figure><img src="/files/3dd47245d7fea0a0f358bfebe05cec06953fe898" alt="" width="563"><figcaption></figcaption></figure></div>

O **O construtor de widgets** será aberto.

1. Selecione o **Tags UTM** .
2. Clique no **"Adicionar um valor"** .

<div data-with-frame="true"><figure><img src="/files/16290e4e1ba98bf12ceaa6ead42051897630faa6" alt="" width="375"><figcaption></figcaption></figure></div>

As configurações adicionais para valores de tags UTM aparecem. Clique no campo **"Selecionar uma tag"**.

<div data-with-frame="true"><figure><img src="/files/cb09f9793fc91a6b32e04a95fc803a696c452eb0" alt="" width="563"><figcaption></figcaption></figure></div>

E selecione o rótulo para o qual você deseja visualizar as estatísticas.

<div data-with-frame="true"><figure><img src="/files/6ca0d26a614fa3cb6b4545b665b7f93a93a08f3e" alt="" width="325"><figcaption></figcaption></figure></div>

Se quiser adicionar várias tags ou todas elas, clique em "Adicionar um valor" novamente.

<div data-with-frame="true"><figure><img src="/files/5d009b260c27955c701f49ada83c3d30f1e41a3a" alt="" width="563"><figcaption></figcaption></figure></div>

Não se esqueça de especificar o período e outras configurações e não deixe de salvá-las.

Em seguida, adicione o número necessário de tags e clique no botão "Salvar".&#x20;

<div data-with-frame="true"><figure><img src="/files/c57b6ae7542f969d77e8a9d85fe728e54f5a91b5" alt="" width="375"><figcaption></figcaption></figure></div>

Depois, você precisa clicar no botão "Adicionar um widget".

<div data-with-frame="true"><figure><img src="/files/f9cd5030b4c7d6a9e0d96fa968fb08dbcd6915a6" alt="" width="375"><figcaption></figcaption></figure></div>

{% hint style="success" %}
Leia mais sobre como trabalhar com analytics no artigo "[MaviBot Analytics](/doc/pt/analises-do-mavibot.md)"
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.mavibot.ai/doc/pt/websites/sites/tags.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.