---
title: "واجهة API واحدة للمراسلة عبر ثماني قنوات"
description: "REST API واحدة لرسائل SMS وWhatsApp وRCS وMessenger وInstagram وTelegram والبريد والإشعارات، مع webhooks وSMPP وSDK بلغة TypeScript وخادم MCP."
canonical: "https://omnichannels.ai/ar/developers/"
language: "ar"
updated: "2026-10-10"
publisher: "BroadNet Technologies"
brand: "OmniChannels.ai"
---

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

Canonical: https://omnichannels.ai/ar/developers/
Language: ar
Publisher: OmniChannels.ai by BroadNet Technologies

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

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

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

- **REST API واحدة لثماني قنوات:** تتشارك SMS وWhatsApp وRCS وMessenger وInstagram وTelegram والبريد الإلكتروني والإشعارات الفورية عنواناً أساسياً واحداً ورمز Bearer واحداً وصيغة أخطاء واحدة، فإضافة قناة تعني نقطة نهاية جديدة لا مزوّداً جديداً.
- **OpenAPI 3.1 وSDK بلغة TypeScript:** نحو 225 مساراً موثّقاً في مواصفة OpenAPI 3.1 يمكنك استيرادها إلى Postman أو توليد عملاء منها، إضافة إلى الحزمة الرسمية ‎@broadnet/cpaas-sdk للغة TypeScript وبيئة Node.js.
- **webhooks لحالة التسليم:** تُوحَّد الحالات عبر القنوات (SUBMITTED وSENT وDELIVERED وREAD وFAILED وREJECTED) وتُرسل إلى نقطة نهاية HTTPS لديك، مع نقاط نهاية للاستعلام وإعادة الإرسال كشبكة أمان.
- **SMPP v3.4 لرسائل SMS عالية الحجم:** اتصالات Transceiver عبر TLS مع قائمة عناوين IP مسموح بها، تُجهَّز لحسابك على مسارات المشغلين المباشرة نفسها التي تستخدمها REST API.
- **خادم MCP لوكلاء الذكاء الاصطناعي:** اربط Claude أو Cursor أو أي عميل MCP بالواجهة باستخدام رمزك، ليتمكن الوكلاء من إرسال الرسائل وقراءة تقارير التسليم (DLR) ضمن الضوابط التي تحددها.
- **اختبر قبل الإطلاق:** ترسل بيانات الاعتماد التجريبية إلى أرقامك الموثّقة فقط، على العنوان الأساسي نفسه لبيئة الإنتاج، فلا تتغير شيفرتك عند الانتقال.
- **دعم من مهندسين متخصصين:** يراجع مهندس مراسلة حالة الاستخدام لديك، ويساعدك في تصميم التكامل عبر REST أو SMPP وفي أسماء المرسِلين وقواعد كل دولة، ويرافقك حتى الإطلاق.
- **مصممة للموزّعين:** يستخدم الموزّعون الواجهة نفسها بعلامتهم التجارية، مع حسابات فرعية لكل منها رصيده وأسماء مرسِليه ومستخدموه وwebhooks الخاصة به، إضافة إلى API للموزّعين لإدارة الحسابات.

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

| العنصر | التفاصيل |
|---|---|
| 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. **اطلب وصولاً تجريبياً:** أخبرنا بقنواتك والدول المستهدفة والأحجام وحالة الاستخدام. يراجع أحد المهندسين الطلب ويصدر لك بيانات اعتماد تجريبية.
2. **أرسل أول رسالة تجريبية:** اتبع دليل البدء السريع لإرسال رسالة SMS إلى رقمك الموثّق واستقبال حالة تسليمها على webhook الخاص بك.
3. **ابنِ التكامل:** أضف القنوات التي تحتاجها، وعالج الأخطاء وإعادة المحاولة، وسجّل معرّفات الرسائل. ويمكن لمهندسينا مراجعة تصميمك عبر REST أو SMPP.
4. **احصل على اعتماد المرسِلين:** تُسجَّل أسماء المرسِلين وحسابات WhatsApp Business ووكلاء RCS بالتوازي مع عملية البناء، وفق قواعد كل دولة ومنصة.
5. **أطلق:** تُفعَّل مسارات الإنتاج لحسابك، وتواصل شيفرتك استدعاء العنوان الأساسي نفسه، فلا يتغير شيء عند الانتقال.

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

### يناسبك إذا

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

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

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

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

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

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

آخر تحديث: 2026-10-10