Webhook'lar

Growth ve Ultimate planlarında Letlink, bir tıklama kaydedildiğinde çalışma alanında kayıtlı her HTTPS URL'sine JSON POST eder. Sahipler ve yöneticiler Entegrasyonlar → Webhook'lar altında URL ekler veya kaldırır. Üyeler listeyi görebilir ancak değiştiremez.

Uç nokta ekleyin

1. Content-Type: application/json ile POST kabul eden bir HTTPS URL'si hazırlayın. HTTP reddedilir.
2. Entegrasyonlar → Webhook'lar'a yapıştırıp kaydedin. Olay adı link_visited'dır.
3. Kısa bağlantılarınızdan birine tıklayın (aylık sınırı aşmamış bir ağdan). Birkaç saniye içinde bir istek görmelisiniz — teslimat yönlendirme sırasında değil, kuyruğa alınarak yapılır.

API üzerinden de abone olabilirsiniz: target_url ve isteğe bağlı event (varsayılan link_visited) ile POST /api/v1/hooks/subscribe. Zapier REST Hook'ları aynı abone olma/abonelikten çıkma rota çiftini çağırır.

Yük

Gövde, standart ziyaret nesnesidir. Boş UTM veya mağaza alanları null olur.

{
  "visit_id": 42,
  "visit_time": "2026-09-09T18:01:22+00:00",
  "link_type": "utm",
  "link_shortcode": "summer",
  "link_domain": "letl.ink",
  "link_destination_url": "https://example.com/a",
  "utm_source": "newsletter",
  "utm_campaign": "sep",
  "utm_medium": "email",
  "google_play_app_url": null,
  "google_play_utm_source": null,
  "google_play_utm_campaign": null,
  "app_store_app_url": null,
  "app_store_ct": null,
  "instagram_username": null,
  "visitor_ip": "203.0.113.10",
  "visitor_browser": "Chrome",
  "visitor_device_type": "desktop",
  "visitor_referrer": "https://mail.example.com/",
  "visitor_variation": "hero-b"
}

Bir webhook tetiklenmediğinde

• Çalışma alanı Free veya Solo planında (allowsWebhooks kapalı).
• Aylık izlenen tıklama sınırına zaten ulaşıldı — yönlendirme yine gerçekleşir, ancak satır yazılmaz; bu nedenle hiçbir şey gönderilmez.
• Cihaz başına ziyaret sınırı, tıklama kaydedilmeden önce 429 döndürdü.
• Bir ülke erişimi kuralı ziyaretçiyi geri çevirdi. Engellenen ziyaretler asla tıklama olarak saklanmaz.
• Hedef URL çalışmıyor. Teslimat en iyi çaba esasına dayanır ve ziyaretçiyi asla geciktirmemelidir; başarısız gönderimler bu sayfadan yeniden denenmez.

Kim neyi alır

Hook'lar kullanıcı başına saklanır. Her üyenin link_visited URL'lerine, çalışma alanındaki herhangi bir bağlantıya yapılan tıklamalar bildirilir. İki ekip arkadaşı ayrı ayrı Zapier'e abone olduysa, iki Zap de çalışır. Artık kalan bir Catch Hook'un tetiklenmeye devam etmemesi için kullanılmayan URL'leri kaldırın.