AI ایجنٹس کے لیے میسجنگ اور وائس۔

داخل ہونے کا طریقہ منتخب کریں

ایجنٹس کو عام طور پر دو چیزوں کی ضرورت ہوتی ہے: منصوبہ بندی کے لیے حقائق، اور عمل کرنے کا ایک طریقہ۔ 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 رن بکس: کوریج اور قیمت، سینڈر-ID رجسٹریشن، پہلا ٹیسٹ SMS، ٹیسٹ رسائی، اور MCP سرورز سے کنیکٹ کرنا۔

• A2A ایجنٹ کارڈ
  /.well-known/agent-card.json

  انہی ریڈ-اونلی نالج ٹولز کے لیے ایک Agent2Agent کارڈ، جو /a2a پر JSON-RPC کے ذریعے فراہم کیا جاتا ہے۔

• API کیٹلاگ
  /.well-known/api-catalog

  ایک RFC 9727 لنک سیٹ جو OpenAPI spec، API ڈاکومنٹس، دونوں MCP سرورز اور اسٹیٹس پیج کی طرف اشارہ کرتا ہے۔

• MCP سرور کارڈ
  /.well-known/mcp.json

  سرور کارڈ جو دونوں MCP سرورز، ان کے ٹرانسپورٹ اور آتھنٹیکیشن کی وضاحت کرتا ہے۔

• OpenAPI 3.1
  /developers/openapi.yaml

  مکمل REST API تفصیل: اسے ڈاؤن لوڈ کریں، یا اس سے ٹائپڈ کلائنٹ تیار کریں۔

• مارک ڈاؤن ٹوئنز
  /pricing/sms/uae.md

  صفحات کے زیادہ تر URLs میں .md شامل کریں، یا Markdown کا صاف ستھرا کاپی حاصل کرنے کے لیے Accept: text/markdown بھیجیں۔

• ڈیٹا فائلز
  /data/coverage.json

  ہر مارکیٹ کے لیے کوریج، شائع شدہ قیمتیں اور ریگولیشنز JSON کے طور پر (کوریج اور قیمتوں کے لیے CSV)۔

• اسٹیٹس JSON
  /status/api/v2/summary.json

  ویب سائٹ، API گیٹ وے اور دونوں MCP اینڈ پوائنٹس کی پیمائش شدہ رسائی، Statuspage v2 کے خلاصے کی شکل میں۔

وہ اصول جن پر ایجنٹ کو عمل کرنا چاہیے

ایک ایجنٹ جو میسجز بھیجتا ہے، آپ کے کریڈنشلز کے ساتھ آپ کے برانڈ کے طور پر کام کرتا ہے۔ ان قواعد کو اس کی ہدایات اور ٹولز میں شامل کریں۔

• مواد سے پہلے رضامندی

  مارکیٹنگ صرف ان وصول کنندگان کو بھیجیں جنہوں نے آپٹ اِن کیا ہو، اور آپٹ اِن کا ریکارڈ اپنے پاس رکھیں۔ sender_id_rules ٹول ہر مارکیٹ کے آپٹ اِن کے قواعد واپس کرتا ہے۔

• آپٹ آؤٹ کا احترام کریں

  پروموشنل میسجز میں مارکیٹ کا آپٹ آؤٹ کی ورڈ ہوتا ہے، جیسے کہ STOP۔ ایجنٹ کبھی بھی اس نمبر پر میسج نہیں بھیجتا جس نے آپٹ آؤٹ کیا ہو۔

• صرف رجسٹرڈ سینڈر ID

  کئی مارکیٹس میں الفانیومیرک (alphanumeric) سینڈر IDs کی پیشگی رجسٹریشن ضروری ہوتی ہے۔ ایجنٹ آپ کے اکاؤنٹ پر منظور شدہ سینڈر IDs استعمال کرتا ہے، کبھی بھی خود سے بنائی گئی ID استعمال نہیں کرتا۔

• خاموش اوقات کا احترام کریں

  کئی مارکیٹس میں رات کے وقت مارکیٹنگ پر پابندی ہوتی ہے۔ sender_id_rules خاموش اوقات (quiet hours) کی معلومات فراہم کرتا ہے؛ OTP اور الرٹس کی عام طور پر چوبیس گھنٹے اجازت ہوتی ہے۔

• پمپنگ کے خلاف OTP فلو کی حفاظت کریں

  بوٹس ان نمبروں پر OTP بھیجنے کا عمل شروع کر سکتے ہیں جن سے انہیں فائدہ ہوتا ہے۔ نمبر، IP اور ڈیوائس کے لحاظ سے کوڈ کی درخواستوں پر ریٹ لمیٹ لگائیں، اور ان منزلوں کو بلاک کریں جہاں آپ سروس فراہم نہیں کرتے۔ MyOTP ڈیفالٹ کے طور پر یہ حفاظتی اقدامات فراہم کرتا ہے۔

• ایک شخص ہر بھیجنے کی تصدیق کرتا ہے

  کسی بھی ایسے ٹول کو استعمال کرنے سے پہلے کہ وہ پیغامات بھیجے، خاص طور پر جب بہت سے وصول کنندگان کو بھیجنا ہو، کلائنٹ سے پوچھیں اور صرف وہی ٹولز فعال کریں جن کی ایجنٹ کو ضرورت ہے۔

• اپنے نمبر پر ٹیسٹ کریں

  ٹیسٹ کریڈنشلز کے ساتھ، صرف اپنے تصدیق شدہ نمبر پر بھیجیں۔ مثالوں اور پرامپٹس میں فرضی نمبر استعمال کیے گئے ہیں۔

• ٹکن کو چیٹ سے باہر رکھیں

  ٹکن ایک سینڈ کریڈنشل ہے۔ اسے انوائرمنٹ ویری ایبل سے لوڈ کریں، پرامپٹ سے کبھی نہیں، اور اگر یہ لیک ہو جائے تو اسے منسوخ کر دیں۔

متعلقہ

سوالات