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 ou vos URL spécifiées avec des informations détaillées sur chaque événement.

Cas d'usage

• Plateformes d'automatisation : Déclencher des workflows dans Make ou Zapier lorsque les liens sont cliqués
• Analyses personnalisées : Envoyer les données de clics à votre propre système d'analyse
• Mises à jour CRM : Mettre à jour les enregistrements clients lorsqu'ils cliquent sur les liens
• Notifications Slack : Recevoir des notifications dans Slack lorsque des liens importants sont cliqués
• Suivi des prospects : Suivre lorsque les prospects s'engagent 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 clics instantanés alimentés par des webhooks, sans codage requis.

Remarque : Si vous configurez des webhooks aux deux niveaux, les deux s'activeront 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 des liens 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 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": {
    "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 d'é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 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,
    "rules": []
  }
}

Intégrations avec des plateformes 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 clics instantanés
• Intégration Zapier - Connectez Linkly à des milliers d'applications sans code

Les deux intégrations utilisent des webhooks en arrière-plan 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 fire-and-forget - Linkly ne réessaie pas les livraisons échouées
• Les échecs de webhook n'affectent jamais la redirection - les utilisateurs atteignent toujours leur destination
• Assurez-vous que votre endpoint webhook répond rapidement (< 5 secondes recommandé)

Sécurité

• Utilisez des endpoints 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 la 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 le payload reçu
4. 4
   Une fois vérifié, passez à votre URL de webhook de production

Accès API

Vous pouvez également gérer les webhooks par programme 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.