Webhooki

Webhooki umożliwiają otrzymywanie powiadomień w czasie rzeczywistym, gdy Twoje linki są klikane. Gdy następuje kliknięcie, Linkly wysyła żądanie POST na określony(-e) przez Ciebie adres(-y) URL ze szczegółowymi informacjami o kliknięciu.

• Platformy automatyzacji: Uruchamiaj przepływy pracy w Make lub Zapier, gdy linki są klikane
• Niestandardowa analityka: Wysyłaj dane o kliknięciach do własnego systemu analitycznego
• Aktualizacje CRM: Aktualizuj rekordy klientów, gdy klikają linki
• Powiadomienia Slack: Otrzymuj powiadomienia w Slack, gdy ważne linki są klikane
• Śledzenie potencjalnych klientów: Śledź, gdy potencjalni klienci wchodzą w interakcję z Twoimi linkami

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

Uwaga: Jeśli skonfigurujesz webhooki na obu poziomach, oba uruchomią się przy kliknięciach tego linku.

Gdy następuje 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": {
    "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"
    }
  }
}

Uwaga dotycząca prywatności: Adresy IP nigdy nie są uwzględniane w ładunkach webhooków.

Dla łatwiejszej konfiguracji bez niestandardowego kodowania użyj naszych natywnych integracji:

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

Obie integracje wykorzystują webhooki pod spodem, ale obsługują całą konfigurację automatycznie.

Możesz dodać wiele adresów URL webhooków (jeden w każdej linii). Wszystkie adresy URL otrzymają ten sam ładunek, gdy nastąpi kliknięcie.

• Webhooki działają na zasadzie wystrzel i zapomnij - Linkly nie ponawia nieudanych dostaw
• Niepowodzenia webhooków nigdy nie wpływają na przekierowanie - użytkownicy zawsze docierają do miejsca docelowego
• Upewnij się, że Twój punkt końcowy webhooka odpowiada szybko (zalecane < 5 sekund)

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

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

Możesz również zarządzać webhookami programowo za pomocą 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

Zobacz Dokumentację API po szczegóły.