Webhooks — إشعارات فورية بالنقرات على روابطك إلى خادمك

لماذا تحتاج Webhooks

احصل على بيانات النقرات لحظة حدوثها وابنِ عليها مساراتك الخاصة

بث فوري

يصلك الحدث لحظة حدوث النقرة، دون الحاجة لاستعلام API على فترات وانتظار التحديثات.

بيانات كاملة لكل نقرة

الدولة والمدينة والجهاز ونظام التشغيل والمتصفح ومصدر الزيارة وعلامة الروبوت — كل ما تحتاجه لتحليلاتك الخاصة.

آمن بطبيعته

كل طلب موقّع بـ HMAC باستخدام مفتاحك السري الخاص، فتميّز بسهولة بين الأحداث الحقيقية والمزيّفة.

تسليم موثوق

إذا كان خادمك غير متاح، تُعاد محاولة التسليم. كل محاولة وحالتها ظاهرة في سجل التسليم.

حالات الاستخدام

إلى أين تُوجَّه أحداث النقر عادة

تحليلاتك أو CRM الخاص بك

خزّن كل نقرة في قاعدة بياناتك أو نظام CRM الخاص بك، وابنِ التقارير بالطريقة التي تناسبك.

إشعارات في تطبيقات الدردشة

اجعل بوت Telegram أو Slack أو Discord يخبرك بالنقرات الجديدة فورًا، دون أي متابعة يدوية.

الأتمتة

شغّل سيناريوهات في Zapier أو Make أو n8n: يتحول حدث النقر إلى مُشغِّل لأي إجراء تاليًا.

ماذا يصلك في الـ webhook

حدث redirects.batch: جسم طلب واحد يجمع دفعة من النقرات ضمن نافذة زمنية واحدة

{
  "delivery_id": "d_01HXY9F0…",
  "event_type": "redirects.batch",
  "sent_at": "2026-08-04T10:15:00Z",
  "window": { "from": "…10:14:00Z", "to": "…10:15:00Z" },
  "count": 1,
  "truncated": false,
  "events": [
    {
      "event_id":   "e_9f86d0…",
      "link_id":    9053352,
      "datetime":   "2026-08-04T10:14:12Z",
      "country":    "DE",
      "city":       "Berlin",
      "browser":    "Chrome",
      "os":         "Android",
      "device":     "mobile",
      "ref_domain": "t.me",
      "group_id":   null,
      "is_bot":     false
    }
  ]
}

لا يُرسَل عنوان IP الخاص بالزائر افتراضيًا (لأنه بيانات شخصية)، ولا يُضاف إلا إذا فعّلته صراحةً لذلك الـ endpoint.

ما الذي تقدّمه Webhooks

إعداد مرن، أمان قوي، وتسليم يمكن التنبؤ به

تسليم الأحداث بدفعات

تصل النقرات على شكل دفعات (redirects.batch) ضمن نافذة زمنية — ما يوفّر عدد الطلبات على خادمك.

نطاق حسب اختيارك

كل روابط حسابك، أو مجموعة محددة، أو رابط واحد — احصل فقط على الأحداث التي تحتاجها.

توقيع HMAC

كل طلب موقّع بمفتاحك السري. يمكنك إعادة إصدار المفتاح السري في أي وقت.

إعادة المحاولة والتعطيل التلقائي

الخادم غير المتاح تُعاد محاولة الوصول إليه؛ والـ endpoint الميّت باستمرار يُعطَّل تلقائيًا.

سجل التسليم

سجل كامل لكل عملية إرسال بحالاتها ومحتواها — يسهّل تتبّع السبب عند حدوث خلل.

إرسال تجريبي (ping)

تحقق من التكامل بنقرة واحدة قبل وصول أي حركة زوار حقيقية — سيصل خادمك حدث اختباري.

بيانات غنية لكل حدث

link_id والوقت والدولة والمدينة ونظام التشغيل والجهاز والمتصفح ومصدر الزيارة وعلامة الروبوت لكل نقرة.

خصوصية افتراضية

لا يُرسَل عنوان IP إلا إذا فعّلته صراحةً لـ endpoint محدد.

جرّبه مجانًا

كيف تعدّ webhook

خمس خطوات — من رابط خادمك إلى تدفق مستمر من أحداث النقر

1

أنشئ endpoint

سجّل في Lix.li، افتح قسم Webhooks، وأدخل رابط خادمك الذي سيرسل إليه Lix.li أحداث النقر.

2

اختر النطاق

قرّر أحداث أي الروابط تريد استقبالها: كل روابط الحساب، أو مجموعة محددة، أو رابط واحد فقط.

3

احفظ مفتاح التوقيع

يمنحك Lix.li مفتاحًا سريًا. كل طلب يُوقَّع بـ HMAC — تحقّق من التوقيع في الترويسة للتأكد أن الحدث وصل فعلًا من Lix.li.

4

أرسل طلبًا تجريبيًا

اضغط "اختبار" (ping) وتأكّد أن خادمك يستقبل الطلب ويردّ برمز 2xx. هكذا تتحقق من التكامل قبل وصول أي حركة زوار حقيقية.

5

راقب سجل التسليم

يعرض السجل كل عمليات الإرسال وحالاتها ومحاولات الإعادة. عند تعذّر الوصول إلى الخادم تُعاد المحاولة تلقائيًا، ويُعطَّل الـ endpoint الميّت باستمرار تلقائيًا.

إعداد webhook

أسئلة شائعة حول Webhooks

ما هو الـ webhook؟

الـ webhook هو إشعار HTTP يرسله Lix.li من تلقاء نفسه إلى خادمك عند حدوث حدث ما. لا تحتاج لاستعلام أي API: تصلك البيانات تلقائيًا لحظة النقر على رابطك.

ما الأحداث التي تُرسَل؟

النقرات على روابطك المختصرة. تصل الأحداث على شكل دفعات (event_type = redirects.batch)، وتحمل كل نقرة الوقت والدولة والمدينة ونظام التشغيل والجهاز والمتصفح ومصدر الزيارة وعلامة الروبوت.

بأي صيغة تصل البيانات؟

بصيغة JSON عبر HTTP POST. يحتوي جسم الطلب على حقول تعريفية (delivery_id، النافذة الزمنية، count) بالإضافة إلى مصفوفة events تحمل بيانات كل نقرة. يوجد مثال كامل لجسم الطلب في هذه الصفحة.

كيف أتحقق أن الطلب وصل فعلًا من Lix.li؟

كل طلب موقّع بـ HMAC بناءً على مفتاحك السري — قارن التوقيع في الترويسة مع جسم الطلب لاستبعاد أي تزوير. يمكنك إعادة إصدار المفتاح السري (تدوير) في أي وقت.

ماذا لو كان خادمي غير متاح مؤقتًا؟

تُعاد محاولة التسليم تلقائيًا. وإذا ظلّ الـ endpoint دون استجابة لفترة طويلة، يُعطَّل مؤقتًا، وتبقى كل المحاولات وحالاتها في سجل التسليم — بحيث لا يضيع أي حدث دون أن تلاحظ.

هل يمكن استقبال أحداث روابط محددة فقط؟

نعم. يمكنك اختيار النطاق: كل روابط الحساب، أو روابط مجموعة محددة، أو رابط واحد فقط — لتفادي حركة زوار زائدة عن الحاجة على خادمك.

هل يُرسَل عنوان IP الخاص بالزائر؟

لا، ليس افتراضيًا، لأنه بيانات شخصية. لا يُضمَّن IP في الأحداث إلا إذا فعّلت ذلك صراحةً في إعدادات الـ endpoint المحدد.

في أي باقة تتوفر Webhooks؟

تتوفر Webhooks في باقة Premium فقط. سجّل واشترك في Premium لربط الـ endpoint الخاص بك.

ابنِ تكاملاتك على أحداث النقر

أعدّ webhook في دقيقتين — واحصل على بيانات النقرات بالضبط حيث تحتاجها.

Webhooks في Lix.li هي طريقة للحصول على إشعارات النقرات على روابطك المختصرة تلقائيًا. بدل استعلام API باستمرار، تعطي Lix.li رابط خادمك، فترسل إليه طلب HTTP POST لحظة حدوث النقرة. هذا هو الـ HTTP callback الكلاسيكي لـالروابط المختصرة، الذي يوصل أحداث النقر إلى نظامك بثًا فوريًا.

كل جسم طلب هو حدث redirects.batch يحتوي مصفوفة من النقرات: تحمل كل نقرة الوقت والدولة والمدينة والمتصفح ونظام التشغيل والجهاز ومصدر الزيارة وعلامة الروبوت. يسهل تخزين هذه البيانات في قاعدة بياناتك أو نظام CRM الخاص بك، وتحويلها إلى إشعارات نقرات في Telegram أو Slack أو Discord، أو استخدامها كمُشغِّل في Zapier وMake وn8n. الطلبات محمية بـتوقيع HMAC: تقارن التوقيع في الترويسة مع جسم الطلب لاستبعاد التزوير، ويمكنك إعادة إصدار المفتاح السري متى احتجت.

التسليم يمكن التنبؤ به: عند تعطّل الخادم تُعاد محاولة إرسال الأحداث، ويُعطَّل الـ endpoint الميّت باستمرار مؤقتًا، وتظهر كل محاولة في سجل التسليم. يمكنك تحديد النطاق ليشمل كل الروابط أو مجموعة واحدة أو رابطًا واحدًا، والتحقق من التكامل بإرسال تجريبي (ping) قبل وصول أي حركة زوار حقيقية. تعمل Webhooks جنبًا إلى جنب مع روابط Lix.li المختصرة العادية وأكواد QR والإحصاءات، وهي متاحة في باقة Premium.