كل ما تحتاج معرفته عن خدمات مورا

مرحبًا بك في مركز الأسئلة الشائعة لدى مورا للاتصالات.

ستجد في هذه الصفحة إجابات عن أكثر الأسئلة شيوعًا حول التسجيل، الدخول إلى الحساب، إرسال الرسائل النصية، Sender ID، SMS API، WhatsApp API، OTP، الرصيد، التكاملات البرمجية، الأمان، والدعم الفني.

1. التسجيل وإدارة الحساب

ما هي مورا؟

مورا هي منصة متخصصة في حلول التواصل الرقمي للأعمال، وتوفر خدمات الرسائل النصية SMS، والتكامل البرمجي عبر API، وخدمات WhatsApp API، ورسائل OTP، بالإضافة إلى حلول التواصل المؤسسي.

كيف يمكنني إنشاء حساب في مورا؟

يمكنك إنشاء حساب جديد من خلال صفحة التسجيل الرسمية:

تسجيل عضوية جديدة في مورا

وتتضمن عملية التسجيل إدخال:

• اسم المستخدم.
• الجهة.
• نوع المستخدم.
• رقم الجوال.
• البريد الإلكتروني.
• كلمة المرور.
• تأكيد كلمة المرور.

كما يجب الموافقة على شروط الاستخدام وسياسة الخصوصية قبل إكمال التسجيل.

ما شروط كلمة المرور؟

يجب أن تحتوي كلمة المرور على 12 حرفا على الأقل، وأن تتضمن أحرفًا كبيرة وصغيرة وأرقامًا ورموزًا.
مثال ( Aa@0123456789)

• ننصح باستخدام كلمة مرور قوية وفريدة وعدم مشاركتها مع أي شخص
  كما يلزم ان تكون البيانات المسجلة للحساب بنفس البيانات المسجلة والمرسلة في خطاب تفعيل اسم المرسل  كرقم الجوال والإيميل واسم الجهه 

ما صيغة رقم الجوال المطلوبة عند التسجيل؟

يجب إدخال رقم جوال صالح يبدأ بالصيغة الدولية السعودية:

9665XXXXXXXX

كما يظهر في نموذج التسجيل الحالي.

كيف أسجل الدخول إلى حسابي؟

يمكنك تسجيل الدخول إلى لوحة التحكم من خلال:

تسجيل الدخول إلى مورا

وتتطلب صفحة الدخول بيانات الحساب، مع إمكانية تفعيل خيار تذكرني.

نسيت كلمة المرور، ماذا أفعل؟

يمكنك استخدام صفحة استعادة كلمة المرور:

استعادة كلمة المرور

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

هل يمكنني إنشاء حساب للشركة؟

نعم. يمكن للشركات والمؤسسات التسجيل واستخدام خدمات مورا بحسب نوع الخدمة المطلوبة وإجراءات التفعيل والتعاقد.

2. خدمات SMS

ما هي خدمة SMS من مورا؟

توفر مورا منصة لإرسال وإدارة الرسائل النصية للأعمال، ويمكن إرسال الرسائل من خلال لوحة التحكم أو من خلال التكامل البرمجي باستخدام SMS API.

هل يمكن إرسال رسالة إلى أكثر من رقم؟

نعم.

تدعم SMS API إرسال الرسائل إلى مستلم واحد أو عدة مستلمين من خلال نفس طلب الإرسال.

هل يمكن جدولة الرسائل؟

نعم.

تدعم SMS API جدولة الرسائل للإرسال في وقت لاحق باستخدام معامل datetime.

هل يمكن معرفة الرصيد من خلال API؟

نعم.

توفر مورا Endpoint مخصصًا للاستعلام عن الرصيد بشكل مباشر:

/balance

ويمكن استخدامه لمعرفة الرصيد الحالي للحساب من خلال التكامل البرمجي.

هل يمكن معرفة أسماء المرسلين المتاحة للحساب من خلال API؟

نعم.

توفر مورا Endpoint مخصصًا لاسترجاع أسماء المرسلين المرتبطة بالحساب:

/sender_names

3. Sender ID

ما هو Sender ID؟

Sender ID هو اسم الجهة الذي يظهر للمستلم بدلًا من رقم الهاتف عند إرسال الرسائل النصية.

مثال:

MORA

أو اسم العلامة التجارية المعتمد للعميل.

هل يمكنني استخدام أي Sender ID؟

لا.

يجب أن يكون اسم المرسل متوافقًا مع متطلبات الاعتماد والتنظيم، وقد يتم رفض أو حجب الاسم إذا لم يكن مستوفيًا للمتطلبات.

وتوضح SMS API أن من حالات الخطأ:

• 106 — Sender name not available
• 107 — Sender name is blocked.

4. SMS API

هل توفر مورا SMS API؟

نعم.

توفر مورا RESTful SMS API للتكامل مع التطبيقات والأنظمة.

وتوفر الـAPI وظائف تشمل:

• إرسال الرسائل.
• الإرسال لمستلم واحد أو عدة مستلمين.
• جدولة الرسائل.
• الاستعلام عن الرصيد.
• الاستعلام عن Sender Names.
• معالجة الأخطاء.
• استجابات JSON أو Text.

ما هو عنوان SMS API؟

عنوان الـBase URL الحالي هو:

https://mora-sa.com/api/v1/

كيف تتم المصادقة مع SMS API؟

تتطلب طلبات API:

• api_key
• username

ويجب إرسال بيانات المصادقة مع الطلبات وفق متطلبات الـAPI.

هل يمكنني استخدام API Key في JavaScript؟

لا يُنصح بذلك.

يجب عدم وضع API Key في Client-Side Code أو أي مكان يمكن للمستخدم النهائي الوصول إليه.

الأفضل تخزين المفتاح على الخادم واستخدامه من Backend آمن.

ما هو Endpoint إرسال الرسائل؟

Endpoint الحالي هو:

/sendsms

ويستخدم لإرسال رسالة إلى مستلم واحد أو عدة مستلمين.

ما البيانات المطلوبة لإرسال SMS عبر API؟

الحقول الأساسية تشمل:

كما يوجد datetime للجدولة وreturn لتحديد صيغة الاستجابة.

ما صيغ استجابة API؟

يمكن طلب الاستجابة بصيغة:

• JSON
• Text

وتكون JSON هي الصيغة الافتراضية وفق الوثائق الحالية.

5. أكواد أخطاء SMS API

ما معنى Error Code 105؟

Insufficient Balance

أي أن رصيد الحساب غير كافٍ لإتمام عملية الإرسال.

ما معنى 106؟

Sender name not available

اسم المرسل غير متاح للحساب.

ما معنى 107؟

Sender name is blocked

اسم المرسل محجوب.

ما معنى 108؟

No valid numbers for sending

لا توجد أرقام صالحة للإرسال.

ما معنى 112؟

Message contains prohibited words

محتوى الرسالة يحتوي على كلمات محظورة.

ما معنى 114؟

Account is suspended

الحساب موقوف.

ما معنى 115؟

Mobile number not activated

رقم الجوال غير مفعل.

ما معنى 116؟

Email not activated

البريد الإلكتروني غير مفعل.

ما معنى 117؟

Empty message cannot be sent

لا يمكن إرسال رسالة فارغة.

ما معنى 118؟

Sender name is empty

لم يتم تحديد اسم المرسل.

ما معنى 119؟

No recipient number provided

لم يتم تحديد رقم مستلم.

هذه الأكواد موثقة في صفحة SMS API الحالية.

6. WhatsApp API

هل توفر مورا WhatsApp API؟

نعم.

توفر مورا Mora WhatsApp API للتكامل مع WhatsApp وإرسال الرسائل من الأنظمة والتطبيقات.

ما الخدمات التي تدعمها WhatsApp API؟

تدعم واجهة Mora WhatsApp API مجموعة من الإمكانيات والخدمات، من أبرزها:

• Template Messages — إرسال الرسائل باستخدام قوالب WhatsApp المعتمدة.
• OTP Messages — إرسال رموز التحقق والمصادقة عبر WhatsApp.
• Dynamic Variables — استخدام المتغيرات الديناميكية لتخصيص محتوى الرسائل لكل مستلم.
• File Attachments — إمكانية إرفاق الملفات مع رسائل القوالب، وفق الإمكانيات والسياسات المعتمدة.
• Chatbot Integration — إمكانية بناء وربط Chatbots مع WhatsApp لأتمتة المحادثات والرد على استفسارات العملاء وتنفيذ سيناريوهات التواصل الآلي.
• Template Compliance — تخضع قوالب ورسائل WhatsApp لسياسات وشروط وأحكام Meta وWhatsApp، بما في ذلك متطلبات إنشاء القوالب واعتمادها واستخدامها، وقد يتم رفض أو تعطيل أي قالب أو محتوى لا يتوافق مع السياسات المعمول بها.
  

  كما تخضع رسوم استخدام WhatsApp Business Platform لأسعار وسياسات Meta، وقد تتغير هذه الأسعار من وقت لآخر.

  للاطلاع على أحدث أسعار WhatsApp Business Platform في المملكة العربية السعودية:
  عرض الأسعار الرسمي من Meta

  تنبيه: أسعار Meta هي رسوم تابعة لـMeta وليست أسعار مورا، وقد تختلف التكلفة النهائية للعميل وفق الباقة والخدمات والرسوم المطبقة من مورا.

ما هو عنوان WhatsApp API؟

عنوان الـBase URL الحالي هو:

https://app.morawhats.com/api

كيف تتم المصادقة؟

تستخدم WhatsApp API API Key للمصادقة.

ويجب إرسال api_key مع الطلبات وفق متطلبات الواجهة.

ويجب عدم كشف API Key في Frontend أو Client-Side Code.

كيف أرسل Template Message؟

يتم استخدام Endpoint:

POST /api/send

وتشمل البيانات الأساسية:

• API Key.
• Template Name.
• Mobile.
• Variables عند الحاجة.
• File Attachment عند الحاجة.

هل يمكن إضافة متغيرات داخل رسالة WhatsApp؟

نعم.

تدعم WhatsApp API المتغيرات الديناميكية داخل القوالب باستخدام:

variables[n]

هل يمكن إرسال ملف مع رسالة WhatsApp؟

نعم.

تدعم واجهة Template Message الحالية إرسال File Attachment باستخدام معامل file.

7. WhatsApp OTP

هل توفر مورا WhatsApp OTP؟

نعم.

توفر WhatsApp API Endpoint مخصصًا لإرسال رسائل OTP:

POST /api/sendotp

ما البيانات المطلوبة لإرسال WhatsApp OTP؟

الطلب يتضمن:

• api_key
• mobile
• template_name
• message

8. أخطاء WhatsApp API

ما هي أكواد الأخطاء في WhatsApp API؟

تستخدم WhatsApp API أكواد HTTP القياسية، ومنها:

ماذا يعني الخطأ 401؟

يعني أن API Key غير صحيح أو غير مصرح به.

ماذا يعني الخطأ 429؟

يعني أن عدد الطلبات تجاوز الحد المسموح به في الفترة الحالية Rate Limit.

وتوصي وثائق API باستخدام Exponential Backoff عند إعادة المحاولة.

9. التكامل مع الأنظمة

هل يمكن ربط مورا مع نظام ERP أو CRM؟

نعم.

يمكن استخدام API لربط خدمات مورا مع الأنظمة والتطبيقات التي تحتاج إلى إرسال رسائل تلقائيًا.

ومن أمثلة الاستخدام:

• أنظمة ERP.
• CRM.
• المتاجر الإلكترونية.
• التطبيقات.
• المواقع الإلكترونية.
• أنظمة الموارد البشرية.
• أنظمة المواعيد.
• أنظمة الفوترة.
• الأنظمة الداخلية للشركات.

هل يمكن إرسال OTP من النظام تلقائيًا؟

نعم.

يمكن ربط النظام مع SMS API أو WhatsApp API وإرسال رموز التحقق تلقائيًا حسب الخدمة المستخدمة.

10. الأمان

كيف أحمي API Key؟

• لا تضع المفتاح داخل Frontend.
• لا تحفظه في GitHub Public Repository.
• لا ترسله عبر البريد الإلكتروني بدون حماية.
• خزنه في Server Environment Variables أو Secret Manager.
• قم بتغييره عند الاشتباه بتسريبه.

وتنص وثائق SMS وWhatsApp API صراحةً على ضرورة حماية API Key وعدم كشفه في Client-Side Code.

11. الرسائل والتسليم

هل نجاح API يعني أن الرسالة وصلت للمستلم؟

ليس بالضرورة.

نجاح طلب API يعني أن النظام قبل الطلب أو عالجه وفق الحالة التي يعيدها الـAPI.

أما التسليم النهائي للمستلم فقد يتأثر بعوامل إضافية مثل:

• شبكة الاتصالات.
• حالة رقم المستلم.
• الجهاز.
• مشغل الاتصالات.
• الفلاتر.
• القيود التنظيمية.
• حالة الخدمة.

لذلك يجب التفريق بين قبول طلب الإرسال والتسليم النهائي.

12. الرصيد

كيف أعرف رصيدي؟

يمكنك معرفة الرصيد من خلال لوحة التحكم أو استخدام Endpoint:

/balance

في SMS API.

ماذا يحدث إذا لم يكن هناك رصيد كافٍ؟

سيتم رفض عملية الإرسال عند عدم توفر الرصيد المطلوب، ويعيد SMS API الكود:

105 – Insufficient Balance.

13. الدعم الفني

كيف أحصل على الدعم الفني؟

يمكنك التواصل مع فريق مورا من خلال قنوات الدعم الرسمية.

كما توفر صفحات API الحالية رابطًا للتواصل مع الدعم والمساعدة في التكامل.

الهاتف:
920013397

ماذا أرسل للدعم عند وجود مشكلة API؟

يفضل إرسال:

• اسم المستخدم.
• وقت حدوث المشكلة.
• Endpoint.
• HTTP Method.
• Request Parameters بدون إرسال API Key.
• Response.
• Error Code.
• Message ID إن وجد.
• Screenshot عند الحاجة.

مهم: لا ترسل API Key أو كلمات المرور للدعم داخل التذاكر أو البريد الإلكتروني.

14. الحساب والأمان

هل يمكنني حفظ بيانات الدخول؟

صفحة تسجيل الدخول توفر خيار “تذكرني” لتسهيل الدخول في المستقبل.

ومع ذلك، لا يُنصح بتفعيل هذا الخيار على أجهزة الكمبيوتر المشتركة أو الأجهزة العامة.

ماذا أفعل إذا توقفت حسابي؟

إذا كان الحساب موقوفًا، تحقق أولًا من حالة الحساب وتواصل مع الدعم لمعرفة سبب الإيقاف والإجراء المطلوب لإعادة التفعيل.

وتوضح SMS API أن 114 تعني:

Account is suspended.

15. الخصوصية

كيف تحمي مورا بياناتي؟

تطبق مورا إجراءات تقنية وتنظيمية مناسبة لحماية البيانات الشخصية وبيانات العملاء.

لمعرفة تفاصيل جمع البيانات ومعالجتها والاحتفاظ بها وحقوق أصحاب البيانات، يرجى مراجعة:

سياسة الخصوصية في مورا

16. الشروط والاتفاقيات

أين أجد شروط استخدام مورا؟

يمكن الوصول إلى الشروط والاتفاقيات من الموقع الرسمي لمورا.

وتظهر الموافقة على شروط الاستخدام واتفاقية الخصوصية ضمن عملية التسجيل.

17. SLA

أين أجد اتفاقية مستوى الخدمة؟

يمكنك مراجعة اتفاقية مستوى الخدمة الرسمية:

اتفاقية مستوى الخدمة SLA

وتوضح الاتفاقية مستوى الخدمة، الدعم، الاستثناءات، والمسؤوليات ذات العلاقة.

18. للمطورين

أين أجد وثائق SMS API؟

وثائق Mora SMS API

وتتضمن:

• Authentication.
• Send SMS.
• Scheduling.
• Balance.
• Sender Names.
• Error Codes.
• أمثلة cURL.
• PHP.
• Python.
• JavaScript.

أين أجد وثائق WhatsApp API؟

وثائق Mora WhatsApp API

وتتضمن:

• Authentication.
• Template Messages.
• Variables.
• Attachments.
• OTP.
• Error Handling.
• أمثلة برمجية متعددة.

19. روابط سريعة

لم تجد إجابة سؤالك؟

إذا لم تجد الإجابة التي تبحث عنها، تواصل مع فريق مورا وسيساعدك في تحديد الحل أو الخدمة المناسبة.

مورا للاتصالات
Mora Communications

920013397