Вебхуки

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

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

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

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

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

Данные вебхука

При возникновении клика 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-адреса никогда не включаются в данные вебхука.

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

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

• Интеграция с 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.