Como transferir parâmetros e tags UTM

07/02/2026

Nesta página

Plataformas como Instagram, Facebook, WhatsApp e Telegram implementam esse mecanismo através do parâmetro visit_key.

Suporte a deep links
A maioria dos mensageiros (como Instagram, Facebook, Telegram) suporta deep links. No entanto, outros não.

Solução alternativa para WhatsApp
Embora o WhatsApp não tenha suporte nativo a deep links, 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 após clicar no seu link. (Este método será abordado em detalhes posteriormente.)

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

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

Estático: Você define o valor exato a ser transmitido.
- Exemplo: utm_term=webinar1 (onde utm_term é o nome e webinar1 é o valor estático).
Dinâmico: A plataforma de anúncios (ex.: Google Ads, Facebook Ads) insere automaticamente os dados relevantes no momento do clique.
- Exemplo: term={keyword} — aqui, o placeholder {keyword} é 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 passados para o 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".

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 passados para o bot e salvos como variáveis de cliente.

Como usar esses parâmetros sem um site

Você pode usar links de proxy para passar parâmetros diretamente. Uma vez que o bot é iniciado através 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 de proxy

Um link de proxy parametrizado consiste em duas partes:

URL base (o próprio link de proxy): https://mavibot.ai/r/mavibot_1
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

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 suporta 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, este placeholder será automaticamente substituído por um código numérico único contendo os parâmetros passados.

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

Quando um usuário vai para o WhatsApp a partir do seu site (ou através de um link de mensageiro das configurações do site), o placeholder #{visit_key} é substituído por um código numérico único.

Inscrição no Instagram

Evolução do rastreamento de parâmetros

Método anterior (#{visit_key}):
A variável #{visit_key} era usada colocando-a na "Mensagem inicial do WhatsApp". Isso permitia rastrear os parâmetros de inicialização para 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 através de deep links do Instagram, oferecendo maior flexibilidade e controle.

Benefícios do uso de parâmetros de referência:

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

Rastrear campanhas vinculando cliques a fontes ou canais específicos.
Atribuir usuários conectando um visitante do Instagram a uma sessão ou conta em seu aplicativo externo.
Personalizar jornadas direcionando usuários para conteúdo direcionado ou recursos específicos dentro da sua conta do Instagram.