واجهة API لإرسال رموز التحقق OTP عبر SMS
أرسل كلمات المرور لمرة واحدة من نظامك الخلفي بطلب HTTPS واحد إلى REST API من BroadNet. ينشئ تطبيقك الرمز ويتحقق منه، ونحن نسلّمه من اسم مرسل مسجّل عبر مسارات مباشرة إلى المشغّلين ونبلغ Webhook لديك بكل حالة.
curl -X POST https://api.broadnet.me/sms/sendSms \
-H "Authorization: Bearer $BROADNET_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"senderId": "OmniDemo",
"destinationNumber": "971500000000",
"message": "482913 is your OmniDemo code. It expires in 5 minutes. Do not share it.",
"messageType": "TEXT",
"campaignName": "login-otp"
}'
# 200 OK
2603121407537573731إرسال رمز OTP عبر واجهة SMS. الرمز واسم المرسل والرقم قيم توضيحية.
الإجابة المختصرة
آخر تحديث
لإرسال رمز OTP عبر SMS مع OmniChannels.ai، ينشئ نظامك الخلفي الرمز ثم يستدعي POST /sms/sendSms على https://api.broadnet.me باستخدام رمز Bearer واسم المرسل والرقم ونص الرسالة. تعيد الواجهة معرّف الرسالة، وتصل حالات التسليم إلى Webhook لديك. تُدعم Unicode والعربية، ويمكن استخدام WhatsApp أو المكالمة الصوتية كبديل احتياطي.
ما الذي تقدّمه واجهة OTP SMS للمطورين؟
طلب REST واحد لكل رمز
POST /sms/sendSms بجسم JSON ورمز Bearer. الاستجابة هي معرّف الرسالة الذي تخزّنه مع محاولة التحقق.
حالات التسليم عبر Webhook
استقبل SUBMITTED وSENT وDELIVERED وFAILED وREJECTED بصيغة موحدة، لتعرف متى تعرض إعادة الإرسال أو تنتقل إلى قناة أخرى.
رموز بالعربية وUnicode
اضبط messageType على UNICODE للعربية أو غيرها من اللغات. ويعيد POST /sms/identify الترميز وعدد الأجزاء قبل الإرسال.
أسماء مرسل مسجّلة
أرسل من اسم مرسل أبجدي مسجّل للحركة الخدمية في الأسواق التي تشترط ذلك، مثل الإمارات والسعودية.
فحص الرقم قبل الإرسال
يتحقق POST /sms/lookup من الرقم على الشبكة (HLR وMNP)، ليساعدك على رفض الأرقام غير الصالحة قبل أن تدفع مقابل إرسال الرمز.
بديل احتياطي عبر WhatsApp أو مكالمة
انتقل إلى قالب مصادقة في WhatsApp أو إلى مكالمة صوتية عندما لا تُسلَّم الرسالة أو لا يُدخَل الرمز.
SMPP للأحجام الكبيرة جداً
إن كنت تشغّل عميل SMPP، أرسل رموز OTP عبر SMPP 3.4 مع TLS على المسارات نفسها واستقبل التقارير على الجلسة.
SDK وخادم MCP
استخدم TypeScript SDK @broadnet/cpaas-sdk، أو مواصفات OpenAPI 3.1، أو خادم MCP لوكلاء الذكاء الاصطناعي.
ما الذي يتولاه نظامك وما الذي تتولاه الواجهة
الفصل الواضح يحافظ على أمان التحقق: نظامك يملك الرمز، والمنصة تتولى التسليم.
| العنصر | التفاصيل |
|---|---|
| إنشاء الرمز | ينشئ نظامك الخلفي رمزاً عشوائياً، ويخزّن قيمة مُجزّأة (hash) منه مع وقت انتهاء، ويحدّ عدد المحاولات لكل رقم وجهاز وعنوان IP. |
| إرسال الرسالة | POST /sms/sendSms مع senderId وdestinationNumber (رمز الدولة ثم الرقم، أرقام فقط) وmessage وmessageType. |
| تتبع التسليم | خزّن معرّف الرسالة المُعاد وطابقه مع حالات Webhook. وعدم وصول DELIVERED خلال المهلة يمكن أن يشغّل البديل الاحتياطي. |
| التحقق من الرمز | يقارن نظامك الخلفي ما أدخله المستخدم بالقيمة المخزّنة. لا تتحقق المنصة من حالة التحقق لديك ولا تخزنها. |
| البديل الاحتياطي | أعد الإرسال عبر WhatsApp بقالب مصادقة، أو بمكالمة صوتية يجهّزها فريقنا معك. |
| التسعير | يُحتسب لكل جزء من الرسالة حسب الوجهة وفق أسعار BroadNet المنشورة، دون رسوم إعداد ودون حد أدنى شهري. راجع أسعار الرسائل النصية حسب الدولة. |
كيف تربط واجهة OTP SMS؟
- 1
احصل على رمز الوصول
اطلب الوصول؛ يُصدر رمز Bearer لحسابك، وتُرسل رسائل الاختبار إلى أرقامك الموثّقة.
- 2
سجّل اسم المرسل
اختر اسم مرسل للحركة الخدمية وسجّله في الدول التي تشترط ذلك قبل الإطلاق.
- 3
اكتب الرسالة
ضع الرمز أولاً، واذكر علامتك التجارية ومدة الصلاحية وتنبيهاً بعدم المشاركة، في جزء واحد.
- 4
أرسل وتتبّع
استدعِ POST /sms/sendSms، وخزّن معرّف الرسالة، وعالج حالات Webhook دون تكرار.
- 5
أضف البدائل والحدود
أضف WhatsApp أو المكالمة الصوتية كخطوة تالية، وحدّد معدل الطلبات لمنع احتيال ضخ الرسائل قبل الإطلاق.
متى تناسبك واجهة OTP SMS؟
يناسبك إذا
- تبني التحقق عند التسجيل أو الدخول أو الدفع داخل تطبيقك وتريد التحكم الكامل في الرمز.
- تحتاج إلى رموز OTP إلى الإمارات والسعودية وأسواق الخليج والشرق الأوسط الأخرى، بالعربية والإنجليزية.
- تريد واجهة واحدة للرسائل النصية الآن، مع بدائل WhatsApp أو RCS أو المكالمة الصوتية لاحقاً.
- تفضّل REST وWebhooks، مع إتاحة SMPP عندما تكبر الأحجام.
ما يجب معرفته قبل البدء
- لا توجد نقطة تحقق مستضافة: تطبيقك ينشئ الرمز ويخزنه ويتحقق منه.
- يراجع فريقنا الوصول إلى بيئة الإنتاج؛ لا يوجد تسجيل ذاتي فوري.
- يستغرق تسجيل اسم المرسل أياماً في بعض الدول، فابدأ به قبل موعد الإطلاق.
- نقاط OTP هدف لاحتيال ضخ الرسائل؛ قوائم الدول المسموحة وحدود المعدل وفحص الروبوتات مسؤوليتك داخل التطبيق.
التحويل التلقائي إلى قناة بديلة خطوة بخطوة
أرسل مرة واحدة عبر المنصة أو API. إذا لم تُسلَّم الرسالة في خطوة ما خلال المهلة المحددة، تتولى القناة التالية الإرسال تلقائياً، وتصلك جميع الحالات بتنسيق webhook موحّد.
- 01
WhatsApp
قالب تفاعلي بأزرار وإشعارات قراءة وردود تصل إلى صندوق الوارد
- 02
RCS
بطاقة تفاعلية بعلامتك التجارية حيث يدعم الهاتف والمشغّل RCS
- 03
SMS
تصل إلى أي هاتف محمول عبر مسارات مباشرة مع المشغّلين
- 04
المكالمات الصوتية
رمز أو رسالة صوتية عندما لا تصل الرسالة النصية
أسئلة شائعة عن واجهة OTP SMS
كيف أرسل رسالة رمز تحقق OTP عبر الواجهة؟
أنشئ الرمز في نظامك الخلفي، ثم استدعِ POST https://api.broadnet.me/sms/sendSms مع ترويسة Authorization: Bearer وجسم JSON يحتوي senderId وdestinationNumber وmessage وmessageType. الاستجابة هي معرّف الرسالة، وتصل حالات التسليم إلى Webhook لديك.
هل تنشئ الواجهة الرمز وتتحقق منه نيابة عني؟
لا. ينشئ تطبيقك الرمز، ويخزّن قيمة مُجزّأة منه مع وقت انتهاء، ويتحقق مما يدخله المستخدم. إبقاء التحقق في نظامك يعني أن منطق الرمز وحدود المحاولات وسجل التدقيق تبقى تحت سيطرتك.
هل يمكن إرسال رمز التحقق بالعربية؟
نعم. اضبط messageType على UNICODE. تتسع رسالة SMS العربية لـ 70 حرفاً في الجزء الواحد، لذا اجعل الرسالة قصيرة. ويمكنك استدعاء POST /sms/identify أولاً لمعرفة الترميز وعدد الأجزاء.
ما أفضل صيغة لرسالة رمز التحقق؟
ابدأ بالرمز، واذكر علامتك التجارية، وحدّد مدة الصلاحية، ونبّه المستخدم بعدم مشاركة الرمز أبداً، وكل ذلك في جزء واحد. استخدم اسم مرسل خدمياً وابتعد عن العروض، حتى لا تصنّف الشبكات الرسالة كتسويقية.
ماذا أفعل إذا لم تصل رسالة رمز التحقق؟
راقب حالات Webhook لمعرّف الرسالة. إذا لم تظهر DELIVERED، أو لم يُدخل المستخدم الرمز خلال المهلة، فاعرض إعادة الإرسال أو انتقل إلى WhatsApp أو مكالمة صوتية. ولا تكرر المحاولة بلا نهاية على الرقم نفسه.
كيف أحمي نقطة OTP من احتيال ضخ الرسائل؟
اسمح فقط بالدول التي تخدمها، وحدّد المعدل لكل رقم وجهاز وعنوان IP، وأضف فحصاً للروبوتات في النماذج العامة، وأطلق تنبيهاً عند ارتفاع الطلبات إلى بادئات غير معتادة. ويساعد فحص الرقم قبل الإرسال أيضاً على رفض الأرقام غير الصالحة.
كم تكلفة رسالة رمز التحقق OTP؟
تُحتسب رسالة OTP لكل جزء وفق سعر الوجهة. تجد أسعار BroadNet الاسترشادية لكل دولة في صفحات أسعار الرسائل النصية، مثلاً بدءاً من 0.0123 دولار أمريكي للجزء إلى الإمارات. لا رسوم إعداد ولا حد أدنى شهري، ويؤكد عرض السعر الأسعار النهائية.
هل توجد بيئة تجريبية (Sandbox)؟
يرسل وصول الاختبار إلى أرقامك الموثّقة على الواجهة نفسها، فتختبر التسليم والحالات الحقيقية قبل الإنتاج. لا توجد بيئة تجريبية عامة منفصلة ولا تسجيل ذاتي فوري.
أدلة حول هذا الموضوع
- الرسائل النصية ورموز التحققرسائل OTP عبر WhatsApp وSMS: الأمان والتسليم ومكافحة الاحتيال9 دقائق للقراءة
- الرسائل النصية ورموز التحققاحتيال SMS pumping: كيف يعمل AIT وكيف توقفه9 دقائق للقراءة
- التكاملدليل تكامل واجهة API للمراسلة: REST وSMPP وWebhooks9 دقائق للقراءة
اكتشف المزيد من المنصة
احصل على وصول API لرسائل OTP
أخبرنا بدولك وأحجام التحقق المتوقعة واسم المرسل، وسنصدر لك رمز وصول للاختبار على أرقامك ونساعدك في تسجيل أسماء المرسل.
شاركنا الأنظمة التي تستخدمها وما تريد ربطه، وسيتواصل معك مهندس حلول.