باختصار
- اذكروا السبب: كل رسالة OTP توضح الغرض منها (البند 4-6-2 من تنظيمات الهيئة).
- رسالة واحدة: حتى 70 حرفًا بالعربي، و160 حرفًا بالإنجليزي (GSM-7).
- بلا روابط في رسائل OTP، مع تنبيه واضح بعدم مشاركة الرمز.
- اسم المرسل يوضح مصدر الرمز، فلا يحتاج النص إلى اسم علامتكم.
- في Digital Connect: يعتمد فريقكم وإنتركي النماذج، وتُرسل رموز OTP عبر REST أو SMPP أو SOAP، مع إشعار تسليم لكل رسالة.
ما الذي تحتاجه كل رسالة OTP
- الغرض: الدخول، أو التحقق من الرقم، أو إعادة تعيين كلمة المرور، أو الدفع، أو إضافة جهاز جديد. ولا تجيز تنظيمات الهيئة إرسال الرمز وحده.
- الرمز في بداية الرسالة ليسهل قراءته على شاشة القفل.
- مدة الصلاحية المطابقة لما يطبقه نظامكم.
- تنبيه بعدم مشاركة الرمز مع أي أحد، ولو كان من موظفيكم.
- ما يفعله العميل إن لم يطلب الرمز، في العمليات الحساسة مثل إعادة تعيين كلمة المرور أو إضافة جهاز.
- جزء واحد. النماذج العربية في حدود 70 حرفًا، والإنجليزية في حدود 160 حرفًا.
نماذج OTP بالعربي
النص العربي يُرسل بترميز Unicode، فتتسع الرسالة الواحدة لـ70 حرفًا، أو 67 حرفًا لكل جزء إذا طالت. وكل نموذج أدناه يتسع في رسالة واحدة، فاستبدلوا الرموز والأوقات والمبالغ بقيمكم.
| الاستخدام | النموذج | عدد الأحرف |
|---|---|---|
| الدخول | رمز الدخول إلى حسابك 482915، صالح 5 دقائق. لا تشاركه مع أحد. | 60 |
| التحقق من رقم الجوال | رمز التحقق من رقم جوالك 730264، صالح 10 دقائق. إن لم تطلبه فتجاهله. | 67 |
| إعادة تعيين كلمة المرور | رمز إعادة تعيين كلمة المرور 159837، صالح 5 دقائق. إن لم تطلبه فراسلنا. | 70 |
| تأكيد الدفع | رمز تأكيد دفع 1250 ريال هو 604118، صالح 3 دقائق. لا تشاركه مع أحد. | 66 |
| إضافة جهاز جديد | رمز إضافة جهاز جديد لحسابك 285043، صالح 5 دقائق. لم تطلبه؟ تواصل معنا. | 70 |
| تسليم الطلب | أعطِ الرمز 3917 للمندوب عند استلام الطلب 58214 فقط. | 51 |
نماذج OTP بالإنجليزي
كل نموذج أدناه يتسع في جزء واحد من 160 حرفًا.
| الاستخدام | النموذج | عدد الأحرف |
|---|---|---|
| الدخول | Your login code is 482915. It is valid for 5 minutes. Do not share this code with anyone, including our staff. | 110 |
| التحقق من رقم الجوال | Your code to verify this mobile number is 730264. It is valid for 10 minutes. If you did not request it, ignore this message. | 125 |
| إعادة تعيين كلمة المرور | Your password reset code is 159837. It is valid for 5 minutes. If you did not ask to reset your password, contact us. | 117 |
| تأكيد الدفع | Code 604118 confirms your payment of SAR 1,250.00. It is valid for 3 minutes. Do not share it with anyone. | 106 |
| إضافة جهاز جديد | Your code to add a new device to your account is 285043. It is valid for 5 minutes. If this was not you, contact us now. | 120 |
| تسليم الطلب | Give code 3917 to the courier only when you receive order 58214. Do not share it before delivery. | 97 |
حرف عربي واحد في رسالة إنجليزية يحوّل الرسالة كلها إلى Unicode، فيصبح حدها 70 حرفًا. أرسلوا لكل عميل بلغة واحدة، وتحققوا من النماذج بـحاسبة أجزاء الرسالة.
صيغ قراءة الرمز تلقائيًا في Android
تستطيع تطبيقات Android قراءة الرمز من الرسالة فلا يحتاج العميل إلى كتابته. وتوثّق Google طريقتين، لكل منهما شروط على نص الرسالة:
| الطريقة | ما يجب أن تحتويه الرسالة |
|---|---|
| SMS Retriever API | ألا تتجاوز 140 بايت، وأن تحتوي الرمز، وسلسلة hash من 11 حرفًا تعرّف تطبيقكم. وبقية النص حسب اختياركم. |
| SMS User Consent API | رمز من 4 إلى 10 أحرف وأرقام فيه رقم واحد على الأقل. ويستمع التطبيق خمس دقائق بعد الطلب، ويوافق العميل على قراءة الرسالة. |
مثال لطريقة SMS Retriever API، مع سلسلة التطبيق في سطر مستقل:
Your login code is 482915. It is valid for 5 minutes. Do not share it. FA+9qCX9VSu
السلسلة الظاهرة مثال من وثائق Google، فاستخدموا السلسلة الخاصة بتطبيقكم. والرسالة الواحدة تحمل 140 بايت، فيجب ألا تتجاوز الرسالة العربية 70 حرفًا بما فيها السلسلة، لذا اختصروا النماذج العربية أعلاه لتتسع للسلسلة. المصادر: SMS Retriever API وSMS User Consent API.
أخطاء تجنبوها
- الرمز وحده، مثل «482915». فهذا لا يوافق قاعدة الهيئة ولا يوضح شيئًا للعميل.
- الروابط في رسائل OTP. أبقوا الرمز والإجراء داخل تطبيقكم، فلا يحتاج العميل إلى ضغط رابط في رسالة تحمل رمزًا.
- أسماء العلامة الطويلة أو الشعارات التي تدفع الرسالة إلى جزء ثانٍ، فاسم المرسل المسجل يوضح المصدر.
- خلط العربية والإنجليزية في رسالة واحدة، فينخفض الحد إلى 70 حرفًا.
- إرسال رمز جديد مع كل ضغطة. حدّوا عدد المحاولات، واطلعوا على قائمة تطبيق رسائل OTP.
نماذج OTP في Digital Connect
- اعتماد النماذج: يعتمد فريقكم وإنتركي كل نموذج قبل استخدامه.
- الإرسال: ترسل أنظمتكم رموز OTP عبر REST أو SMPP أو SOAP، مع وصول مقصور على عناوين IP مسموح بها أو اتصال VPN.
- اسم المرسل: تسجّل إنتركي اسم المرسل الخاص بكم لدى المشغلين عبر النظام المركزي للرسائل الجماعية التابع للهيئة أثناء التجهيز.
- النتائج: إشعار تسليم لكل رسالة.
- الحماية: حماية من الاحتيال، وحظر الدول، وحدود الإنفاق لحسابكم.
- التسعير: بعرض سعر، ولرسائل OTP سعر مختلف عن الرسائل التسويقية.
- التصريح: تحمل إنتركي تصريح هيئة الاتصالات والفضاء والتقنية لتقديم خدمات الرسائل القصيرة (SMS).
اطلعوا على رسائل OTP للتحقق من العملاء لمعرفة الخدمة نفسها.
أسئلة عن نص رسالة OTP
هل يجب أن توضح رسالة OTP الغرض من الرمز؟
نعم. تُلزم تنظيمات الهيئة المرسل بأن يوضح في الرسالة سبب إرسال رمز التحقق، وألا يكتفي بإرسال الرمز (البند 4-6-2).
هل نرسل الرمز بالعربي أم بالإنجليزي؟
باللغة التي اختارها العميل في تطبيقكم أو حسابه. وأبقوا النماذج العربية في حدود 70 حرفًا لتبقى رسالة واحدة.
كم رقمًا يكون في الرمز؟
تحدده سياسة الأمن لديكم. وإذا استخدمتم SMS User Consent API في Android فيجب أن يكون الرمز من 4 إلى 10 أحرف وفيه رقم واحد على الأقل.
هل نضع اسم علامتنا في النص؟
لا حاجة لذلك، فاسم المرسل المسجل يوضح مصدر الرسالة، وحذف الاسم من النص يجعلها أقصر.
هل تحتاج نماذج OTP إلى اعتماد في Digital Connect؟
يعتمد فريقكم وإنتركي نماذج الرسائل في Digital Connect قبل استخدامها، فاتفقوا على نماذج OTP أثناء التجهيز.