انتقل إلى المحتوى
OmniChannels.ai
القائمة

واجهة API واحدة للمراسلة عبر ثماني قنوات

أرسل رسائل SMS وWhatsApp وRCS وMessenger وInstagram وTelegram والبريد الإلكتروني والإشعارات الفورية من شيفرتك الخاصة بعنوان أساسي واحد ورمز Bearer واحد. وتابع كل رسالة عبر webhooks، ووسّع إرسال SMS عبر SMPP، ومكّن وكلاء الذكاء الاصطناعي من استخدام الواجهة نفسها عبر MCP.

تحدث مع مختص في APIاحجز عرضاً توضيحياً مباشراً
POST /sms/sendSmscURL
curl -X POST https://api.broadnet.me/sms/sendSms \
  -H "Authorization: Bearer $BROADNET_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "senderId": "OmniDemo",
    "destinationNumber": "447700900123",
    "message": "Your code is 482913",
    "messageType": "TEXT"
  }'

# 200 OK
2603121407537573731

طلب حقيقي: يعيد POST /sms/sendSms معرّف الرسالة كنص عادي. استبدل الرمز واسم المرسِل والرقم ببياناتك.

الإجابة المختصرة

آخر تحديث

تمنح OmniChannels.ai المطورين REST API واحدة لرسائل SMS وWhatsApp وRCS وMessenger وInstagram وTelegram والبريد الإلكتروني والإشعارات الفورية. وتضم نحو 225 مساراً موثّقاً في مواصفة OpenAPI 3.1، إلى جانب SDK بلغة TypeScript، وwebhooks لحالة التسليم، وSMPP v3.4 عبر TLS، وخادم MCP لوكلاء الذكاء الاصطناعي. ويقتصر الوصول التجريبي على أرقامك الموثّقة، ويدعم مهندسونا تكاملك، ويستطيع الموزّعون استخدام الواجهة نفسها بعلامتهم التجارية.

بنية تحتية موثوقةمزوّد حلول أعمال رسمي لدى Metaشريك Google RBMعضو في GSMAISO/IEC 27001:2022ISO/IEC 27018ISO 9001:2015ISO 22301SOC 2 Type IIمتوافق مع GDPR

ما تحصل عليه بصفتك مطوراً

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

نواة مراسلة توضيحية تضم REST API والويب هوك وSMPP عبر TLS وMCP لوكلاء الذكاء الاصطناعي، توجّه الرسائل إلى واتساب وSMS وRCS وماسنجر وإنستغرام وتيليجرام والبريد الإلكتروني والإشعارات.

أدوات المطورين في لمحة

ما هو متاح اليوم، وما يُجهَّز بالتنسيق مع فريقنا.

العنصرالحالةالتفاصيل
REST API (SMS وWhatsApp وRCS وMessenger وInstagram وTelegram والبريد الإلكتروني والإشعارات الفورية)متاحالعنوان الأساسي https://api.broadnet.me مع مصادقة برمز Bearer. ويُمنح الوصول التجريبي بعد طلب قصير.
webhooks لحالة التسليممتاحتُضبط لكل حساب أو حساب فرعي، وتُوحَّد الحالات عبر القنوات.
SDK بلغة TypeScriptمتاحnpm install @broadnet/cpaas-sdk axios. أما اللغات الأخرى فتستدعي REST API مباشرة أو تولّد عميلاً.
مواصفة OpenAPI 3.1متاحمتاحة للجميع على https://omnichannels.ai/developers/openapi.json (وبصيغة YAML على ‎/developers/openapi.yaml): كل العمليات التي يستطيع رمز العميل استدعاءها، لاستخدامها في Postman وInsomnia وتوليد العملاء وأدوات البرمجة بالذكاء الاصطناعي.
خادم MCPمتاحhttps://mcp.broadnet.me/mcp عبر Streamable HTTP، مع المصادقة برمزك.
SMPP v3.4 عبر TLSعند الطلبيجهّز فريقنا لحسابك الاتصالات والإنتاجية وقائمة عناوين IP المسموح بها.
الصوت (OTP والرد الصوتي التفاعلي IVR والمكالمات الصادرة ووكلاء الصوت بالذكاء الاصطناعي)عند الطلبيُجهَّز مع فريق الحساب؛ ولا توجد نقاط نهاية صوتية عامة في REST API.

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

لا يوجد تسجيل ذاتي فوري. يبدأ الوصول بطلب قصير لنُعدّ الحساب بما يناسب قنواتك ودولك.

  1. 1

    اطلب وصولاً تجريبياً

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

  2. 2

    أرسل أول رسالة تجريبية

    اتبع دليل البدء السريع لإرسال رسالة SMS إلى رقمك الموثّق واستقبال حالة تسليمها على webhook الخاص بك.

  3. 3

    ابنِ التكامل

    أضف القنوات التي تحتاجها، وعالج الأخطاء وإعادة المحاولة، وسجّل معرّفات الرسائل. ويمكن لمهندسينا مراجعة تصميمك عبر REST أو SMPP.

  4. 4

    احصل على اعتماد المرسِلين

    تُسجَّل أسماء المرسِلين وحسابات WhatsApp Business ووكلاء RCS بالتوازي مع عملية البناء، وفق قواعد كل دولة ومنصة.

  5. 5

    أطلق

    تُفعَّل مسارات الإنتاج لحسابك، وتواصل شيفرتك استدعاء العنوان الأساسي نفسه، فلا يتغير شيء عند الانتقال.

هل تناسب هذه الواجهة فريقك؟

يناسبك إذا

  • تريد تكاملاً واحداً لرسائل SMS وWhatsApp وRCS والمراسلة الاجتماعية والبريد الإلكتروني والإشعارات الفورية بدلاً من التعامل مع عدة مزوّدين.
  • تحتاج إلى حالة تسليم كل رسالة داخل أنظمتك، لا في لوحة التحكم فقط.
  • ترسل أحجاماً كبيرة من رسائل SMS وتريد SMPP إلى جانب REST.
  • تعيد بيع خدمات المراسلة وتحتاج إلى الواجهة نفسها بعلامتك التجارية مع حسابات فرعية.
  • تبني وكلاء ذكاء اصطناعي ينبغي أن يرسلوا الرسائل ويتابعوها عبر MCP.

ما يجب معرفته قبل البدء

  • لا يوجد تسجيل ذاتي فوري؛ إذ يُمنح الوصول التجريبي بعد طلب قصير.
  • SDK الرسمي متاح بلغة TypeScript فقط؛ وتستخدم اللغات الأخرى HTTP مباشرة أو عميلاً مولّداً من المواصفة.
  • لا تقبل الواجهة مفتاح منع التكرار (idempotency key)، لذا يجب أن يسجّل تكاملك كل عملية إرسال قبل إعادة المحاولة.
  • يُجهَّز الصوت وSMPP مع فريقنا بدلاً من نقاط نهاية عامة.
  • يخضع الإرسال عبر WhatsApp وMessenger وInstagram لقواعد Meta، بما فيها القوالب المعتمدة ونوافذ المراسلة.

التوثيق

كل ما تحتاجه للتكامل، من أول طلب عبر الواجهة البرمجية إلى اتصالات SMPP ووكلاء الذكاء الاصطناعي. التوثيق التقني متاح باللغة الإنجليزية.

كيف تندمج API مع أنظمتك

تتصل أنظمتك بـ REST API واحدة باستخدام رمز Bearer واحد. وتوجّه BroadNet كل رسالة عبر القناة والمشغّل المناسبين، وتعيد حالات التسليم إلى webhook الخاص بك.

تطبيقك أو نظام CRM أو وكيل الذكاء الاصطناعي

  • رمز Bearer وعنوان URL أساسي واحد
  • SMPP 3.4 عبر TLS للأحجام الكبيرة
  • خادم MCP لوكلاء الذكاء الاصطناعي

API المراسلة من BroadNet

https://api.broadnet.me
التوجيه والتحويل البديلمسارات مباشرة مع المشغّلين

هاتف عميلك

حالات التسليم إلى webhook الخاص بك

SENTDELIVEREDREADFAILED

أسئلة المطورين

كيف تتم المصادقة؟

أرسل رمز الوصول الخاص بحسابك في ترويسة Authorization: Bearer مع كل طلب. تُصدر الرموز لكل حساب، ولا توجد نقطة نهاية تستبدل اسم المستخدم وكلمة المرور برمز. ويعيد الطلب بلا رمز أو برمز غير صالح الرمز 401. احفظ الرمز على خوادمك، ولا تضعه أبداً في شيفرة المتصفح أو تطبيقات الجوال.

ما العنوان الأساسي، وهل توجد بيئة sandbox منفصلة؟

تُوجَّه كل الاستدعاءات إلى https://api.broadnet.me دون بادئة إصدار. وتستخدم بيئتا الاختبار والإنتاج العنوان الأساسي نفسه: ترسل بيانات الاعتماد التجريبية إلى أرقامك الموثّقة فقط، وتُفعَّل بيئة الإنتاج لحسابك بعد اعتماد المرسِل، فلا تتغير شيفرتك.

كيف أحصل على تقارير التسليم؟

تُرسل الحالات إلى عنوان webhook المضبوط على حسابك: SUBMITTED وSENT وDELIVERED، وREAD في القنوات التي تبلّغ عن القراءة، وFAILED وREJECTED. ويمكنك أيضاً الاستعلام الدوري، مثل GET /sms/list لمهام SMS الجماعية وGET /whatsapp/message/bulk-insights لدفعات WhatsApp.

كيف أتعامل مع إعادة المحاولة والتكرار؟

أعد المحاولة فقط عند أخطاء الشبكة واستجابات 429 و5xx، مع تأخير أُسّي وعشوائية (jitter)، ولا تُعِد أبداً طلبات 4xx دون تعديل. ولأن الواجهة لا تقبل مفتاح idempotency، سجّل كل عملية إرسال قبل تنفيذها، واحفظ معرّف الرسالة المُعاد، وتحقق من الحالة بعد انتهاء المهلة قبل الإرسال مجدداً.

ما حدود المعدّل؟

الحدود الافتراضية الموثّقة هي 200 طلب في الثانية لواجهة REST مع ذروات تصل إلى 500 لمدة أقصاها 60 ثانية، و1,000 رسالة في الثانية لكل اتصال SMPP، و50 طلباً في الثانية للاستعلام عن الأرقام. وتُؤكَّد حدود حسابك مع بيانات الاعتماد. وتعيد الطلبات المتجاوزة للحد الرمز 429 مع ترويسة Retry-After.

ما اللغات البرمجية المدعومة؟

أي لغة قادرة على إرسال طلبات HTTPS. يتوفر SDK رسمي بلغة TypeScript هو ‎@broadnet/cpaas-sdk، وتتضمن الوثائق أمثلة HTTP مباشرة بلغات cURL وNode.js وPython وPHP وJava و.NET وGo وRuby. ويمكنك أيضاً توليد عميل من مواصفة OpenAPI 3.1 المتاحة للعموم على ‎/developers/openapi.json.

هل أستخدم REST أم SMPP لرسائل SMS؟

تناسب REST معظم التطبيقات وتمنحك كل القنوات عبر واجهة واحدة. أما SMPP v3.4 عبر TLS فيناسب الإرسال المستمر لرسائل SMS بأحجام كبيرة، خاصة إن كنت تشغّل عميل SMPP بالفعل. وتُجهَّز الاتصالات والإنتاجية وقوائم عناوين IP المسموح بها لحسابك، ويمكنك استخدام الاثنين معاً على حساب واحد.

هل يمكنني إعادة بيع خدمات المراسلة عبر الواجهة؟

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

أدلة حول هذا الموضوع

اكتشف المزيد من المنصة

اطلب وصولاً تجريبياً

أخبرنا بقنواتك ودولك وأحجامك. سيُعدّ أحد المهندسين بيانات اعتماد تجريبية لأرقامك الموثّقة ويساعدك في التخطيط للانتقال إلى بيئة الإنتاج.

شاركنا الأنظمة التي تستخدمها وما تريد ربطه، وسيتواصل معك مهندس حلول.

تحدث مع مختص في API

نستخدمه للرد عليك. يمكنك استخدام أي نطاق خاص بشركتك.

اختياري. أضف رمز الدولة إذا كنت تفضّل الاتصال الهاتفي.

أضف تفاصيل (اختياري)
القنوات التي تهمك(اختياري)

سيتواصل معك فريقنا بخصوص عملية الربط.