Webhooks: Link-Klicks landen automatisch auf Ihrem Server

Lix.li sendet zu jedem Klick ein Event per HTTP POST direkt an Ihre URL — in Echtzeit, HMAC-signiert und zuverlässig zugestellt. Kein ständiges API-Polling nötig: Die Daten kommen von selbst, im Moment des Klicks.

Webhook einrichten Payload-Format ansehen

Echtzeit · HMAC-Signatur · Retries und Zustell-Log

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

Wofür Webhooks gut sind

Erhalten Sie Klickdaten sofort und bauen Sie Ihre eigenen Workflows darauf auf

Echtzeit

Events treffen im Moment des Klicks ein. Kein geplantes Polling der API und kein Warten auf Updates nötig.

Daten zu jedem Klick

Land, Stadt, Gerät, Betriebssystem, Browser, Referrer und Bot-Kennzeichnung — alles, was Sie für Ihre eigene Analyse brauchen.

Sicher per Design

Jeder Request wird mit HMAC über Ihr eigenes Secret signiert — so erkennen Sie echte Events zuverlässig und trennen sie von gefälschten.

Zuverlässige Zustellung

Ist Ihr Server nicht erreichbar, wird die Zustellung wiederholt. Alle Versuche und Status sehen Sie im Zustell-Log.

Anwendungsfälle

Wohin Klick-Events üblicherweise geleitet werden

Lix.li POST
Eigene Analyse oder CRM

Speichern Sie jeden Klick in Ihrer eigenen Datenbank oder Ihrem CRM und bauen Sie Reports genau so, wie Sie sie brauchen.

Lix.li POST
Chat-Benachrichtigungen

Lassen Sie einen Telegram-, Slack- oder Discord-Bot sofort über neue Klicks informieren — ganz ohne manuelle Kontrolle.

Lix.li POST
Automatisierung

Starten Sie Workflows in Zapier, Make oder n8n: Ein Klick-Event wird zum Auslöser für jede beliebige Folgeaktion.

Was im Webhook ankommt

Das Event redirects.batch: Ein einzelner Payload bündelt einen Stapel Klicks aus einem Zeitfenster

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

Die IP-Adresse des Besuchers wird standardmäßig nicht übermittelt (personenbezogene Daten) und nur hinzugefügt, wenn Sie das für den jeweiligen Endpoint ausdrücklich aktivieren.

Was Webhooks können

Flexible Konfiguration, solide Sicherheit und vorhersehbare Zustellung

Gebündelte Zustellung

Klicks treffen gebündelt (redirects.batch) innerhalb eines Zeitfensters ein — das spart Requests an Ihren Server.

Umfang nach Wahl

Alle Links des Accounts, eine bestimmte Gruppe oder ein einzelner Link — Sie erhalten nur die Events, die Sie wirklich brauchen.

HMAC-Signatur

Jeder Request wird mit Ihrem Secret signiert. Das Secret lässt sich jederzeit neu generieren.

Retries und automatische Deaktivierung

Ist der Server nicht erreichbar, wird erneut versucht; ein dauerhaft toter Endpoint wird automatisch deaktiviert.

Zustell-Log

Historie aller Zustellungen mit Status und Inhalt — praktisch, um die Ursache eines Problems zu finden.

Testversand (Ping)

Prüfen Sie die Integration mit einem Klick, noch bevor echter Traffic ankommt — Ihr Server erhält ein Testevent.

Umfangreiche Event-Daten

link_id, Zeitstempel, Land, Stadt, Betriebssystem, Gerät, Browser, Referrer und Bot-Kennzeichnung zu jedem Klick.

Privatsphäre per Voreinstellung

Die IP-Adresse wird nur gesendet, wenn Sie das für einen bestimmten Endpoint ausdrücklich aktivieren.

Kostenlos testen

So richten Sie einen Webhook ein

Fünf Schritte — von der URL Ihres Servers bis zum laufenden Strom an Klick-Events

1
Endpoint anlegen

Registrieren Sie sich bei Lix.li, öffnen Sie den Bereich Webhooks und tragen Sie die URL Ihres Servers ein — dorthin sendet Lix.li die Klick-Events.

2
Umfang festlegen

Entscheiden Sie, für welche Links Sie Events erhalten möchten: alle Links des Accounts, eine bestimmte Gruppe oder einen einzelnen Link.

3
Signatur-Secret speichern

Lix.li stellt Ihnen einen geheimen Schlüssel aus. Jeder Request wird mit HMAC signiert — prüfen Sie die Signatur im Header, um sicherzustellen, dass das Event wirklich von Lix.li stammt.

4
Testanfrage senden

Klicken Sie auf „Testen“ (Ping) und prüfen Sie, ob Ihr Server die Anfrage annimmt und mit 2xx antwortet. So validieren Sie die Integration, bevor echter Traffic ankommt.

5
Zustell-Log im Blick behalten

Im Log sehen Sie jede Zustellung, ihren Status und alle Wiederholungsversuche. Ist der Server nicht erreichbar, wird die Zustellung wiederholt, und ein dauerhaft toter Endpoint wird automatisch deaktiviert.

Webhook einrichten

Häufige Fragen zu Webhooks

Ein Webhook ist eine HTTP-Benachrichtigung, die Lix.li von sich aus an Ihren Server sendet, sobald etwas passiert. Sie müssen keine API abfragen — die Daten kommen automatisch, im Moment des Klicks auf Ihren Link.
Klicks auf Ihre Kurzlinks. Events treffen gebündelt ein (event_type = redirects.batch); jeder Klick enthält Zeitstempel, Land, Stadt, Betriebssystem, Gerät, Browser, Referrer und Bot-Kennzeichnung.
JSON per HTTP POST. Der Body enthält Metadaten (delivery_id, Zeitfenster, count) sowie ein events-Array mit den Daten zu jedem einzelnen Klick. Ein vollständiges Beispiel für den Request-Body finden Sie auf dieser Seite.
Jeder Request wird mit HMAC auf Basis Ihres geheimen Schlüssels signiert — gleichen Sie die Signatur im Header mit dem Request-Body ab, um Fälschungen auszuschließen. Das Secret lässt sich jederzeit neu generieren (Rotation).
Die Zustellung wird automatisch wiederholt. Bleibt ein Endpoint zu lange ohne Antwort, wird er vorübergehend deaktiviert, und alle Versuche samt Status bleiben im Zustell-Log erhalten — nichts geht unbemerkt verloren.
Ja. Der Umfang ist frei wählbar: alle Links des Accounts, Links einer bestimmten Gruppe oder ein einzelner Link. So landet kein unnötiger Traffic auf Ihrem Server.
Standardmäßig nicht — das sind personenbezogene Daten. Die IP wird nur dann in die Events aufgenommen, wenn Sie das in den Einstellungen des jeweiligen Endpoints ausdrücklich aktivieren.
Webhooks stehen im Premium-Tarif zur Verfügung. Registrieren Sie sich und wechseln Sie zu Premium, um Ihren Endpoint anzubinden.

Bauen Sie Integrationen auf Basis von Klick-Events

Richten Sie einen Webhook in wenigen Minuten ein — und erhalten Sie Klickdaten genau dort, wo Sie sie brauchen.

Webhooks bei Lix.li sind eine Möglichkeit, Klick-Benachrichtigungen für Ihre Kurzlinks automatisch zu erhalten. Statt eine API rund um die Uhr abzufragen, geben Sie Lix.li die URL Ihres Servers, und Lix.li sendet dorthin einen HTTP POST im Moment des Klicks. Das ist ein klassischer HTTP-Callback für Kurzlinks, der Klick-Events in Echtzeit in Ihr System bringt.

Jeder Request-Body ist ein redirects.batch-Event mit einem Array von Klicks: Jeder Klick enthält Zeitstempel, Land, Stadt, Browser, Betriebssystem, Gerät, Referrer und Bot-Kennzeichnung. Diese Daten lassen sich einfach in Ihre eigene Datenbank oder Ihr CRM einspeisen, als Klick- Benachrichtigungen in Telegram, Slack oder Discord ausgeben oder als Trigger in Zapier, Make und n8n nutzen. Requests sind durch eine HMAC-Signatur geschützt: Sie gleichen die Signatur im Header mit dem Body ab, um Fälschungen auszuschließen, und können das Secret bei Bedarf jederzeit neu generieren.

Die Zustellung ist vorhersehbar: Bei einem Serverausfall werden Events erneut zugestellt, ein dauerhaft toter Endpoint wird vorübergehend deaktiviert, und jeder Versuch erscheint im Zustell-Log. Sie können den Umfang auf alle Links, eine einzelne Gruppe oder einen einzelnen Link beschränken und die Integration mit einem Testversand (Ping) validieren, bevor echter Traffic eintrifft. Webhooks funktionieren zusammen mit den gewöhnlichen Kurzlinks von Lix.li, QR-Codes und Statistiken und sind im Premium-Tarif verfügbar.

Webhook einrichten