Skip to content

Tintim Integration

OneClick Tracking — Tintim Integration

OneClick Tracking is the OneClick Ads feature that lets you track the real conversions generated by your ads more accurately and reliably.

When you advertise on Meta Ads, each ad click carries tracking parameters called UTMs (for example, utm_source, utm_campaign). These parameters follow the visitor along the journey, from the ad to filling out a form or a lead being created in the CRM.

OneClick Tracking captures this data and, when the lead reaches the status defined as a conversion inside Tintim, records that event as a conversion attributed to the correct ad — making ROAS and campaign metrics much more accurate.


A webhook is a way for one system to automatically send data to another system in real time, whenever a given event happens.

In this integration:

  • Tintim is the one that sends the webhook (with the lead’s data) when a new lead is created or when an existing lead’s status is updated.
  • OneClick Tracking is the one that receives that data and records the conversion if the lead’s status matches one of the statuses selected as a conversion.

This integration uses a hybrid flow:

  1. OneClick Ads connects to your Tintim account (with your Client Code and Security Token) to list the lead statuses available.
  2. Inside OneClick Ads, you select which statuses should be considered a conversion.
  3. Tintim fires a webhook to OneClick Tracking whenever a lead is created (the lead.create event) or when an existing lead’s status is updated (the lead_source.update event).
  4. OneClick Tracking checks whether the lead’s status matches one of the selected ones — either at creation or in a later update — and, if so, records the conversion, associating it with the correct ad through the UTMs.

For OneClick Ads to list the lead statuses in your Tintim account, you’ll need two credentials:

  • Client Code (“Código do Cliente” in the app): the unique identifier of your Tintim account.
  • Security Token (“Token de Segurança” in the app): your Tintim account’s access key.

See the official Tintim API documentation to find this information in your account dashboard.


Step 2 — Set up the integration in OneClick Tracking

Section titled “Step 2 — Set up the integration in OneClick Tracking”
  1. Log in to your OneClick Ads account.

  2. Go to the "OneClick Tracking" tab, available in the left sidebar of OneClick Ads.

    The OneClick Tracking tab in the OneClick Ads sidebar, with the New Integration card

  3. Click "New Integration".

  4. Select the "Lead Generation" product type and click Continue.

  5. Select the "Tintim" platform and click Continue.

  1. Enter your Tintim Client Code and Security Token and click Connect Tintim.

    After connecting, OneClick Ads will automatically list all the lead statuses available in your Tintim account.

  2. Select which statuses should be considered a conversion in your business (for example: “Qualificado” (Qualified), “Proposta Enviada” (Proposal Sent), “Venda Fechada” (Sale Closed)).

    Important: a lead is recorded as a conversion when its status matches one of the selected statuses — either at creation or in a later update of the lead. Each lead counts only once: if it later reaches another selected status, the existing conversion is updated rather than a new one being created.

  3. When you finish, the system will generate a unique webhook URL for this integration.

  4. Copy this URL — you’ll use it in the next step.


Tintim needs to be configured to send the lead.create event (and, optionally, lead_source.update) to the URL generated by OneClick Tracking. See the official Tintim webhook documentation for the full step-by-step.

In general terms:

  1. Log in to your Tintim account and go to the Configurações de Webhooks (Webhook Settings) area (or Integrações (Integrations)).
  2. Create a new webhook and select the lead.create event. If you also want to capture conversions when an existing lead’s status changes (not just at creation), also select the lead_source.update event.
  3. Paste the webhook URL generated in Step 2 into the destination URL field.
  4. Save the configuration.

Attention: OneClick Tracking processes the lead.create and lead_source.update events. Select the corresponding event(s) when setting up the webhook in Tintim, according to what you want to track.


  1. Copy the UTM Script generated inside OneClick Tracking.

    image2

  2. Paste it into the URL parameters field of all your ads in Ads Manager:

    image3


Step 5 — Install the UTM Passthrough Script

Section titled “Step 5 — Install the UTM Passthrough Script”

Install the UTM Passthrough Script on all your sales pages, so the UTMs are automatically carried into the leads created in Tintim.

  • You can install it on your site via Google Tag Manager or, preferably, directly in your site’s header.

Step 6 — Set the Attribution Mode and Naming Convention

Section titled “Step 6 — Set the Attribution Mode and Naming Convention”
  1. Set the Attribution Mode.

    image4

  2. Set the Naming Convention your campaigns, ad sets and ads will receive inside Ads Manager and click Next.

    image5 image6


Wait at least 24 hours for the setup to take effect, and all your campaigns (those that receive conversions) will start recording conversions right inside Ads Manager.

Campaigns with the OneClick Tracking prefix in Ads Manager


  • OneClick Tracking processes Tintim’s lead.create and lead_source.update events — that is, both the creation of a lead and a later update of its status can generate a conversion. Lead deletion events are not processed.
  • A lead is recorded as a conversion when its status matches one of the selected statuses, either at creation or in a later update. Each lead (identified by its phone number) generates at most one conversion per ad account: later status changes update that same conversion.
  • For attribution to work, the lead must arrive with the ad’s origin: the campaign, ad set and ad Tintim itself identified (for example, on leads from WhatsApp ads) or the UTMs. Make sure your lead capture forms are sending the UTMs correctly.
  • Each ad account has its own unique webhook URL. If you manage multiple accounts, create a separate integration for each one.
  • Only campaigns created after the setup will have access to the “Maximum Period” data. This does not affect OneClick Ads optimization of older campaigns in any way.