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

> Learn how to set up OneClick Tracking with Agendor CRM.

**OneClick Tracking** records as conversions the Agendor deals that reach the funnel stages you choose — or that are marked as **won** — and links each one to the Meta ad that brought the customer. Your campaigns' CPA and ROAS then reflect your sales team's real sales.

You don't need to set up any webhook in Agendor: OneClick creates the delivery in your account automatically, with the token you provide.

---

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

Agendor has no field of its own for UTMs. For OneClick to know which ad each deal came from, the UTMs must be in **deal custom fields** with these names:

- `utm_source`
- `utm_medium`
- `utm_campaign`
- `utm_content`
- `utm_term`

Create these fields under **Menu > Configurações > Campos personalizados** (for deals) and have your website form, or the tool that creates deals in Agendor, fill them in. A deal without UTMs stays in your Agendor as usual, but it doesn't become a tracked conversion, because there is no ad to attribute it to.

---

## How to Connect OneClick Tracking to Agendor

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

6. Paste the Agendor **API token** and click Connect.
   a. In Agendor, open **Menu > Integrações** and copy the **Token da API**.
   b. Use the token of an **admin user**. A collaborator's token only sees the deals they can access, so the other salespeople's deals would not be tracked.

7. Choose **which stages count as a conversion**.
   a. OneClick lists your account's funnels and the stages of each one.
   b. Select the stages that represent a real conversion for your business. Each funnel also shows a **"Negócio ganho"** (deal won) option, which counts the deal when it is marked as won, at any stage.

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. When you finish, OneClick automatically creates, in your Agendor account, the delivery of deals created, moved between stages and won. There is no URL to copy.

---

## Important Notes

- Each stage you chose counts **once per deal**: the same deal moved to the same stage again does not create a duplicate conversion. If you choose more than one stage, a deal that goes through all of them counts once in each.
- **Lost** deals never count as conversions.
- Renaming a stage in Agendor does not stop the tracking.
- If you remove the integration in OneClick, the delivery created in your Agendor account is removed too.
- If you change the token in Agendor, reconnect the integration in OneClick with the new token.

---

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