Webhooks: переходы по ссылкам приходят на ваш сервер сами

Lix.li отправляет события о каждом переходе прямо на ваш URL по HTTP POST — в реальном времени, с HMAC-подписью и надёжной доставкой. Никакого постоянного опроса API: данные приходят сами в момент клика.

Подключить webhook Формат данных

Реальное время · подпись HMAC · ретраи и журнал доставок

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

Зачем нужны webhooks

Получайте данные о переходах мгновенно и стройте на них свои сценарии

Реальное время

События приходят в момент перехода. Не нужно опрашивать API по расписанию и ждать обновлений.

Данные о каждом переходе

Страна, город, устройство, ОС, браузер, источник и флаг бота — всё, что нужно для вашей аналитики.

Безопасно

Каждый запрос подписан HMAC по вашему секрету — вы легко отличаете настоящие события от подделок.

Надёжная доставка

Сервер недоступен — доставка повторяется. Все попытки и статусы видны в журнале доставок.

Сценарии использования

Куда обычно направляют события о переходах

Lix.li POST
Своя аналитика и CRM

Складывайте каждый переход в собственную базу данных или CRM и стройте отчёты так, как удобно вам.

Lix.li POST
Уведомления в чат

Пусть бот в Telegram, Slack или Discord пишет вам о новых переходах — мгновенно, без ручных проверок.

Lix.li POST
Автоматизация

Запускайте сценарии в Zapier, Make или n8n: событие о переходе становится триггером для любых действий.

Что приходит в webhook

Событие redirects.batch: одно тело содержит пачку переходов за окно времени

{ "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-адрес посетителя по умолчанию не передаётся (персональные данные) и включается только по вашему явному разрешению на endpoint.

Возможности webhooks

Гибкая настройка, безопасность и предсказуемая доставка

Батч-доставка событий

Переходы приходят пачками (redirects.batch) за окно времени — это экономит запросы к вашему серверу.

Область на выбор

Все ссылки аккаунта, конкретная группа или одна ссылка — получайте только нужные события.

HMAC-подпись

Каждый запрос подписан вашим секретом. Секрет можно перевыпустить в любой момент.

Ретраи и авто-отключение

Недоступный сервер — повторные попытки; «мёртвый» endpoint временно отключается автоматически.

Журнал доставок

История всех отправок со статусами и телом — удобно искать причину, если что-то пошло не так.

Тестовая отправка (ping)

Проверьте интеграцию одним кликом ещё до реального трафика — сервер получит тестовое событие.

Богатые данные события

link_id, время, страна, город, ОС, устройство, браузер, источник и флаг бота по каждому переходу.

Приватность по умолчанию

IP-адрес не передаётся, пока вы явно не включите его для конкретного endpoint.

Попробовать бесплатно

Как настроить webhook

Пять шагов — от URL сервера до потока событий о переходах

1
Создайте endpoint

Зарегистрируйтесь в Lix.li, откройте раздел Webhooks и укажите URL своего сервера, на который Lix.li будет отправлять события о переходах.

2
Выберите область

Решите, о переходах по каким ссылкам получать события: по всем ссылкам аккаунта, по конкретной группе или по одной ссылке.

3
Сохраните секрет для подписи

Lix.li выдаст секретный ключ. Каждый запрос подписывается HMAC — сверяйте подпись из заголовка, чтобы убедиться, что событие пришло именно от Lix.li.

4
Отправьте тестовый запрос

Нажмите «Тест» (ping) и убедитесь, что ваш сервер принимает запрос и отвечает 2xx. Так вы проверите интеграцию до реального трафика.

5
Следите за журналом доставок

В журнале видны все отправки, их статусы и повторные попытки. При недоступности сервера доставка ретраится, а «мёртвый» endpoint автоматически отключается.

Подключить webhook

Частые вопросы о webhooks

Webhook — это HTTP-уведомление, которое Lix.li сам отправляет на ваш сервер, когда происходит событие. Вам не нужно опрашивать API: данные приходят автоматически в момент перехода по ссылке.
Переходы (клики) по вашим коротким ссылкам. События приходят батчами (event_type = redirects.batch), по каждому переходу передаются время, страна, город, ОС, устройство, браузер, источник перехода и флаг бота.
JSON по HTTP POST. В теле — служебные поля (delivery_id, окно времени, count) и массив events с данными о каждом переходе. Пример полного тела запроса есть на этой странице.
Каждый запрос подписан HMAC на основе вашего секретного ключа — сверьте подпись из заголовка с телом запроса, и подделки будут отсечены. Секрет можно в любой момент перевыпустить (ротация).
Доставка повторяется автоматически (ретраи). Если endpoint долго не отвечает, он временно отключается, а все попытки и их статусы остаются в журнале доставок — событие не потеряется незаметно.
Да. Область на выбор: все ссылки аккаунта, ссылки конкретной группы или одна конкретная ссылка. Так вы не получаете лишний трафик на свой сервер.
По умолчанию нет — это персональные данные. IP включается в события, только если вы явно разрешите это в настройках конкретного endpoint.
Webhooks доступны на тарифе Premium. Зарегистрируйтесь и оформите Premium, чтобы подключить свой endpoint.

Стройте интеграции на событиях переходов

Подключите webhook за пару минут — и получайте данные о кликах туда, где они вам нужны.

Webhooks (вебхуки) в Lix.li — это способ получать уведомления о переходах по коротким ссылкам автоматически. Вместо того чтобы постоянно опрашивать API, вы указываете URL своего сервера, и Lix.li сам отправляет туда HTTP POST в момент клика. Так события о переходах попадают в вашу систему в реальном времени — это классический HTTP callback для коротких ссылок.

Каждое тело запроса — это событие redirects.batch с массивом переходов: по каждому клику передаются время, страна, город, браузер, операционная система, устройство, источник и флаг бота. Данные удобно складывать в свою базу или CRM, отправлять как уведомления о переходах в Telegram, Slack или Discord, а также использовать как триггер в Zapier, Make и n8n. Запросы защищены HMAC-подписью: вы сверяете подпись из заголовка и отсекаете подделки, а секрет при необходимости перевыпускаете.

Доставка предсказуема: при сбое сервера события повторяются, «мёртвый» endpoint временно отключается, а все попытки видны в журнале доставок. Область можно ограничить всеми ссылками, группой или одной ссылкой, а интеграцию — проверить тестовой отправкой (ping) ещё до реального трафика. Webhooks работают вместе с обычными короткими ссылками Lix.li, QR-кодами и статистикой и доступны на тарифе Premium.

Подключить webhook