chatleadr Docs

See Which Ad or Campaign Brought a Visitor

Every lead and every conversation carries a Came from line: the Meta ad, the campaign, the story, the catalogue product or the page that brought the visitor. When somebody taps a Meta ad that opens WhatsApp or Instagram, Meta sends the ad's details with the conversation, so Came from names the ad with no setup. On your website, Came from names a campaign only when the link a visitor followed carries UTM tags, so tag your ad links once and every lead from them names its campaign, its ad and, for a search ad, the keyword.

Takes about ten minutes for each ad account. Needs access to Meta Ads Manager or Google Ads.

Read the Came From Column#

Came from is the column after Phone on the Leads page, and on the Conversations page that View Conversations opens from a bot's menu. Its first line says what brought the visitor. A second line appears when it adds something: the page they landed on, or Returning, last conversation 12 Oct when the same person has written to the bot before.

The first line reads one of these:

Came fromWhat brought themChannel
Test chatA test from the bot's Preview tab or the WordPress plugin's preview modeWeb Chat
Meta ad: Websites in 10 daysA Meta ad, with its headline when Meta sent oneWhatsApp, Instagram
Meta postA Facebook or Instagram post with a WhatsApp buttonWhatsApp
Story reply, Story mentionA reply to your Instagram story, or a mention of you in theirsInstagram
Product: WEB-STARTERA product from your WhatsApp catalogue, named by its codeWhatsApp
Shared postA post, reel or story they shared with you to start the chatInstagram
Facebook: Winter sale 2026A campaign named in the UTM tags of the link they followedWeb Chat
Link tag: winter_flyerThe tag on an ig.me link they openedInstagram
Reply to your follow-upTheir reply, within a day, to a follow-up your workflow sentWhatsApp, Instagram
Google ad, Microsoft ad, TikTok adAn ad whose link carried no UTM tagsWeb Chat
Facebook or Instagram linkA link opened inside Facebook or Instagram, which may or may not be an adWeb Chat
From chatgpt.comAnother website that linked to yours, or a link with a UTM source and nothing elseWeb Chat
Home page, /pricingThe page they were on, when nothing else is knownWeb Chat
WhatsApp, Instagram, Web ChatNothing more than the channelAny

To list only the leads or conversations that one kind of origin brought, such as Meta ad, choose it in the filter that reads Came from: any on the Leads page or the Conversations page. Only the channel lists the rows where nothing more than the channel is known. Download CSV then writes only the rows the filter lists.

To see everything recorded about one visitor, click View Chat on their row. The Came From card at the top of the conversation lists the ad's headline, picture, text and ID, every UTM tag, the page they landed on, the page they chatted on and their earlier conversations with the bot. On WhatsApp and Instagram it also shows their WhatsApp ID or Instagram ID, with a Copy button beside it. When something is missing from one conversation, such as a headline that Meta did not send, a note under the card says what is missing and how to find the ad.

Tag Your Meta Ads#

To see the campaign and the ad's name on a visitor that a Meta ad sent to your website, add these URL parameters to the ad:

utm_source={{site_source_name}}&utm_medium=paid_social&utm_campaign={{campaign.name}}&utm_content={{ad.name}}
  1. In Meta Ads Manager, open the ad and find URL parameters, under Tracking.
  2. Paste the URL parameters into URL parameters.
  3. Publish the ad. When somebody clicks it, Meta replaces each name in braces with the real one.

For a campaign called Winter sale 2026, Came from then reads Facebook: Winter sale 2026, or Instagram: Winter sale 2026 when the ad ran on Instagram. The ad's own name travels in utm_content, which the Came From card lists with the other tags and the CSV exports as its own column.

An ad that opens WhatsApp or Instagram needs no URL parameters. Meta sends the ad's details with the conversation: its headline, ID and link on WhatsApp, and its title, ID and picture on Instagram. Instagram never sends a link to the ad, and it sends the details after the ad's post, which opens the conversation and reads Opened your ad in the transcript.

Tag Your Google Ads#

Google Ads fills in the keyword a visitor searched, and it has no tag for a campaign's name. To see campaign names, give each campaign its name as a custom parameter, and use this tracking template:

{lpurl}?utm_source=google&utm_medium=cpc&utm_campaign={_campaign}&utm_term={keyword}
  1. In Google Ads, open Admin, then Account settings, then Tracking.
  2. Paste the tracking template into Tracking template, then click Save.
  3. Open a campaign's settings, then Campaign URL options, and add a custom parameter named campaign, which the template reads as {_campaign}. Set its value to the campaign's name, such as winter_sale.
  4. Repeat step 3 for every campaign.

Came from then reads Google: winter_sale for a visitor from that campaign. A campaign without the custom parameter shows the keyword instead, such as Google keyword: website design cape town. Both arrive in the CSV, in utm_campaign and utm_term.

If your ads' final URLs already contain a ?, put the same tags, without {lpurl}?, in Final URL suffix in the same Tracking settings instead. Microsoft Advertising takes the same tracking template with utm_source=bing, which Came from reads as Microsoft.

For a link in a newsletter, in a social post or behind a QR code that opens your website, add the tags to the address yourself:

https://fynbosweb.example/winter?utm_source=newsletter&utm_medium=email&utm_campaign=October+news

Came from reads that as Newsletter: October news: the source with a capital first letter, then the campaign. A link that carries utm_source and no other tag reads as the place it came from, such as From newsletter, and names no campaign.

What Each Channel Sends#

A WhatsApp or Instagram conversation names its ad only when Meta sends the details. What each channel sends:

  • WhatsApp. WhatsApp says which ad brought someone only when they tap a Meta ad that opens WhatsApp. A Google ad, a QR code, a website button or a wa.me link passes nothing on, so those conversations show WhatsApp alone. For a catalogue product, WhatsApp sends its code, not its name or price.
  • Instagram. Instagram says which ad, story or tagged ig.me link brought someone. For an ad it sends the title and picture, never its text or a link. Instagram does not allow a copy of a visitor's own story to be kept, so a mention shows only that it happened.
  • Web Chat. UTM tags in the link name the campaign. Facebook and Instagram mark every link tapped in their apps, so a link from them may or may not be an ad. Chatleadr keeps only the address of the site a visitor came from, not the page or the search.

Came from keeps a conversation's first ad. When a visitor taps a second ad later in the same chat, the first one stays.

When a conversation opens with Meta's ready-made ad message, Hello! Can I get more info on this?, and Meta sent no details of the ad, Came from reads Meta ad with no headline, and a note on the card says Meta sent no details of the ad.

The ad's picture on the card is a copy Chatleadr saved when the message arrived, so it stays on the lead after Meta's own link to the picture stops working.

Keep Your Site on the Current Widget#

A caching or speed plugin that minifies or combines JavaScript can keep its own copy of the chat widget's script, app.js, and go on serving that copy after Chatleadr updates the widget. An old copy cannot report a Google ad whose link had no UTM tags, or the website that sent a visitor, and it misses every later fix to the widget.

The Chatleadr WordPress plugin loads the script from Chatleadr each time a page opens, so a caching plugin cannot keep a copy of it. A site where you pasted the snippet into a theme, a page builder or a footer setting can be affected. To keep that site on the current widget:

  1. Open your caching or speed plugin's JavaScript settings.
  2. Add chat.chatleadr.com/widget/app.js to the files it must not minify or combine. In WP Rocket, the list is Excluded JavaScript Files, under File Optimization.
  3. Clear the plugin's cache.

To check, open a page of your site, view the page source, and search for widget/app.js. Visitors load the current widget when that address starts with https://chat.chatleadr.com. An address on your own site, such as one under /wp-content/cache/, is the plugin's copy.

Common Questions#

Why Does a Lead From My Ad Show Only WhatsApp?#

Meta sends an ad's details only when somebody taps a Meta ad that opens WhatsApp, and only with their first message after that tap. A Google ad, a QR code, a button on your website and a wa.me link pass nothing on, so a conversation that started from one of them shows the channel alone.

Does the Lead Email Say Where the Lead Came From?#

Yes. The lead email and the ClickUp task carry the lead's channel and, when more than the channel is known, its Came from line, in the same words as the Leads page.

Why Do Older Leads Show Less?#

Chatleadr records ads, stories and the page a visitor landed on from 20 Oct 2026, so an older lead or conversation can show less. An older web conversation shows the page of its first message, and a campaign or source when the address of a page the visitor chatted on carried UTM tags. An older WhatsApp or Instagram conversation shows its channel, or the first Meta ad behind it without that ad's text or picture.

Does Chatleadr Keep the Click ID From an Ad?#

No. For a visitor whose link carried an ad network's click code, Chatleadr records which network it was, such as Google, and never the code itself.