الوثائق

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

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

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

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

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

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

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

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

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

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

تتيح أداة email.send لوكيل إرسال بريد إلكتروني (تقرير، تأكيد، متابعة) من أحد حسابات البريد الإلكتروني المربوطة بالمؤسسة. وبالاقتران مع قناة الجدولة، تكون أساس تقرير متكرّر.

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

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

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

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

تحويل مكالمة

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

لماذا هي آمنة

  • إرسال البريد الإلكتروني احترازي (idempotent): في حال إعادة نشر أو إعادة محاولة للدورة نفسها، لا تُرسَل الرسالة مرّتين.
  • يستخدم رابط دفع Stripe مفتاح Stripe الخاص بمؤسستك أنت: فأنت من يحصّل، ويُتحقَّق من الدفعة (stripe.check_payment) قبل إطلاق الإجراء.
  • يتيح claim_row ضمان أن مهمّة صادرة عن طابور في قاعدة البيانات لا تُعالَج إلا مرّة واحدة.