التدفقات التفاعلية

نماذج متعددة الشاشات على نمط WhatsApp Flow (التسجيل وقوائم الانتظار وجمع البيانات).

المفاهيم

الكائن	الوصف
Bot	حاوية (runtime_mode=local أو خدمة الشريك)
Flow	مسار مُسمّى متعدد المراحل (code وصورة البطاقة وCTA)
Step	شاشة: form أوinput أوselect أوend وغيرها
الدعوة	رسالة في المركز بقيمة content_type=flow؛ تفتح النموذج

دعوة مستخدم إلى تدفق

POST /api/v1/bots/{bot_code}/flows/{flow_code}/invite

{
  "phone": "+228XXXXXXXX",
  "body": "Rejoignez la liste d’attente SEED."
}

ينشئ بطاقة تدفق مستقلة في مركز الشريك (وليس محادثة دعم).

مثال

curl -X POST "$API/bots/portail/flows/waitlist/invite" \
  -H "Authorization: Bearer $KEY" \
  -H "Content-Type: application/json" \
  -d '{"phone":"+228XXXXXXXX"}'

جلسة المستخدم النهائي (تطبيقات العميل)

تستخدم تطبيقات العميل JWT الخاص بالمستخدم (وليس مفتاح الشريك):

نقطة النهاية	الهدف
POST /me/flows/start	بدء الجلسة / استئنافها
POST /me/bots/sessions/{ref}/input	إرسال المرحلة (form_submit أو نص أو otp)
GET /me/flows	سرد التدفقات المتاحة

حمولة إرسال النموذج

{
  "type": "form_submit",
  "values": {
    "full_name": "Ama Koffi",
    "phone": "+22890000000",
    "email": "[email protected]"
  }
}

التحقق

يتحقق الخادم من أنواع الحقول (البريد الإلكتروني وهاتف E.164 والرقم والتاريخ وselect وغيرها).
راجع التحقق من الحقول.

الإكمال

عند الإكمال بنجاح، تتحول بطاقة التدفق نفسها إلى status=completed مع ملخص للإجابات في وضع القراءة فقط. لا تُنشر رسائل دردشة المراحل الوسيطة.

تعريف تدفق محلي

أعدّه في Partner Hub (MorisBox ← Bots) أو باستخدام بيانات seed / provisioning:

• Bot:‏ runtime_mode=local
• Flow: حقول البطاقة (code والصورة وCTA)
• Steps:‏ fields_json للنماذج متعددة الحقول