ওয়েবহুক

Growth ও Ultimate-এ কোনো ক্লিক রেকর্ড হলে Letlink ওয়ার্কস্পেসে নিবন্ধিত প্রতিটি HTTPS URL-এ JSON POST করে। মালিক ও অ্যাডমিনরা Integrations → Webhooks-এ URL যোগ বা সরান। সদস্যরা তালিকা দেখতে পারেন, কিন্তু পরিবর্তন করতে পারেন না।

একটি এন্ডপয়েন্ট যোগ করুন

1. Content-Type: application/json-সহ POST গ্রহণ করে এমন একটি HTTPS URL চালু করুন। HTTP প্রত্যাখ্যান করা হয়।
2. এটি Integrations → Webhooks-এ পেস্ট করে সেভ করুন। ইভেন্টের নাম link_visited।
3. আপনার কোনো শর্ট লিংকে ক্লিক করুন (এমন নেটওয়ার্ক থেকে যা মাসিক সীমা ছাড়ায়নি)। কয়েক সেকেন্ডের মধ্যে একটি রিকোয়েস্ট দেখতে পাবেন — ডেলিভারি কিউতে যায়, রিডাইরেক্টের সঙ্গে সঙ্গে নয়।

API থেকেও সাবস্ক্রাইব করতে পারেন: target_url ও ঐচ্ছিক event (ডিফল্ট link_visited) দিয়ে POST /api/v1/hooks/subscribe। Zapier REST Hooks একই subscribe/unsubscribe রুট জোড়া কল করে।

পেলোড

বডি হলো মানক ভিজিট অবজেক্ট। খালি 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 চালু হতে না থাকে।