المنصات

يوفر MorisBox API واحدة للشركاء تصل إلى المستخدمين عبر أسطح عملاء وقنوات تسليم متعددة. تجمع هذه الصفحة كل ما هو متاح حاليًا.

نظرة سريعة

الطبقة	الوصف	من يستخدمها
Partner API	API بنمط REST (`/api/v1`) للرسائل والحسابات والقوالب والروبوتات وخطافات الويب	نظامك الخلفي
Partner Hub	وحدة تحكم ويب للمفاتيح والروبوتات والقوالب وردود الدعم	مشغلو الشريك
Partner Docs	هذا الموقع: مرجع API وأدلة التكامل	المطورون
تطبيق الهاتف	تطبيق أصلي للمستخدم النهائي على iOS / Android (Expo)	المستخدمون النهائيون
Application Client	تطبيق ويب تقدمي (المنتج نفسه كتطبيق الهاتف)	المستخدمون النهائيون
الوقت الفعلي	تحديثات مباشرة (صندوق الوارد والدردشة والبث)	عملاء الهاتف / Application Client
قناة in-app	التسليم في تطبيق الهاتف / Application Client من MorisBox	المسار الأساسي
قناة WhatsApp	انتقال احتياطي / وصول عندما لا تتوفر in-app	مسار احتياطي
قناة SMS	المسار الاحتياطي الأخير (OTP والتنبيهات المهمة)	مسار احتياطي

استدعاء إرسال واحد؛ ويختار MorisBox أفضل قناة بالترتيب.

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

تُعد لكل شريك في صورة سلسلة مرتبة (يمكن تجاوزها لكل رسالة). ترتيب إنتاج شائع:

الترتيب	رمز القناة	السطح	الاستخدام المعتاد
1	`inapp`	تطبيق الهاتف + Application Client من MorisBox	رسائل المركز والتدفقات والنشرات والدردشة: أغنى تجربة
2	`whatsapp`	WhatsApp	المستخدم غير متصل / من دون تطبيق؛ تنبيهات مكيّفة مع القوالب
3	`sms`	SMS	OTP والحسابات غير المطالب بها والنص كحل أخير

ملاحظات السلوك

الموضوع	القاعدة
حساب مُطالب به	تفضيل `inapp` عندما يكون المستخدم قد طالب بحسابه في MorisBox
غير مُطالب به	غالبًا ما تُتخطى in-app (`not_claimed`) ← WhatsApp / SMS
OTP	يمكنه فرض SMS / WhatsApp (لا توجد جلسة تطبيق بعد)
المهل الزمنية	لكل مرحلة؛ وعند الفشل أو انتهاء المهلة ← القناة التالية
تذكير عدم الاتصال	بعد التسليم عبر in-app، إذا كان المستخدم غير متصل ← WhatsApp/SMS: «رسالة جديدة في MorisBox» (من دون جسم E2EE)
التكرار الآمن	لا تنشئ `idempotency_key` نفسها توزيعًا مكررًا

راجع المفاهيم الأساسية للتعرف على دورة حياة الحساب، والرسائل للاطلاع على حمولات الإرسال.

منصات المستخدم النهائي

يصادق المستخدمون باستخدام رقم الهاتف + OTP. ويظهر الشركاء المرتبطون في مركزهم.

الهاتف (iOS / Android)


المنتج	تطبيق MorisBox الأصلي (Expo)
المصادقة	OTP من دون كلمة مرور
الميزات	مركز الشركاء ورسائل مستقلة ووسائط ونشرات HTML وCTA برابط وتدفقات تفاعلية وروبوتات ومحادثات دعم وتثبيت / غير مقروءة وتحديثات فورية
مثالي لـ	تجربة كاملة تدعم عدم الاتصال، وعملاء جاهزون للإشعارات الفورية، ومستهلكون في الإنتاج

Application Client (الويب)


المنتج	منتج المستخدم النهائي نفسه في صورة تطبيق ويب تقدمي
المصادقة	OTP من دون كلمة مرور
الميزات	نموذج المركز نفسه كتطبيق الهاتف: الرسائل والتدفقات والروبوتات والدعم والنشرات
مثالي لـ	وصول فوري بلا تثبيت من متجر؛ وعروض توضيحية للشركاء ومستخدمي سطح المكتب

ما يراه المستخدمون (نموذج المركز)

المنطقة	الهدف
الرسائل	عناصر مستقلة للشريك (نص ووسائط وروابط وHTML وبطاقات تدفق): ليست محادثة
النماذج / الروبوتات	تدفقات تفاعلية متعددة المراحل وقوائم روبوت
المحادثات	محادثات دعم يبدأها المستخدم

تستهدف Partner API عبر POST /messages المركز دائمًا، وليس دردشة الدعم. التفاصيل: واجهة الرسائل وتجاربها.

منصات الشركاء

Partner API


القاعدة	`https://api.morisbox.com/api/v1` (Sandbox)
المصادقة	`Authorization: Bearer <api_key>`
الإمكانات	إرسال الرسائل (جميع أنواع المحتوى) والحسابات والربط والقوالب والبث والمحادثات (الوكيل) والروبوتات وخطافات الويب وSandbox

الخريطة الكاملة: نظرة عامة على API · البدء السريع · المصادقة.

Partner Hub


المنتج	وحدة تحكم ويب للمشغلين
المهام المعتادة	مفاتيح API والقوالب وإعدادات القنوات وإعداد الروبوت / التدفق وردود الدعم وهواتف Sandbox والامتثال
عنوان URL (Sandbox)	https://partner.morisbox.com

لوحة المطور


المنتج	وحدة تحكم مبسطة للمطورين غير الشركاء
المهام المعتادة	مفاتيح `sk_dev_…` وخطافات الويب والإرسال عبر القوالب المعتمدة والسجل
عنوان URL (Sandbox)	https://developers.morisbox.com/login
الوثائق	حسابات المطورين

وثائق الشركاء


المنتج	Partner Docs (docs.morisbox.com/partners) + Developer Docs (docs.morisbox.com/developers)
الجمهور	مهندسو التكامل (الشركاء والمطورون)
النطاق	REST وأنواع الوسائط والنشرات والتدفقات والروبوتات وخطافات الويب والمطورون وSandbox

منصة الوقت الفعلي

تحديثات مباشرة لعملاء المستخدم النهائي (رسائل مركز جديدة وأحداث محادثة وتسليم البث).


النقل	Socket.IO عبر حافة الوقت الفعلي
العملاء	تطبيق الهاتف + Application Client (جلسات مستخدم مصادق عليها)
نموذج التوسع	بوابات عديمة الحالة؛ rooms لكل حساب مستخدم
الأثر على الشريك	ترسل مرة واحدة دائمًا عبر REST؛ ويتحدث العملاء مباشرة من دون polling

لا تستدعِ طبقة الوقت الفعلي من الأنظمة الخلفية للشركاء في الإرسال المعتاد؛ تكفي Partner API.

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

`content_type`	In-app (الهاتف / Application Client)	WhatsApp	SMS
`text`	كامل	نعم (نص)	نعم (مقتطع)
`image`	عارض كامل	يعتمد على المزوّد	رابط / تخطٍ
`document`	تنزيل / فتح	يعتمد على المزوّد	رابط / تخطٍ
`audio`	مشغّل	يعتمد على المزوّد	رابط / تخطٍ
`video`	مشغّل	يعتمد على المزوّد	رابط / تخطٍ
`link`	بطاقة CTA	نص + عنوان URL	عنوان URL
`html`	قارئ نشرة HTML كامل	ملخص / رابط	ملخص / رابط
`flow`	واجهة تفاعلية متعددة المراحل	نص دعوة + deep link	نص دعوة
`system`	إشعار من المنصة	نادر	نادر

تكون التجربة الأغنى دائمًا عبر in-app. صمم الحمولات لـin-app أولًا؛ واحتفظ بنص قصير متوافق مع SMS للانتقال الاحتياطي في الميل الأخير.

المنصات التفاعلية (التدفقات والروبوتات)

الإمكانية	السطح	الوثائق
دعوة إلى تدفق	بطاقة تدفق في المركز ← نموذج متعدد الشاشات	التدفقات التفاعلية
روبوت محلي	قوائم / مراحل معرفة في MorisBox	360Bots
روبوت خدمة	بيئة تشغيل HTTPS الخاصة بك (`/start` و`/input`)	الروبوتات · بيانات اعتماد الروبوتات
التحقق من الحقول	قواعد لكل مرحلة قبل الإرسال	التحقق من الحقول
خطافات الويب	أحداث صادرة / أوامر واردة	خطافات الويب · بيانات اعتماد الروبوتات

مصفوفة المنصات (من يتواصل مع ماذا)

Your systems
    │  Partner API key
    ▼
Partner API  ──────►  routing (inapp → whatsapp → sms)
    │                        │
    │                        ├─► Mobile / Application Client (hub + realtime)
    │                        ├─► WhatsApp
    │                        └─► SMS
    │
    ├─► Partner Hub (operators)
    └─► Webhooks → your HTTPS endpoints

ملخص التوفر

المنصة	الحالة	ملاحظات
Partner REST API	متاحة	مسار الإنتاج للتكاملات
Partner Hub	متاح	العمليات والإعداد
Partner Docs	متاحة	هذا الموقع
تطبيق الهاتف	متاح	iOS / Android عبر Expo
Application Client	متاح	عائلة المنتج نفسها كتطبيق الهاتف
الإشعارات الفورية في الوقت الفعلي	متاحة	صندوق الوارد / الدردشة / البث المباشر
قناة `inapp`	متاحة	التسليم الأساسي
قناة `whatsapp`	متاحة	محول / مزوّد يُعد حسب النشر
قناة `sms`	متاحة	محول / مزوّد يُعد حسب النشر
مفاتيح Sandbox	متاحة	اختبار إرسال بلا مخاطر: Sandbox
E2EE في in-app	متاح	محادثات + حمولات مركز مختومة: تشفير E2EE
قنوات البريد الإلكتروني / push الأصلي	على خارطة الطريق	ليست ضمن السلسلة الافتراضية بعد

يعتمد الاتصال بمزوّدي WhatsApp وSMS على بيئتك (مفاتيح Live مقابل stubs محلية). ويظل سلوك سلسلة الانتقال الاحتياطي واحدًا في جميع البيئات.

اختيار السطح المناسب

الهدف	الاستخدام
إرسال OTP / تنبيه مهم	Partner API ← سلسلة بأولوية SMS/WA حسب الحاجة
نشرة ثرية أو وسائط	`content_type=html` / `image` / `video` ← in-app أولًا
نموذج متعدد المراحل (بنمط SEED)	دعوة إلى تدفق + مشغّل التدفق
دعم مستمر	يبدأ المستخدم محادثة؛ ويرد الوكيل عبر Hub / API
إعلان جماعي	API عمليات البث
أتمتة القوائم	360Bots (بيئة تشغيل محلية أو خدمة)

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

البدء السريع: أول رسالة خلال دقائق
المفاهيم الأساسية: الحسابات والشركاء والقنوات
الرسائل: إرسال جميع أنواع المحتوى
واجهة الرسائل: ما يراه المستخدمون النهائيون فعليًا
Sandbox: الاختبار من دون مخاطر على الإنتاج