वेबहुक

Growth और Ultimate पर, जब कोई क्लिक दर्ज होता है, तो Letlink वर्कस्पेस पर रजिस्टर हर HTTPS URL पर JSON POST करता है। मालिक और एडमिन इंटीग्रेशन → वेबहुक में URL जोड़ते या हटाते हैं। सदस्य सूची देख सकते हैं लेकिन बदल नहीं सकते।

एंडपॉइंट जोड़ें

1. एक HTTPS URL तैयार करें जो Content-Type: application/json के साथ POST स्वीकार करे। HTTP अस्वीकार कर दिया जाता है।
2. इसे इंटीग्रेशन → वेबहुक में पेस्ट करें और सेव करें। इवेंट का नाम link_visited है।
3. अपने किसी शॉर्ट लिंक पर क्लिक करें (ऐसे नेटवर्क से जो मासिक सीमा पार न कर चुका हो)। कुछ ही सेकंड में आपको एक अनुरोध दिखना चाहिए — डिलीवरी कतार में जाती है, रीडायरेक्ट के साथ नहीं।

आप API से भी सब्सक्राइब कर सकते हैं: target_url और वैकल्पिक event (डिफ़ॉल्ट link_visited) के साथ POST /api/v1/hooks/subscribe। Zapier REST Hooks सब्सक्राइब/अनसब्सक्राइब के इन्हीं रूट को कॉल करते हैं।

पेलोड

बॉडी मानक विज़िट ऑब्जेक्ट है। खाली 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 URL को सूचना मिलती है। अगर दो साथियों ने अलग-अलग Zapier सब्सक्राइब किया है, तो दोनों Zap चलेंगे। इस्तेमाल न होने वाले URL हटा दें ताकि कोई बचा हुआ Catch Hook चलता न रहे।