Webhooks

Les webhooks vous permettent de recevoir des notifications en temps réel lorsque vos liens sont cliqués. Lorsqu'un clic se produit, Linkly envoie une requête POST à votre ou vos URL spécifiées avec des informations détaillées sur le clic.

• 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 clics vers votre propre système d'analyse
• Mises à jour CRM : Mettez à jour les dossiers 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 l'engagement de vos prospects avec vos liens

Astuce : Pour la plupart des cas d'usage en automatisation, notre intégration Make ou intégration Zapier sont plus faciles à configurer que des webhooks personnalisés. Elles incluent des déclencheurs de clics instantanés alimentés par des webhooks, sans programmation requise.

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

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",
    "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"
    }
  }
}

Note de confidentialité : Les adresses IP ne sont jamais incluses dans les charges utiles des webhooks.

Pour une configuration plus facile sans programmation personnalisée, 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.

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

• Les webhooks sont à déclenchement unique - 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 point de terminaison de webhook répond rapidement (< 5 secondes recommandées)

• 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 la vérification

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

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 de l'API pour plus de détails.