ویب ہُکس

Growth اور Ultimate پر، جب کوئی کلک ریکارڈ ہوتا ہے تو Letlink ورک اسپیس پر رجسٹرڈ ہر HTTPS URL کو JSON بھیجتا ہے۔ مالکان اور ایڈمنز Integrations ← Webhooks کے تحت URLs شامل یا ہٹاتے ہیں۔ اراکین فہرست دیکھ سکتے ہیں لیکن بدل نہیں سکتے۔

اینڈ پوائنٹ شامل کریں

1. ایک HTTPS URL تیار کریں جو Content-Type: application/json کے ساتھ POST قبول کرے۔ HTTP مسترد کر دیا جاتا ہے۔
2. اسے Integrations ← Webhooks میں پیسٹ کریں اور محفوظ کریں۔ ایونٹ کا نام link_visited ہے۔
3. اپنے کسی مختصر لنک پر کلک کریں (ایسے نیٹ ورک سے جو ماہانہ حد سے تجاوز نہ کر چکا ہو)۔ چند سیکنڈز میں آپ کو ایک درخواست نظر آنی چاہیے — ڈیلیوری قطار میں لگتی ہے، ری ڈائریکٹ کے ساتھ فوری نہیں۔

آپ API سے بھی سبسکرائب کر سکتے ہیں: POST /api/v1/hooks/subscribe کے ساتھ target_url اور اختیاری event (ڈیفالٹ link_visited)۔ Zapier REST Hooks بھی انہی subscribe/unsubscribe روٹس کو کال کرتے ہیں۔

پے لوڈ

باڈی معیاری visit آبجیکٹ ہے۔ خالی UTM یا اسٹور فیلڈز null ہوتی ہیں۔

{
  "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"
}

جب ویب ہُک فائر نہ ہو

• ورک اسپیس Free یا Solo پر ہے (allowsWebhooks بند ہے)۔
• ماہانہ ٹریک شدہ کلکس کی حد پہلے ہی پوری ہو چکی ہے — ری ڈائریکٹ پھر بھی ہوتا ہے، کوئی قطار نہیں لکھی جاتی، اس لیے کچھ نہیں بھیجا جاتا۔
• فی ڈیوائس وزٹ کی حد نے کلک محفوظ ہونے سے پہلے 429 لوٹایا۔
• ملکی رسائی کے ایک اصول نے وزیٹر کو واپس کر دیا۔ بلاک شدہ وزٹس کبھی کلکس کے طور پر محفوظ نہیں ہوتے۔
• ٹارگٹ URL بند ہے۔ ڈیلیوری بہترین کوشش پر مبنی ہے اور وزیٹر کو کبھی تاخیر نہیں ہونی چاہیے؛ ناکام پوسٹس اس صفحے سے دوبارہ نہیں بھیجی جاتیں۔

کسے کیا ملتا ہے

ہُکس فی صارف محفوظ ہوتے ہیں۔ ورک اسپیس کے کسی بھی لنک پر کلک ہونے پر ہر رکن کے link_visited URLs کو اطلاع دی جاتی ہے۔ اگر دو ساتھیوں نے الگ الگ Zapier سبسکرائب کیا ہو تو دونوں Zaps چلیں گے۔ غیر استعمال شدہ URLs ہٹا دیں تاکہ کوئی بچا ہوا Catch Hook فائر ہوتا نہ رہے۔