---
title: "Tintim Integration"
description: "Learn how to connect OneClick Tracking to Tintim CRM to accurately track lead conversions in your Meta Ads campaigns."
---

OneClick Tracking — Tintim Integration

:::tip[You can connect several platforms at the same time]
OneClick Tracking lets you connect **more than one platform to the same ad account** at the same time (for example, Hotmart and Eduzz together). Each platform has its own integration — with its own Webhook link or access credential — and they coexist without competing with each other; just repeat the **"New Integration"** steps for each one you want to connect.

Each sale is attributed to the right campaign by its **UTM**, not by the platform. So if one campaign sells through one platform and other campaigns sell through another, each conversion is automatically linked to the campaign it came from, regardless of which platform generated the sale. The recommended setup is **each campaign serving a single platform** — avoid having the same campaign sell on two platforms at once.
:::

## What is OneClick Tracking?

**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.

---

## What is a webhook?

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.

---

## How the integration works (overview)

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.

---

## Step 1 — Get the Tintim API credentials

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](https://tintim.app/documentacao/documentacao-de-api/) to find this information in your account dashboard.

---

## 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](https://app.oneclickads.com.br/oneclick-tracking).

   ![The OneClick Tracking tab in the OneClick Ads sidebar, with the New Integration card](../../../../../public/oneclick-tracking/common/image-1.png)

3. Click "New Integration".

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

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

6. 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.

7. 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.

8. When you finish, the system will generate a unique **webhook URL** for this integration.
9. **Copy this URL** — you'll use it in the next step.

---

## Step 3 — Set up the webhook in Tintim

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](https://tintim.app/documentacao/documentacao-de-webhooks/) 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.

---

## Step 4 — Set up the UTMs in your ads

1. Copy the **UTM Script** generated inside OneClick Tracking.

   ![image2](../../../../../public/oneclick-tracking/common/image-2.png)

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

   ![image3](../../../../../public/oneclick-tracking/common/image-3.png)

---

## 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

1. Set the **Attribution Mode**.
   - [Watch this video](https://www.youtube.com/watch?v=JgWkvv4ZNLY) to understand each model.
   - Click Continue.

   ![image4](../../../../../public/oneclick-tracking/common/image-4.png)

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

   :::caution[Campaign renaming depends on processed conversions]
   The naming convention configured here **will only be applied to the campaign name in Ads Manager once there is at least 1 processed conversion**. Receiving raw webhook data from the integrated platform isn't enough — the system needs to have structured the conversion and attributed it to a campaign. If the webhook is arriving but the campaign name hasn't changed yet, wait for the first conversion to be recorded.
   :::

   ![image5](../../../../../public/oneclick-tracking/common/image-5.png)
   ![image6](../../../../../public/oneclick-tracking/common/image-6.png)

---

## Done!

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](../../../../../public/oneclick-tracking/common/image-7.png)

---

## Important Notes

- 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.

---

## References

- [Tintim Webhook Documentation](https://tintim.app/documentacao/documentacao-de-webhooks/)
- [Tintim API Documentation](https://tintim.app/documentacao/documentacao-de-api/)
