Pular para o conteúdo

Integração Tintim

OneClick Tracking — Integração com o Tintim

O OneClick Tracking é a funcionalidade da OneClick Ads que permite rastrear conversões reais geradas pelos seus anúncios de forma mais precisa e confiável.

Ao anunciar no Meta Ads, cada clique no anúncio carrega parâmetros de rastreamento chamados UTMs (por exemplo, utm_source, utm_campaign). Esses parâmetros acompanham o visitante ao longo da jornada, desde o anúncio até o preenchimento de um formulário ou criação de um lead no CRM.

O OneClick Tracking captura esses dados e, quando o lead avança até o status definido como conversão dentro do Tintim, registra esse evento como uma conversão atribuída ao anúncio correto — tornando o ROAS e as métricas de campanha muito mais precisos.


Um webhook é uma forma de um sistema enviar dados automaticamente para outro sistema em tempo real, sempre que um determinado evento acontece.

Nesta integração:

  • O Tintim é quem envia o webhook (com os dados do lead) quando um novo lead é criado ou quando o status de um lead já existente é atualizado.
  • O OneClick Tracking é quem recebe esses dados e registra a conversão caso o status do lead corresponda a um dos status selecionados como conversão.

Esta integração utiliza um fluxo híbrido:

  1. O OneClick Ads se conecta à sua conta do Tintim (com o Código do Cliente e o Token de Segurança) para listar os lead statuses disponíveis.
  2. Você seleciona, dentro do OneClick Ads, quais statuses devem ser considerados conversão.
  3. O Tintim dispara um webhook para o OneClick Tracking sempre que um lead é criado (evento lead.create) ou quando o status de um lead já existente é atualizado (evento lead_source.update).
  4. O OneClick Tracking verifica se o status do lead corresponde a um dos selecionados — seja no momento da criação, seja em uma atualização posterior — e, em caso positivo, registra a conversão associando-a ao anúncio correto pelas UTMs.

Para que o OneClick Ads consiga listar os lead statuses da sua conta Tintim, você precisará de duas credenciais:

  • Código do Cliente: identificador único da sua conta no Tintim.
  • Token de Segurança: chave de acesso da sua conta Tintim.

Consulte a documentação oficial da API do Tintim para localizar essas informações no painel da sua conta.


Passo 2 — Configurar a integração no OneClick Tracking

Seção intitulada “Passo 2 — Configurar a integração no OneClick Tracking”
  1. Acesse sua conta OneClick Ads.

  2. Vá até a aba "OneClick Tracking", conforme disponível no menu lateral esquerdo do OneClick Ads.

    Aba OneClick Tracking no menu lateral do OneClick Ads, com o cartão Nova Integração

  3. Clique em "Nova Integração".

  4. Selecione o tipo de produto "Geração de Leads" e clique em Continuar.

  5. Selecione a plataforma "Tintim" e clique em Continuar.

  1. Insira o Código do Cliente e o Token de Segurança do Tintim e clique em Conectar Tintim.

    Após a conexão, o OneClick Ads listará automaticamente todos os lead statuses disponíveis na sua conta Tintim.

  2. Selecione quais statuses devem ser considerados conversão no seu negócio (por exemplo: “Qualificado”, “Proposta Enviada”, “Venda Fechada”).

    Importante: um lead é registrado como conversão quando seu status coincide com um dos statuses selecionados — seja no momento da criação, seja em uma atualização posterior do lead. Cada lead conta uma única vez: se ele passar por outro status selecionado depois, a conversão existente é atualizada, sem gerar uma nova.

  3. Ao finalizar, o sistema irá gerar uma URL de webhook exclusiva para essa integração.

  4. Copie essa URL — você irá usá-la no próximo passo.


O Tintim precisa ser configurado para enviar o evento lead.create (e, opcionalmente, lead_source.update) para a URL gerada pelo OneClick Tracking. Consulte a documentação oficial de webhooks do Tintim para o passo a passo completo.

Em linhas gerais:

  1. Acesse sua conta no Tintim e vá até a área de Configurações de Webhooks (ou Integrações).
  2. Crie um novo webhook e selecione o evento lead.create. Se você também quiser capturar conversões quando o status de um lead já existente mudar (não apenas na criação), selecione também o evento lead_source.update.
  3. Cole a URL de webhook gerada no Passo 2 no campo de URL de destino.
  4. Salve a configuração.

Atenção: o OneClick Tracking processa os eventos lead.create e lead_source.update. Selecione o(s) evento(s) correspondente(s) ao configurar o webhook no Tintim, de acordo com o que você deseja rastrear.


  1. Copie o Script de UTM gerado dentro do OneClick Tracking.

    image2

  2. Insira no campo Parâmetros de URL dentro de todos os seus anúncios no gerenciador de anúncios:

    image3


Insira o Script de Passagem de UTMs em todas as suas páginas de vendas, para que as UTMs sejam carregadas automaticamente para dentro dos leads criados no Tintim.

  • Você pode instalar no seu site via Google Tag Manager ou, preferivelmente, instalando diretamente no header do seu site.

Passo 6 — Definir o Modo de Atribuição e Nomenclatura

Seção intitulada “Passo 6 — Definir o Modo de Atribuição e Nomenclatura”
  1. Defina o Modo de Atribuição.

    image4

  2. Defina a Nomenclatura que suas campanhas, conjuntos de anúncios e anúncios receberão dentro do seu gerenciador de anúncios e clique em Avançar.

    image5 image6


Aguarde pelo menos 24 horas para que a configuração esteja vigente e todas as suas campanhas (as que receberem conversões) passarão a registrar as conversões dentro do próprio gerenciador de anúncios.

Campanhas com o prefixo do OneClick Tracking no gerenciador de anúncios


  • O OneClick Tracking processa os eventos lead.create e lead_source.update do Tintim — ou seja, tanto a criação de um lead quanto uma atualização posterior do seu status podem gerar uma conversão. Eventos de exclusão de leads não são processados.
  • Um lead é registrado como conversão quando seu status corresponde a um dos statuses selecionados, seja no momento da criação, seja em uma atualização posterior. Cada lead (identificado pelo telefone) gera no máximo uma conversão por conta de anúncios: mudanças posteriores de status atualizam essa mesma conversão.
  • Para a atribuição funcionar, o lead precisa chegar com a origem do anúncio: a campanha, o conjunto e o anúncio que o próprio Tintim identificou (por exemplo, em leads de anúncios para o WhatsApp) ou as UTMs. Confirme que os formulários de captura de lead estão enviando as UTMs corretamente.
  • Cada conta de anúncios possui uma URL de webhook exclusiva. Se você gerencia múltiplas contas, crie uma integração separada para cada uma.
  • Só campanhas criadas após a configuração terão acesso ao dado de “Período Máximo”. Isso não prejudica de nenhum modo a otimização do OneClick Ads em campanhas mais antigas.