طلبات الويب والـ Webhooks

يتكامل GetMyBot مع الأنظمة الخارجية عبر HTTP في الاتجاهين: الطلبات الواردة تُشغّل التفاعلات، وإجراءات الصادرة تستدعي APIs خارجية. هذا يربط البوت بـ CRM ومنصات الدفع والنماذج على الموقع وأي خدمات.

الـ Webhook الوارد (مُشغِّل)

مُشغِّل «طلب ويب وارد (webhook)» يُشغّل تفاعلاً بطلب HTTP من الخارج:

  • المسار — عنوان المستقبِل (يتشكّل URL الكامل من عنوان البوت والمسار).
  • الرمز السري — يحمي نقطة النهاية من الغرباء.
  • الطريقة — POST / GET / PUT / ANY.

تصل بيانات الطلب (حقول النموذج أو الجسم) إلى سياق التنفيذ وتتاح في الإجراءات عبر {{ctx.حقل}}. هكذا يستطيع الموقع أو الخدمة «دفع» حدث للبوت — مثلاً: تمّ الدفع → أرسل للمستخدم صلاحية الوصول.

طلب الويب الصادر (إجراء)

إجراء «طلب الويب» يُنفّذ طلب HTTP من التفاعل:

  • الطريقة (GET/POST/PUT/DELETE) والترويسات والجسم (JSON أو نموذج)؛
  • أكواد النجاح والمهلة وعدد إعادات المحاولة عند الخطأ؛
  • حفظ الاستجابة في معامل أو ctx بـ JSONPath؛
  • وضع غير متزامن (لا يُوقف التفاعل) وتشغيل تفاعلات عند النجاح/الخطأ.

إجراءات مشابهة: «تحميل URL» (تنزيل نص صفحة في ctx) و**«الاستعلام من المصدر» / «الكتابة في المصدر»** للموصّلات المحفوظة — راجع المصادر والمفاتيح.

تكامل Webhook

للإرسال المنتظم للبيانات إلى خدمة واحدة الأنسب إعداد تكامل «Webhook» (URL + توقيع HMAC) — راجع التكاملات.

الأمان

نقاط النهاية الواردة محمية بالرمز السري؛ الطلبات الصادرة تمر عبر حماية من SSRF (لا يمكن الوصول إلى الشبكة الداخلية)، وحجم الاستجابة محدود.

الخطوات التالية