Webhooks

في Growth وUltimate، يرسل Letlink بيانات JSON عبر POST إلى كل رابط HTTPS مسجّل في مساحة العمل عند تسجيل نقرة. يضيف المالكون والمشرفون الروابط أو يزيلونها ضمن التكاملات ← Webhooks. ويمكن للأعضاء رؤية القائمة لكن لا يمكنهم تغييرها.

إضافة نقطة نهاية

1. جهّز رابط HTTPS يقبل POST مع Content-Type: application/json. يُرفض HTTP.
2. الصقه في التكاملات ← Webhooks واحفظ. اسم الحدث هو link_visited.
3. انقر على أحد روابطك القصيرة (من شبكة لم تتجاوز الحد الشهري). يُفترض أن ترى طلبًا خلال ثوانٍ — التسليم يتم عبر قائمة انتظار، لا ضمن إعادة التوجيه.

يمكنك أيضًا الاشتراك من API: POST /api/v1/hooks/subscribe مع target_url وevent الاختياري (القيمة الافتراضية link_visited). تستدعي REST Hooks في Zapier زوج مساري الاشتراك/إلغاء الاشتراك نفسه.

الحمولة

المتن هو كائن الزيارة القياسي. حقول 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"
}

عندما لا يعمل Webhook

• مساحة العمل على Free أو Solo (allowsWebhooks غير مفعّل).
• تم بلوغ الحد الشهري للنقرات المتتبَّعة بالفعل — تتم إعادة التوجيه، لكن لا يُسجَّل أي صف، لذا لا يُرسَل شيء.
• أرجع حد الزيارات لكل جهاز الرمز 429 قبل تخزين النقرة.
• رفضت قاعدة الوصول حسب البلد الزائر. الزيارات المحظورة لا تُخزَّن أبدًا كنقرات.
• الرابط المستهدف متوقف. التسليم يتم بأفضل جهد ولا يجب أن يؤخر الزائر أبدًا؛ ولا تُعاد محاولة الإرسالات الفاشلة من هذه الصفحة.

من يتلقى ماذا

تُخزَّن الـ hooks لكل مستخدم. تُخطَر روابط link_visited لكل عضو بالنقرات على أي رابط في مساحة العمل. إذا اشترك زميلان كل منهما في Zapier، فسيعمل كلا الـ Zap. أزل الروابط غير المستخدمة حتى لا يستمر Catch Hook متبقٍّ في العمل.