Webhooks

Webhooks umożliwiają otrzymywanie powiadomień w czasie rzeczywistym dotyczących twoich linków — zarówno gdy są klikane, jak i gdy są tworzone, aktualizowane lub usuwane. Linkly wysyła żądanie POST na podany(e) adres(y) URL ze szczegółowymi informacjami o każdym zdarzeniu.

Przypadki użycia

• Platformy automatyzacji: Wyzwól przepływy pracy w Make lub Zapier gdy linki są klikane
• Niestandardowa analityka: Wyślij dane kliknięć do własnego systemu analityki
• Aktualizacje CRM: Aktualizuj rekordy klientów gdy klikną linki
• Powiadomienia Slack: Otrzymuj powiadomienia w Slack gdy ważne linki są klikane
• Śledzenie potencjalnych klientów: Śledź zaangażowanie potencjalnych klientów z twoimi linkami

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

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

Zdarzenia

Każdy webhook otrzymuje wszystkie typy zdarzeń dla jego 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 poziomie najwyższym, aby je rozróżnić:

Zawartość webhooku

Zawartość kliknięcia

Gdy następuje kliknięcie, 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": {
    "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 zawartości

Informacje o zdarzeniu

Obiekt linku

Obiekt kliknięcia

Uwaga o prywatności: Adresy IP nigdy nie są uwzględniane w zawartościach webhooków.

Zawartość cyklu życia linku

Zdarzenia link.created, link.updated i link.deleted mają jeden kształt. 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, skorzystaj z 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ów

Możesz dodać wiele adresów URL webhooku (jeden w każdym wierszu). Wszystkie adresy URL będą otrzymywać tę samą zawartość gdy następuje kliknięcie.

Obsługa błędów

• Webhooki to wypal i zapomnij - Linkly nie ponawia nieudanych dostaw
• Błędy webhooku nigdy nie wpływają na przekierowanie - użytkownicy zawsze docierają do celu
• Upewnij się, że endpoint webhooku odpowiada szybko (< 5 sekund zalecane)

Bezpieczeństwo

• Używaj punktów końcowych HTTPS dla adresów URL webhooków
• Sprawdzaj poprawność żądań przychodzących w obsługiwaczu webhooku
• Rozważ dodanie parametru tajnego do adresu URL webhooku w celu weryfikacji

Testowanie

1. 1
   Skonfiguruj adres URL webhooku 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 webhooku

Dostęp do API

Możesz również zarządzać webhookami 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 można znaleźć w Dokumentacji API.