Webhooks

Webhooks umożliwiają otrzymywanie powiadomień w czasie rzeczywistym o Twoich linkach — zarówno gdy są klikane, jak i gdy są tworzone, aktualizowane lub usuwane. Linkly wysyła żądanie POST na określony(e) adres(y) URL zawierający szczegółowe informacje o każdym zdarzeniu.

Przypadki użycia

• Platformy automatyzacji: Wyzwalaj przepływy pracy w Make lub Zapier gdy linki są klikane
• Niestandardowa analityka: Wyślij dane o klikach do własnego systemu analityki
• Aktualizacje CRM: Aktualizuj rekordy klientów gdy klikają na linki
• Powiadomienia Slack: Otrzymuj powiadomienia na Slack gdy ważne linki są klikane
• Śledzenie potencjalnych klientów: Śledź kiedy potencjalni klienci angażują się z Twoimi linkami

Porada: W przypadku większości scenariuszy automatyzacji nasza integracja Make lub integracja Zapier są łatwiejsze w konfiguracji niż niestandardowe webhooks. Zawierają natychmiastowe wyzwalacze kliknięć zasilane webhookami, bez konieczności kodowania.

Uwaga: Jeśli skonfigurujesz webhooks na obu poziomach, oba będą wyzwalane dla kliknięć na tym linku.

Zdarzenia

Każdy webhook otrzymuje wszystkie typy zdarzeń dla swojego zakresu — webhook na poziomie linku otrzymuje zdarzenia dla tego linku, webhook na poziomie obszaru roboczego otrzymuje zdarzenia dla każdego linku w obszarze roboczym. Sprawdź pole event najwyższego poziomu aby je odróżnić:

Zawartość webhook

Zawartość kliknięcia

Gdy dojdzie do kliknięcia, Linkly wysyła żądanie POST z następującą zawartością 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"
    }
  }
}

Pola zawartości

Informacje o zdarzeniu

Obiekt linku

Obiekt kliknięcia

Uwaga o prywatności: Adresy IP nigdy nie są zawarte w zawartości webhook.

Zawartość cyklu życia linku

Zdarzenia link.created, link.updated i link.deleted mają tę samą strukturę. Nie ma obiektu click — otrzymujesz event, timestamp i pełny 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": []
  }
}

Integracje platform automatyzacji

Aby ułatwić konfigurację bez niestandardowego kodowania, użyj naszych natywnych integracji:

• Integracja Make - Wizualna platforma automatyzacji z natychmiastowymi wyzwalaczami kliknięć
• Integracja Zapier - Połącz Linkly z tysiącami aplikacji bez kodu

Obie integracje używają webhooków pod spodem, ale obsługują całą konfigurację automatycznie.

Najlepsze praktyki

Wiele webhook

Możesz dodać wiele adresów URL webhook (jeden na linię). Wszystkie adresy URL będą otrzymywać tę samą zawartość gdy dojdzie do kliknięcia.

Obsługa błędów

• Webhooks są fire-and-forget - Linkly nie ponawia nieudanych dostaw
• Błędy webhook nigdy nie wpływają na przekierowanie - użytkownicy zawsze docierają do swojego celu
• Upewnij się że Twój endpoint webhook odpowiada szybko (< 5 sekund rekomendowane)

Bezpieczeństwo

• Użyj adresów HTTPS dla adresów URL webhook
• Sprawdzaj przychodzące żądania w obsłudze webhook
• Rozważ dodanie tajnego parametru do adresu URL webhook dla weryfikacji

Testowanie

1. 1
   Skonfiguruj adres URL webhook używając usługi takiej jak webhook.site lub RequestBin
2. 2
   Kliknij swój link
3. 3
   Sprawdź otrzymaną zawartość
4. 4
   Po weryfikacji przełącz się na produkcyjny adres URL webhook

Dostęp do API

Możesz również zarządzać webhook programowo za pośrednictwem 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

Szczegóły znajdują się w Dokumentacji API.