Webhooks: kliknięcia w linki same trafiają na Twój serwer

Lix.li wysyła zdarzenie dla każdego kliknięcia bezpośrednio na Twój URL przez HTTP POST — w czasie rzeczywistym, podpisane HMAC, z niezawodną dostawą. Bez ciągłego odpytywania API: dane trafiają do Ciebie same, w chwili kliknięcia.

Skonfiguruj webhook Zobacz format danych

Czas rzeczywisty · podpis HMAC · ponawianie prób i log dostaw

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

Po co webhooks

Otrzymuj dane o kliknięciach natychmiast i buduj na nich własne procesy

Czas rzeczywisty

Zdarzenie przychodzi w chwili kliknięcia. Nie trzeba odpytywać API według harmonogramu i czekać na aktualizacje.

Dane o każdym kliknięciu

Kraj, miasto, urządzenie, system operacyjny, przeglądarka, źródło ruchu i flaga bota — wszystko, co potrzebne do własnej analityki.

Bezpieczne domyślnie

Każde żądanie jest podpisane HMAC przy użyciu Twojego własnego sekretu, więc łatwo odróżnisz prawdziwe zdarzenia od podrobionych.

Niezawodna dostawa

Gdy Twój serwer jest niedostępny, dostawa jest ponawiana. Wszystkie próby i statusy widać w logu dostaw.

Zastosowania

Dokąd zwykle trafiają zdarzenia o kliknięciach

Lix.li POST
Własna analityka lub CRM

Zapisuj każde kliknięcie we własnej bazie danych lub CRM i twórz raporty dokładnie tak, jak chcesz.

Lix.li POST
Powiadomienia na czacie

Niech bot na Telegramie, Slacku lub Discordzie informuje o nowych kliknięciach od razu, bez ręcznego sprawdzania.

Lix.li POST
Automatyzacja

Uruchamiaj scenariusze w Zapier, Make lub n8n: zdarzenie kliknięcia staje się wyzwalaczem dowolnej akcji.

Co przychodzi w webhooku

Zdarzenie redirects.batch: jedno ciało żądania zawiera paczkę kliknięć z jednego okna czasowego

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

Adres IP odwiedzającego domyślnie nie jest przesyłany (to dane osobowe) i pojawia się tylko wtedy, gdy jawnie włączysz to dla danego endpointu.

Co potrafią webhooks

Elastyczna konfiguracja, solidne bezpieczeństwo i przewidywalna dostawa

Dostawa zdarzeń partiami

Kliknięcia przychodzą pogrupowane (redirects.batch) w oknie czasowym — to oszczędza liczbę żądań do Twojego serwera.

Zakres wedle wyboru

Wszystkie linki na koncie, konkretna grupa lub pojedynczy link — otrzymuj tylko te zdarzenia, których naprawdę potrzebujesz.

Podpis HMAC

Każde żądanie jest podpisane Twoim sekretem. Sekret możesz w każdej chwili wygenerować ponownie.

Ponawianie prób i automatyczne wyłączanie

Niedostępny serwer skutkuje ponowną próbą; trwale „martwy” endpoint zostaje automatycznie wyłączony.

Log dostaw

Historia wszystkich wysyłek ze statusami i treścią — łatwo znaleźć przyczynę, gdy coś pójdzie nie tak.

Wysyłka testowa (ping)

Sprawdź integrację jednym kliknięciem, zanim pojawi się prawdziwy ruch — Twój serwer otrzyma testowe zdarzenie.

Bogate dane zdarzenia

link_id, znacznik czasu, kraj, miasto, system operacyjny, urządzenie, przeglądarka, źródło ruchu i flaga bota przy każdym kliknięciu.

Prywatność domyślnie

Adres IP nie jest wysyłany, dopóki jawnie go nie włączysz dla konkretnego endpointu.

Wypróbuj za darmo

Jak skonfigurować webhook

Pięć kroków — od adresu URL serwera do stałego strumienia zdarzeń o kliknięciach

1
Utwórz endpoint

Zarejestruj się w Lix.li, otwórz sekcję Webhooks i podaj adres URL swojego serwera — tam Lix.li będzie wysyłać zdarzenia o kliknięciach.

2
Wybierz zakres

Zdecyduj, dla których linków chcesz otrzymywać zdarzenia: wszystkich linków na koncie, konkretnej grupy albo jednego linku.

3
Zapisz sekret do podpisu

Lix.li wygeneruje dla Ciebie klucz sekretny. Każde żądanie jest podpisane HMAC — sprawdzaj podpis w nagłówku, aby potwierdzić, że zdarzenie rzeczywiście pochodzi z Lix.li.

4
Wyślij żądanie testowe

Kliknij „Testuj” (ping) i sprawdź, czy Twój serwer przyjmuje żądanie i odpowiada kodem 2xx. Dzięki temu zweryfikujesz integrację, zanim pojawi się prawdziwy ruch.

5
Obserwuj log dostaw

W logu widać wszystkie wysyłki, ich statusy i ponowione próby. Gdy serwer jest niedostępny, dostawa jest ponawiana, a trwale „martwy” endpoint zostaje automatycznie wyłączony.

Skonfiguruj webhook

Najczęstsze pytania o webhooks

Webhook to powiadomienie HTTP, które Lix.li samodzielnie wysyła na Twój serwer, gdy dochodzi do zdarzenia. Nie musisz odpytywać żadnego API — dane trafiają do Ciebie automatycznie w chwili kliknięcia w link.
Kliknięcia w Twoje krótkie linki. Zdarzenia przychodzą partiami (event_type = redirects.batch); przy każdym kliknięciu przekazywane są czas, kraj, miasto, system operacyjny, urządzenie, przeglądarka, źródło ruchu i flaga bota.
JSON przez HTTP POST. Ciało żądania zawiera pola techniczne (delivery_id, okno czasowe, count) oraz tablicę events z danymi każdego kliknięcia. Pełny przykład ciała żądania znajduje się na tej stronie.
Każde żądanie jest podpisane HMAC na podstawie Twojego klucza sekretnego — porównaj podpis z nagłówka z treścią żądania, aby odsiać fałszywe. Sekret możesz w każdej chwili wygenerować ponownie (rotacja).
Dostawa jest ponawiana automatycznie. Jeśli endpoint długo nie odpowiada, zostaje tymczasowo wyłączony, a wszystkie próby i ich statusy pozostają w logu dostaw — żadne zdarzenie nie ginie niezauważone.
Tak. Zakres można dowolnie wybrać: wszystkie linki na koncie, linki z konkretnej grupy albo jeden konkretny link. Dzięki temu na Twój serwer nie trafia zbędny ruch.
Domyślnie nie — to dane osobowe. IP trafia do zdarzeń tylko wtedy, gdy jawnie włączysz to w ustawieniach danego endpointu.
Webhooks są dostępne w planie Premium. Zarejestruj się i wykup Premium, aby podłączyć swój endpoint.

Buduj integracje na zdarzeniach o kliknięciach

Skonfiguruj webhook w kilka minut — i odbieraj dane o kliknięciach dokładnie tam, gdzie ich potrzebujesz.

Webhooks w Lix.li to sposób na automatyczne otrzymywanie powiadomień o kliknięciach w Twoje krótkie linki. Zamiast ciągle odpytywać API, podajesz adres URL swojego serwera, a Lix.li wysyła tam żądanie HTTP POST w chwili kliknięcia. To klasyczny HTTP callback dla krótkich linków, który dostarcza zdarzenia o kliknięciach do Twojego systemu w czasie rzeczywistym.

Każde ciało żądania to zdarzenie redirects.batch z tablicą kliknięć: każde z nich zawiera czas, kraj, miasto, przeglądarkę, system operacyjny, urządzenie, źródło ruchu i flagę bota. Te dane łatwo zapisać we własnej bazie danych lub CRM, zamienić w powiadomienia o kliknięciach na Telegramie, Slacku czy Discordzie, albo wykorzystać jako wyzwalacz w Zapier, Make i n8n. Żądania są chronione podpisem HMAC: porównujesz podpis z nagłówka z treścią żądania, odsiewając fałszywki, a sekret możesz wygenerować ponownie, kiedy tylko zajdzie potrzeba.

Dostawa jest przewidywalna: przy awarii serwera zdarzenia są ponawiane, trwale „martwy” endpoint zostaje tymczasowo wyłączony, a każda próba jest widoczna w logu dostaw. Zakres możesz ograniczyć do wszystkich linków, jednej grupy albo pojedynczego linku, a integrację zweryfikować wysyłką testową (ping), zanim pojawi się prawdziwy ruch. Webhooks działają obok zwykłych krótkich linków Lix.li, kodów QR i statystyk i są dostępne w planie Premium.

Skonfiguruj webhook