# أرسل أول SMS تجريبي لك بعد خمس دقائق من حصولك على بيانات الاعتماد.

- الرابط الأساسي: https://www.broadnet.me/ar/developers/quickstart
- اللغة: ar
- آخر تحديث: 2026-10-21
- الناشر: BroadNet (https://www.broadnet.me)
- نسخة Markdown من الصفحة، مولّدة من الصفحة المعروضة.

دليل البدء السريع للمطورين

اطلب الوصول التجريبي وسنرد خلال يوم عمل واحد ببيانات الاعتماد التجريبية. بعد ذلك خذ الرمز (token)، وثبّت TypeScript SDK، واستدعِ `smsSendsmsPost`. تصل أول رسالة اختبار لك إلى رقمك الموثق الخاص بعد حوالي خمس دقائق من حصولك على بيانات اعتماد الاختبار. جميع النماذج أدناه جاهزة للنسخ، وتغطي الخطوة 5 ما يجب التحقق منه قبل الانتقال إلى بيئة الإنتاج.

[اطلب وصولاً تجريبياً](https://www.broadnet.me/ar/signup) [مرجع كامل لواجهة برمجة التطبيقات (API)](https://www.broadnet.me/ar/developers/api)

التقدّم

0 / 5 خطوات · 5 دقائق

0/5

الخطوات المتبقية

5

1. احصل على رمز الوصول الخاص بك الخطوة 1 · 30 ثانية
2. قم بتثبيت حزمة تطوير البرامج (SDK) الخطوة 2 · 45 ثانية
3. أرسل رسالتك الأولى الخطوة 3 · 60 ثانية
4. تلقي حالة التسليم الخطوة 4 · 90 ثانية
5. قبل بيئة الإنتاج الخطوة 5 · ليس جزءاً من الخمس دقائق

من الطلب إلى بيئة الإنتاج

## مسار واحد لإرسال رسالتك الأولى، مع توضيح المدة الزمنية لكل خطوة.

1. 01 طلب وصول تجريبي نردّ خلال يوم عمل واحد سيقوم مهندس رسائل بالرد عليك وتزويدك ببيانات الاعتماد التجريبية، وحجز مكالمة مدتها 30 دقيقة لمناقشة الدول، والأحجام، وحالة الاستخدام الخاصة بك.
2. 02 أول رسالة تجريبية بعد حوالي 5 دقائق من استلام بيانات الاعتماد أرسل رسالة تجريبية إلى رقمك الموثّق باستخدام كود البدء السريع. يصل إيصال التسليم إلى الـ webhook الخاص بك.
3. 03 الربط التقني 2–5 أيام عمل قم بالبناء والاختبار باستخدام بيانات اعتماد الاختبار الخاصة بك مقابل نفس نقطة النهاية (endpoint) المستخدمة في نماذج الكود. سيعمل مهندس من BroadNet معك جنباً إلى جنب عبر REST أو SMPP.
4. 04 الموافقة 3–10 أيام عمل نراجع معرّف المُرسِل والغرض من الرسائل وقواعد كل وجهة، ونسجّل معرّفات المُرسِلين لدى كل جهة تنظيمية، بالتوازي مع الربط التقني.
5. 05 بيئة الإنتاج يوم الانتقال إلى الإنتاج تم تفعيل الوصول إلى بيئة الإنتاج والمسارات لحسابك. عملية الربط الخاصة بك تستدعي بالفعل https://api.broadnet.me.

الإجمالي: من 5 إلى 15 يوم عمل من الطلب حتى الإنتاج في معظم الأسواق، وأطول حيث تكون مدة تسجيل معرّف المُرسِل لدى الجهة التنظيمية أطول.

مخطط كيفية وصول رسالة A2P إلى الهاتف

1. تطبيقك يتم الإرسال عبر REST API أو SMPP
2. منصة BroadNet تتحقق من كل رسالة وتوجّهها وتحتسب تكلفتها
3. SMSC الخاص بالمشغّل اتصال مباشر مع المشغّل
4. هاتف المشترك يتم تسليم الرسالة

يعود إيصال التسليم (DLR) عبر المسار نفسه إلى الـ webhook الخاص بك

في هذه الصفحة

1. 01 احصل على رمز الوصول الخاص بك
2. 02 قم بتثبيت حزمة تطوير البرامج (SDK)
3. 03 أرسل رسالتك الأولى
4. 04 تلقي حالة التسليم
5. 05 قبل بيئة الإنتاج

بعد الحصول على بيانات الاعتماد

5 دقائق

حوالي خمس دقائق من الحصول على بيانات الاعتماد التجريبية وحتى وصول أول رسالة تجريبية. تتطلب خطوة الـ webhook رابط URL عام؛ وngrok يعمل بشكل ممتاز.

01

الخطوة 1 · 30 ثانية

## احصل على رمز الوصول الخاص بك.

يأتي رمز الوصول الخاص بك مع بيانات اعتماد الاختبار: اطلب الوصول التجريبي وسنرد عليك خلال يوم عمل واحد. قم بتخزين الرمز في متغير البيئة BROADNET_TOKEN وإرساله في ترويسة Authorization: Bearer عند كل استدعاء. تستخدم جميع النماذج في هذه الصفحة رابط URL الأساسي للإنتاج، https://api.broadnet.me.

your BroadNet account · access token

Access token

quickstart-default

active

84f1a02e3c7d4b91a7e0•••••••••••• copy

Header

Bearer

Env var

BROADNET_TOKEN

Base URL

api.broadnet.me

$ curl -X POST https://api.broadnet.me/sms/sendSms -H "Authorization: Bearer $BROADNET_TOKEN" …

200 OK

اختبره

أرسل SMS تجريبي إلى رقمك الموثق باستخدام POST /sms/sendSms. سيؤكد لك استلام استجابة 200 OK التي تحتوي على معرف الرسالة (message ID) في متنها أن الرمز يعمل قبل البدء في كتابة أي كود آخر.

step 1.broadnet.me

02

الخطوة 2 · 45 ثانية

## قم بتثبيت حزمة تطوير البرامج (SDK).

لدى BroadNet حزمة تطوير برمجية SDK رسمية واحدة، لـ TypeScript و Node.js: npm install @broadnet/cpaas-sdk axios. يتم إنشاؤها من مواصفات OpenAPI BroadNet. في أي لغة برمجة أخرى، يمكنك استدعاء API REST باستخدام مكتبة HTTP المعتادة، أو إنشاء عميل من مواصفات OpenAPI.

Install

```
npm install @broadnet/cpaas-sdk axios

export BROADNET_TOKEN=your_access_token
```

bash

node >= 18

اختبره

استورد ملفي Configuration و SMSSMSApi من @broadnet/cpaas-sdk. إذا تم حل عملية الاستيراد بنجاح وتحققت من أنواع البيانات، فأنت جاهز للإرسال.

step 2.broadnet.me

03

الخطوة 3 · 60 ثانية

## أرسل رسالتك الأولى.

أنشئ كائن SMSSMSApi باستخدام عنوان URL الأساسي ورمز الوصول، ثم استدعِ الدالة smsSendsmsPost مع senderId وdestinationNumber وmessage وmessageType، وسجّل النتيجة. جسم الاستجابة هو معرّف الرسالة؛ احتفظ به لمطابقة حالة التسليم لاحقًا.

POST /sms/sendSms

```
// 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 ID
```

javascript

200 OK · message ID

Response · 200 OK

body · message ID

```
HTTP/1.1 200 OK

2603121407537573731
```

اختبره

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

step 3.broadnet.me

04

الخطوة 4 · 90 ثانية

## تلقي حالة التسليم.

ترسل BroadNet حالة التسليم إلى URL خطاف الويب المُعدّ في حسابك: SUBMITTED وSENT وDELIVERED وREAD على القنوات التي تُبلغ عن القراءة، أو FAILED وREJECTED. خزِّن كل تحديث، وأجب بسرعة برمز 2xx، ثم عالجه بشكل غير متزامن.

POST /webhooks/broadnet

```
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);
});
```

javascript

delivery status · JSON

DELIVERED

تم التأكيد على الهاتف. تصل التحديثات السابقة، SUBMITTED و SENT، أثناء انتقال الرسالة عبر الشبكة.

بعد التسليم

READ

يتم فتحها من قبل المستلم، على قنوات يتم الإبلاغ عن قراءتها، مثل WhatsApp.

عند القراءة

FAILED / REJECTED

لم يتم التسليم. يرجى التحقق من تنسيق الرقم ومعرّف المُرسِل قبل إعادة الإرسال.

الحالة النهائية

اختبره

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

step 4.broadnet.me

05

الخطوة 5 · ليس جزءاً من الخمس دقائق

## قبل بيئة الإنتاج.

يتم تفعيل بيئة الإنتاج بمجرد إتمام الموافقة: التحقق من هوية الجهة المُرسِلة، والغرض من الرسائل، ومعرّفات المُرسِلين، وذلك خلال 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. بعد انتهاء المهلة، تحقق من حالة التسليم قبل إعادة الإرسال، لأن الطلب الأول قد يكون قد تم قبوله بالفعل.

اختبره

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

step 5.broadnet.me

صُممت للإنتاج منذ اليوم الأول

## تعالج مسارات التعليمات البرمجية نفسها أكثر من 300 مليون رسالة يوميًا.

حركة رسائل الاختبار الخاصة بك ليست مجرد محاكاة. فكل طلب ومفتاح وwebhook قمت بضبطه في الخطوات السابقة يمر عبر نفس مسارات التوجيه والفواتير والامتثال التي تمر عبرها حركة رسائل الشركات لدينا — والتي تخضع للتدقيق سنوياً بموجب الشهادات المذكورة أدناه.

ISO 27001

أمن المعلومات

ISO 9001

إدارة الجودة

ISO 22301

استمرارية الأعمال

اللائحة العامة لحماية البيانات (GDPR)

متوافق · توطين البيانات في الاتحاد الأوروبي

قانون HIPAA

متوافق · اتفاقية الشراكة التجارية عند الطلب

SOC 2

النوع الثاني · التدقيق السنوي

توطين البيانات في الاتحاد الأوروبي والإمارات العربية المتحدة اتفاقية مستوى خدمة لتشغيل API بنسبة 99.99% عنوان URL أساسي واحد للاختبار والإنتاج خطافات ويب لحالة التسليم

أسئلة يطرحها المشترون

## أسئلة البدء السريع

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).

السؤال ليس هنا؟ [استشر فريقنا الهندسي](https://www.broadnet.me/ar/contact)

وصول تجريبي · نرد خلال يوم عمل واحد

## أنجزت خمس خطوات. بقي مفتاح واحد.

اختبر باستخدام أرقامك الموثقة الخاصة، ثم أطلق عملية الربط البرمجي، وبعد ذلك انتقل إلى حركة الرسائل الفعلية من خلال لوحة التحكم نفسها. نفس الـ SDK، ونفس نقاط النهاية (endpoints)، ونفس اتفاقيات مستوى الخدمة (SLAs) التي تعالج أكثر من 300 مليون رسالة يوميًا.

[اطلب وصولاً تجريبياً](https://www.broadnet.me/ar/signup) [مرجع كامل لواجهة برمجة التطبيقات (API)](https://www.broadnet.me/ar/developers/api)

$ curl -X POST https://api.broadnet.me/sms/sendSms -H "Authorization: Bearer $BROADNET_TOKEN" -d '{ "senderId": "…", "destinationNumber": "…", "message": "…", "messageType": "TEXT" }'