Webhooks — kliknutí na vaše odkazy v reálném čase na váš server

K čemu jsou webhooks dobré

Získejte data o kliknutích okamžitě a stavte na nich vlastní procesy

Reálný čas

Událost přichází v okamžiku kliknutí. Není třeba pravidelně dotazovat API a čekat na aktualizace.

Data o každém kliknutí

Země, město, zařízení, operační systém, prohlížeč, zdroj návštěvnosti a příznak bota — vše, co potřebujete pro vlastní analytiku.

Bezpečné ve výchozím nastavení

Každý požadavek je podepsán HMAC pomocí vašeho vlastního tajného klíče, takže snadno odlišíte skutečné události od podvržených.

Spolehlivé doručení

Pokud je váš server nedostupný, doručení se opakuje. Všechny pokusy a jejich stavy jsou vidět v protokolu doručení.

Případy použití

Kam se události o kliknutí obvykle posílají

Vlastní analytika nebo CRM

Ukládejte každé kliknutí do vlastní databáze nebo CRM a vytvářejte reporty přesně podle svých potřeb.

Notifikace do chatu

Nechte bota v Telegramu, Slacku nebo Discordu okamžitě hlásit nová kliknutí, bez ruční kontroly.

Automatizace

Spouštějte scénáře v Zapieru, Make nebo n8n: událost o kliknutí se stane spouštěčem jakékoli akce.

Co přijde ve webhooku

Událost redirects.batch: jedno tělo požadavku obsahuje dávku kliknutí za dané časové okno

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

IP adresa návštěvníka se ve výchozím nastavení nepředává (jde o osobní údaje) a přidá se pouze tehdy, pokud ji pro daný endpoint výslovně povolíte.

Co webhooks umí

Flexibilní nastavení, silné zabezpečení a předvídatelné doručování

Dávkové doručování událostí

Kliknutí přicházejí seskupená (redirects.batch) za dané časové okno — to šetří počet požadavků na váš server.

Rozsah podle vašeho výběru

Všechny odkazy v účtu, konkrétní skupina, nebo jediný odkaz — dostávejte jen ty události, které skutečně potřebujete.

Podpis HMAC

Každý požadavek je podepsán vaším tajným klíčem. Klíč lze kdykoli znovu vygenerovat.

Opakované pokusy a automatické vypnutí

Nedostupný server vede k novým pokusům o doručení; trvale „mrtvý“ endpoint se automaticky vypne.

Protokol doručení

Historie všech odeslání se stavy a obsahem — snadno dohledáte příčinu, když něco selže.

Testovací odeslání (ping)

Ověřte integraci jedním kliknutím ještě před skutečným provozem — na server dorazí testovací událost.

Bohatá data o události

link_id, čas, zemi, město, operační systém, zařízení, prohlížeč, zdroj a příznak bota u každého kliknutí.

Soukromí jako výchozí stav

IP adresa se neposílá, dokud ji výslovně nepovolíte pro konkrétní endpoint.

Vyzkoušet zdarma

Jak nastavit webhook

Pět kroků — od URL vašeho serveru až po nepřetržitý proud událostí o kliknutích

1

Vytvořte endpoint

Zaregistrujte se na Lix.li, otevřete sekci Webhooks a zadejte URL svého serveru — tam bude Lix.li posílat události o kliknutích.

2

Zvolte rozsah

Rozhodněte, u kterých odkazů chcete dostávat události: všech odkazů v účtu, konkrétní skupiny, nebo jediného odkazu.

3

Uložte podpisový klíč

Lix.li vám vydá tajný klíč. Každý požadavek je podepsán HMAC — ověřte podpis v hlavičce, abyste potvrdili, že událost skutečně přišla z Lix.li.

4

Odešlete testovací požadavek

Klikněte na „Test“ (ping) a ověřte, že váš server požadavek přijme a odpoví kódem 2xx. Tím integraci ověříte ještě před příchodem skutečného provozu.

5

Sledujte protokol doručení

V protokolu vidíte všechna odeslání, jejich stavy a opakované pokusy. Když je server nedostupný, doručení se opakuje, a trvale „mrtvý“ endpoint se automaticky vypne.

Nastavit webhook

Časté dotazy o webhooks

Co je to webhook?

Webhook je HTTP notifikace, kterou Lix.li sám odešle na váš server, jakmile nastane určitá událost. Nemusíte se dotazovat žádného API — data přijdou automaticky v okamžiku kliknutí na váš odkaz.

Jaké události se odesílají?

Kliknutí na vaše zkrácené odkazy. Události přicházejí v dávkách (event_type = redirects.batch); každé kliknutí obsahuje čas, zemi, město, operační systém, zařízení, prohlížeč, zdroj a příznak bota.

V jakém formátu data přicházejí?

JSON přes HTTP POST. Tělo obsahuje řídicí pole (delivery_id, časové okno, count) a pole events s daty o každém kliknutí. Kompletní příklad těla požadavku najdete na této stránce.

Jak ověřím, že požadavek skutečně přišel z Lix.li?

Každý požadavek je podepsán HMAC na základě vašeho tajného klíče — porovnejte podpis z hlavičky s tělem požadavku a odfiltrujete padělky. Tajný klíč můžete kdykoli znovu vygenerovat (rotace).

Co se stane, když je můj server dočasně nedostupný?

Doručení se automaticky opakuje. Pokud endpoint dlouho neodpovídá, dočasně se vypne, a všechny pokusy i jejich stavy zůstávají v protokolu doručení — žádná událost se neztratí nepozorovaně.

Mohu dostávat události jen pro konkrétní odkazy?

Ano. Rozsah si zvolíte sami: všechny odkazy v účtu, odkazy konkrétní skupiny, nebo jediný odkaz. Server tak nezatížíte zbytečným provozem.

Odesílá se IP adresa návštěvníka?

Ve výchozím nastavení ne — jde o osobní údaje. IP se do událostí zahrne pouze tehdy, když ji výslovně povolíte v nastavení daného endpointu.

V jakém tarifu jsou webhooks dostupné?

Webhooks jsou dostupné v tarifu Premium. Zaregistrujte se a přejděte na Premium, abyste mohli připojit svůj endpoint.

Stavte integrace na událostech o kliknutích

Nastavte webhook za pár minut — a získávejte data o kliknutích přesně tam, kde je potřebujete.

Webhooks v Lix.li jsou způsob, jak automaticky získávat notifikace o kliknutích na vaše zkrácené odkazy. Místo neustálého dotazování API stačí zadat URL vašeho serveru a Lix.li tam v okamžiku kliknutí odešle HTTP POST. Jde o klasický HTTP callback pro zkrácené odkazy, který dostává události o kliknutích do vašeho systému v reálném čase.

Každé tělo požadavku je událost redirects.batch s polem kliknutí: každé z nich obsahuje čas, zemi, město, prohlížeč, operační systém, zařízení, zdroj a příznak bota. Tato data snadno uložíte do vlastní databáze nebo CRM, proměníte je v notifikace o kliknutích v Telegramu, Slacku nebo Discordu, nebo je použijete jako spouštěč v Zapieru, Make a n8n. Požadavky jsou chráněny podpisem HMAC: porovnáte podpis z hlavičky s tělem a odfiltrujete padělky, přičemž tajný klíč můžete kdykoli podle potřeby znovu vygenerovat.

Doručování je předvídatelné: při výpadku serveru se události opakovaně odešlou, trvale „mrtvý“ endpoint se dočasně vypne a každý pokus se zobrazí v protokolu doručení. Rozsah lze omezit na všechny odkazy, jednu skupinu nebo jediný odkaz a integraci lze ověřit testovacím odesláním (ping) ještě před příchodem skutečného provozu. Webhooks fungují společně s běžnými zkrácenými odkazy Lix.li, QR kódy a statistikami a jsou dostupné v tarifu Premium.