---
title: "Bitrix24 Integration"
description: "Learn how to connect OneClick Tracking to Bitrix24 CRM to record as conversions the deals that reach the pipeline stages you choose."
---

> Learn how to set up OneClick Tracking in Bitrix24 CRM.

**OneClick Tracking** records as conversions the Bitrix24 deals that reach the pipeline stages you choose, and links each one to the Meta ad that brought the customer. Your campaigns' CPA and ROAS then reflect your sales team's real results.

The integration works with **Bitrix24 cloud** (`yourcompany.bitrix24.com`, `.com.br` and the other Bitrix24 domains). Portals on a custom domain and self-hosted (on-premise) Bitrix24 are not supported.

---

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

## Before you start: UTMs in Bitrix24

Bitrix24 deals have their own UTM fields (`UTM_SOURCE`, `UTM_MEDIUM`, `UTM_CAMPAIGN`, `UTM_CONTENT` and `UTM_TERM`). Bitrix24 **CRM forms** and **website widgets** fill them with the visit's UTMs. OneClick also reads deal custom fields with those names (for example, `UF_CRM_UTM_SOURCE`).

A deal created by hand or from a WhatsApp chat arrives without UTMs: it stays in your Bitrix24 as usual, but it does not become a tracked conversion, because there is no ad to attribute it to.

---

## How to Connect OneClick Tracking to Bitrix24

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 "Bitrix24" platform and click Continue.

6. Paste the Bitrix24 **inbound webhook URL** and click Connect.
   a. In Bitrix24, open **Applications** > **Developer resources** > **Other** > **Inbound webhook**.
   b. Under **Permissions**, tick **CRM (crm)** and save.
   c. Copy the URL Bitrix24 shows, shaped like `https://yourcompany.bitrix24.com/rest/1/abc123.../`. The URL works like a password: do not share it.
   d. Create the webhook with a user who can see every deal in the pipeline: OneClick reads deals with that user's permissions.

7. Choose **which stages count as a conversion**.
   a. OneClick lists your Bitrix24 deal pipelines and their stages.
   b. Tick the stages that are a real conversion for your business (for example, "Proposal sent" or "Deal won").

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

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

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

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

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

11. Copy the **Webhook URL** OneClick generates and create, in Bitrix24, the webhook that tells OneClick when a deal changes:

    11.1. In Bitrix24, open **Applications** > **Developer resources** > **Other** > **Outbound webhook**.

    11.2. In **Handler URL**, paste the OneClick Webhook URL.

    11.3. Under **Events**, tick **Deal updated** (`ONCRMDEALUPDATE`) and **Deal created** (`ONCRMDEALADD`), and save.

    :::note[The notice only carries the deal number]
    Bitrix24 only tells OneClick that a deal changed. OneClick then reads the deal through the inbound webhook from step 6 to learn its stage, value and UTMs. Both webhooks must stay active.
    :::

---

## Important Notes

- Each stage you chose counts **once per deal**: editing the same deal again in the same stage does not create a duplicate conversion. If you choose several stages, a deal that goes through all of them counts once in each.
- In Bitrix24, "won" and "lost" are stages too: the stage you tick in step 7 is what counts as a conversion.
- The recorded value is the **deal amount** (Opportunity field), in the deal's currency.
- The conversion date is when the deal entered the stage.
- If you delete or recreate the inbound webhook in Bitrix24, reconnect the integration in OneClick with the new URL.

---

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