# Liens traqués

> Lire tes liens WhatsApp traqués et leurs statistiques de clics, et comprendre comment chaque lead reçoit sa source et son lien.

Source: https://docs.whatsetter.com/fr/developers/guides/links/

Un lien traqué, c'est une adresse courte WhatSetter (`https://app.whatsetter.com/l/insta-bio`) qui ouvre une conversation WhatsApp avec un de tes agents et enregistre le clic. L'API expose tes liens et leurs statistiques en lecture seule ; tu les crées et les modifies dans le dashboard.

## Endpoints

| Méthode | Chemin | Scope |
|---|---|---|
| GET | [`/links`](/api-reference/operations/listlinks/) | `links:read` |
| GET | [`/links/{id}`](/api-reference/operations/getlink/) | `links:read` |

## Lister les liens

**cURL**

```bash
curl "https://app.whatsetter.com/api/v1/links?status=active&limit=25" \
  -H "Authorization: Bearer ws_live_…"
```

**JavaScript**

```js
const res = await fetch('https://app.whatsetter.com/api/v1/links?status=active&limit=25', {
  headers: { Authorization: 'Bearer ws_live_…' },
});
const { data: links, pagination } = await res.json();
```

**Python**

```python
import requests

r = requests.get(
    "https://app.whatsetter.com/api/v1/links",
    params={"status": "active", "limit": 25},
    headers={"Authorization": "Bearer ws_live_…"},
)
links = r.json()["data"]
```

```json
{
  "data": [
    {
      "id": "66f1a2b3c4d5e6f7a8b9c0f1",
      "slug": "insta-bio",
      "name": "Bio Instagram",
      "url": "https://app.whatsetter.com/l/insta-bio",
      "campaign_id": "acme-france-1-ab12",
      "status": "active",
      "channel": "auto",
      "clicks": 128,
      "last_click_at": "2026-09-18T10:00:00.000Z",
      "created_at": "2026-09-01T08:00:00.000Z"
    }
  ],
  "pagination": { "has_more": false, "next_cursor": null }
}
```

| Paramètre | Effet |
|---|---|
| `campaign_id` | Le slug de la campagne ou son `id`. |
| `status` | `active` ou `inactive`. |
| `limit`, `cursor` | Pagination. |

| Champ | Signification |
|---|---|
| `url` | L'adresse à partager. |
| `campaign_id` | La campagne (et donc le numéro WhatsApp) que le lien ouvre. |
| `channel` | `auto` quand la plateforme est lue à chaque clic, ou une plateforme forcée. |
| `clicks` | Total des clics depuis la création. Les robots d'aperçu et les crawlers ne sont pas comptés. |

## Lire un lien avec ses statistiques sur 30 jours

**cURL**

```bash
curl "https://app.whatsetter.com/api/v1/links/66f1a2b3c4d5e6f7a8b9c0f1" \
  -H "Authorization: Bearer ws_live_…"
```

**JavaScript**

```js
const res = await fetch('https://app.whatsetter.com/api/v1/links/66f1a2b3c4d5e6f7a8b9c0f1', {
  headers: { Authorization: 'Bearer ws_live_…' },
});
const { data: link } = await res.json();
```

**Python**

```python
import requests

r = requests.get(
    "https://app.whatsetter.com/api/v1/links/66f1a2b3c4d5e6f7a8b9c0f1",
    headers={"Authorization": "Bearer ws_live_…"},
)
link = r.json()["data"]
```

```json
{
  "data": {
    "id": "66f1a2b3c4d5e6f7a8b9c0f1",
    "slug": "insta-bio",
    "name": "Bio Instagram",
    "url": "https://app.whatsetter.com/l/insta-bio",
    "campaign_id": "acme-france-1-ab12",
    "status": "active",
    "channel": "auto",
    "clicks": 128,
    "last_click_at": "2026-09-18T10:00:00.000Z",
    "created_at": "2026-09-01T08:00:00.000Z",
    "stats_30d": {
      "clicks": 128,
      "by_channel": { "instagram": 90, "tiktok": 30, "direct": 8 },
      "leads": 41,
      "qualified": 12
    }
  }
}
```

`stats_30d` contient les mêmes chiffres que le tiroir du lien dans le dashboard : les clics des 30 derniers jours, ventilés par plateforme lue au clic, plus les conversations que le lien a amenées et combien ont été qualifiées.

## Comment marche l'attribution

La plateforme est lue **au moment du clic**, jamais devinée dans le message : l'application depuis laquelle le lien a été ouvert (Instagram, TikTok, LinkedIn…), le referrer, ou la variante du lien que tu as partagée (`?c=qr`, `?c=email`, `?c=sms` pour les supports muets), sinon `direct`. Quand la personne écrit ensuite au numéro, WhatSetter regarde les clics sur les liens de ce numéro dans les 45 dernières minutes. Un seul clic, ou des clics d'une seule plateforme, donne une attribution **certaine** ; plusieurs plateformes dans la fenêtre donnent le clic le plus récent depuis le pays de la personne, marqué **probable**. Un message qui porte un signal publicitaire Meta est attribué à la pub, certain, sans aucun lien. Aucun clic du tout signifie que la personne a écrit spontanément : `inbound`.

Chaque lead porte ensuite `source` (la plateforme), `tracked_link_id` (l'`id` de ce lien) et `source_confidence` (`certain` ou `probable`). Filtre-les avec [`GET /leads?tracked_link_id=`](/fr/developers/guides/leads/) ou `?source=instagram`.

## Les erreurs que tu rencontreras

| HTTP | `code` | Quand |
|---|---|---|
| 401 | `missing_api_key`, `invalid_api_key` | Clé absente, inconnue ou révoquée. |
| 403 | `insufficient_scope` | La clé n'a pas `links:read`. |
| 404 | `not_found` | Lien inconnu, ou lien d'un autre espace de travail. |
| 422 | `validation_error` | `status` inconnu, curseur invalide. |
| 429 | `rate_limited` | Trop de requêtes cette minute. Respecte `Retry-After`. |

## Voir aussi

- [Leads : filtrer par source et par lien](/fr/developers/guides/leads/)
- [Campagnes](/fr/developers/guides/campaigns/)
- [Liens traqués dans le dashboard](/fr/dashboard/tracked-links/)
