Webhooks

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

Cas d'usage

• Plateformes d'automatisation : Déclenchez des workflows dans Make ou Zapier quand les liens sont cliqués
• Analytique personnalisée : Envoyez les données de clic à votre propre système d'analytique
• Mises à jour CRM : Mettez à jour les enregistrements clients quand ils cliquent sur les liens
• Notifications Slack : Recevez une notification dans Slack quand les liens importants sont cliqués
• Suivi des prospects : Suivez quand 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 les webhooks, sans code requis.

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

Contenu du webhook

Quand un clic se produit, Linkly envoie une requête POST avec le contenu 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 contenu

Informations d'événement

Objet Lien

Objet Clic

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

Intégrations 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 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

Plusieurs webhooks

Vous pouvez ajouter plusieurs URL de webhook (une par ligne). Toutes les URL recevront le même contenu quand 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 atteindront toujours leur destination
• Assurez-vous que votre endpoint webhook répond rapidement (< 5 secondes recommandé)

Sécurité

• Utilisez les 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

Tests

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 contenu 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 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.