Вебхуки

Вебхуки позволяют получать уведомления в реальном времени о ваших ссылках — как когда на них кликают, так и когда они создаются, обновляются или удаляются. 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": {
    "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"
    }
  }
}

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

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

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

Объект клика

Примечание о конфиденциальности: 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-адреса будут получать одинаковую полезную нагрузку при клике.

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

• Вебхуки работают по принципу fire-and-forget — 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.