# المراسلة والصوت لوكلاء الذكاء الاصطناعي.

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

لوكلاء الذكاء الاصطناعي· /developers/ai-agents

امنح وكيل الذكاء الاصطناعي وسيلة آمنة للاطلاع على التغطية والقواعد والأسعار، وإرسال SMS وWhatsApp ورموز المرور لمرة واحدة عبر حساب BroadNet الخاص بك. استخدم أي واجهة تناسب بنيتك التقنية: خادما MCP، أو REST API، أو TypeScript SDK، أو ملفات بسيطة قابلة للقراءة آلياً.

[طلب وصول تجريبي](https://www.broadnet.me/ar/signup) نسخ إعدادات MCP

## اختر طريقة الدخول

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

خادم المعرفة MCP

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

https://www.broadnet.me/mcp

**المصادقة:**

لا يوجد

**الوصول:**

للقراءة فقط · 13 أداة، و60 طلبًا في الدقيقة لكل عنوان IP

**الأنسب لـ:**

أسئلة التخطيط والبحث وما قبل البيع، قبل إنشاء أي حساب.

خادم المراسلة MCP

واجهة BroadNet البرمجية للمراسلة متاحة على شكل أدوات MCP. يرسل الوكيل الرسائل ويتتبعها بصلاحيات الرمز الذي تمنحه إياه.

https://mcp.broadnet.me/mcp

**المصادقة:**

Bearer <token>

**الوصول:**

ينفذ عمليات على حسابك

**الأنسب لـ:**

المساعدون والوكلاء الذين يرسلون بناءً على طلب المستخدم، مع تأكيد الشخص لكل عملية إرسال.

REST API

واجهة REST بمصادقة رمز Bearer، مع مجموعة مسارات لكل قناة، موصوفة في مواصفة OpenAPI 3.1. وكيلك يقرّر، وشيفرتك تنفّذ الاستدعاء.

https://api.broadnet.me

**المصادقة:**

Bearer <token>

**الوصول:**

يقوم الكود الخاص بك باستدعاء API · OpenAPI 3.1

**الأنسب لـ:**

وكلاء الإنتاج حيث تتولى برمجياتك الخلفية عمليات إعادة المحاولة، والتسجيل، والقيود.

TypeScript SDK

حزمة SDK الرسمية الوحيدة، @broadnet/cpaas-sdk، مُولَّدة من مواصفة OpenAPI. أما اللغات الأخرى فتستدعي REST API مباشرةً أو تُولّد عميلًا من المواصفة.

npm i @broadnet/cpaas-sdk

**المصادقة:**

Bearer <token>

**الوصول:**

يقوم الكود الخاص بك باستدعاء API · TypeScript / Node.js

**الأنسب لـ:**

أطر عمل وكلاء Node.js وتعاريف الأدوات مع أنواع كاملة.

## ما يمكن للوكيل إرساله

تنطبق القواعد نفسها بغض النظر عن الواجهة التي يستخدمها الوكيل: مُرسِل مُسجل، ومستلم وافق مسبقاً، ومحتوى يتناسب مع القناة.

SMS

رسالة واحدة لكل طلب، أو مهمة جماعية من ملف. تتم الفوترة لكل مقطع، لذا تكلّف النصوص الطويلة أو غير اللاتينية أكثر: احسب عدد مقاطعها أولًا.

**REST API**

`POST /sms/sendSms` (JSON) `POST /sms/sendbulk` (multipart)

**MCP المراسلة**

أدوات إرسال SMS، على سبيل المثال `post_sms_send`

WhatsApp

رسائل حرة التنسيق ضمن نافذة الخدمة التي تبلغ 24 ساعة؛ وخارجها، تُستخدم القوالب المعتمدة فقط. يتم إدراج القوالب وإرسالها بواسطة الاسم.

**REST API**

`POST /whatsapp/message/sendbulk` (multipart)

**MCP المراسلة**

`post_whatsapp_message_send`، `get_whatsapp_template_list`، `post_whatsapp_template_send`

OTP

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

**REST API**

`POST /sms/sendSms` مع تضمين الرمز في الرسالة

**MCP المراسلة**

أدوات SMS وقوالب WhatsApp نفسها

الصوت

يُوفَّر OTP الصوتي ومكالمات تحويل النص إلى كلام وIVR عبر فريق حسابك. تغطي مواصفة OpenAPI العامة وأدوات MCP قنوات المراسلة، لا المكالمات الصوتية. وللاتصال الصادر بالذكاء الاصطناعي، راجع DialerBee.

**REST API**

يتم توفيرها لكل حساب

**MCP المراسلة**

لا تتوفر أدوات صوتية

## مثال عملي: يقوم وكيل بالتخطيط لإطلاق OTP

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

المستخدم

نريد إرسال حوالي 50,000 رمز تسجيل دخول شهرياً للعملاء في الإمارات. ما الذي نحتاجه، وكم ستكون التكلفة؟

1. 1 استدعاء الأداة `check_coverage` هل تغطي الخدمة الإمارات؟ ومع أي مشغّلين؟ → `{"country":"UAE"}` النتيجة (مختصرة) `{ "country": "UAE", "regulator": "TDRA (Telecommunications and Digital Government Regulatory Authority)", "channels": { "sms": "Live", "otp": "Live", "whatsapp": "Live", "rcs": "Available", "voice": "Live" }, "operators": [ { "name": "Etisalat / e&", "status": "Direct" }, { "name": "du", "status": "Direct" }, { "name": "Virgin Mobile", "status": "Operator-grade" } ] }`
2. 2 استدعاء الأداة `sender_id_rules` ما الذي يتطلبه معرّف المُرسِل هناك؟ → `{"country":"ae"}` النتيجة (مختصرة) `{ "typicalLeadTime": "5-7 business days", "requirements": [ { "format": "Alphanumeric (Latin or Arabic), up to 11 chars. AD- prefix mandatory on promotional senders.", "preRegistration": "Required — one sender ID per legal entity per use case" } ], "marketingRules": { "quietHours": "TDRA's spam policy bars marketing text messages between 21:00 and 07:00 GST. Transactional OTP and alerts are 24/7." } }`
3. 3 استدعاء الأداة `count_sms_segments` كم عدد المقاطع في الرسالة؟ → `{"text":"Your MyShop code is 482913. It expires in 5 minutes. Never share it."}` النتيجة (مختصرة) `{ "encoding": "GSM-7", "units": 68, "segments": 1 }`
4. 4 استدعاء الأداة `estimate_price` ما هو السعر التقديري؟ → `{"country":"UAE","channel":"sms","volume":50000}` النتيجة (مختصرة) `{ "country": "UAE", "unitPriceUsd": 0.0123, "unit": "per SMS segment", "estimatedMonthlyUsd": 615, "ratesReviewed": "2026-09-24", "note": "Indicative list rate, excluding taxes and sender-ID fees. Volume pricing available; a written quote confirms per-operator pricing." }`

الوكيل

دولة الإمارات مغطّاة بمسارات مباشرة مع المشغّلين (Etisalat / e& · du). يتطلب معرّف المُرسِل تسجيلًا مسبقًا لدى TDRA، ويستغرق عادةً 5–7 أيام عمل. تتكوّن رسالة الرمز من 1 مقطع SMS. وبسعر القائمة الاسترشادي البالغ ‏0.0123 US$ لكل مقطع، تبلغ تكلفة 50,000 رمز نحو ‏615 US$ شهريًا، دون الضرائب ورسوم معرّف المُرسِل. هذا ليس عرض سعر.

الخطوة التالية: اطلب وصولاً تجريبياً عبر broadnet.me/signup. بمجرد حصولك على الرمز، يمكنني إرسال رمز تجريبي واحد إلى رقمك الموثق عبر خادم المراسلة. هل أقوم بتجهيز هذه الرسالة لك للتأكيد؟

تُبنى من المخرجات الفعلية للأدوات عند كل نشر

## نسخ ولصق

تستخدم الأمثلة أرقامًا وهمية فقط. اقرأ الرمز من متغير بيئة، ولا تلصقه أبدًا في محادثة أو في ملف يُرفع إلى المستودع.

mcp.json — كلا الخادمين

```
{
  "mcpServers": {
    "broadnet-knowledge": {
      "type": "http",
      "url": "https://www.broadnet.me/mcp"
    },
    "broadnet": {
      "type": "http",
      "url": "https://mcp.broadnet.me/mcp",
      "headers": {
        "Authorization": "Bearer ${BROADNET_TOKEN}"
      }
    }
  }
}
```

تختلف أسماء الحقول قليلًا بين العملاء (بعضها يتوقع النوع "streamable-http"، وبعضها يقرأ الترويسات من إعداد منفصل). أضف إدخال خادم المعرفة وحده إن لم يكن لديك رمز بعد.

tools/call estimate_price (خادم المعرفة)

```
curl -X POST https://www.broadnet.me/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "MCP-Protocol-Version: 2025-06-18" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call",
       "params":{"name":"estimate_price",
                 "arguments":{"country":"UAE","channel":"sms","volume":50000}}}'
```

إرسال SMS واحد (REST API)

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

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

يُرجع HTTP 200 معرف الرسالة. لا يحتوي API على ترويسة تكرار العمليات (idempotency): بعد حدوث خطأ في الشبكة أو 5xx، تحقق من حالة الرسالة باستخدام معرفها قبل محاولة الإرسال مرة أخرى.

الإرسال ذاته باستخدام TypeScript SDK

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

إرسال قالب WhatsApp معتمد (REST API)

```
# Send an approved WhatsApp template
curl -X POST https://api.broadnet.me/whatsapp/message/sendbulk \
  -H "Authorization: Bearer $BROADNET_TOKEN" \
  -F batchId=0 \
  -F campaignName=order-updates \
  -F destinationNo=447700900123 \
  -F messageType=TEMPLATE \
  -F templateName=order_update \
  -F templateLanguage=en_US \
  -F bodyTemplateVariables=INV-400

# 200 OK → the response carries the batchId; per-recipient status
# (SUBMITTED → SENT → DELIVERED → READ) arrives on your webhook.
```

تعمل القوالب خارج نافذة الخدمة التي تبلغ 24 ساعة؛ بينما تتطلب النصوص الحرة نافذة مفتوحة.

## نقاط دخول قابلة للقراءة آلياً

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

- [llms.txt `/llms.txt` فهرس الموقع لنماذج اللغة، مع قسم خاص بوصول الوكلاء والقيود، بالإضافة إلى ملف واحد لكل لغة.](https://www.broadnet.me/llms.txt)
- [مهارات الوكيل `/.well-known/agent-skills/index.json` خمسة أدلة تشغيل SKILL.md: التغطية والسعر، وتسجيل معرّف المُرسِل، وSMS اختبار أولي، ووصول تجريبي، والاتصال بخوادم MCP.](https://www.broadnet.me/.well-known/agent-skills/index.json)
- [بطاقة وكيل A2A `/.well-known/agent-card.json` بطاقة Agent2Agent لنفس أدوات المعرفة المخصصة للقراءة فقط، والتي يتم تقديمها عبر JSON-RPC عند /a2a.](https://www.broadnet.me/.well-known/agent-card.json)
- [كتالوج API `/.well-known/api-catalog` مجموعة روابط RFC 9727 تشير إلى مواصفات OpenAPI، ووثائق API، وكلا خادمي MCP، وصفحة الحالة.](https://www.broadnet.me/.well-known/api-catalog)
- [بطاقة خادم MCP `/.well-known/mcp.json` بطاقة الخادم التي تصف كلا خادمي MCP، وطرق النقل والمصادقة الخاصة بهما.](https://www.broadnet.me/.well-known/mcp.json)
- [OpenAPI 3.1 `/developers/openapi.yaml` الوصف الكامل لـ REST API: نزّله، أو ولّد منه عميلًا بأنواع محددة.](https://www.broadnet.me/developers/openapi.yaml)
- [نسخ Markdown المطابقة `/pricing/sms/uae.md` أضف .md إلى معظم روابط URL الخاصة بالصفحة، أو أرسل Accept: text/markdown، للحصول على نسخة Markdown نظيفة من الصفحة.](https://www.broadnet.me/pricing/sms/uae.md)
- [ملفات البيانات `/data/coverage.json` التغطية، والأسعار المعلنة، واللوائح لكل سوق بصيغة JSON (CSV للتغطية والتسعير).](https://www.broadnet.me/data/coverage.json)
- [الحالة بصيغة JSON `/status/api/v2/summary.json` إمكانية الوصول المقاسة للموقع الإلكتروني، وبوابة API، وكلا نقطتي النهاية MCP، بصيغة ملخص Statuspage v2.](https://www.broadnet.me/status/api/v2/summary.json)

## القواعد التي يجب على الوكيل اتباعها

يعمل الوكيل الذي يرسل الرسائل نيابة عن علامتك التجارية باستخدام بيانات اعتمادك. قم بدمج هذه القواعد ضمن تعليماته وأدواته.

- الموافقة المسبقة قبل إرسال المحتوى أرسل الرسائل التسويقية فقط للمستلمين الذين قدموا موافقة مسبقة، واحتفظ بسجل الموافقة المسبقة. توفر أداة sender_id_rules قواعد الموافقة المسبقة لكل سوق.
- احترام طلبات إلغاء الاشتراك تحمل الرسائل الترويجية الكلمة المفتاحية لإلغاء الاشتراك الخاصة بكل سوق، مثل STOP. لا يقوم الوكيل أبداً بمراسلة أي رقم قام بإلغاء اشتراكه.
- معرّفات المُرسِلين المسجلة فقط تتطلب العديد من الأسواق التسجيل المسبق لمعرّفات المُرسِلين الأبجدية الرقمية. يستخدم الوكيل معرّفات المُرسِلين المعتمدة في حسابك، ولا يستخدم أبداً معرّفات وهمية.
- احترام ساعات منع الإرسال تحظر العديد من الأسواق الرسائل التسويقية ليلاً. توفر sender_id_rules ساعات منع الإرسال المستمدة من المصادر؛ وعادةً ما يُسمح بإرسال OTP والتنبيهات على مدار الساعة.
- حماية تدفقات OTP من عمليات الضخ قد تُطلق البوتات عمليات إرسال OTP إلى أرقام يجني منها المحتالون أرباحًا. حدّد معدل طلبات الرموز لكل رقم وعنوان IP وجهاز، واحظر الوجهات التي لا تخدمها. وتأتي MyOTP بهذه الحمايات مفعّلة افتراضيًا.
- يقوم شخص بتأكيد كل عملية إرسال اجعل العميل يطلب الإذن قبل استخدام أي أداة إرسال، خاصة عند الإرسال إلى عدد كبير من المستلمين، وقم بتفعيل الأدوات التي يحتاجها الوكيل فقط.
- اختبر على رقمك الخاص باستخدام بيانات اعتماد الاختبار، أرسل فقط إلى رقمك الموثق. تُستخدم أرقام وهمية في الأمثلة والمطالبات.
- حافظ على الرمز بعيداً عن الدردشة الرمز بيانات اعتماد للإرسال. حمّله من متغير بيئة، ولا تضعه أبدًا في نص الطلب (prompt)، وألغِه إن تسرّب.

## ذات صلة

[خوادم MCP تفاصيل كلا الخادمين: نقاط النهاية، والمصادقة، وإعداد العميل، والعرض التوضيحي.](https://www.broadnet.me/ar/developers/mcp) [البدء السريع من الوصول التجريبي إلى أول SMS باستخدام curl أو TypeScript SDK.](https://www.broadnet.me/ar/developers/quickstart) [مرجع API نقطة نهاية الإرسال لكل قناة، ومصادقة Bearer، وتنسيق الخطأ.](https://www.broadnet.me/ar/developers/api) [إعادة محاولات آمنة كيفية إعادة المحاولة دون إرسال الرسالة مرتين.](https://www.broadnet.me/developers/idempotency) [عدّاد مقاطع SMS الترميز وعدد المقاطع لأي نص رسالة.](https://www.broadnet.me/ar/developers/sms-counter) [BroadNet Inference نماذج اللغة العربية لتحويل الكلام إلى نص ونماذج الرؤية لوكلاء الصوت والمستندات.](https://www.broadnet.me/ar/products/inference) [DialerBee نظام اتصال آلي صادر متعدد اللغات مدعوم بالذكاء الاصطناعي لمراكز الاتصال.](https://www.broadnet.me/ar/dialerbee) [ما هو ضخ SMS؟ كيف يعمل احتيال OTP والوسائل الدفاعية التي توقفه.](https://www.broadnet.me/ar/answers/what-is-sms-pumping)

## الأسئلة

### هل يمكن لوكيل الذكاء الاصطناعي إرسال رسائل SMS و WhatsApp عبر BroadNet؟

نعم. اربطه بخادم المراسلة MCP على https://mcp.broadnet.me/mcp باستخدام رمز BroadNet الخاص بك، أو اجعل شيفرتك تستدعي REST API على https://api.broadnet.me. وفي الحالتين يعمل الوكيل بصلاحيات رمزك، لذا اشترط أن يؤكد شخصٌ كل عملية إرسال.

### هل يحتاج الوكيل إلى حساب للاستفسار عن التغطية أو الأسعار؟

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

### كيف يقوم الوكيل بإرسال رمز مرور لمرة واحدة؟

يُنشئ نظامك الرمز، ويرسله الوكيل في رسالة SMS عبر POST /sms/sendSms، أو في قالب مصادقة على WhatsApp. لا تتضمن الواجهة البرمجية العامة نقطة نهاية منفصلة للتحقق، لذا يبقى التحقق من الرمز داخل نظامك.

### هل يمكن للوكيل إجراء مكالمات صوتية؟

يُوفَّر OTP الصوتي ومكالمات تحويل النص إلى كلام وIVR عبر فريق حسابك في BroadNet، وهي غير مدرجة في مواصفة OpenAPI العامة ولا في أدوات MCP. أما DialerBee فهو نظام الاتصال الصادر بالذكاء الاصطناعي من BroadNet لمراكز الاتصال.

### كيف يمكنني الحصول على رمز؟

اطلب وصولًا تجريبيًا عبر /signup. ترد BroadNet خلال يوم عمل واحد ببيانات اعتماد تجريبية. لا يوجد مفتاح فوري بالخدمة الذاتية.

## اربط وكيلك بـ BroadNet

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

[طلب وصول تجريبي](https://www.broadnet.me/ar/signup) [دليل خادم MCP](https://www.broadnet.me/ar/developers/mcp)