# Tracked links

> Create one WhatsApp link per agent, paste it everywhere, and read on each lead whether it came from Instagram, TikTok, your website or a QR code.

Source: https://docs.whatsetter.com/dashboard/tracked-links/

A tracked link opens WhatsApp on your agent's number, with a message already
written. When someone clicks it, WhatSetter notes where they came from before
WhatsApp opens. The conversation that starts keeps that origin, and you see it
on the lead.

## What a tracked link is

Open **Links** in the menu, under **Reach out**. A link is a short address,
such as `app.whatsetter.com/l/julia`, that opens WhatsApp on one agent's
number with a message already written. The person sends the message and your
agent answers.

One link per agent is enough. Paste the same link in your Instagram bio,
under your TikTok videos, on your website: the platform is read at the moment
of the click, never from the message. Each lead then arrives with its origin.

A link is one of three ways a contact reaches an agent. With a link, the
person writes first. With a [form](/dashboard/forms/), the person leaves a
number and the agent writes first. With a [list](/dashboard/lists/), you bring
the contacts.

## Create a link

1. Open **Links** and click **New link**, or **Create my first link** on an empty page.
2. Pick the **Agent who replies**. Only an agent with a WhatsApp number can be picked.
3. Edit the **Message already written** if you want, 1,000 characters at most. The person can change it before sending.
4. Give the link a **Name (only you see it)** and a **Link address**: lowercase letters, digits and dashes. **Available** confirms that the address is free.
5. Click **Create the link**.

The right side shows what the person will see in WhatsApp. The window then
turns into "Your link is ready", with every way to share it. When no agent
has a number, the window offers **Connect a number** first: see
[Connect WhatsApp](/getting-started/connect-whatsapp/).

## What the person sees when they click

When someone taps your link, WhatsApp opens on your agent's chat with your
message already written in the typing field. They tap Send, and the agent
answers. They can change the text first: it plays no part in reading the
origin.

- The link always opens the number the agent has today. If you give the agent another number, the link keeps working.
- If the link is paused, or the agent has no number, the person lands on a page, written in English, saying that the link is not active.
- If the agent's number is disconnected, WhatsApp still opens, but nobody answers until you reconnect.

To check it yourself, open the link in **Links** and click the
**Test in WhatsApp** icon next to its address. Your own test counts as a
click, read as **Direct link**.

## Share a link in a bio, a post or a page

Open **Links** and click a link: the **Share** section shows its address with
a **Copy** button. Each line of the **Links** page has **Copy** too.

Paste that one address wherever people can tap it. These places are
recognised on their own at the click: Instagram, Facebook, TikTok, YouTube,
LinkedIn, X, Snapchat, Pinterest, a Google search, an email read in a webmail,
and any website that links to you.

The app suggests where to paste it: bio, stories and DMs on Instagram, bio and
captions on TikTok, description and pinned comment on YouTube, button, footer
or popup on a website.

Three places leave no trace on the click and have their own copy of the link
in the same **Share** section: a QR code, an email, an SMS.

## Print a link as a QR code

Open **Links**, click the link, and find **QR code** in the **Share**
section. Click **Show**: the code appears with a **Download the PNG** button.
The file is named after the address of the link.

Print it on flyers, a shop window, business cards or packaging. The person
scans it and WhatsApp opens on your agent, as with the link itself.

The QR code carries its own copy of the link, ending with `?c=qr`, so its
clicks and its leads are read as **QR code**. Do not build a QR code yourself
from the plain address: its scans would show as **Direct link**.

## Add a WhatsApp button to your website

Open **Links**, click the link, and find **Button for your website** in the
**Share** section. Click **Get the code**.

1. Choose the **Shape**: **With a label** or **Round**.
2. With a label, type the **Button label**, 40 characters at most.
3. Choose the **Position**: **Bottom right** or **Bottom left**.
4. Look at **Preview on a page**, then click **Copy the code**.
5. Paste the code before the `</body>` tag of your pages, or in an "HTML" block of your site builder.

The button stays pinned to the bottom of the page and opens WhatsApp on your
agent. The code is one HTML link with nothing else to load. Its clicks are
counted as **Website**, even when your site hides where its visitors come
from. This button replaces the former website widget.

## Use a link in an email or an SMS

Open **Links**, click the link, and look at the **Share** section. **Email**
and **SMS** each have their own **Copy** button. Use these copies in a
signature, a newsletter or a text message: an email app or an SMS leaves no
trace on the click, so the copy itself says where it comes from. It ends with
`?c=email` or `?c=sms`.

You can mark any other place the same way: add `?c=` and a name at the end of
the link, for example `?c=ads` for an advert. Accepted names: instagram,
facebook, tiktok, youtube, linkedin, x, snapchat, pinterest, google, website,
email, sms, qr, ads, other. This mark wins over what is read on the click.

## How the origin of a click is recognised

For every link created on the **Links** page, the origin is read on the
click, in this order:

1. the copy of the link that was used: QR code, email, SMS, website button, or your own `?c=` mark;
2. the app the person is in: Instagram, Facebook, TikTok, LinkedIn, Snapchat, Pinterest, X and YouTube open links in their own browser, which says who it is;
3. the site the person comes from: a social network, a Google search, a webmail, or any other website, read as **Website**;
4. otherwise **Direct link**: the address was typed, pasted, or opened from an app that says nothing.

The message already written plays no part. The previews that Instagram,
Facebook or WhatsApp build when you paste the link somewhere are not counted
as clicks, and neither are robots.

## Read the Links page

Open **Links**. The top line counts your links, their clicks and their leads
since they were created. Each link is one line:

| Column | Meaning |
|---|---|
| **Link** | Its name and its address. |
| **Agent** | The agent that answers. |
| **Clicks** | Clicks since the link was created. |
| **Leads** | People who wrote after a click. Click the number to open them in Leads. |
| **Qualified** | Those leads that your agent qualified. |
| **Status** | **Active**, **Paused**, **No number** or **Agent disconnected**. |

Links that lead nowhere come first. Under the table,
**Where your clicks come from** covers the last 30 days for all your links:
clicks, leads and qualified leads, then one bar per platform. Past 1,000
clicks, the split is computed on the latest 1,000. The page lists up to 100
links, and a search box appears above 5 links.

## Read the results of one link

Open **Links** and click a link. The **Results** section counts, since the
link was created: **Clicks**, **Leads**, **Qualified** and **Conversion**,
the share of clicks that became leads. **See the leads** opens Leads filtered
on this link.

Below, **Clicks over 30 days** draws one bar per day, then the devices
(iPhone, Android, computer) and the countries with the most clicks.
**Where the clicks come from** splits clicks and leads by platform.

The 30-day part reads the latest 500 clicks: past that, the panel says
"Showing the latest 500 clicks." The totals since creation stay exact. The
top of the panel also says when the last click happened.

## Find the origin on each lead

The origin of a lead shows in four places:

- In [Leads](/dashboard/leads/), open a lead. The **About** section has a line **Comes from**, for example "Instagram · Bio Insta": the platform, then the name of the link. Click it to open that link.
- In the Leads table, the **Origin** column is hidden at first. Click **Display**, then tick **Origin** under **Columns**.
- To filter, click **Filter**, then **Origin**, and pick a platform. From a link, **See the leads** filters on that link alone.
- In [Conversations](/dashboard/conversations/), the details of the lead show the same **Comes from** line.

Origins other than links exist: **List**, **Via API**, **Wrote in** (the
person wrote without clicking a link) and **Added by hand**. A dash means the
origin is unknown. The origin was called the source before.

## Why a lead shows a probable origin

In Leads and in Conversations, the origin of a lead is certain or probable. A
probable origin ends with the word "probable" and has a dotted outline.

When a new person writes to your agent, WhatSetter looks at the clicks on
that agent's links during the 45 minutes before:

- one click, or several clicks from the same platform: the origin is certain;
- clicks from several platforms: when only one of them was clicked from the lead's own country, WhatSetter keeps that one and the origin stays certain;
- otherwise it keeps the most recent click and marks the origin as probable.

A dedicated number per channel makes every origin certain: the clicks of two
channels never mix.

## Why a lead shows Direct link or Wrote in

In Leads, the **Comes from** line of a lead can read one of these two origins:

- **Direct link**: the person clicked your link, but nothing said where from. It happens when the link is opened in a plain browser from an email app, an SMS, or a QR code built without the copies of the **Share** section.
- **Wrote in**: the person wrote to your number and no click on your links was found in the 45 minutes before. A plain wa.me link, or your number typed by hand, produces no click, so no origin.

A lead that already has an origin keeps it: a later click never replaces it.
A lead that had none takes the origin of its click.

A person who comes from an advert that opens WhatsApp directly is recognised
without any link, as **Instagram**, **Facebook** or **Ads**.

A link carries one written message. For the same channel on two accounts,
create two links.

## Change the message, the agent or the address of a link

Open **Links** and click the link.

- **Message already written**: edit the text. The preview under it shows what the person sees.
- **Settings**: change the **Name (only you see it)**, the **Agent who answers** (it must have a number) and the **Link address**.

Click **Save** at the bottom of the panel, or **Cancel** to drop your
changes. Clicks and leads already counted stay on the link.

> **Changing the address breaks the link**
The **Link address** is part of the link. Change it and every copy you
already pasted or printed stops working.

## Pause or delete a link

Open **Links**, click the link, and go to **Settings**.

- To pause, switch **Link active** off and confirm with **Pause**. People who click land on a "link unavailable" page until you switch it back on. The status reads **Paused**.
- To delete, click **Delete the link** at the bottom of the panel, then **Delete**. The link stops working right away. Leads already attributed keep their origin.

A deleted link cannot be restored, and its address becomes free again. Prefer
a pause when printed QR codes or old posts still point to the link.

## Why a link shows No number or Agent disconnected

On the **Links** page, two statuses mean that clicks lead nowhere. These
links come first in the list.

- **No number**: the agent has no WhatsApp number. People who click land on a "link unavailable" page. Open the link and click **Connect a number**.
- **Agent disconnected**: the agent's number is disconnected. WhatsApp opens and the person can send the message, but nobody answers. Open the link and click **Reconnect**.

**Paused** means that you switched the link off yourself. **Active** means
that a click opens WhatsApp on a connected number. It does not check the agent
itself: a link to an agent you paused, or to a draft, still reads **Active**,
and the agent does not answer until you switch it on. See
[Agents](/dashboard/agents/). When a line reads "Deleted
agent", open the link and choose another agent under **Agent who answers**.

## Links that lead to a WhatsApp group

A team with an agent that follows WhatsApp groups sees two kinds at the top
of **Links**: **To an agent**, the links of this page, and **To a group**.

A link to a group is an address of yours, ending with `/join/` and a name.
Whoever opens it is sent to one of your WhatsApp groups, and you can point it
to another group later without changing the address. Each line shows the
group it leads to, its clicks and a status: **Active**, **No group** (the link
leads nowhere until you choose a group) or **Paused**.

Seeing these links needs the right **See the groups**, and creating one needs
**Manage and import groups**. More in [WhatsApp groups](/dashboard/groups/).

## Who can create and see links

The **Links** entry of the menu and its page show only for people who have
the right **Connect tools (calendar, links, Instagram)**. **Owner** and
**Admin** have it. The other roles do not, unless you give them that right in
a **Custom** role.

The same right is needed to create, change, pause and delete a link. The
origin of a lead, on the other hand, is visible to everyone who can open that
lead in Leads or in Conversations.

Roles and rights are set in [Team](/dashboard/team/).

## Related

- [Forms](/dashboard/forms/)
- [Lists & import](/dashboard/lists/)
- [Leads & CRM](/dashboard/leads/)
- [API: tracked links](/developers/guides/links/)
