Вебхуки

Вебхуки позволяют получать уведомления в реальном времени о ваших ссылках — как при переходах по ним, так и при их создании, обновлении или удалении. Linkly отправляет POST-запрос на указанный(-е) URL(-ы) с подробной информацией о каждом событии.

Варианты использования

• Платформы автоматизации: Запуск рабочих процессов в Make или Zapier при переходах по ссылкам
• Пользовательская аналитика: Отправка данных переходов в вашу систему аналитики
• Обновления CRM: Обновление записей клиентов при переходах по ссылкам
• Уведомления в Slack: Получение уведомлений в Slack при переходах по важным ссылкам
• Отслеживание лидов: Отслеживание взаимодействия потенциальных клиентов с вашими ссылками

Совет: Для большинства задач автоматизации наша интеграция Make или интеграция Zapier проще в настройке, чем пользовательские вебхуки. Они включают мгновенные триггеры переходов на основе вебхуков без необходимости кодирования.

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

События

Каждый вебхук получает все типы событий для своей области — вебхук на уровне ссылки получает события для этой ссылки, вебхук на уровне рабочей области получает события для каждой ссылки в рабочей области. Проверьте поле event верхнего уровня, чтобы их различить:

Полезная нагрузка вебхука

Полезная нагрузка переходов

При переходе Linkly отправляет POST-запрос со следующей JSON-полезной нагрузкой:

{
  "event": "click",
  "timestamp": "2025-01-15T10:30:00Z",
  "link": {
    "id": 12345,
    "name": "My Campaign Link",
    "url": "https://example.com/landing-page",
    "full_url": "https://yourdomain.com/abc123",
    "domain": "yourdomain.com",
    "slug": "/abc123",
    "destination": "https://example.com/landing-page",
    "workspace_id": 1,
    "enabled": true,
    "cloaking": false,
    "forward_params": true,
    "block_bots": true,
    "public_analytics": false,
    "utm_source": "newsletter",
    "utm_medium": "email",
    "utm_campaign": "spring-sale",
    "og_title": "Special Offer",
    "og_description": "Check out our spring sale!",
    "rules": [
      {
        "what": "country",
        "matches": "US",
        "url": "https://example.com/us-landing"
      }
    ]
  },
  "click": {
    "country": "US",
    "is_eu_country": false,
    "platform": "desktop",
    "browser_name": "Chrome",
    "referer": "https://twitter.com/",
    "isp": "Comcast",
    "bot_name": null,
    "destination": "https://example.com/landing-page",
    "params": {
      "utm_source": "twitter"
    }
  }
}

Поля полезной нагрузки

Информация о событии

Объект ссылки

Объект переходов

Примечание о конфиденциальности: IP-адреса никогда не включаются в полезную нагрузку вебхука.

Полезная нагрузка жизненного цикла ссылки

События link.created, link.updated и link.deleted имеют одинаковую структуру. Нет объекта click — вы получаете event, timestamp и полный объект link:

{
  "event": "link.created",
  "timestamp": "2026-06-20T10:30:00Z",
  "link": {
    "id": 12345,
    "name": "My Campaign Link",
    "url": "https://example.com/landing-page",
    "full_url": "https://yourdomain.com/abc123",
    "domain": "yourdomain.com",
    "slug": "/abc123",
    "workspace_id": 1,
    "enabled": true,
    "rules": []
  }
}

Интеграции платформ автоматизации

Для более простой настройки без пользовательского кодирования используйте наши встроенные интеграции:

• Интеграция Make - Визуальная платформа автоматизации с мгновенными триггерами переходов
• Интеграция Zapier - Подключите Linkly к тысячам приложений без кода

Обе интеграции используют вебхуки под капотом, но полностью автоматизируют всю настройку.

Лучшие практики

Несколько вебхуков

Вы можете добавить несколько URL-адресов вебхука (по одному в строке). Все URL-адреса будут получать одну и ту же полезную нагрузку при переходе.

Обработка ошибок

• Вебхуки используют принцип отправить и забыть - Linkly не повторяет неудачные доставки
• Сбои вебхука никогда не влияют на перенаправление - пользователи всегда достигают своего места назначения
• Убедитесь, что конечная точка вебхука отвечает быстро (рекомендуется < 5 секунд)

Безопасность

• Используйте HTTPS для URL-адресов вебхука
• Проверяйте входящие запросы в обработчике вебхука
• Рассмотрите возможность добавления секретного параметра к URL-адресу вебхука для верификации

Тестирование

1. 1
   Установите URL-адрес вебхука, используя сервис, такой как webhook.site или RequestBin
2. 2
   Переходите по ссылке
3. 3
   Проверьте полученную полезную нагрузку
4. 4
   После проверки переключитесь на URL-адрес вебхука для продакшена

Доступ через API

Вы также можете управлять вебхуками программно через API:

POST   /api/v1/link/:link_id/webhooks
DELETE /api/v1/link/:link_id/webhooks/:hook_id
GET    /api/v1/link/:link_id/webhooks

POST   /api/v1/workspace/:workspace_id/webhooks
DELETE /api/v1/workspace/:workspace_id/webhooks/:hook_id
GET    /api/v1/workspace/:workspace_id/webhooks

Подробности см. в Документации API.