Webhooks

Webhooks umożliwiają otrzymywanie powiadomień w czasie rzeczywistym, gdy ktoś klika na Twoje linki. Gdy nastąpi klik, Linkly wysyła żądanie POST na określony adres URL z szczegółowymi informacjami o kliknięciu.

Przypadki użycia

• Platformy automatyzacji: Wyzwalaj przepływy pracy w Make lub Zapier gdy ktoś klika na linki
• Niestandardowa analityka: Wyślij dane o klikach do swojego systemu analityki
• Aktualizacje CRM: Aktualizuj rekordy klientów po kliknięciu na linki
• Powiadomienia Slack: Otrzymuj powiadomienia na Slacku, gdy ktoś klika na ważne linki
• Śledzenie potencjalnych klientów: Śledź interakcje potencjalnych klientów z Twoimi linkami

Wskazówka: W przypadku większości scenariuszy automatyzacji nasza integracja Make lub integracja Zapier są łatwiejsze do skonfigurowania niż niestandardowe webhooks. Zawierają wyzwalacze natychmiastowych kliknięć zasilane webhookami, bez konieczności kodowania.

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

Ładunek webhooka

Gdy nastąpi klik, 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": {
    "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 linku

Obiekt kliknięcia

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

Integracje platform automatyzacji

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

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

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 webhooków (jeden na linię). Wszystkie adresy URL otrzymają ten sam ładunek, gdy nastąpi klik.

Obsługa błędów

• Webhooks działają na zasadzie "wyślij i zapomnij" - Linkly nie ponawia nieudanych dostaw
• Awarie webhooka nigdy nie wpływają na przekierowanie - użytkownicy zawsze dotrą do celu
• Upewnij się, że punkt końcowy webhooka odpowiada szybko (poniżej 5 sekund zalecane)

Bezpieczeństwo

• Używaj punktów końcowych HTTPS dla adresów URL webhooków
• Weryfikuj przychodzące żądania w obsługi webhooka
• Rozważ dodanie tajnego parametru do adresu URL webhooka w celu weryfikacji

Testowanie

1. 1
   Skonfiguruj adres URL webhooka za pomocą usługi takiej jak webhook.site lub RequestBin
2. 2
   Kliknij na swój link
3. 3
   Sprawdź otrzymany ładunek
4. 4
   Po weryfikacji przejdź na produkcyjny adres URL webhooka

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 znajdują się w Dokumentacji API.