AI एजेंट्स के लिए मैसेजिंग और वॉइस

प्रवेश का तरीका चुनें

एजेंट्स को आमतौर पर दो चीज़ों की आवश्यकता होती है: योजना बनाने के लिए तथ्य, और कार्य करने का एक तरीका। BroadNet उन्हें अलग रखता है। नॉलेज सर्वर बिना अकाउंट के सवालों के जवाब देता है; भेजने के लिए हमेशा आपके टोकन की आवश्यकता होती है।

नॉलेज MCP सर्वर

इसी वेबसाइट के डेटा से प्राप्त सार्वजनिक, रीड-ओनली (read-only) जवाब: कवरेज, सेंडर ID नियम, सांकेतिक लिस्ट कीमतें, कंप्लायंस, सेगमेंट काउंट, जवाब, केस स्टडीज, चेंजलॉग और स्टेटस।

ऑथेंटिकेशन:: कोई नहीं
एक्सेस:: केवल पढ़ने के लिए · 13 टूल्स, प्रति IP प्रति मिनट 60 रिक्वेस्ट
इनके लिए सबसे अच्छा:: प्लानिंग, रिसर्च और प्री-सेल्स सवालों के लिए, किसी भी अकाउंट के बनने से पहले।

मैसेजिंग MCP सर्वर

BroadNet मैसेजिंग API जिसे MCP टूल्स के रूप में पेश किया गया है। एजेंट आपके द्वारा दिए गए टोकन की अनुमतियों के साथ मैसेज भेजता है और उन्हें ट्रैक करता है।

ऑथेंटिकेशन:: Bearer <token>
एक्सेस:: आपके अकाउंट पर कार्य करता है
इनके लिए सबसे अच्छा:: असिस्टेंट और एजेंट जो उपयोगकर्ता के अनुरोध पर मैसेज भेजते हैं, जिसमें एक व्यक्ति प्रत्येक मैसेज भेजने की पुष्टि करता है।

REST API

Bearer-token REST, प्रत्येक चैनल के लिए एक पाथ फैमिली, जिसका वर्णन OpenAPI 3.1 spec द्वारा किया गया है। आपका एजेंट निर्णय लेता है; आपका कोड कॉल करता है।

ऑथेंटिकेशन:: Bearer <token>
एक्सेस:: आपका कोड API को कॉल करता है · OpenAPI 3.1
इनके लिए सबसे अच्छा:: प्रोडक्शन एजेंट जहाँ आपका बैकएंड रिट्राइज़, लॉगिंग और लिमिट्स को संभालता है।

TypeScript SDK

OpenAPI spec से जनरेट किया गया एकमात्र आधिकारिक SDK, @broadnet/cpaas-sdk। अन्य भाषाएँ REST API को कॉल करती हैं या क्लाइंट जनरेट करती हैं।

ऑथेंटिकेशन:: Bearer <token>
एक्सेस:: आपका कोड API को कॉल करता है · TypeScript / Node.js
इनके लिए सबसे अच्छा:: पूर्ण प्रकारों के साथ Node.js एजेंट फ्रेमवर्क और टूल डेफिनिशन।

एक एजेंट क्या भेज सकता है

वही नियम लागू होते हैं चाहे एजेंट किसी भी माध्यम का उपयोग करे: एक रजिस्टर्ड सेंडर, एक सहमति प्राप्त प्राप्तकर्ता और ऐसा कंटेंट जो चैनल के अनुकूल हो।

SMS

प्रत्येक रिक्वेस्ट पर एक मैसेज, या फ़ाइल से एक बल्क जॉब। बिलिंग प्रति सेगमेंट होती है, इसलिए लंबे या नॉन-लैटिन टेक्स्ट की लागत अधिक होती है: पहले उन्हें गिन लें।

REST API: POST /sms/sendSms (JSON) POST /sms/sendbulk (मल्टीपार्ट)
मैसेजिंग MCP: SMS भेजने के टूल्स, उदाहरण के लिए post_sms_send

24-घंटे की सर्विस विंडो के भीतर फ्री-फॉर्म मैसेज; विंडो के बाहर, केवल स्वीकृत टेम्पलेट्स। टेम्पलेट्स की सूची दी गई है और उन्हें नाम से भेजा जाता है।

REST API: POST /whatsapp/message/sendbulk (मल्टीपार्ट)
मैसेजिंग MCP: post_whatsapp_message_sendget_whatsapp_template_listpost_whatsapp_template_send

OTP

आपका सिस्टम कोड जेनरेट करता है; एजेंट इसे SMS या WhatsApp ऑथेंटिकेशन टेम्पलेट में भेजता है। पब्लिक API में कोई अलग वेरिफाई एंडपॉइंट नहीं है, इसलिए कोड की जांच आपके सिस्टम में ही रहती है।

REST API: मैसेज में कोड के साथ POST /sms/sendSms
मैसेजिंग MCP: वही SMS और WhatsApp टेम्पलेट टूल्स

वॉइस

वॉइस OTP, टेक्स्ट-टू-स्पीच कॉलआउट और IVR आपकी अकाउंट टीम के माध्यम से प्रोविज़न किए जाते हैं। पब्लिक OpenAPI स्पेसिफिकेशन और MCP टूल्स मैसेजिंग चैनलों को कवर करते हैं, वॉइस कॉल को नहीं। AI-संचालित आउटबाउंड कॉलिंग के लिए, DialerBee देखें।

REST API: प्रत्येक अकाउंट के लिए प्रोविज़न किया गया
मैसेजिंग MCP: कोई वॉइस टूल नहीं

एक व्यावहारिक उदाहरण: एक एजेंट OTP लॉन्च की योजना बनाता है

एक यूजर एजेंट से UAE के लिए वन-टाइम पासवर्ड प्लान करने के लिए कहता है। एजेंट पब्लिक नॉलेज सर्वर पर चार टूल्स को कॉल करता है। नीचे दिए गए परिणाम सर्वर का वास्तविक आउटपुट हैं, जिन्हें एजेंट द्वारा उपयोग किए जाने वाले फ़ील्ड्स तक सीमित किया गया है।

यूज़र

हम UAE में ग्राहकों को महीने में लगभग 50,000 लॉगिन कोड भेजना चाहते हैं। हमें क्या चाहिए, और इसकी कीमत क्या होगी?

टूल कॉलcheck_coverageक्या UAE कवर है, किन ऑपरेटर्स पर?

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

टूल कॉलsender_id_rulesवहाँ सेंडर ID के लिए किन आवश्यकताओं की ज़रूरत है?

→{"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
टूल कॉलcount_sms_segmentsमैसेज में कितने सेगमेंट हैं?
→{"text":"Your MyShop code is 482913. It expires in 5 minutes. Never share it."}
परिणाम (ट्रिम किया हुआ)
```
{
  "encoding": "GSM-7",
  "units": 68,
  "segments": 1
}
```

टूल कॉल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."
}

एजेंट

UAE में ऑपरेटरों से सीधे कनेक्शन (Etisalat / e& · du) के माध्यम से कवरेज उपलब्ध है। आपकी सेंडर ID के लिए TDRA के साथ प्री-रजिस्ट्रेशन की आवश्यकता है, जिसमें आमतौर पर 5–7 कार्य दिवस लगते हैं। आपका कोड मैसेज 1 SMS सेगमेंट है। $0.0123 प्रति सेगमेंट की सांकेतिक लिस्ट दर पर, टैक्स और सेंडर ID शुल्क को छोड़कर, 50,000 कोड का खर्च प्रति माह लगभग $615 आता है। यह कोई कोटेशन नहीं है।

अगला कदम: 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}"
      }
    }
  }
}

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 मैसेज ID लौटाता है। API में कोई इडेम्पोटेंसी हेडर नहीं है: नेटवर्क एरर या 5xx के बाद, दोबारा भेजने से पहले अपनी ID के माध्यम से मैसेज स्टेटस की जाँच करें।

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-घंटे की सर्विस विंडो के बाहर काम करते हैं; फ्री-फॉर्म टेक्स्ट के लिए ओपन विंडो की आवश्यकता होती है।

मशीन-रीडेबल एंट्री पॉइंट्स

कनेक्ट करने के बजाय ब्राउज़ करने वाले एजेंट प्लेन फाइलों से सब कुछ पढ़ सकते हैं। उनमें से किसी को भी लॉगिन की आवश्यकता नहीं है।

नियम जिनका एक एजेंट को पालन करना चाहिए

एक एजेंट जो मैसेज भेजता है, वह आपके क्रेडेंशियल्स के साथ आपके ब्रांड की ओर से कार्य करता है। इन नियमों को उसके निर्देशों और उसके टूल्स में शामिल करें।

कंटेंट से पहले सहमति
मार्केटिंग केवल उन्हीं प्राप्तकर्ताओं को भेजें जिन्होंने ऑप्ट-इन किया है, और ऑप्ट-इन का रिकॉर्ड रखें। sender_id_rules टूल प्रत्येक मार्केट के ऑप्ट-इन नियम लौटाता है।
ऑप्ट-आउट का सम्मान करें
प्रमोशनल मैसेज में मार्केट का ऑप्ट-आउट कीवर्ड होता है, जैसे कि STOP। एक एजेंट कभी भी उस नंबर पर मैसेज नहीं भेजता जिसने ऑप्ट-आउट किया हो।
केवल रजिस्टर्ड सेंडर ID
कई मार्केट्स में अल्फ़ान्यूमेरिक सेंडर ID का प्री-रजिस्ट्रेशन आवश्यक है। एजेंट आपके अकाउंट पर स्वीकृत सेंडर ID का उपयोग करता है, कभी भी किसी मनगढ़ंत ID का नहीं।
शांत घंटों का सम्मान करें
कई मार्केट्स में रात के समय मार्केटिंग पर रोक होती है। sender_id_rules सोर्स किए गए शांत घंटों (quiet hours) की जानकारी देता है; OTP और अलर्ट आमतौर पर चौबीसों घंटे मान्य होते हैं।
पंपिंग के खिलाफ OTP फ्लो की सुरक्षा करें
बॉट्स उन नंबरों पर OTP भेज सकते हैं जिनसे उन्हें लाभ होता है। प्रति नंबर, IP और डिवाइस के लिए कोड रिक्वेस्ट पर रेट-लिमिट लगाएं, और उन डेस्टिनेशन को ब्लॉक करें जिन्हें आप सर्विस नहीं देते हैं। MyOTP डिफ़ॉल्ट रूप से इन सुरक्षाओं को लागू करता है।
एक व्यक्ति हर मैसेज भेजने की पुष्टि करता है
किसी भी ऐसे टूल का उपयोग करने से पहले क्लाइंट से पूछें जो मैसेज भेजता है, विशेष रूप से कई प्राप्तकर्ताओं को, और केवल उन्हीं टूल्स को सक्षम करें जिनकी एजेंट को आवश्यकता है।
अपने नंबर पर टेस्ट करें
टेस्ट क्रेडेंशियल्स के साथ, केवल अपने स्वयं के वेरिफ़ाइड नंबर पर भेजें। उदाहरणों और प्रॉम्प्ट्स में काल्पनिक नंबरों का उपयोग किया गया है।
टोकन को चैट से बाहर रखें
टोकन एक सेंड क्रेडेंशियल है। इसे एनवायरनमेंट वेरिएबल से लोड करें, प्रॉम्प्ट से कभी नहीं, और यदि यह लीक हो जाए तो इसे तुरंत रद्द कर दें।

प्रश्न

क्या एक AI एजेंट BroadNet के माध्यम से SMS और WhatsApp मैसेज भेज सकता है?

हाँ। अपने BroadNet टोकन के साथ इसे https://mcp.broadnet.me/mcp पर मैसेजिंग MCP सर्वर से कनेक्ट करें, या अपने कोड से https://api.broadnet.me पर REST API को कॉल कराएँ। दोनों ही तरीकों में एजेंट आपके टोकन की अनुमतियों के साथ काम करता है, इसलिए हर मैसेज भेजने से पहले किसी व्यक्ति की पुष्टि अनिवार्य रखें।

क्या कवरेज या कीमतों के बारे में पूछने के लिए किसी एजेंट को अकाउंट की आवश्यकता है?

नहीं। https://www.broadnet.me/mcp पर MCP नॉलेज सर्वर पब्लिक और केवल पढ़ने के लिए (read-only) है। यह वेबसाइट के समान ही डेटा से कवरेज, सेंडर ID नियम, सांकेतिक लिस्ट कीमतें और नियम प्रदान करता है। कीमतें सांकेतिक लिस्ट दरें हैं, कोटेशन नहीं।

एक एजेंट वन-टाइम पासवर्ड कैसे भेजता है?

आपका सिस्टम कोड जनरेट करता है और एजेंट इसे POST /sms/sendSms के साथ SMS में, या WhatsApp ऑथेंटिकेशन टेम्पलेट में भेजता है। पब्लिक API में कोई अलग वेरीफाई एंडपॉइंट नहीं है, इसलिए कोड की जांच आपके सिस्टम में ही रहती है।

क्या एक एजेंट वॉइस कॉल कर सकता है?

वॉइस OTP, टेक्स्ट-टू-स्पीच कॉलआउट और IVR आपकी BroadNet अकाउंट टीम के माध्यम से प्रदान किए जाते हैं। वे पब्लिक OpenAPI spec या MCP टूल्स में नहीं हैं। DialerBee कॉन्टैक्ट सेंटर्स के लिए BroadNet का AI आउटबाउंड डायलर है।

मैं टोकन कैसे प्राप्त करूँ?

/signup पर टेस्ट एक्सेस का अनुरोध करें। BroadNet एक कार्य दिवस के भीतर टेस्ट क्रेडेंशियल्स के साथ जवाब देता है। कोई इंस्टेंट सेल्फ-सर्व की (key) उपलब्ध नहीं है।

अपने एजेंट को BroadNet से कनेक्ट करें

आज ही पब्लिक नॉलेज सर्वर के साथ शुरुआत करें। जब आपका एजेंट भेजने के लिए तैयार हो जाए, तो टेस्ट एक्सेस का अनुरोध करें।

टेस्ट एक्सेस का अनुरोध करें (अंग्रेज़ी फ़ॉर्म)MCP सर्वर गाइड

AI एजेंटों के लिए मैसेजिंग और वॉइस।

प्रवेश का तरीका चुनें

एक एजेंट क्या भेज सकता है

एक व्यावहारिक उदाहरण: एक एजेंट OTP लॉन्च की योजना बनाता है

कॉपी और पेस्ट

मशीन-रीडेबल एंट्री पॉइंट्स

नियम जिनका एक एजेंट को पालन करना चाहिए

संबंधित

प्रश्न

क्या एक AI एजेंट BroadNet के माध्यम से SMS और WhatsApp मैसेज भेज सकता है?

क्या कवरेज या कीमतों के बारे में पूछने के लिए किसी एजेंट को अकाउंट की आवश्यकता है?

एक एजेंट वन-टाइम पासवर्ड कैसे भेजता है?

क्या एक एजेंट वॉइस कॉल कर सकता है?

मैं टोकन कैसे प्राप्त करूँ?

अपने एजेंट को BroadNet से कनेक्ट करें