Com as UTMs, você acompanha no Google Analytics, ou em outra ferramenta de análise, quais campanhas de WhatsApp e quais botões levaram visitas ao seu site.
A configuração acontece em dois lugares: no modelo de mensagem, onde você identifica cada botão, e na campanha, onde você identifica a campanha. A OmniChat junta tudo ao link no momento do clique.
Antes de começar
A UTM só funciona em botões de link. Links escritos no texto da mensagem e os botões de ligar, de resposta rápida, de Flow e de copiar código não recebem UTM.
Como as UTMs são montadas
Parâmetro | O que identifica | Onde é definido |
| A origem: | Automático. Para usar a sua, coloque no link do botão |
| O meio: | Automático. Para usar a sua, coloque no link do botão |
| Qual botão foi clicado | No modelo de mensagem, em UTM do botão (opcional) |
| Qual campanha gerou a visita | Na campanha, pontual ou recorrente, em Personalizar UTMs |
O utm_source e o utm_medium padrão são os mesmos em todas as campanhas, para que toda visita vinda do WhatsApp apareça do mesmo jeito nos relatórios. Se o link do botão já tiver utm_source ou utm_medium, a OmniChat mantém os seus.
Passo 1: identifique os botões no modelo de mensagem
Acesse a criação de um modelo de mensagem.
Preencha o corpo da mensagem.
Na seção Botões, adicione um botão com o tipo de ação Visitar website, Acessar checkout ou Acessar link variável.
Preencha o texto e o link do botão.
No campo UTM do botão (opcional), escreva o nome que identifica esse botão, por exemplo
botao-oferta.Confira a Prévia do parâmetro da UTM, ao lado do campo.
Repita para cada botão de link do modelo.
Salve o modelo.
A prévia mostra os parâmetros que serão somados ao link, começando por ?utm_source=omnichat&utm_medium=whatsapp. Ao preencher o campo, o utm_content aparece no fim.
No carrossel, cada card tem os seus botões, e cada botão de link recebe o próprio utm_content. Nos cards, os botões que aceitam UTM são Visitar website e Acessar link variável.
A UTM fica guardada na OmniChat e não faz parte do modelo enviado à Meta para aprovação.
Passo 2: identifique a campanha
Na seleção do modelo de mensagem na criação da campanha, os modelos com botão de link aparecem com a etiqueta UTM.
Em campanhas pontuais
Crie uma campanha e selecione um modelo com a etiqueta UTM.
No card Personalizar UTMs, preencha o campo utm_campaign (opcional), por exemplo
black-friday-2026.Em UTM dos botões, confira a prévia do parâmetro de cada botão. No carrossel, a prévia aparece em UTM botões dos cards, separada por card.
Conclua a campanha normalmente.
O utm_content de cada botão vem do modelo de mensagem e não é editado na campanha. Botões que não aceitam UTM aparecem como Botão incompatível com UTM.
Em campanhas recorrentes
Vale para carrinho abandonado e pedido não pago.
Crie ou abra a campanha e selecione um modelo com a etiqueta UTM.
No card da mensagem, clique em UTM da campanha.
No painel que abre à direita, preencha o campo utm_campanha (opcional).
Confira a prévia do parâmetro de cada botão.
Clique em Salvar.
Como fica o link
O contato recebe um link encurtado no botão. Ao clicar, ele é levado para o endereço do seu site já com as UTMs, por exemplo:
https://sualoja.com.br/ofertas?utm_content=botao-oferta&utm_campaign=black-friday-2026&utm_source=omnichat&utm_medium=whatsapp
A ordem dos parâmetros não muda nada na leitura do Google Analytics.
Se o link tiver
#, as UTMs entram antes dele.Nos botões Acessar checkout e Acessar link variável, o link de cada contato é respeitado e recebe as UTMs do mesmo jeito.
Regras de preenchimento
Para que o link continue válido, a OmniChat ajusta o que foi digitado:
O que você digita | Como fica |
Letras maiúsculas | Minúsculas |
Acentos e ç | Sem acento: |
Espaços e | Hífen: |
Símbolos ( | Removidos: |
Hífens repetidos ou nas pontas | Juntados e retirados: |
O limite é de 100 caracteres por campo. Se o texto ficar vazio depois do ajuste (por exemplo, só símbolos), o parâmetro não é enviado.
O que pode e o que não pode ser alterado
O quê | Pode alterar? |
| Não. Crie um novo modelo com a UTM correta |
| Sim, até a campanha começar a disparar |
| Sim, a qualquer momento. A mudança vale para os envios seguintes |
| Na OmniChat, não. Para usar valores próprios, coloque os dois no link do botão e a OmniChat os mantém |
Se o link do seu botão já tem UTM
Se o link do botão já tem configurados utm_source ou utm_medium, a OmniChat não mexe neles. Se não tem, o clique sai com utm_source=omnichat e utm_medium=whatsapp, inclusive em modelos antigos com campanhas ativas, sem UTM configurada.
O utm_content e o utm_campaign só são trocados quando preenchidos na OmniChat. Se o campo ficar vazio, o valor que já estava no link é mantido. Outros parâmetros do link, como utm_term, não são alterados.
Boas práticas
Preencha sempre o
utm_campaign. Sem ele, o Google Analytics mostra a campanha como "(not set)", e outm_contentfica sem contexto.Combine um padrão de nomes com o seu time, por exemplo
data-tema(2026-11-black-friday). Fica mais fácil comparar campanhas depois.Use o
utm_contentpara comparar botões e argumentos, e outm_campaignpara comparar campanhas.Se usar UTM própria, coloque origem e mídia juntas. Com só uma das duas, a outra chega vazia ao Google Analytics, que mostra "(not set)".
O que você quer descobrir | Use |
Qual botão chama mais atenção |
|
Qual produto, curso ou card do carrossel tem mais interesse |
|
Qual argumento leva mais cliques (ex.: desconto ou frete grátis) |
|
Como foi uma campanha ou data comemorativa |
|
Comparar campanhas entre si |
|
Separar carrinho abandonado de pedido não pago |
|
Solução de problemas
Problema: o card de UTMs não aparece na campanha.
Possível causa: o modelo escolhido não tem botão de link do tipo Visitar website, Acessar checkout ou Acessar link variável.
Como resolver: selecione um modelo com a etiqueta UTM, ou crie um modelo com pelo menos um botão de link.
Problema: cliquei no botão e não vi a UTM no link da mensagem.
Possível causa: o link da mensagem é encurtado. As UTMs entram no momento do clique.
Como resolver: clique no botão e confira o endereço que abre no navegador.
Problema: o valor que digitei apareceu diferente na prévia.
Possível causa: a OmniChat ajusta o texto para manter o link válido.
Como resolver: confira a tabela de Regras de preenchimento. O valor da prévia é o que vai para o Google Analytics.
Problema: não consigo mudar a UTM de um modelo.
Possível causa: o
utm_contentnão pode ser alterado depois que o modelo é salvo.Como resolver: crie um novo modelo com a UTM correta.
Problema: no Google Analytics 4, as visitas das campanhas aparecem como "Unassigned".
Possível causa: o GA4 não tem um canal padrão para WhatsApp, e a mídia
whatsappnão bate com nenhuma regra dele.Como resolver: crie um grupo de canais personalizado no GA4, em Administrador > Exibição de dados > Grupos de canais, com um canal WhatsApp na condição Meio corresponde exatamente a
whatsapp, acima dos outros canais. O GA4 aplica o grupo também às visitas anteriores.
Nos informe se este artigo foi útil, seu feedback é muito importante para nós!
