انقل حركة رسائل SMS الخاصة بك إلى BroadNet من أي مزود خدمة.

طابِق واجهة API الحالية مع BroadNet

تشترك معظم واجهات API لرسائل SMS في المفاهيم نفسها وإن اختلفت أسماؤها. ابحث عن المفهوم في العمود الأول، أياً كان اسمه لدى مزودك، واستخدم ما يقابله في BroadNet. أسماء الحقول مطابقة تماماً لما ورد في مواصفات OpenAPI.

إليك نفس عملية الإرسال كطلب واحد. استبدل حقول المرسل والمستلم والنص الخاصة بمزود الخدمة الخاص بك بـ senderId و destinationNumber و message :

curl -X POST https://api.broadnet.me/sms/sendSms \
  -H "Authorization: Bearer $BROADNET_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "senderId": "ACME",
    "destinationNumber": "447700900101",
    "message": "Your code is 8123",
    "messageType": "TEXT"
  }'

# 200 OK — the response body is the message ID, e.g. 2603121407537573731

للتحقق من رسالة واحدة، استعلم عن حالتها باستخدام معرّف الرسالة الذي أعاده طلب الإرسال:

# Status lookup on the legacy HTTP API (/websmpp), by message ID
curl "https://api.broadnet.me/websmpp/websmsstatus?respid=2603121407537573731&format=json" \
  -H "Authorization: Bearer $BROADNET_TOKEN"

# "status": "DELIVRD"   (or UNDELIV, EXPIRED, REJECTD)

انقل معرّفات المُرسِلين الخاصة بك

تُعدّ معرّفات المُرسِلين الأبجدية الرقمية والرموز المختصرة قابلة للنقل عمومًا، وتخضع لقواعد التسجيل الخاصة بكل مشغّل وهيئة تنظيمية. يرتبط التسجيل بالمسار الذي تسلكه حركة البيانات، لذا يُنصح بالتخطيط له قبل إرسال أي رسالة إنتاجية إلى BroadNet.

1. 1

   قم بإدراج كل معرّف مُرسِل، والدول التي يرسل إليها، ونوع حركة الرسائل التي يحملها: OTP، أو المعاملات، أو التسويق.

2. 2

   تحقق من قواعد كل دولة. في الإمارات العربية المتحدة تُسجَّل معرّفات المُرسِلين وفق قواعد TDRA عبر المشغّل، بمعرّف واحد لكل كيان قانوني لكل حالة استخدام. أما في المملكة العربية السعودية فيتطلب الأمر موافقة CST والمشغّل، ويرتبط المرسلون الأجانب عبر مجمّع محلي مرخّص من CST.

3. 3

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

4. 4

   ابدأ التشغيل الموازي في أي بلد فقط بعد الموافقة على معرّف المُرسِل فيه بالنسبة لمسارات BroadNet. وحتى ذلك الحين، استمر في الإرسال عبر مزود الخدمة الحالي.

توجد قواعد كل سوق في صفحات اللوائح. لوائح رسائل SMS حسب البلد

شغّل المزودَين بالتوازي

أبقِ مزود الخدمة الحالي لديك فعالاً، وأضف BroadNet كمسار ثانٍ خلف محوّل في برمجتك. أرسل أولاً إلى أرقامك الموثقة، ثم إلى جزء صغير من حركة الرسائل الحقيقية، وقارن بين المسارين على نفس الوجهات.

مقارنة حسب البلد والمشغّل:

• مزيج حالات التسليم: تم التسليم، لم يتم التسليم، منتهية الصلاحية، ومرفوضة.
• الوقت المستغرق من إرسال الرسالة إلى استلام إيصال التسليم.
• المرسل الذي يظهر على الهاتف.
• عدد المقاطع لنفس النص، من POST /sms/identify.

اختر المسار لكل مستلم لا لكل رسالة، حتى تمر كل محاولات إعادة إرسال OTP للمستخدم نفسه عبر المزود نفسه. مفتاح توجيه بسيط:

// Send a share of recipients through BroadNet; the rest stay on your
// current provider. BROADNET_SHARE is a percentage (0-100) you control.
const BROADNET_SHARE = Number(process.env.BROADNET_SHARE ?? "0");

// Same recipient -> same bucket, so OTP retries stay on one provider.
function bucket(to: string): number {
  let h = 0;
  for (const c of to) h = (h * 31 + c.charCodeAt(0)) >>> 0;
  return h % 100;
}

export async function sendSms(to: string, text: string, senderId: string) {
  if (bucket(to) < BROADNET_SHARE) return sendViaBroadNet(to, text, senderId);
  return sendViaCurrentProvider(to, text, senderId); // your existing code
}

async function sendViaBroadNet(to: string, text: string, senderId: string) {
  const res = await fetch("https://api.broadnet.me/sms/sendSms", {
    method: "POST",
    headers: {
      Authorization: `Bearer ${process.env.BROADNET_TOKEN}`,
      "Content-Type": "application/json",
    },
    // Use UNICODE for non-GSM text; POST /sms/identify tells you which.
    body: JSON.stringify({ senderId, destinationNumber: to, message: text, messageType: "TEXT" }),
  });
  if (!res.ok) throw new Error(`BroadNet send failed: ${res.status}`);
  return { provider: "broadnet", messageId: await res.text() };
}

زيادة حركة الرسائل على مراحل

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

1. الاختبار

   أرقامك الموثقة فقط. تأكد من معرّف المُرسِل، ونص الرسالة، وإيصالات التسليم.

2. 5%

   نسبة صغيرة من حركة الرسائل الحقيقية. حركة رسائل OTP إلى دولة واحدة تُعيد إيصالات تسليم سريعة وواضحة.

3. 25%

   حجم كافٍ لمقارنة معدلات التسليم وأوقات الاستلام مع مزود الخدمة الحالي.

4. 100%

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

كم من الوقت يستغرق ذلك

زيادة حركة الرسائل تستغرق الوقت الذي تختاره. عملية الإعداد تتم وفق مسار واحد: نرد على طلب الوصول التجريبي خلال يوم عمل واحد، ويستغرق التكامل التقني من يومين إلى خمسة أيام عمل، بينما يستغرق التحقق من المسار مع الموافقة على معرّف المُرسِل من ثلاثة إلى عشرة أيام عمل. في معظم الأسواق، ينتقل النظام من مرحلة الاكتشاف إلى مرحلة التشغيل الفعلي في غضون 5 إلى 15 يوم عمل؛ أما في الأسواق التي تستغرق فيها الجهات التنظيمية وقتًا أطول للموافقة على معرّفات المُرسِلين، فيستغرق الأمر وقتًا أطول. اطلع على خطوات الإعداد

العودة إلى مزودك الحالي دون انقطاع

للتراجع، استخدم نفس المفتاح ولكن بشكل عكسي: خفّض نسبة حركة البيانات المرسلة عبر BroadNet إلى آخر خطوة نجحت، أو إلى الصفر. سيبقى التكامل الحالي وتسجيلات معرّف المُرسِل الخاصة به فعّالة طوال الوقت، لذا يكفي خفض النسبة. لا حاجة لإعادة بناء أي شيء.

• احتفظ ببيانات اعتماد مزود الخدمة الحالي، وتسجيلات معرّف المُرسِل، ونقطة نهاية webhook نشطة حتى يتم نقل جميع حركة الرسائل وتتطابق إيصالات التسليم مع ما أرسلته.
• قبل البدء، اتفقوا على ما الذي يؤدي إلى التراجع، على سبيل المثال انخفاض في نسبة الرسائل التي يتم تسليمها في بلد واحد، ومن يُسمح له باتخاذ القرار.
• أبقِ معالج webhook قيد التشغيل بعد عملية التراجع: لا يزال من الممكن وصول إيصالات التسليم للرسائل التي تم إرسالها بالفعل عبر BroadNet.
• لا تقم بإلغاء المسار القديم إلا بعد أن تسير جميع حركة الرسائل بسلاسة عبر BroadNet وتتطابق إيصالات التسليم مع ما أرسلته.

من المسؤول عن ماذا؟

تؤثر عملية الترحيل على الكود البرمجي، وتسجيلات المرسلين، وحركة البيانات المباشرة. هكذا يتم تقسيم العمل.

الوثائق ذات الصلة

الأسئلة الشائعة