أرسل أول SMS تجريبي لك بعد خمس دقائق من حصولك على بيانات الاعتماد.
اطلب الوصول التجريبي وسنرد خلال يوم عمل واحد ببيانات الاعتماد التجريبية. بعد ذلك خذ الرمز (token)، وثبّت TypeScript SDK، واستدعِ smsSendsmsPost. تصل أول رسالة اختبار لك إلى رقمك الموثق الخاص بعد حوالي خمس دقائق من حصولك على بيانات اعتماد الاختبار. جميع النماذج أدناه جاهزة للنسخ، وتغطي الخطوة 5 ما يجب التحقق منه قبل الانتقال إلى بيئة الإنتاج.
مسار واحد لإرسال رسالتك الأولى، مع توضيح المدة الزمنية لكل خطوة.
- 01
طلب وصول تجريبي
نردّ خلال يوم عمل واحدسيقوم مهندس رسائل بالرد عليك وتزويدك ببيانات الاعتماد التجريبية، وحجز مكالمة مدتها 30 دقيقة لمناقشة الدول، والأحجام، وحالة الاستخدام الخاصة بك.
- 02
أول رسالة تجريبية
بعد حوالي 5 دقائق من استلام بيانات الاعتمادأرسل رسالة تجريبية إلى رقمك الموثّق باستخدام كود البدء السريع. يصل إيصال التسليم إلى الـ webhook الخاص بك.
- 03
الربط التقني
2–5 أيام عملقم بالبناء والاختبار باستخدام بيانات اعتماد الاختبار الخاصة بك مقابل نفس نقطة النهاية (endpoint) المستخدمة في نماذج الكود. سيعمل مهندس من BroadNet معك جنباً إلى جنب عبر REST أو SMPP.
- 04
الموافقة
3–10 أيام عملنراجع معرّف المُرسِل والغرض من الرسائل وقواعد كل وجهة، ونسجّل معرّفات المُرسِلين لدى كل جهة تنظيمية، بالتوازي مع الربط التقني.
- 05
بيئة الإنتاج
يوم الانتقال إلى الإنتاجتم تفعيل الوصول إلى بيئة الإنتاج والمسارات لحسابك. عملية الربط الخاصة بك تستدعي بالفعل https://api.broadnet.me.
الإجمالي: من 5 إلى 15 يوم عمل من الطلب حتى الإنتاج في معظم الأسواق، وأطول حيث تكون مدة تسجيل معرّف المُرسِل لدى الجهة التنظيمية أطول.
- تطبيقكيتم الإرسال عبر REST API أو SMPP
- منصة BroadNetتتحقق من كل رسالة وتوجّهها وتحتسب تكلفتها
- SMSC الخاص بالمشغّلاتصال مباشر مع المشغّل
- هاتف المشتركيتم تسليم الرسالة
احصل على رمز الوصول الخاص بك.
يأتي رمز الوصول الخاص بك مع بيانات اعتماد الاختبار: اطلب الوصول التجريبي وسنرد عليك خلال يوم عمل واحد. قم بتخزين الرمز في متغير البيئة BROADNET_TOKEN وإرساله في ترويسة Authorization: Bearer عند كل استدعاء. تستخدم جميع النماذج في هذه الصفحة رابط URL الأساسي للإنتاج، https://api.broadnet.me.
أرسل SMS تجريبي إلى رقمك الموثق باستخدام POST /sms/sendSms. سيؤكد لك استلام استجابة 200 OK التي تحتوي على معرف الرسالة (message ID) في متنها أن الرمز يعمل قبل البدء في كتابة أي كود آخر.
قم بتثبيت حزمة تطوير البرامج (SDK).
لدى BroadNet حزمة تطوير برمجية SDK رسمية واحدة، لـ TypeScript و Node.js: npm install @broadnet/cpaas-sdk axios. يتم إنشاؤها من مواصفات OpenAPI BroadNet. في أي لغة برمجة أخرى، يمكنك استدعاء API REST باستخدام مكتبة HTTP المعتادة، أو إنشاء عميل من مواصفات OpenAPI.
npm install @broadnet/cpaas-sdk axios
export BROADNET_TOKEN=your_access_tokenاستورد ملفي Configuration و SMSSMSApi من @broadnet/cpaas-sdk. إذا تم حل عملية الاستيراد بنجاح وتحققت من أنواع البيانات، فأنت جاهز للإرسال.
أرسل رسالتك الأولى.
أنشئ كائن SMSSMSApi باستخدام عنوان URL الأساسي ورمز الوصول، ثم استدعِ الدالة smsSendsmsPost مع senderId وdestinationNumber وmessage وmessageType، وسجّل النتيجة. جسم الاستجابة هو معرّف الرسالة؛ احتفظ به لمطابقة حالة التسليم لاحقًا.
// npm install @broadnet/cpaas-sdk axios
import { Configuration, SMSSMSApi } from "@broadnet/cpaas-sdk";
const sms = new SMSSMSApi(
new Configuration({
basePath: "https://api.broadnet.me",
accessToken: process.env.BROADNET_TOKEN!,
}),
);
const res = await sms.smsSendsmsPost({
sMSSmsRequest: {
senderId: "BroadNet",
destinationNumber: "447700900123",
message: "Your verification code is 482913",
messageType: "TEXT",
},
});
console.log(res.data); // message IDHTTP/1.1 200 OK
2603121407537573731تحقق من الهاتف الذي في يدك. إذا وصلتك الرسالة النصية، فقد انتهيت من الجزء الصعب - كل ما يلي هو تحسينات تشغيلية.
تلقي حالة التسليم.
ترسل BroadNet حالة التسليم إلى URL خطاف الويب المُعدّ في حسابك: SUBMITTED وSENT وDELIVERED وREAD على القنوات التي تُبلغ عن القراءة، أو FAILED وREJECTED. خزِّن كل تحديث، وأجب بسرعة برمز 2xx، ثم عالجه بشكل غير متزامن.
import express from "express";
const app = express();
app.post("/webhooks/broadnet", express.json(), async (req, res) => {
// Store the status update first, then acknowledge with a 2xx.
// Statuses: SUBMITTED, SENT, DELIVERED, READ, FAILED, REJECTED.
await db.statusUpdates.insert({ receivedAt: new Date(), body: req.body });
res.sendStatus(200);
});تم التأكيد على الهاتف. تصل التحديثات السابقة، SUBMITTED و SENT، أثناء انتقال الرسالة عبر الشبكة.
يتم فتحها من قبل المستلم، على قنوات يتم الإبلاغ عن قراءتها، مثل WhatsApp.
لم يتم التسليم. يرجى التحقق من تنسيق الرقم ومعرّف المُرسِل قبل إعادة الإرسال.
أرسل رسالة إلى هاتفك، ثم تحقق من سجل الخادم الخاص بك لمعرفة تحديث حالة DELIVERED.
قبل بيئة الإنتاج.
يتم تفعيل بيئة الإنتاج بمجرد إتمام الموافقة: التحقق من هوية الجهة المُرسِلة، والغرض من الرسائل، ومعرّفات المُرسِلين، وذلك خلال 3–10 أيام عمل بالتوازي مع الربط البرمجي الخاص بك. وبعد الموافقة، يرسل الكود نفسه رسائل الإنتاج. قبل ذلك، احرص على إبقاء الرمز بعيداً عن أنظمة التحكم في الإصدار (source control)، وقم بإعداد webhooks حالة التسليم، وحدد سياسة إعادة المحاولة الخاصة بك.
- 01انقل الأسرار إلى بيئتك
احتفظ BROADNET_TOKEN في متغير بيئي أو في مدير الأسرار الخاص بك، ولا تقم أبدًا بتضمينه في نظام التحكم بالمصادر أو في كود جانب العميل. استبدله فورًا في حال تسريبه.
- 02أعد المحاولة بأمان وراقب رصيدك
إعادة محاولة إرسال الرسائل في حال حدوث أخطاء في الشبكة أو ظهور رمز الخطأ 5xx مع تأخير زمني متزايد. كل عملية إرسال مقبولة تُعيد معرّف الرسالة، لذا يُنصح بحفظه والتحقق من حالة التسليم بدلاً من إعادة الإرسال عشوائياً. تُشير عمليات الإرسال الجماعي إلى رصيدك المتبقي في كل رد.
- 03حدّد إصدار SDK بدقة
ثبّت @broadnet/cpaas-sdk على إصدار محدد في package.json وقم بالترقية بعناية. لا تحمل مسارات واجهة API بادئة إصدار، لذا تابع التغييرات في سجل التغييرات ومواصفات OpenAPI.
- 04معالجة الأخطاء حسب رمز الحالة
تُعيد الأخطاء رمز حالة HTTP وجسم ExceptionResponse يحتوي على status وerror وmessage وerrorCode وrequestUri. أصلح أخطاء 400 و401، وأعد محاولة أخطاء 5xx بتأخير تدريجي (backoff).
- 05حدد سياسة إعادة المحاولة الخاصة بك
الوضع الافتراضي: تراجع أسي عند حدوث أخطاء من نوع 5xx وأخطاء الشبكة، ولا يحدث ذلك مطلقًا عند حدوث أخطاء من نوع 4xx. بعد انتهاء المهلة، تحقق من حالة التسليم قبل إعادة الإرسال، لأن الطلب الأول قد يكون قد تم قبوله بالفعل.
قم بمراجعة الكود الخاص بك مقابل قائمة التحقق أدناه. بمجرد استكمال جميع البنود، سيكون التكامل الخاص بك جاهزاً لبيئة الإنتاج فور إتمام عملية الموافقة.
تعالج مسارات التعليمات البرمجية نفسها أكثر من 300 مليون رسالة يوميًا.
حركة رسائل الاختبار الخاصة بك ليست مجرد محاكاة. فكل طلب ومفتاح وwebhook قمت بضبطه في الخطوات السابقة يمر عبر نفس مسارات التوجيه والفواتير والامتثال التي تمر عبرها حركة رسائل الشركات لدينا — والتي تخضع للتدقيق سنوياً بموجب الشهادات المذكورة أدناه.
أسئلة البدء السريع
POST https://api.broadnet.me/sms/sendSms، مع ترويسة Authorization: Bearer وجسم JSON يتضمن الحقول senderId وdestinationNumber وmessage وmessageType (TEXT أو UNICODE). ويكون الرد هو معرّف الرسالة. ولا تزال واجهة HTTP API القديمة ضمن /websmpp متاحة لعمليات التكامل المبنية في حقبة SMPP.
اطلب وصولاً تجريبياً عبر /signup. يرد عليك مهندس من BroadNet خلال يوم عمل واحد ببيانات اعتماد الاختبار: رمز الوصول (access token) الذي ترسله في ترويسة Authorization: Bearer، والعنوان الذي ترسل إليه حركة الرسائل التجريبية. ويمكن إرسال أول رسالة اختبار بعد نحو خمس دقائق من استلامها.
حزمة SDK رسمية واحدة: @broadnet/cpaas-sdk للغة TypeScript وبيئة Node.js، متاحة على npm. وفي أي لغة برمجة أخرى، استدعِ REST API مباشرةً عبر HTTPS، أو أنشئ عميلاً من مواصفات OpenAPI (/developers/openapi.yaml).
السؤال ليس هنا؟ استشر فريقنا الهندسي
أنجزت خمس خطوات.
بقي مفتاح واحد.
اختبر باستخدام أرقامك الموثقة الخاصة، ثم أطلق عملية الربط البرمجي، وبعد ذلك انتقل إلى حركة الرسائل الفعلية من خلال لوحة التحكم نفسها. نفس الـ SDK، ونفس نقاط النهاية (endpoints)، ونفس اتفاقيات مستوى الخدمة (SLAs) التي تعالج أكثر من 300 مليون رسالة يوميًا.