Os parâmetros UTM são informações adicionadas às URLs para identificar a origem dos acessos, campanhas e canais que geraram uma conversa.

Ao utilizar UTMs corretamente, você consegue:

Identificar de onde veio cada lead;
Medir campanhas de marketing;
Avaliar performance por canal;
Comparar anúncios e criativos;
Alimentar dashboards e relatórios;
Enriquecer automações e integrações.

Como funciona

Os parâmetros UTM são enviados na URL utilizada para iniciar a conversa.

Exemplo:

https://api.digitalizei.digital/chat/v1/channel/wa/[TELEFONE]?text=[MENSAGEM]&utm_source=[SOURCE]&utm_medium=[MEDIUM]&utm_campaign=[CAMPAIGN]

Quando a conversa é iniciada, essas informações ficam vinculadas ao atendimento e ao contato.

Exemplo completo

https://api.digitalizei.com.br/chat/v1/channel/wa/5511999999999?text=Quero+saber+mais&utm_source=tiktok&utm_medium=stories&utm_campaign=black_friday

Parâmetros disponíveis

TELEFONE

Número do canal WhatsApp.

Exemplo:

5511999999999

MENSAGEM

Mensagem inicial enviada automaticamente.

Exemplo:

Quero saber mais

URL codificada:

Quero+saber+mais

utm_source

Identifica a origem do tráfego.

Exemplos:

google
facebook
instagram
tiktok
linkedin
youtube
email

utm_medium

Identifica o formato ou meio de divulgação.

Exemplos:

cpc
stories
feed
video
email
referral
banner
organic

utm_campaign

Identifica a campanha utilizada.

Exemplos:

black_friday
seguro_auto_julho
campanha_natal
publico_aberto
retargeting

utm_content (Opcional)

Permite identificar anúncios ou criativos específicos.

Exemplos:

video_01
video_02
imagem_carrossel
criativo_a
criativo_b

utm_term (Opcional)

Normalmente utilizado para identificar palavras-chave.

Exemplos:

seguro auto
seguro carro barato
seguro uber

Onde os dados aparecem

Após a conversa ser iniciada, a Digitalizei registra automaticamente as informações de rastreamento.

Os dados ficam disponíveis em:

Conversa;
Contato;
Relatórios;
Indicadores;
Webhooks;
Integrações.

Exemplo visual

Insira aqui a imagem de rastreamento exibida na conversa.

Exemplo registrado

Origem: TIKTOK
Campanha: Publico Aberto
Meio: STORIES

Dados disponíveis via API

As informações também podem ser acessadas através da API e dos webhooks.

Exemplo:

{
  "utm": {
    "source": "INSTAGRAM",
    "medium": "STORIES",
    "campaign": "BLACK_FRIDAY",
    "content": "VIDEO_01",
    "term": null,
    "headline": "Converse conosco",
    "referralUrl": "https://instagram.com"
  }
}

Exemplo para Meta Ads

utm_source=facebook
utm_medium=feed
utm_campaign=seguro_auto
utm_content=criativo_01

Exemplo para Instagram Stories

utm_source=instagram
utm_medium=stories
utm_campaign=campanha_natal
utm_content=video_03

Exemplo para TikTok

utm_source=tiktok
utm_medium=video
utm_campaign=publico_aberto
utm_content=criativo_a

Exemplo para Google Ads

utm_source=google
utm_medium=cpc
utm_campaign=seguro_auto
utm_term=seguro+carro

Boas práticas

Utilize nomes padronizados

Prefira:

black_friday
campanha_natal
seguro_auto

Evite:

Black Friday
BLACK FRIDAY
BlackFriday

Não altere nomes durante a campanha

Após iniciar uma campanha, mantenha os parâmetros consistentes para facilitar análises e relatórios.

Utilize utm_content para testes

Quando possuir múltiplos anúncios:

utm_content=video_01
utm_content=video_02
utm_content=imagem_01

Isso permite identificar qual criativo gerou mais conversões.

Utilize utm_term para campanhas de busca

Exemplo:

utm_term=seguro auto uber

Casos de uso

Identificar origem dos leads

Google
↓
WhatsApp
↓
Lead criado
↓
Origem registrada

Comparar anúncios

Anúncio A
↓
utm_content=video_01

Anúncio B
↓
utm_content=video_02

Medir campanhas

Campanha Janeiro
↓
utm_campaign=janeiro

Campanha Fevereiro
↓
utm_campaign=fevereiro

Alimentar CRM

Meta Ads
↓
UTM
↓
Contato criado
↓
Origem salva automaticamente

Perguntas frequentes

Os parâmetros UTM são obrigatórios?

Não. A conversa funciona normalmente sem UTMs.

Posso usar apenas source e campaign?

Sim.

Exemplo:

utm_source=instagram
utm_campaign=black_friday

Posso utilizar utm_content e utm_term?

Sim.

Esses parâmetros são opcionais e recomendados para análises mais avançadas.

As UTMs ficam disponíveis nos webhooks?

Sim.

Elas são enviadas dentro do objeto:

{
  "session": {
    "utm": {}
  }
}

Posso utilizar qualquer valor?

Sim.

Porém recomendamos seguir uma nomenclatura padronizada para facilitar relatórios e integrações.

As UTMs ficam registradas no contato?

Sim.

Além da conversa, as informações também ficam disponíveis no contato e nos relatórios da plataforma.