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 à vos URL(s) spécifiée(s) 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 les 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 client lorsqu'ils cliquent sur les liens
• Notifications Slack : Recevez une notification sur Slack lorsque les 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 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.

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 son domaine — un webhook au niveau des liens obtient les événements de ce lien, un webhook au niveau de l'espace de travail obtient les événements de chaque lien de l'espace de travail. Vérifiez le champ event du niveau supérieur pour les distinguer :

Payload du webhook

Payload de clic

Lorsqu'un clic se produit, Linkly envoie une requête POST avec le payload JSON suivant :

{
  "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",
    "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 du payload

Informations sur l'événement

Objet lien

Objet clic

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

Payload du cycle de vie du lien

Les événements link.created, link.updated et link.deleted partagent une 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,
    "rules": []
  }
}

Intégrations de plateforme d'automatisation

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

• Intégration Make - Plateforme d'automatisation visuelle avec déclencheurs de clic instantanés
• Intégration Zapier - Connectez Linkly à des milliers d'applications sans code

Les deux intégrations utilisent les webhooks sous le capot mais gèrent toute la configuration automatiquement.

Bonnes pratiques

Webhooks multiples

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

Gestion des erreurs

• Les webhooks sont tirer et oublier - Linkly ne réessaie pas les livraisons échouées
• Les défaillances des webhooks 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é)

Sécurité

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

Test

1. 1
   Configurez une URL de webhook en utilisant un service comme webhook.site ou RequestBin
2. 2
   Cliquez sur votre lien
3. 3
   Inspectez le payload reçu
4. 4
   Une fois vérifié, basculez vers votre URL de webhook de production

Accès 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

Consultez la Documentation API pour plus de détails.