वेबहुक

Growth आणि Ultimate वर, क्लिक नोंदवला गेल्यावर Letlink वर्कस्पेसवर नोंदवलेल्या प्रत्येक HTTPS URL ला JSON POST करते. मालक आणि ॲडमिन इंटिग्रेशन → वेबहुक अंतर्गत URL जोडतात किंवा काढतात. सदस्य यादी पाहू शकतात पण बदलू शकत नाहीत.

एंडपॉइंट जोडा

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

तुम्ही API मधूनही सबस्क्राइब करू शकता: target_url आणि पर्यायी event (डीफॉल्ट link_visited) सह POST /api/v1/hooks/subscribe. Zapier REST Hooks सबस्क्राइब/अनसबस्क्राइब रूटची हीच जोडी कॉल करतात.

पेलोड

बॉडी म्हणजे प्रमाणित 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 URL ना सूचना दिली जाते. दोन सहकाऱ्यांनी प्रत्येकी Zapier सबस्क्राइब केले असल्यास, दोन्ही Zap चालतात. उरलेला Catch Hook चालत राहू नये म्हणून न वापरलेले URL काढून टाका.