waplyGuide
Click-to-WhatsApp ads to Kommo: track every lead with the official API
·
When a customer messages you from a Meta Click-to-WhatsApp ad, Waply writes the ad attribution to the Kommo lead. Waply fills Kommo's UTM fields (from your ad URL, or with fallback values when it has none) and ten Waply lead fields, including Waply CTWA Click ID. It works on the official WhatsApp Cloud API, and Waply adds those lead fields to your Kommo account when you connect it.
This guide is for teams that run Click-to-WhatsApp ads on Facebook or Instagram and work their leads in Kommo. It shows how those leads arrive through Waply, which attribution fields you get on each lead, how to set up your ads for clean data and where the 72-hour free entry point window fits.
Free 3-day trial with everything in Voice AI.
How Click-to-WhatsApp leads reach Kommo through Waply
A Click-to-WhatsApp ad opens a WhatsApp chat with your business. When that first message arrives, Meta includes a referral with the ad data. Waply reads it and writes the attribution to the customer's lead in Kommo, from the message that comes from the ad.
What you need
Waply connected to Kommo with your number on the official WhatsApp Cloud API. If you haven't connected it yet, follow the connection guide first; nothing extra is needed for ads.
Which attribution fields Waply saves on the Kommo lead
UTM fields (from your ad URL)
If your ad's destination URL has UTM parameters, Waply copies them to Kommo's UTM fields: utm_source, utm_medium, utm_campaign, utm_content and utm_term.
Fallback values when the ad URL has no UTMs
Fallback values Waply uses for each missing UTM
| UTM field | Value without a UTM parameter |
|---|---|
| UTM_SOURCE | meta |
| UTM_MEDIUM | ctwa_ad (ad), ctwa_post (post) or ctwa (other source) |
| UTM_CAMPAIGN | The ad headline |
| UTM_CONTENT | The ad ID (source ID) |
Waply ad fields, including CTWA Click ID
Waply lead fields in Kommo
| Field name in Kommo | What it holds |
|---|---|
| Waply Ad Source ID | The ID of the ad or post |
| Waply Source Type | Whether the source is an ad or a post |
| Waply Ad Text | The ad text |
| Waply Ad Headline | The ad headline |
| Waply Media Type | The ad media type |
| Waply Image URL | The ad image URL |
| Waply Video URL | The ad video URL |
| Waply Thumbnail URL | The ad thumbnail URL |
| Waply CTWA Click ID | The Click-to-WhatsApp click ID (ctwa_clid) sent by Meta |
| Waply Source URL | The ad source URL |
Example: one ad message, the resulting lead
An ad with the URL https://example.com/landing?utm_source=instagram&utm_campaign=launch, ID 23850000000000000 and the headline Launch offer brings in a message. The lead gets:
- UTM_SOURCE = instagram (from the URL)
- UTM_MEDIUM = ctwa_ad (fallback, because the URL has no utm_medium)
- UTM_CAMPAIGN = launch (from the URL, so the headline isn't used)
- UTM_CONTENT = 23850000000000000 (the ad ID)
Set up your ads for clean attribution
- Add utm_source, utm_medium and utm_campaign to the destination URL of each Click-to-WhatsApp ad, with the names you use in your reports.
- In Kommo, open a lead that came from an ad and check its UTM fields and the Waply ad fields.
- Filter or segment your leads in Kommo by these fields, for example UTM_MEDIUM = ctwa_ad, to see which leads came from ads.
Leave a UTM out and Waply still fills it with the fallback value, so every ad lead carries at least its source, medium and ad ID.
Reply fast with Waply's AI agent
On AI 24/7 and Voice AI, Waply's AI agent replies to the incoming conversation like any other, around the clock, so a lead from an ad gets an answer right away. Give the agent a knowledge base with your offers so its replies stay on point.
The 72-hour free entry point window
According to Meta, the free 72-hour window that opens from Click-to-WhatsApp ads and the Facebook page button stays for eligible message delivery. The pricing guide explains it; once the window closes, follow up with approved templates.
Waply also saves attribution for WhatsApp calls that come from an ad; the Voice AI guide covers calls.
- Guide: WhatsApp API pricing 2026
- Guide: WhatsApp templates in Kommo
- Guide: Voice AI for Kommo
- Guide: choose a Waply plan
Frequently asked questions
Does Waply save UTM parameters from Click-to-WhatsApp ads in Kommo?
Yes. If the ad's destination URL has utm_ parameters, Waply copies them to the lead's UTM fields in Kommo.
What if my ad has no UTM parameters?
Waply fills each missing UTM with a fallback: source meta, medium ctwa_ad, ctwa_post or ctwa, campaign with the ad headline and content with the ad ID.
Where is the CTWA click ID stored?
In the Waply CTWA Click ID field of the Kommo lead. Waply saves it there with the rest of the ad data.
Do I need to create the fields in Kommo?
No. Waply adds its lead fields to your Kommo account when you connect it, if they are missing.
Is the 72-hour window still free?
According to Meta, the free 72-hour entry point window stays for eligible message delivery. See the pricing guide for the details.
Track your Click-to-WhatsApp leads in Kommo
Install Waply in Kommo and use the free 3-day trial with everything in Voice AI: connect your number, run an ad and check the attribution on the lead.
Free 3-day trial with everything in Voice AI.