---
title: "Kommo Integration"
description: "Learn how to connect OneClick Tracking to Kommo CRM to track lead conversions and closed deals in your Meta Ads campaigns via UTM."
---

> Learn how to set up OneClick Tracking.

**OneClick Tracking** is a new feature for Meta Ads advertisers who use Kommo as their CRM. It provides accurate tracking of qualified leads.

This solution **corrects wrong attributions made by Meta**, delivering **real data based on UTMs** and enabling safer scaling decisions.

**With OneClick Tracking you see the volume of real conversions per period right in your Ads Manager, making for a quick and clear audit, with no need for complicated dashboards that have to be kept up to date.**

Note: **OneClick Tracking** eliminates the need for extra tracking tools!

---

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

## Setting up Kommo to generate a Long-Lived Token

Before integrating ONECLICK Tracking with Kommo, you need to create an integration and generate a **long-lived token**. Follow the steps below.

- **Accessing Kommo's integrations area**
  You need **administrator permission** on the Kommo account.
- Open your Kommo account in the browser:
  `https://{your-subdomain}.kommo.com/home/`
- In the main menu, go to:
- **Settings**
- **Integrations**
- Click **Create integration**.

![image1](../../../../../public/oneclick-tracking/kommo/image-1.png)
![image2](../../../../../public/oneclick-tracking/kommo/image-2.png)

-

* **Creating the integration**
  On the integration creation screen, fill in the fields as follows:

* **Integration name**
  Example:
  `ONECLICK TRACKING`
* **Redirect URL**
  Enter the ONECLICK app URL:
  `https://app.oneclickads.com.br/`
* After filling in the details, click **Save**.

* **Generating the Long-Lived Token**
  With the integration created, follow the steps below:

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

* Inside the integration, open the tab:
* **Keys and scopes**
* Click **Generate long-lived token**.
* Set the **expiration date**:
* Kommo allows tokens of up to **5 years**
* Select the **latest possible date**
* Click **Save / Generate token**.

* **Saving the token**
  **Attention:** the long-lived token is shown only once.
* Copy the generated token
* Store it somewhere safe
* Use this token in the **ONECLICK Tracking** app

---

## Setting up 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 "Kommo" platform and click Continue.

5.1. Enter your long-lived API token and click Connect.

5.2. Now open the funnel and the stage at which the conversion will be fired. If you set the conversion to happen at "payment link sent", as in the example below, OneClick Tracking will record that conversion in your Ads Manager when a lead is moved to this stage.

![image5](../../../../../public/oneclick-tracking/kommo/image-4.png)

6. Copy the Webhook URL and add it in Kommo following the steps below:
   a. Each ad account gets a unique, automatically generated link.
   b. This link is what connects your account and tracks conversions by UTM.
   c. In Kommo, go to "Settings >> Integrations >> Webhooks".
   d. Click "+ Webhook" in the top right corner of the screen.
   e. Configure the Webhook: Event action = e.g.: Lead status changed / Webhook name = OneClick Tracking.
   f. Paste the webhook URL generated in OneClick Tracking into the "Endpoint URL" field. Click Save.

   ![image6](../../../../../public/oneclick-tracking/kommo/image-5.png)

7. Copy the UTM Script generated in OneClick Tracking.

   ![The UTM parameters step of OneClick Tracking, with the parameter to copy](../../../../../public/oneclick-tracking/common/image-2.png)

   7.1. Paste it into the "URL parameters" field in ALL of your ads in Ads Manager, as shown below:

   ![The URL parameters field of an ad in Meta Ads Manager](../../../../../public/oneclick-tracking/common/image-3.png)

8. Add the **UTM Passthrough Script** to all your sales pages, so the UTMs are automatically carried into the card of each lead generated.
   a. You can install it on your website via Google Tag Manager or, preferably, directly in your website's header.

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

   ![The Attribution Mode step of OneClick Tracking](../../../../../public/oneclick-tracking/common/image-4.png)

10. Set the Naming Convention that your campaigns, ad sets and ads will receive in your Ads Manager and click next.

:::caution[Campaign renaming depends on processed conversions]
The naming set 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 is not enough — the system must 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.
:::

![The Campaign Naming step of OneClick Tracking](../../../../../public/oneclick-tracking/common/image-5.png)
![Analysis periods and the Naming Convention preview](../../../../../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

- Only campaigns created after the setup will have access to the “Período Máximo” (Maximum Period) data. This **does not affect** OneClick Ads' optimization of older campaigns in any way.

- If Kommo refuses the saved token (for example, because it was revoked or expired), OneClick Ads notifies you once so you can reconnect the integration. Until you reconnect, you cannot view or change the funnels and conversion stages; conversions from the stages already configured keep arriving normally through the webhook. Funnel stages can only be read again after you reconnect.
