संदेश ब्रांड पंजीकृत करें

अपने संदेशों के पीछे का व्यवसाय पंजीकृत करें

संदेश ब्रांड US 10DLC संदेश भेजने वाले व्यवसाय की पहचान करता है। अभियान उपयोग मामला चुनने से पहले ब्रांड पंजीकृत करें। व्यवसाय के कानूनी विवरण और ऐसे संपर्क का उपयोग करें जो आवश्यक सत्यापन पूरा कर सके। लौटाई गई ब्रांड आईडी अपने आप में संदेश भेजने की अनुमति नहीं है।

इस वर्तमान खाता-स्वामित्व वाले रूट का उपयोग HTTPS पर सक्षम API खाते और उसके अनुमत स्रोत IP पते के साथ करें। user_id, username या किसी अन्य ग्राहक का स्वामी पहचानकर्ता सबमिट न करें। MultiTEL प्रमाणीकृत खाते से स्वामित्व दर्ज करता है।

स्पष्ट सैंडबॉक्स अनुरोध से प्रारंभ करें

पोर्टल अपने फ़ॉर्म के mode फ़ील्ड को डिफ़ॉल्ट रूप से सैंडबॉक्स पर सेट करता है; मॉक ब्रांड हेतु सीधे API अनुरोध में JSON बूलियन mock: true स्पष्ट रूप से शामिल करना आवश्यक है। उस फ़्लैग को छोड़ना सैंडबॉक्स की गारंटी नहीं है और इससे बिल योग्य प्रोडक्शन पंजीकरण बन सकता है। पोर्टल का mode फ़ील्ड API के mock फ़ील्ड का विकल्प नहीं है।

नीचे दिए गए फ़ील्ड का उपयोग करके स्थानीय brand.json फ़ाइल तैयार करें। प्लेसहोल्डर को उपयुक्त परीक्षण विवरण और वर्तमान कैटलॉग कोड से बदलें। यह उदाहरण निजी-लाभ व्यवसाय का है; अन्य इकाई प्रकारों की आवश्यकताएँ भिन्न हैं।

{
  "entityType": "PRIVATE_PROFIT",
  "displayName": "Example business",
  "companyName": "Example legal business name",
  "ein": "YOUR_TAX_ID",
  "einIssuingCountry": "US",
  "phone": "+12025550123",
  "street": "123 Example Street",
  "city": "Example City",
  "state": "NY",
  "postalCode": "10001",
  "country": "US",
  "email": "contact@example.invalid",
  "brandRelationship": "BASIC_ACCOUNT",
  "vertical": "CURRENT_VERTICAL_CODE",
  "referenceId": "your-business-reference",
  "mock": true
}

ऊपर दिए गए व्यवसाय, पता, फ़ोन और पहचानकर्ता प्लेसहोल्डर हैं, पंजीकरण-योग्य व्यावसायिक पहचान नहीं। entityType, vertical, country, state, brandRelationship और अन्य एन्यूमरेशन के वर्तमान मानों के लिए देखें संदेश कैटलॉग.

curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
  --header 'Content-Type: application/json' \
  --header "Idempotency-Key: $IDEMPOTENCY_KEY" \
  --data-binary @brand.json \
  'https://api.multitel.net/tcr/v2/brand/nonBlocking'

व्यवसाय और संपर्क फ़ील्ड

एकल स्वामी US या कनाडाई पंजीकरणों के लिए समर्थित हैं और अभियान पात्रता से पहले OTP सत्यापन आवश्यक है। शेयर बाज़ार में सूचीबद्ध कंपनियों के लिए व्यावसायिक-संपर्क सत्यापन चरण आवश्यक हो सकता है। GOVERNMENT US-स्थित सरकारी इकाइयों के लिए है; अन्य संगठनों के लिए सही इकाई श्रेणी की पुष्टि करें। इकाई-विशिष्ट आवश्यकताओं के साथ-साथ लौटाई गई सत्यापन त्रुटियों का भी पालन करें।

स्थिर इडम्पोटेंसी कुंजी रखें

इस इच्छित पंजीकरण के लिए एक Idempotency-Key जनरेट करें। इसमें बिना रिक्त स्थान के 1–128 मुद्रण योग्य ASCII वर्ण होने चाहिए। समान कुंजी का पुनः उपयोग केवल समान HTTP विधि, पथ, क्वेरी स्ट्रिंग और अनुरोध-बॉडी के बिल्कुल उन्हीं बाइट्स के साथ करें। JSON को पुनः स्वरूपित करना, अर्थ बदले बिना भी, अनुरोध फ़िंगरप्रिंट बदल देता है।

कुंजी सहित पूर्ण हो चुका अनुरोध बिना अन्य पंजीकरण सबमिशन के अपना संग्रहीत प्रत्युत्तर पुनः चला सकता है। अभी संसाधित हो रहा डुप्लिकेट HTTP 409 लौटाता है और इसमें Retry-After शामिल हो सकता है। समान कुंजी के साथ बदला गया अनुरोध विरोध करता है। केवल इसलिए नई कुंजी जनरेट न करें कि अनुरोध समयबाह्य हुआ या त्रुटि लौटी: व्यवसाय पहले ही पंजीकृत हो चुका हो सकता है।

उस अनुरोध का समाधान करते समय brand.json अपरिवर्तित रखें। कैश की गई 500 या 502 त्रुटि पंजीकरण पुनः प्रयास के बजाय मूल त्रुटि पुनः चला सकती है। लौटाए गए brandId, requestId और सहसंबंध हेडर सुरक्षित रखें; भिन्न अनुरोध प्रारंभ करने से पहले मौजूदा ब्रांड की वास्तविक स्थिति जाँचें और किसी भी विसंगति का समाधान करें।

ब्रांड और उसकी स्थिति पढ़ें

यह API v3 status/response लिफ़ाफ़े के बजाय HTTP स्थिति कोड और सीधे JSON बॉडी का उपयोग करता है। सफल पंजीकरण brandId सहित ब्रांड ऑब्जेक्ट लौटाता है। उस पहचानकर्ता को संग्रहीत करें और लौटाई गई सत्यापन या पहचान स्थिति की जाँच करें। अतिरिक्त फ़ील्ड इकाई और पंजीकरण स्थिति पर निर्भर करते हैं।

curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
  "https://api.multitel.net/tcr/v2/brand/$BRAND_ID"

केवल अपने खाते का ब्रांड पढ़ें। 404 का अर्थ हो सकता है कि ब्रांड इस खाते के लिए उपलब्ध नहीं है। आवश्यक सत्यापन पूरा करें, फिर ब्रांड योग्यता के माध्यम से इसके उपलब्ध अभियान उपयोग मामले खोजें। मॉक संसाधनों को प्रोडक्शन भेजने हेतु योग्य न मानें।

प्रोडक्शन शुल्क

ये खुदरा राशियाँ 24 अक्टूबर 2026 को वर्तमान पोर्टल कॉन्फ़िगरेशन से मिलान करके जाँची गई थीं। प्रोडक्शन पंजीकरण से पहले पोर्टल में वर्तमान शुल्क की पुष्टि करें। अभियान शुल्क, अतिरिक्त जाँच और संदेश उपयोग अलग हैं। प्रोडक्शन पंजीकरण सबमिशन से पहले क्रय अनुमति और उपलब्ध निधि जाँचता है; सफल रजिस्ट्री निर्माण और स्थानीय बिलिंग अलग प्रसंस्करण चरण हैं, इसलिए संसाधन ID सुरक्षित रखें और त्रुटि या बिलिंग समस्या होने पर लेनदेन का मिलान करें।

मॉक ब्रांड को प्रोडक्शन में बदलना अलग से पुष्ट वर्कफ़्लो है और इससे नई प्रोडक्शन पहचान और शुल्क बन सकता है। यह न मानें कि बाद के अनुरोध पर mock को false में संपादित करने से मौजूदा ब्रांड परिवर्तित हो जाता है।

ब्रांड को डुप्लिकेट किए बिना त्रुटियाँ सँभालें