الوثائق

إجراءات بلا كود

الإجراءات التي يمكن لوكيل تشغيلها دون كتابة كود — الكتابة إلى قاعدة بيانات، إرسال بريد، تحصيل دفعة، تحويل مكالمة.

إجراءات بلا كود

لا يكتفي الوكيل بالردّ: بل يستطيع التصرّف. ويوفّر betool مجموعة من الإجراءات الجاهزة للاستخدام يستدعيها الوكيل عند الاقتضاء — دون سطر كود واحد.

الكتابة إلى قاعدة بيانات

انطلاقًا من قاعدة بيانات، يستطيع الوكيل:

  • إنشاء صفّ — تسجيل عميل محتمل، أو طلب، أو موعد.
  • تحديث صفّ — تغيير حالة، أو ملء حقل.
  • حجز صفّ (claim_row) — عملية «مقارنة وتعيين» ذرّية: تضمن معالجة المهمّة نفسها مرّة واحدة فقط، حتى لو كانت عدّة عمليات تنفيذ تجري بالتوازي (exactly-once).

claim_row هو لَبِنة طابور مهام موثوق: مُراقِب يكتشف الصفوف الجديدة للمعالجة، ويحجزها واحدًا تلو الآخر، ولا أحد يعالج الصفّ نفسه مرّتين.

الاستيراد بالجملة

لتغذية قاعدة بيانات، يستورد مساعد من 3 خطوات ملف xlsx / csv (بما في ذلك ربط الأعمدة). مفيد لتحميل سجلّ أو قائمة جهات اتصال.

إرسال بريد إلكتروني

تتيح أداة email.send لوكيل إرسال بريد إلكتروني (تقرير، تأكيد، متابعة) ضمن الـpipeline الخاص به. وبالاقتران مع قناة الجدولة، تكون أساس تقرير متكرّر.

تحصيل دفعة (رابط دفع)

مع تكامل Stripe، يستطيع الوكيل:

  • توليد رابط دفع بـStripe Checkout (stripe.create_payment_link).
  • التحقق من الدفعة (stripe.check_payment) قبل تأكيد إجراء.

الاستخدام النموذجي: جعل موعد مدفوعًا مسبقًا قبل وضعه في التقويم.

تحويل مكالمة

على قناة الهاتف، يستطيع الوكيل تحويل المكالمة إلى رقم آخر (SIP REFER) — مثلًا، توجيه متصل VIP إلى خطّ مباشر. ويُتحقَّق من الرقم المستهدَف بصيغة E.164.

لماذا هي آمنة

  • الإجراءات ذات الأثر الجانبي الخارجي (البريد، الدفع، النشر) احترازية (idempotent): في حال إعادة نشر أو إعادة محاولة، لا يُنفَّذ الإجراء مرّتين أبدًا.
  • قد تتطلّب الإجراءات الحسّاسة موافقة بشرية قبل التنفيذ (راجع المقترحات والموافقة).