Вебхуки

На Growth и Ultimate Letlink отправляет JSON POST-запросом на каждый HTTPS URL, зарегистрированный в рабочем пространстве, когда клик записан. Владельцы и администраторы добавляют и удаляют URL в разделе Интеграции → Вебхуки. Участники видят список, но не могут его менять.

Добавление эндпоинта

1. Поднимите HTTPS URL, принимающий POST с Content-Type: application/json. HTTP отклоняется.
2. Вставьте его в Интеграции → Вебхуки и сохраните. Имя события — link_visited.
3. Перейдите по одной из своих коротких ссылок (из сети, не превысившей месячный лимит). Запрос должен прийти в течение нескольких секунд — доставка ставится в очередь, а не выполняется во время перенаправления.

Подписаться можно и через API: POST /api/v1/hooks/subscribe с target_url и необязательным event (по умолчанию link_visited). Zapier REST Hooks вызывают ту же пару маршрутов subscribe/unsubscribe.

Данные

Тело — это канонический объект перехода. Пустые поля UTM или магазина равны null.

{
  "visit_id": 42,
  "visit_time": "2026-09-09T18:01:22+00:00",
  "link_type": "utm",
  "link_shortcode": "summer",
  "link_domain": "letl.ink",
  "link_destination_url": "https://example.com/a",
  "utm_source": "newsletter",
  "utm_campaign": "sep",
  "utm_medium": "email",
  "google_play_app_url": null,
  "google_play_utm_source": null,
  "google_play_utm_campaign": null,
  "app_store_app_url": null,
  "app_store_ct": null,
  "instagram_username": null,
  "visitor_ip": "203.0.113.10",
  "visitor_browser": "Chrome",
  "visitor_device_type": "desktop",
  "visitor_referrer": "https://mail.example.com/",
  "visitor_variation": "hero-b"
}

Когда вебхук не срабатывает

• Рабочее пространство на тарифе Free или Solo (allowsWebhooks выключен).
• Месячный лимит отслеживаемых кликов уже исчерпан — перенаправление всё равно происходит, но запись не создаётся, поэтому ничего не отправляется.
• Лимит переходов на устройство вернул 429 до того, как клик был сохранён.
• Посетителя не пропустило правило доступа по странам. Заблокированные переходы никогда не сохраняются как клики.
• Целевой URL недоступен. Доставка выполняется по возможности и никогда не должна задерживать посетителя; неудачные отправки с этой страницы не повторяются.

Кто что получает

Хуки хранятся для каждого пользователя. URL link_visited каждого участника получают уведомления о кликах по любой ссылке рабочего пространства. Если два коллеги подписали Zapier, запустятся оба Zap. Удаляйте неиспользуемые URL, чтобы забытый Catch Hook не продолжал срабатывать.