المفاهيم الأساسية

الحسابات

الحساب هو مستخدم نهائي يُعرّف برقم هاتف E.164 (+228…).

الحالة	المعنى
pending	مدعو / لم يكتمل التحقق منه بعد
claimed	أكمل المستخدم التحقق عبر OTP ويمكنه استخدام التطبيق
blocked	ألغى الاشتراك / محظور

يربط الشركاء الحسابات بأنفسهم (M2M أو حقول المزوّد). يرى المستخدمون المرتبطون ذلك الشريك في مركزهم.

الشركاء

الشريك هو مؤسسة (مثل SEED) لديها:

• مفاتيح API
• قوالب
• سلسلة قنوات (in-app ← WhatsApp ← SMS)
• روبوتات وتدفقات اختيارية
• هوية مرئية (الشعار والاسم)

الرسائل

يمكن أن تكون رسائل الشريك ← المستخدم:

النوع	السلوك في المركز
نص أو وسائط أو رابط أو HTML	رسائل مركز مستقلة (قائمة، والأحدث أولًا)
دعوات إلى تدفقات	بطاقات تدفق مستقلة
ردود الدعم	ضمن محادثة يبدأها المستخدم

تنشئ API الشركاء POST /messages رسائل في المركز، وليس محادثات دعم.

أنواع المحتوى

content_type	الوصف
text	نص عادي
image	عنوان URL لصورة أو base64
document	ملفات PDF / ملفات أخرى
audio	ملف صوتي
video	ملف فيديو
link	بطاقة CTA‏ (url + label + title)
html	نشرة إخبارية للهاتف (HTML)
flow	دعوة إلى نموذج تفاعلي متعدد المراحل
system	رسالة نظام المنصة

المحادثات

المحادثات هي تفاعلات دعم:

• تُنشأ عندما يبدأ المستخدم طلب دعم
• يرد الوكلاء عبر Partner Hub / API الوكيل
• يمكن أن تستخدم جلسات الروبوت مواضيع مثل Bot · … (تُخفى من قائمة «المحادثات» لدى المستخدم)

قنوات التسليم

تُعد لكل شريك كسلسلة مرتبة، على سبيل المثال:

1. inapp: تطبيق MorisBox للهاتف / Application Client
2. whatsapp
3. sms

يمكن لرموز OTP والرسائل المهمة فرض مجموعة فرعية من القنوات.

للاطلاع على الكتالوج الكامل لأسطح العميل وأدوات الشركاء وسلوك القنوات، راجع المنصات.

التكرار الآمن

مرّر idempotency_key عند الإرسال لتجنب النسخ المكررة أثناء إعادة المحاولة:

{ "idempotency_key": "partner-order-98765" }

يُرجع الشريك نفسه + المفتاح نفسه الرسالة الأصلية.