Webhooks — les clics sur vos liens en temps réel sur votre serveur

Pourquoi utiliser les webhooks

Recevez les données de clic à l'instant même et construisez vos propres workflows dessus

Temps réel

Les événements arrivent au moment du clic. Plus besoin d'interroger l'API selon un planning et d'attendre les mises à jour.

Les données de chaque clic

Pays, ville, appareil, système d'exploitation, navigateur, référent et indicateur de bot — tout ce qu'il faut pour vos propres analyses.

Sécurisé par défaut

Chaque requête est signée en HMAC avec votre propre secret, ce qui permet de distinguer facilement les vrais événements des faux.

Livraison fiable

Si votre serveur est injoignable, la livraison est réessayée. Toutes les tentatives et leurs statuts sont visibles dans le journal de livraison.

Cas d'usage

Où les événements de clic sont généralement envoyés

Votre propre analytique ou CRM

Enregistrez chaque clic dans votre propre base de données ou CRM et construisez des rapports exactement comme vous le souhaitez.

Notifications dans un chat

Faites en sorte qu'un bot Telegram, Slack ou Discord vous informe instantanément des nouveaux clics, sans vérification manuelle.

Automatisation

Déclenchez des scénarios dans Zapier, Make ou n8n : un événement de clic devient le déclencheur de n'importe quelle action.

Ce que contient un webhook

L'événement redirects.batch : un seul payload regroupe un lot de clics sur une fenêtre de temps

{
  "delivery_id": "d_01HXY9F0…",
  "event_type": "redirects.batch",
  "sent_at": "2026-08-04T10:15:00Z",
  "window": { "from": "…10:14:00Z", "to": "…10:15:00Z" },
  "count": 1,
  "truncated": false,
  "events": [
    {
      "event_id":   "e_9f86d0…",
      "link_id":    9053352,
      "datetime":   "2026-08-04T10:14:12Z",
      "country":    "DE",
      "city":       "Berlin",
      "browser":    "Chrome",
      "os":         "Android",
      "device":     "mobile",
      "ref_domain": "t.me",
      "group_id":   null,
      "is_bot":     false
    }
  ]
}

L'adresse IP du visiteur n'est pas incluse par défaut (données personnelles) — elle n'est ajoutée que si vous l'activez explicitement pour cet endpoint.

Ce que permettent les webhooks

Une configuration flexible, une sécurité solide et une livraison prévisible

Livraison des événements par lots

Les clics arrivent regroupés (redirects.batch) sur une fenêtre de temps — cela économise des requêtes vers votre serveur.

Une portée à votre convenance

Tous les liens du compte, un groupe précis ou un seul lien — ne recevez que les événements dont vous avez besoin.

Signature HMAC

Chaque requête est signée avec votre secret. Vous pouvez régénérer ce secret à tout moment.

Réessais et désactivation automatique

Un serveur injoignable déclenche des réessais ; un endpoint durablement mort est automatiquement désactivé.

Journal de livraison

Un historique de tous les envois, avec statuts et contenu — pratique pour retrouver la cause d'un problème.

Envoi de test (ping)

Validez votre intégration en un clic avant tout trafic réel — votre serveur reçoit un événement de test.

Des données riches par événement

link_id, horodatage, pays, ville, système d'exploitation, appareil, navigateur, référent et indicateur de bot pour chaque clic.

Confidentialité par défaut

L'adresse IP n'est envoyée que si vous l'activez explicitement pour un endpoint donné.

Essayer gratuitement

Comment configurer un webhook

Cinq étapes — de l'URL de votre serveur à un flux continu d'événements de clic

1

Créez un endpoint

Inscrivez-vous sur Lix.li, ouvrez la section Webhooks et indiquez l'URL de votre serveur — c'est là que Lix.li enverra les événements de clic.

2

Choisissez la portée

Décidez pour quels liens vous voulez recevoir des événements : tous les liens du compte, un groupe précis ou un seul lien.

3

Enregistrez le secret de signature

Lix.li vous fournit une clé secrète. Chaque requête est signée en HMAC — vérifiez la signature dans l'en-tête pour confirmer que l'événement provient bien de Lix.li.

4

Envoyez une requête de test

Cliquez sur « Tester » (ping) et vérifiez que votre serveur accepte la requête et répond par un 2xx. Vous validez ainsi l'intégration avant l'arrivée du trafic réel.

5

Surveillez le journal de livraison

Le journal affiche tous les envois, leurs statuts et les réessais. Si le serveur est injoignable, la livraison est réessayée, et un endpoint durablement mort est automatiquement désactivé.

Configurer un webhook

Questions fréquentes sur les webhooks

Qu'est-ce qu'un webhook ?

Un webhook est une notification HTTP que Lix.li envoie de lui-même à votre serveur dès qu'un événement se produit. Vous n'avez besoin d'interroger aucune API : les données arrivent automatiquement au moment du clic sur votre lien.

Quels événements sont envoyés ?

Les clics sur vos liens courts. Les événements arrivent par lots (event_type = redirects.batch) ; chaque clic contient l'horodatage, le pays, la ville, le système d'exploitation, l'appareil, le navigateur, le référent et un indicateur de bot.

Dans quel format les données arrivent-elles ?

Du JSON transmis en HTTP POST. Le corps contient des champs techniques (delivery_id, fenêtre de temps, count) ainsi qu'un tableau events avec les données de chaque clic. Un exemple complet du corps de requête figure sur cette page.

Comment vérifier qu'une requête provient bien de Lix.li ?

Chaque requête est signée en HMAC à partir de votre clé secrète — comparez la signature de l'en-tête au corps de la requête pour écarter les falsifications. Vous pouvez régénérer le secret (rotation) à tout moment.

Que se passe-t-il si mon serveur est temporairement indisponible ?

La livraison est réessayée automatiquement. Si un endpoint reste trop longtemps sans réponse, il est temporairement désactivé, et toutes les tentatives ainsi que leurs statuts restent dans le journal de livraison — rien ne se perd silencieusement.

Puis-je recevoir des événements uniquement pour certains liens ?

Oui. La portée est configurable : tous les liens du compte, les liens d'un groupe précis ou un seul lien. Vous évitez ainsi d'envoyer du trafic inutile vers votre serveur.

L'adresse IP du visiteur est-elle transmise ?

Pas par défaut, car il s'agit de données personnelles. L'IP n'est incluse dans les événements que si vous l'activez explicitement dans les paramètres de cet endpoint.

Sur quel abonnement les webhooks sont-ils disponibles ?

Les webhooks sont disponibles avec l'abonnement Premium. Inscrivez-vous et passez à Premium pour connecter votre endpoint.

Construisez vos intégrations à partir des événements de clic

Configurez un webhook en quelques minutes — et recevez les données de clic exactement là où vous en avez besoin.

Les webhooks de Lix.li permettent de recevoir automatiquement des notifications de clic pour vos liens courts. Plutôt que d'interroger une API en continu, vous indiquez l'URL de votre serveur, et Lix.li y envoie une requête HTTP POST au moment du clic. C'est le principe classique du callback HTTP appliqué aux liens courts, qui fait remonter les événements de clic vers votre système en temps réel.

Chaque corps de requête est un événement redirects.batch contenant un tableau de clics : chacun comporte l'horodatage, le pays, la ville, le navigateur, le système d'exploitation, l'appareil, le référent et un indicateur de bot. Il est facile d'injecter ces données dans votre propre base ou votre CRM, de les transformer en notifications de clic sur Telegram, Slack ou Discord, ou de les utiliser comme déclencheur dans Zapier, Make et n8n. Les requêtes sont protégées par une signature HMAC : vous comparez la signature de l'en-tête au corps pour écarter les falsifications, et vous pouvez régénérer le secret dès que nécessaire.

La livraison est prévisible : en cas de panne serveur, les événements sont réessayés, un endpoint durablement mort est temporairement désactivé, et chaque tentative apparaît dans le journal de livraison. Vous pouvez limiter la portée à tous vos liens, à un seul groupe ou à un seul lien, et valider l'intégration avec un envoi de test (ping) avant l'arrivée du trafic réel. Les webhooks fonctionnent aux côtés des liens courts Lix.li classiques, des QR codes et des statistiques, et sont disponibles avec l'abonnement Premium.