Вебхуки

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

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

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

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

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

События

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

Payload вебхука

Payload клика

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

{
  "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": {
    "id": "01KYPGEEPJSPR3S564QRBDGA1W",
    "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"
    }
  }
}

Поля payload

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

Объект Link

Объект Click

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

Payload жизненного цикла ссылки

События 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-адреса получат один и тот же payload при возникновении клика.

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

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

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

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

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

1. 1
   Установите URL вебхука, используя сервис типа webhook.site или RequestBin
2. 2
   Нажмите на вашу ссылку
3. 3
   Проверьте полученный payload
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.