وب‌هوک‌ها

در Growth و Ultimate، Letlink هنگامی که یک کلیک ثبت می‌شود، JSON را با POST به همه URLهای HTTPS ثبت‌شده در فضای کاری ارسال می‌کند. مالکان و مدیران URLها را در یکپارچه‌سازی‌ها ← وب‌هوک‌ها اضافه یا حذف می‌کنند. اعضا فهرست را می‌بینند اما نمی‌توانند آن را تغییر دهند.

افزودن اندپوینت

1. یک URL از نوع HTTPS راه‌اندازی کنید که POST با Content-Type: application/json را بپذیرد. HTTP پذیرفته نمی‌شود.
2. آن را در یکپارچه‌سازی‌ها ← وب‌هوک‌ها جای‌گذاری و ذخیره کنید. نام رویداد link_visited است.
3. روی یکی از لینک‌های کوتاه خود کلیک کنید (از شبکه‌ای که از سقف ماهانه عبور نکرده است). باید ظرف چند ثانیه یک درخواست ببینید — ارسال در صف قرار می‌گیرد، نه همزمان با هدایت.

می‌توانید از طریق API هم مشترک شوید: POST /api/v1/hooks/subscribe با target_url و event اختیاری (پیش‌فرض link_visited). REST Hooks در Zapier همین دو مسیر 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 هدف از دسترس خارج است. ارسال بر اساس بهترین تلاش است و هرگز نباید بازدیدکننده را معطل کند؛ ارسال‌های ناموفق از این صفحه دوباره تلاش نمی‌شوند.

چه کسی چه چیزی دریافت می‌کند

هوک‌ها برای هر کاربر ذخیره می‌شوند. URLهای link_visited همه اعضا برای کلیک روی هر لینکی در فضای کاری مطلع می‌شوند. اگر دو هم‌تیمی هر کدام Zapier را مشترک کرده باشند، هر دو Zap اجرا می‌شوند. URLهای بی‌استفاده را حذف کنید تا یک Catch Hook باقی‌مانده به اجرا شدن ادامه ندهد.