Webhooks

Webhooks pozwalają Ci otrzymywać powiadomienia 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 URL (adresy) z szczegółowymi informacjami o każdym zdarzeniu.

Przypadki użycia

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

Wskazówka: W większości przypadków automatyzacji nasza integracja Make lub integracja Zapier są łatwiejsze do skonfigurowania niż niestandardowe webhooks. Zawierają wyzwalacze kliknięć zasilane webhooks, bez konieczności pisania kodu.

Uwaga: Jeśli skonfigurujesz webhooks na obu poziomach, oba będą uruchamiane dla kliknięć na ten link.

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 na najwyższym poziomie, aby je rozróżnić:

Ładunek webhook

Ładunek kliknięcia

Gdy nastąpi kliknięcie, Linkly wysyła żądanie POST z następującym ładunkiem 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"
    }
  }
}

Pola ładunku

Informacje o zdarzeniu

Obiekt Link

Obiekt Click

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

Ładunek cyklu życia linku

Zdarzenia link.created, link.updated i link.deleted mają jedną strukturę. Brak 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 wyzwalaczami kliknięć w czasie rzeczywistym
• Integracja Zapier - Połącz Linkly z tysiącami aplikacji bez kodu

Obie integracje używają webhooks pod maską, ale obsługują całą konfigurację automatycznie.

Najlepsze praktyki

Wiele webhooks

Możesz dodać wiele adresów URL webhooks (jeden na linię). Wszystkie adresy URL będą otrzymywać ten sam ładunek, gdy nastąpi kliknięcie.

Obsługa błędów

• Webhooks to fire-and-forget - Linkly nie powtarza nieudanych dostaw
• Awarie webhook nigdy nie wpływają na przekierowanie - użytkownicy zawsze docierają do celu
• Upewnij się, że Twój endpoint webhook odpowiada szybko (< 5 sekund zalecane)

Bezpieczeństwo

• Używaj endpoints HTTPS dla adresów URL webhooks
• Waliduj przychodzące żądania w obsługiwanym webhook
• Rozważ dodanie parametru tajnego 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
   Zbadaj odebrany ładunek
4. 4
   Po weryfikacji przejdź do produkcyjnego adresu URL webhook

Dostęp API

Możesz również zarządzać webhooks 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.