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

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

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

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

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

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

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

نسخ ولصق

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

{
  "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}"
      }
    }
  }
}

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}}}'

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

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

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

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

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

• llms.txt
  /llms.txt

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

• مهارات الوكيل
  /.well-known/agent-skills/index.json

  خمسة أدلة تشغيل SKILL.md: التغطية والسعر، وتسجيل معرّف المُرسِل، وSMS اختبار أولي، ووصول تجريبي، والاتصال بخوادم MCP.

• بطاقة وكيل A2A
  /.well-known/agent-card.json

  بطاقة Agent2Agent لنفس أدوات المعرفة المخصصة للقراءة فقط، والتي يتم تقديمها عبر JSON-RPC عند /a2a.

• كتالوج API
  /.well-known/api-catalog

  مجموعة روابط RFC 9727 تشير إلى مواصفات OpenAPI، ووثائق API، وكلا خادمي MCP، وصفحة الحالة.

• بطاقة خادم MCP
  /.well-known/mcp.json

  بطاقة الخادم التي تصف كلا خادمي MCP، وطرق النقل والمصادقة الخاصة بهما.

• OpenAPI 3.1
  /developers/openapi.yaml

  الوصف الكامل لـ REST API: نزّله، أو ولّد منه عميلًا بأنواع محددة.

• نسخ Markdown المطابقة
  /pricing/sms/uae.md

  أضف .md إلى معظم روابط URL الخاصة بالصفحة، أو أرسل Accept: text/markdown، للحصول على نسخة Markdown نظيفة من الصفحة.

• ملفات البيانات
  /data/coverage.json

  التغطية، والأسعار المعلنة، واللوائح لكل سوق بصيغة JSON (CSV للتغطية والتسعير).

• الحالة بصيغة JSON
  /status/api/v2/summary.json

  إمكانية الوصول المقاسة للموقع الإلكتروني، وبوابة API، وكلا نقطتي النهاية MCP، بصيغة ملخص Statuspage v2.

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

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

• الموافقة المسبقة قبل إرسال المحتوى

  أرسل الرسائل التسويقية فقط للمستلمين الذين قدموا موافقة مسبقة، واحتفظ بسجل الموافقة المسبقة. توفر أداة sender_id_rules قواعد الموافقة المسبقة لكل سوق.

• احترام طلبات إلغاء الاشتراك

  تحمل الرسائل الترويجية الكلمة المفتاحية لإلغاء الاشتراك الخاصة بكل سوق، مثل STOP. لا يقوم الوكيل أبداً بمراسلة أي رقم قام بإلغاء اشتراكه.

• معرّفات المُرسِلين المسجلة فقط

  تتطلب العديد من الأسواق التسجيل المسبق لمعرّفات المُرسِلين الأبجدية الرقمية. يستخدم الوكيل معرّفات المُرسِلين المعتمدة في حسابك، ولا يستخدم أبداً معرّفات وهمية.

• احترام ساعات منع الإرسال

  تحظر العديد من الأسواق الرسائل التسويقية ليلاً. توفر sender_id_rules ساعات منع الإرسال المستمدة من المصادر؛ وعادةً ما يُسمح بإرسال OTP والتنبيهات على مدار الساعة.

• حماية تدفقات OTP من عمليات الضخ

  قد تُطلق البوتات عمليات إرسال OTP إلى أرقام يجني منها المحتالون أرباحًا. حدّد معدل طلبات الرموز لكل رقم وعنوان IP وجهاز، واحظر الوجهات التي لا تخدمها. وتأتي MyOTP بهذه الحمايات مفعّلة افتراضيًا.

• يقوم شخص بتأكيد كل عملية إرسال

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

• اختبر على رقمك الخاص

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

• حافظ على الرمز بعيداً عن الدردشة

  الرمز بيانات اعتماد للإرسال. حمّله من متغير بيئة، ولا تضعه أبدًا في نص الطلب (prompt)، وألغِه إن تسرّب.

ذات صلة

الأسئلة