FAQ
Bulk SMS API प्रश्न और उत्तर
खातों, भेजने, कीमतों, डिलीवरी रिपोर्ट और API के बारे में 39 उत्तर, कोड में सीमाओं के विरुद्ध जाँचे गए। एंडपॉइंट और फ़ील्ड के लिए, API संदर्भ में विवरण है।
सेवा
BulkSMSAPI क्या है?
डेवलपर्स के लिए एक बल्क एसएमएस एपीआई: REST के माध्यम से 227 देशों में एक अनुरोध पर एक टेक्स्ट या 10,000 नंबरों तक का बैच भेजें, हर मैसेज को साइन्ड वेबहुक्स से ट्रैक करें, और प्रीपेड बैलेंस से प्रति मैसेज भुगतान करें। वेब कंसोल बिना कोड के पेस्ट की गई सूची या CSV से कैंपेन भेजता है।
बल्क एसएमएस एपीआई कौन उपयोग करता है?
प्रोडक्ट और इंजीनियरिंग टीमें जो अपने सिस्टम से टेक्स्ट भेजती हैं: लॉगिन और साइन-अप कोड, ऑर्डर और डिलीवरी अपडेट्स, अपॉइंटमेंट रिमाइंडर्स, पेमेंट अलर्ट्स, सर्विस नोटिसेज और मार्केटिंग कैंपेन। कोई भी जो HTTPS अनुरोध कर सकता है, इसका उपयोग कर सकता है।
मैं किन देशों में भेज सकता हूँ?
227 देश और क्षेत्र, जिनकी कीमतें प्राइसिंग पेज और देशों के पेजों पर सूचीबद्ध हैं। एक अनुरोध में देश मिलाए जा सकते हैं: हर नंबर की कीमत उस देश के अनुसार होती है जिससे वह संबंधित है।
क्या कोई मासिक शुल्क या अनुबंध है?
नहीं। आप प्रीपेड बैलेंस से प्रति मैसेज सेगमेंट भुगतान करते हैं, और कोई मासिक शुल्क, सेटअप शुल्क या न्यूनतम वॉल्यूम नहीं है। बैलेंस की कोई एक्सपायरी तिथि नहीं है।
क्या कोई निःशुल्क परीक्षण है?
अकाउंट शून्य बैलेंस से शुरू होते हैं और पहला टॉप-अप सब कुछ खोल देता है। पहला टॉप-अप 40% तक का बोनस जोड़ता है, इसलिए पहले मैसेज कम कीमत पर आते हैं। कीमतें सार्वजनिक हैं, और एस्टीमेट एंडपॉइंट और कंसोल भेजने से पहले सटीक लागत दिखाते हैं।
अकाउंट और API कीज़
मैं अकाउंट कैसे बनाऊँ?
Get API key खोलें। आपका ब्राउज़र acct_ से शुरू होने वाली एक अकाउंट की बनाता है; इसे कॉपी करें या टेक्स्ट फाइल के रूप में सेव करें, पुष्टि करें कि आपने इसे सेव कर लिया है, और अकाउंट तैयार है। अकाउंट की ही एकमात्र लॉगिन है: कोई ईमेल या पासवर्ड मैनेज करने की आवश्यकता नहीं है।
अगर मैं अपनी अकाउंट की खो दूँ तो क्या होगा?
हम इसका केवल कीड हैश स्टोर करते हैं, इसलिए हमारी सपोर्ट टीम सहित कोई भी इसे फिर से नहीं दिखा सकता। इसे पासवर्ड मैनेजर में रखें। जब तक आप लॉग इन हैं, कंसोल काम करता रहेगा, और आप इससे सपोर्ट से संपर्क कर सकते हैं।
मुझे API key कैसे मिलेगी?
कंसोल के API keys पेज पर, पहली टॉप-अप क्रेडिट होने के बाद। key का नाम दें, इसे बनाएं और एक बार कॉपी करें: यह bsa_live_ से शुरू होती है। एक अकाउंट में 10 एक्टिव keys हो सकती हैं, प्रत्येक का अपना नाम और rate limit काउंटर होता है।
क्या मैं प्रोडक्शन और स्टेजिंग के लिए अलग-अलग keys का उपयोग कर सकता हूँ?
हाँ। प्रत्येक ऐप या एनवायरनमेंट के लिए एक key बनाएं और उसे नाम दें। प्रत्येक key दिखाती है कि वह आखिरी बार कब उपयोग की गई थी, और एक को रद्द करने से बाकी काम करती रहेंगी।
मैं कितने अकाउंट बना सकता हूँ?
प्रति नेटवर्क एड्रेस 3 अकाउंट तक। ज्यादातर टीमों को एक अकाउंट और कई API keys की जरूरत होती है।
मैसेज भेजना
एक रिक्वेस्ट में कितने नंबर हो सकते हैं?
POST /v1/batches प्रति रिक्वेस्ट 10,000 नंबर तक लेता है, या तो सभी के लिए एक टेक्स्ट या प्रति नंबर पर्सनल टेक्स्ट। कंसोल प्रति कैंपेन 50,000 नंबर लेता है। बड़ी लिस्ट को कई रिक्वेस्ट में बांटा जाता है।
मैसेज कितनी तेजी से भेजे जाते हैं?
कतार हर दो सेकंड में चलती है और प्रति अकाउंट प्रति मिनट 1,200 मैसेज तक नेटवर्क को भेजती है, जिस क्रम में वे स्वीकार किए गए थे। एकल मैसेज आमतौर पर रिक्वेस्ट के कुछ सेकंड के भीतर भेज दिया जाता है।
फोन नंबर किस फॉर्मेट में होने चाहिए?
अंतरराष्ट्रीय E.164: एक प्लस साइन, कॉलिंग कोड और नेशनल नंबर, जैसे +14155550123। स्पेस, डैश, ब्रैकेट और 00 प्रीफिक्स स्वचालित रूप से हटा दिए जाते हैं; डुप्लीकेट और पढ़े न जा सकने वाले नंबर अलग रख दिए जाते हैं और चार्ज नहीं किए जाते।
एक मैसेज कितना लंबा हो सकता है?
10 सेगमेंट तक: GSM-7 में 1,530 वर्ण या Unicode में 670। एक सेगमेंट में 160 GSM-7 या 70 Unicode वर्ण होते हैं; लंबे टेक्स्ट 153 या 67 वर्ण के हिस्सों में बंट जाते हैं और फोन पर फिर जुड़ जाते हैं।
मेरे मैसेज ने मेरी अपेक्षा से अधिक सेगमेंट क्यों लिए?
GSM-7 वर्णमाला से बाहर का एक वर्ण, जैसे कर्वी कोट, इमोजी या á, ç जैसा अक्षर, पूरे टेक्स्ट को Unicode में बदल देता है जहां प्रति सेगमेंट 70 वर्ण होते हैं। कंसोल कंपोजर उन वर्णों को दिखाता है, और POST /v1/estimates भेजने से पहले एन्कोडिंग बताता है।
क्या मैं मैसेज शेड्यूल कर सकता हूँ?
हाँ। API रिक्वेस्ट में send_at जोड़ें, या कंसोल में 2 मिनट से 45 दिन आगे का समय चुनें। एक शेड्यूल्ड बैच शुरू होने तक कैंसल किया जा सकता है, और उसकी पूरी लागत बैलेंस में वापस आ जाती है।
क्या प्रत्येक प्राप्तकर्ता को अलग टेक्स्ट मिल सकता है?
हाँ। API के जरिए, messages के साथ एक बैच भेजें, प्रति प्राप्तकर्ता एक {to, text}। कंसोल में, एक्स्ट्रा कॉलम वाली लिस्ट पेस्ट या अपलोड करें और टेक्स्ट में मर्ज फील्ड्स {{1}} से {{9}} का उपयोग करें।
क्या मेरे मैसेज में ऑप्ट-आउट लाइन जोड़ी जाती है?
सेटिंग्स में एक बार अपना ऑप्ट-आउट वर्डिंग सेट करें, जैसे लिंक या ईमेल पता, और कंसोल बॉक्स टिक करने पर इसे कैंपेन टेक्स्ट में जोड़ देगा। API के जरिए आप पूरा टेक्स्ट कंट्रोल करते हैं, इसलिए मार्केटिंग मैसेज में लाइन खुद जोड़ें। do-not-send लिस्ट के नंबर कंसोल और API द्वारा छोड़ दिए जाते हैं, और चार्ज नहीं किए जाते।
क्या मैं पहले एक टेस्ट मैसेज भेज सकता हूँ?
हाँ। कंसोल में कैंपेन से पहले एक नंबर पर टेस्ट भेजने का विकल्प है, और API के जरिए आप POST /v1/messages से अपने फोन पर एक मैसेज भेज सकते हैं।
कीमतें और भुगतान
एक SMS की कीमत कितनी है?
यह नंबर के देश पर निर्भर करता है: प्रत्येक देश की प्रति सेगमेंट कीमत अमेरिकी डॉलर में है, $0.00247 (ब्राज़ील) से शुरू। प्राइसिंग पेज और GET /v1/pricing हर देश की सूची देते हैं।
बैच की लागत कैसे निकाली जाती है?
प्रत्येक प्राप्तकर्ता के लिए: उसके देश की प्रति सेगमेंट कीमत को उसके टेक्स्ट के सेगमेंट से गुणा किया जाता है। योग रिक्वेस्ट स्वीकार होने पर बैलेंस से लिया जाता है, और जवाब में इसे cost में दिखाया जाता है।
न्यूनतम टॉप-अप क्या है?
$40. टॉप-अप $40 से $5,000 तक की कोई भी राशि हो सकती है। पहले टॉप-अप पर अधिकतम 40% का बोनस मिलता है, जो भुगतान करने से पहले प्रत्येक राशि पर दिखाया जाता है।
मैं भुगतान कैसे करूं?
कंसोल में, बिलिंग पेज पर एक होस्टेड चेकआउट विंडो खोलती है। आप राशि चुनते हैं और क्रिप्टोकरेंसी में भुगतान करते हैं, और भुगतान पृष्ठ सटीक राशि और पता दिखाता है। भुगतान पृष्ठ प्रत्येक चरण को सूचीबद्ध करता है।
क्या विफल संदेशों की धनवापसी की जाती है?
हां। जब कोई संदेश विफल होता है, तो उसकी कीमत स्वचालित रूप से उसी पास में बैलेंस में वापस आ जाती है, जैसा कि लेजर में रिफंड लाइन होती है। एक रद्द किए गए शेड्यूल्ड बैच की पूरी राशि वापस कर दी जाती है।
क्या मैं अपना बैलेंस निकाल सकता हूं?
बैलेंस संदेशों के लिए भुगतान करता है और आपके खाते में कोई समाप्ति तिथि के बिना रहता है। विफल या रद्द किए गए संदेशों की धनवापसी भी बैलेंस में वापस चली जाती है।
क्या कीमतें बदलती हैं?
नेटवर्क लागत बदलने पर कीमतें बदल सकती हैं। वर्तमान सूची दिनांकित है, API प्रत्येक कीमत के साथ तिथि लौटाता है, और पहले से स्वीकृत संदेश उस कीमत को बनाए रखते हैं जिस पर उन्हें चार्ज किया गया था।
डिलीवरी और रिपोर्ट
मैं कैसे जानूं कि संदेश डिलीवर हो गया है?
प्रत्येक संदेश कतारबद्ध से भेजे गए और फिर डिलीवर या विफल होने तक चलता है। प्रत्येक अंतिम स्थिति के लिए एक साइन किया गया इवेंट प्राप्त करने के लिए कंसोल में एक webhook URL जोड़ें, या GET /v1/messages/{id} और GET /v1/batches/{id} पढ़ें।
Webhooks कैसे साइन किए जाते हैं?
Standard Webhooks प्रारूप में: हेडर webhook-id, webhook-timestamp और webhook-signature, जहां सिग्नेचर आपके whsec_ सीक्रेट के साथ id, टाइमस्टैम्प और रॉ बॉडी का HMAC-SHA256 है। डॉक्स में Node.js, Python, PHP और Go के लिए वेरिफिकेशन कोड है।
अगर मेरा webhook एंडपॉइंट डाउन हो तो क्या होगा?
प्रत्येक इवेंट को लगभग 24 घंटे में 10 प्रयास मिलते हैं, और प्रत्येक प्रयास कंसोल में उसके HTTP स्थिति के साथ सूचीबद्ध होता है। आप किसी भी समय संदेश एंडपॉइंट्स को पोल भी कर सकते हैं।
संदेश क्यों विफल होगा?
हैंडसेट बहुत लंबे समय तक बंद हो सकता है, नंबर अब सेवा में नहीं हो सकता है, या नेटवर्क संदेश को अस्वीकार कर सकता है। विफल स्थिति में एक त्रुटि कोड होता है, और कीमत वापस कर दी जाती है।
संदेश रिकॉर्ड कितने समय तक रखे जाते हैं?
बैच, संदेश और बैलेंस लेजर आपके खाते और API में रहते हैं। अनुरोध लॉग आपके अंतिम 500 API कॉल और webhook लॉग आपके अंतिम 500 डिलीवरी को रखता है।
डेवलपर्स के लिए
क्या कोई SDK है?
API HTTPS पर सादा JSON है, इसलिए किसी भी भाषा की स्टैंडर्ड लाइब्रेरी पर्याप्त है। डॉक्स में curl, Node.js, Python, PHP और Go में पूर्ण नमूने हैं, और /openapi.json पर OpenAPI स्पेक अधिकांश भाषाओं में एक टाइप किया गया क्लाइंट उत्पन्न करता है।
रेट लिमिट क्या हैं?
प्रति API कुंजी प्रति मिनट 600 अनुरोध। प्रत्येक उत्तर में X-RateLimit-Limit, X-RateLimit-Remaining और X-RateLimit-Reset हेडर होते हैं, और 429 उत्तर में Retry-After होता है।
टाइमआउट के बाद मैं सुरक्षित रूप से पुनः प्रयास कैसे करूं?
POST अनुरोध Idempotency-Key हेडर के साथ भेजें और उसी कुंजी के साथ पुनः प्रयास करें। 24 घंटे के लिए समान कुंजी और बॉडी फिर से भेजने के बजाय पहला उत्तर लौटाती है।
क्या मैं API कुंजी के बिना कीमतें जांच सकता हूं?
हां। GET /v1/pricing और GET /v1/pricing/{country} सार्वजनिक हैं, इसलिए चेकआउट पृष्ठ या डैशबोर्ड लाइव कीमतें दिखा सकता है।
मैं अपने कोड द्वारा भेजे गए संदेश कहाँ देख सकता हूँ?
कंसोल में आपके अंतिम 500 API कॉल की विधि, पथ, स्थिति और समय का एक अनुरोध लॉग होता है, जो बैच, संदेश और वेबहुक लॉग के बगल में होता है।
कंसोल
क्या मैं कोड लिखे बिना संदेश भेज सकता हूँ?
हाँ। कंसोल में, नंबर पेस्ट करें या 50,000 पंक्तियों तक की CSV फ़ाइल अपलोड करें, मर्ज फ़ील्ड के साथ टेक्स्ट लिखें, प्रत्येक प्राप्तकर्ता के लिए पूर्वावलोकन और प्रति देश की लागत की जाँच करें, और अभी या निर्धारित समय पर भेजें।
कंसोल क्या दिखाता है?
बैलेंस, लाइव काउंट के साथ हाल के बैच, प्रत्येक बैच के साथ उसके संदेश और स्थितियाँ, टॉप-अप और लेजर, API कुंजी, वेबहुक सेटिंग्स और डिलीवरी, अनुरोध लॉग, मूल्य सूची, सपोर्ट टिकट और सेटिंग्स।
मैं सपोर्ट से कैसे संपर्क करूँ?
कंसोल के सपोर्ट पेज से। भुगतान संबंधी प्रश्न पहले दिन से पूछे जा सकते हैं; अन्य विषय पहले टॉप-अप के क्रेडिट होने के बाद खुलते हैं।
अभी भी कोई प्रश्न है?
साइन इन किए गए खाते कंसोल से सपोर्ट टिकट खोल सकते हैं। भुगतान संबंधी प्रश्न पहले दिन से पूछे जा सकते हैं।