Webhooks

Les webhooks vous permettent de recevoir des notifications en temps réel concernant vos liens — à la fois lorsqu'ils sont cliqués et lorsqu'ils sont créés, mis à jour ou supprimés. Linkly envoie une demande 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éclenchez des flux de travail 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 de clients lorsqu'ils cliquent sur des liens

• Notifications Slack : Recevez une notification dans Slack lorsque des liens importants sont cliqués

• Suivi des prospects : Suivez quand les prospects interagissent avec vos liens

Conseil : Pour la plupart des cas d'utilisation en automatisation, > notre intégration Make ou > intégration Zapier sont plus faciles à > configurer que les webhooks personnalisés. Ils 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, tous > deux se déclencheront pour les clics sur ce lien.

Événements

Chaque webhook reçoit tous les types d'événements pour son étendue — un webhook au niveau des liens obtient les événements pour ce lien, un webhook au niveau de l'espace de travail obtient les événements pour chaque lien dans l'espace de travail. Vérifiez le champ event de haut niveau pour les distinguer :

Payload du webhook

Payload de clic

Lorsqu'un clic se produit, Linkly envoie une demande 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 de lien

Objet de 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 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,
    "rules": []
  }
}

Intégrations de 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 clic 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.

Meilleures pratiques

Plusieurs webhooks

Vous pouvez ajouter plusieurs URL de webhook (une par ligne). Tous 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 défaillances des webhooks n'affectent jamais la redirection - les utilisateurs atteignent toujours leur destination

• Assurez-vous que votre point de terminaison de webhook répond rapidement (< 5 secondes recommandé)

Sécurité

• Utilisez des points de terminaison HTTPS pour les URL de webhook
• Validez les demandes 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é, changez pour 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.