Webhooks

Les webhooks vous permettent de recevoir des notifications en temps réel sur vos liens — à la fois lorsqu'ils sont cliqués et lorsqu'ils sont créés, mis à jour ou supprimés. Linkly envoie une requête POST à votre URL spécifiée avec des informations détaillées sur chaque événement.

Cas d'usage

  • Plateformes d'automatisation : Déclenchez des workflows dans Make ou Zapier lorsque des liens sont cliqués
  • Analyses personnalisées : Envoyez les données de clic à votre propre système d'analyse
  • Mises à jour CRM : Mettez à jour les enregistrements clients lorsqu'ils cliquent sur des liens
  • Notifications Slack : Recevez des notifications dans Slack lorsque des liens importants sont cliqués
  • Suivi des prospects : Suivez lorsque les prospects interagissent avec vos liens

Conseil : Pour la plupart des cas d'usage d'automatisation, notre intégration Make ou notre intégration Zapier sont plus faciles à configurer que les webhooks personnalisés. Elles incluent des déclencheurs de clic instantanés alimentés par des webhooks, sans codage requis.

Comment configurer les webhooks au niveau du lien

1

Accédez à Liens et cliquez sur le lien que vous souhaitez configurer.

2

Faites défiler jusqu'à la section Webhooks.

3

Entrez votre ou vos URL de webhook, une par ligne.

Vous pouvez ajouter plusieurs URL de webhook. Toutes les URL recevront la même charge utile lorsque le lien est cliqué.

Entrez votre ou vos URL de webhook, une par ligne.
Entrez votre ou vos URL de webhook, une par ligne.
4

Cliquez sur Enregistrer.

Les webhooks au niveau du lien se déclenchent uniquement lorsque ce lien spécifique est cliqué.

Comment configurer les webhooks au niveau de l'espace de travail

1

Accédez à Paramètres (icône d'engrenage dans la barre latérale).

2

Cliquez sur Paramètres de l'espace de travail

3

Entrez votre ou vos URL de webhook, une par ligne.

Vous pouvez ajouter plusieurs URL de webhook. Toutes les URL recevront la même charge utile lorsqu'un lien de votre espace de travail est cliqué.

Entrez votre ou vos URL de webhook, une par ligne.
Entrez votre ou vos URL de webhook, une par ligne.
4

Cliquez sur Enregistrer les paramètres.

Les webhooks au niveau de l'espace de travail se déclenchent pour chaque clic sur n'importe quel lien de votre espace de travail.

Remarque : Si vous configurez des webhooks aux deux niveaux, les deux se déclencheront pour les clics sur ce lien.

Événements

Chaque webhook reçoit tous les types d'événements pour sa portée — un webhook au niveau du lien reçoit les événements pour ce lien, un webhook au niveau de l'espace de travail reçoit les événements pour chaque lien de l'espace de travail. Vérifiez le champ event de haut niveau pour les distinguer :

eventEnvoyé lorsque
clickUn lien court est cliqué. Inclut un objet click avec les données de la requête du visiteur.
link.createdUn nouveau lien est créé dans l'espace de travail.
link.updatedLes paramètres d'un lien changent. Se déclenche à chaque mise à jour, y compris les éditions enregistrées automatiquement, donc vous pouvez en recevoir plusieurs par session d'édition.
link.deletedUn lien est supprimé. L'objet link conserve le slug et le domaine qu'il avait avant la suppression.

Charge utile du webhook

Charge utile de clic

Lorsqu'un clic se produit, Linkly envoie une requête POST avec la charge utile JSON suivante :

{
  "event": "click",
  "timestamp": "2025-01-15T10:30:00Z",
  "link": {
    "id": 12345,
    "name": "My Campaign Link",
    "url": "https://example.com/landing-page",
    "full_url": "https://yourdomain.com/abc123",
    "domain": "yourdomain.com",
    "slug": "/abc123",
    "metadata": {
      "order_id": "A-10293",
      "crm_contact_id": "3f2b8c1e-9a47-4d0e-b6a5-1c2d3e4f5a6b"
    },
    "destination": "https://example.com/landing-page",
    "workspace_id": 1,
    "enabled": true,
    "cloaking": false,
    "forward_params": true,
    "block_bots": true,
    "public_analytics": false,
    "utm_source": "newsletter",
    "utm_medium": "email",
    "utm_campaign": "spring-sale",
    "og_title": "Special Offer",
    "og_description": "Check out our spring sale!",
    "rules": [
      {
        "what": "country",
        "matches": "US",
        "url": "https://example.com/us-landing"
      }
    ]
  },
  "click": {
    "id": "01KYPGEEPJSPR3S564QRBDGA1W",
    "country": "US",
    "is_eu_country": false,
    "platform": "desktop",
    "browser_name": "Chrome",
    "referer": "https://twitter.com/",
    "isp": "Comcast",
    "bot_name": null,
    "destination": "https://example.com/landing-page",
    "params": {
      "utm_source": "twitter"
    }
  }
}

Champs de la charge utile

Informations sur l'événement

ChampDescription
eventclick, link.created, link.updated, ou link.deleted
timestampHorodatage ISO 8601 du clic

Objet lien

ChampDescription
idIdentifiant unique du lien
nameSurnom du lien
urlURL de destination d'origine
full_urlL'URL du lien court
domainDomaine personnalisé (s'il est configuré)
slugChemin/slug de l'URL
metadataVos propres données clé-valeur attachées au lien, par exemple les ID de votre propre système. Toujours un objet, vide s'il n'est pas défini. Voir métadonnées du lien
destinationDestination réelle pour ce clic (peut différer de url si des règles s'appliquent)
workspace_idIdentifiant de l'espace de travail
enabledSi le lien est actif
rulesTableau des règles de redirection (géo, appareil, rotateur)
utm_*Paramètres UTM s'ils sont configurés
og_*Paramètres Open Graph s'ils sont configurés

Objet clic

ChampDescription
idIdentifiant unique pour ce clic, un ULID de 26 caractères. Les caractères de début codent l'heure du clic, les ID se trient donc chronologiquement sous forme de chaînes brutes
countryCode de pays à deux lettres (par ex., « US », « GB »)
is_eu_countrySi le clic provient de l'UE
platformPlateforme d'appareil (desktop, ios, android, etc.)
browser_nameNom du navigateur (Chrome, Safari, Firefox, etc.)
refererURL de référence (si disponible)
ispFournisseur d'accès à Internet
bot_nameIdentifiant de bot (null pour les clics humains)
destinationURL de destination finale pour ce clic
paramsParamètres de requête transmis au lien

Remarque sur la confidentialité : Les adresses IP ne sont jamais incluses dans les charges utiles des webhooks.

Charge utile du cycle de vie du lien

Les événements link.created, link.updated et link.deleted partagent la même forme. Il n'y a pas d'objet click — vous obtenez l'event, un timestamp et le link complet :

{
  "event": "link.created",
  "timestamp": "2026-06-20T10:30:00Z",
  "link": {
    "id": 12345,
    "name": "My Campaign Link",
    "url": "https://example.com/landing-page",
    "full_url": "https://yourdomain.com/abc123",
    "domain": "yourdomain.com",
    "slug": "/abc123",
    "workspace_id": 1,
    "enabled": true,
    "metadata": {
      "order_id": "A-10293"
    },
    "rules": []
  }
}

Intégrations de plateformes d'automatisation

Pour une configuration plus facile sans codage personnalisé, utilisez nos intégrations natives :

Les deux intégrations utilisent des webhooks en arrière-plan mais gèrent toute la configuration automatiquement.

Meilleures pratiques

Plusieurs webhooks

Vous pouvez ajouter plusieurs URL de webhook (une par ligne). Toutes les URL recevront la même charge utile lorsqu'un clic se produit.

Gestion des erreurs

  • Les webhooks sont fire-and-forget - Linkly ne réessaye pas les livraisons échouées
  • Les défaillances de webhook n'affectent jamais la redirection - les utilisateurs atteignent toujours leur destination
  • Assurez-vous que votre point de terminaison webhook répond rapidement (< 5 secondes recommandées)

Sécurité

  • Utilisez des points de terminaison HTTPS pour les URL de webhook
  • Validez les requêtes entrantes dans votre gestionnaire de webhook
  • Envisagez d'ajouter un paramètre secret à votre URL de webhook pour vérification

Test

  1. 1
    Configurez une URL de webhook à l'aide d'un service comme webhook.site ou RequestBin
  2. 2
    Cliquez sur votre lien
  3. 3
    Inspectez la charge utile reçue
  4. 4
    Une fois vérifiée, passez à votre URL de webhook de production

Accès à l'API

Vous pouvez également gérer les webhooks par programmation via l'API :

POST   /api/v1/link/:link_id/webhooks
DELETE /api/v1/link/:link_id/webhooks/:hook_id
GET    /api/v1/link/:link_id/webhooks

POST   /api/v1/workspace/:workspace_id/webhooks
DELETE /api/v1/workspace/:workspace_id/webhooks/:hook_id
GET    /api/v1/workspace/:workspace_id/webhooks

Voir la Documentation API pour plus de détails.

FAQ sur les webhooks

Quels événements les webhooks peuvent-ils envoyer ?

Les webhooks se déclenchent sur quatre événements, identifiés par le champ event dans la charge utile. Vous obtenez click lorsqu'un lien est cliqué, plus link.created, link.updated et link.deleted lorsque les liens changent. Chaque webhook reçoit tous les types d'événements pour sa portée, alors divisez selon le champ event pour traiter chacun.

Pourquoi mes webhooks ne se déclenchent-ils pas ?

Vérifiez que votre URL de webhook est valide et accessible, et que les webhooks sont enregistrés sur le lien ou l'espace de travail. Pour les événements de clic, notez que les webhooks se déclenchent uniquement lorsqu'un clic est réellement enregistré - les IP exclues ou les robots ignorés ne les déclencheront pas.

Pourquoi certains champs sont-ils null dans la charge utile du webhook ?

Certains champs peuvent être null si l'information n'était pas disponible (par ex., pas de référent), les paramètres de confidentialité ont empêché la collecte, ou le clic provenait d'un bot (auquel cas bot_name sera rempli à la place).

Linkly réessaye-t-il les livraisons de webhooks échouées ?

Non. Les webhooks sont fire-and-forget. Les livraisons échouées ne sont pas réessayées, et Linkly ne suit pas l'état de livraison des webhooks. Les requêtes de webhook expirent après 5 secondes.

Linkly supporte-t-il les postbacks pour le suivi des conversions ?

Non. Les webhooks Linkly sont sortants uniquement et se déclenchent lorsque des clics se produisent. Nous ne pouvons pas recevoir les données de postback des réseaux d'affiliation ou des plateformes publicitaires. Pour le suivi des conversions, utilisez le suivi natif de la plateforme de destination, transmettez un ID de clic via la transmission de paramètres de requête, ou utilisez notre intégration BigQuery pour joindre les données de clic à vos données de conversion.

Dois-je utiliser des webhooks ou Make/Zapier ?

Pour la plupart des cas d'usage d'automatisation, nos intégrations Make ou Zapier sont plus faciles à configurer. Elles utilisent des webhooks en arrière-plan mais gèrent toute la configuration automatiquement. Utilisez les webhooks personnalisés lorsque vous devez envoyer des données à vos propres systèmes ou que vous avez besoin de plus de contrôle sur l'intégration.

Puis-je avoir des webhooks à la fois sur un lien et l'espace de travail ?

Oui. Si vous configurez des webhooks aux deux niveaux, les deux se déclencheront lorsque ce lien est cliqué. C'est utile si vous voulez une journalisation à l'échelle de l'espace de travail plus des actions spécifiques pour certains liens.

Qui peut configurer les webhooks ?

Les webhooks sur un seul lien nécessitent le rôle Écriture ou supérieur. Les webhooks de l'espace de travail nécessitent le rôle Admin ou Propriétaire. Voir rôles et permissions des utilisateurs.

Disponibilité du forfait

Disponible sur Business et supérieur

Comparer les forfaits →

Obtenez 100 liens courts et suivez 500 clics mensuels gratuitement.