Webhooks: linkkliks komen vanzelf op uw server terecht

Lix.li stuurt voor elke klik een event rechtstreeks naar uw URL via HTTP POST — realtime, HMAC-ondertekend en met betrouwbare bezorging. Geen constante API-polling meer nodig: de data komt vanzelf binnen op het moment van de klik.

Webhook instellen Bekijk het dataformaat

Realtime · HMAC-handtekening · retries en bezorglog

# Lix.li itself sends POST to your server during transitions POST https://your-server.com/hooks X-Lix-Signature: sha256=9f86d0818884… Content-Type: application/json { "event_type": "redirects.batch", "count": 2, "events": [ { "link_id": 9053352, "country": "DE", "device": "mobile" } ] }

Waarom webhooks gebruiken

Ontvang klikdata op het moment zelf en bouw er uw eigen workflows op

Realtime

Events komen binnen op het moment van de klik. Geen API meer op een schema pollen en op updates wachten.

Data bij elke klik

Land, stad, apparaat, besturingssysteem, browser, referrer en een bot-vlag — alles wat u nodig heeft voor uw eigen analyses.

Standaard veilig

Elk verzoek wordt met HMAC ondertekend met uw eigen secret, zodat u echte events makkelijk van vervalste onderscheidt.

Betrouwbare bezorging

Is uw server niet bereikbaar, dan wordt de bezorging opnieuw geprobeerd. Alle pogingen en statussen zijn zichtbaar in het bezorglog.

Toepassingen

Waar klikgebeurtenissen doorgaans naartoe worden gestuurd

Lix.li POST
Uw eigen analytics of CRM

Sla elke klik op in uw eigen database of CRM en bouw rapportages precies zoals u wilt.

Lix.li POST
Chatmeldingen

Laat een Telegram-, Slack- of Discord-bot direct melden bij nieuwe kliks, zonder handmatig controleren.

Lix.li POST
Automatisering

Start scenario's in Zapier, Make of n8n: een klikgebeurtenis wordt de trigger voor elke gewenste actie.

Wat er in een webhook zit

Het event redirects.batch: één payload bundelt een reeks kliks uit één tijdvenster

{ "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 } ] }

Het IP-adres van de bezoeker wordt standaard niet meegestuurd (persoonsgegevens) en wordt alleen toegevoegd als u dit expliciet inschakelt voor dat endpoint.

Wat webhooks kunnen

Flexibele configuratie, solide beveiliging en voorspelbare bezorging

Batchgewijze bezorging

Kliks komen gebundeld binnen (redirects.batch) binnen een tijdvenster — dat scheelt verzoeken naar uw server.

Bereik naar keuze

Alle links van het account, een specifieke groep of één link — ontvang alleen de events die u echt nodig heeft.

HMAC-handtekening

Elk verzoek wordt ondertekend met uw secret. U kunt het secret op elk moment opnieuw genereren.

Retries en automatisch uitschakelen

Een onbereikbare server wordt opnieuw geprobeerd; een blijvend dood endpoint wordt automatisch uitgeschakeld.

Bezorglog

Een geschiedenis van alle verzendingen met status en inhoud — handig om de oorzaak van een probleem te achterhalen.

Testverzending (ping)

Valideer uw integratie met één klik voordat er echt verkeer binnenkomt — uw server ontvangt een testevent.

Rijke event-data

link_id, tijdstip, land, stad, besturingssysteem, apparaat, browser, referrer en bot-vlag bij elke klik.

Standaard privacyvriendelijk

Het IP-adres wordt niet verstuurd, tenzij u dit expliciet inschakelt voor een specifiek endpoint.

Gratis proberen

Zo stelt u een webhook in

Vijf stappen — van de URL van uw server tot een doorlopende stroom klikgebeurtenissen

1
Maak een endpoint aan

Registreer u bij Lix.li, open de sectie Webhooks en vul de URL van uw server in — daarheen stuurt Lix.li de klikgebeurtenissen.

2
Kies het bereik

Bepaal voor welke links u events wilt ontvangen: alle links van het account, een specifieke groep of één link.

3
Bewaar het ondertekeningssecret

Lix.li geeft u een geheime sleutel. Elk verzoek wordt ondertekend met HMAC — controleer de handtekening in de header om te bevestigen dat het event echt van Lix.li komt.

4
Verstuur een testverzoek

Klik op "Testen" (ping) en controleer of uw server het verzoek accepteert en met een 2xx antwoordt. Zo valideert u de integratie voordat er echt verkeer binnenkomt.

5
Houd het bezorglog in de gaten

In het log ziet u alle verzendingen, hun status en de retries. Is de server niet bereikbaar, dan wordt de bezorging opnieuw geprobeerd, en een blijvend dood endpoint wordt automatisch uitgeschakeld.

Webhook instellen

Veelgestelde vragen over webhooks

Een webhook is een HTTP-melding die Lix.li vanzelf naar uw server stuurt zodra er iets gebeurt. U hoeft geen API te pollen: de data komt automatisch binnen op het moment dat er op uw link wordt geklikt.
Kliks op uw verkorte links. Events komen binnen in batches (event_type = redirects.batch); elke klik bevat tijdstip, land, stad, besturingssysteem, apparaat, browser, referrer en een bot-vlag.
JSON via HTTP POST. De body bevat metadata-velden (delivery_id, tijdvenster, count) plus een events-array met de gegevens van elke klik. Een volledig voorbeeld van de request-body staat op deze pagina.
Elk verzoek wordt ondertekend met HMAC op basis van uw geheime sleutel — vergelijk de handtekening uit de header met de body van het verzoek om vervalsingen eruit te filteren. U kunt het secret op elk moment opnieuw genereren (roteren).
De bezorging wordt automatisch opnieuw geprobeerd. Reageert een endpoint te lang niet, dan wordt het tijdelijk uitgeschakeld, en blijven alle pogingen met hun status bewaard in het bezorglog — er gaat niets ongemerkt verloren.
Ja. U kiest zelf het bereik: alle links van het account, links van een specifieke groep of één link. Zo krijgt uw server geen onnodig verkeer te verwerken.
Standaard niet — dit zijn persoonsgegevens. Het IP wordt alleen in de events opgenomen als u dit expliciet inschakelt in de instellingen van dat endpoint.
Webhooks zijn beschikbaar in het Premium-abonnement. Registreer u en neem Premium om uw endpoint te koppelen.

Bouw integraties op basis van klikgebeurtenissen

Stel in een paar minuten een webhook in — en ontvang klikdata precies waar u ze nodig heeft.

Webhooks bij Lix.li zijn een manier om automatisch klikmeldingen voor uw verkorte links te ontvangen. In plaats van voortdurend een API te pollen, geeft u de URL van uw server op, en stuurt Lix.li daar op het moment van de klik een HTTP POST naartoe. Dat is een klassieke HTTP-callback voor verkorte links, die klikgebeurtenissen realtime naar uw systeem brengt.

Elke request-body is een redirects.batch-event met een array van kliks: elke klik bevat tijdstip, land, stad, browser, besturingssysteem, apparaat, referrer en een bot-vlag. Deze data zet u makkelijk over naar uw eigen database of CRM, of verandert u in klikmeldingen op Telegram, Slack of Discord, of gebruikt u als trigger in Zapier, Make en n8n. Verzoeken zijn beveiligd met een HMAC-handtekening: u vergelijkt de handtekening uit de header met de body om vervalsingen eruit te filteren, en u kunt het secret opnieuw genereren wanneer u dat nodig heeft.

De bezorging is voorspelbaar: bij een serverstoring worden events opnieuw geprobeerd, wordt een blijvend dood endpoint tijdelijk uitgeschakeld, en verschijnt elke poging in het bezorglog. U kunt het bereik beperken tot alle links, één groep of één link, en de integratie valideren met een testverzending (ping) voordat er echt verkeer binnenkomt. Webhooks werken naast de gewone verkorte links van Lix.li, QR-codes en statistieken, en zijn beschikbaar in het Premium-abonnement.

Webhook instellen