Sign inGet started

Bird Connectivity Platform से SMS माइग्रेट करें

यह पेज rest.messagebird.com पर उपलब्ध Bird Connectivity Platform API को Bird पर मैप करता है, जिसे आप अभी भी MessageBird API के नाम से जानते होंगे। मुख्य माइग्रेशन गाइड को क्रम में फ़ॉलो करें और इन मैपिंग्स को स्टेप 3, 4 और 5 के लिए उपयोग करें।
दोनों प्लेटफ़ॉर्म Bird के हैं, और API वह हिस्सा है जो बदलता है। तीन अंतर हर कॉल को प्रभावित करते हैं। रिक्वेस्ट एक ग्लोबल होस्ट के बजाय आपके रीजनल होस्ट https://us1.platform.bird.com या https://eu1.platform.bird.com पर जाती हैं। ऑथेंटिकेशन Authorization: AccessKey के बजाय एक bearer API key (Authorization: Bearer bk_us1_…) है। और सेंड एसिंक्रोनस है: POST /v1/sms/messages मैसेज को क्यू में रखकर 202 Accepted रिटर्न करता है, जबकि Connectivity Platform मैसेज ऑब्जेक्ट के साथ प्रति-प्राप्तकर्ता स्टेटस पहले से अटैच करके रिटर्न करता था।

इसे अपने एजेंट को दें

इस ब्रीफ़ को अपने कोडिंग एजेंट में उपयोग करें। यह डिस्कवरी से शुरू होता है और किसी भी प्रोडक्शन बदलाव से पहले एक रिव्यू करने योग्य माइग्रेशन प्लान तैयार करता है।
कोड उदाहरण
Help me migrate my SMS integration from Bird Connectivity Platform to Bird.
1. Inspect this repository's sends, senders, callbacks, schedules, templates, opt-outs and tests. List the traffic and behavior that must survive the migration.
2. Read the Markdown guides at https://bird.com/docs/guides/sms/migrate/connectivity-platform.md and https://bird.com/docs/guides/sms/migrate.md. Use an existing authenticated Bird MCP or CLI connection. If neither is available, follow https://bird.com/docs/ai/set-up-your-agent.md. Discover the actual operations; do not invent commands or ask me to paste credentials into chat.
3. Prepare the code changes, sender/destination requirements, consent migration, webhook verification and rollout/rollback plan. Preserve the scope of each customer's preferences, including requests outside SMS replies. Separate API batches from audience broadcasts and preserve any behavior that has no direct endpoint equivalent.
4. Show me the exact affected resources, destinations, test volume and known costs before an action that sends messages, spends money, registers or changes a sender, or moves production traffic. Require explicit human authorization for each paid submission or production change. Name one-off 10DLC registration and resubmission fees before requesting approval. An existing explicit approval for that exact action is sufficient; broad migration approval is not. Simulated SMS destinations are billable and still require authorization.
5. If I am keeping Connectivity Platform numbers, prepare the human support port request and obtain authorization to send it. Read bird support-tickets create --help, then use the available CLI or MCP support operation with the reviewed number list and requirements. Return the ticket ID and follow the reply; support arranges the port on its own schedule, separately from the code cutover.
6. Run local and intercepted tests first. When authorized, perform the agreed bounded integration tests, inspect accepted and final outcomes separately, and report failures or uncertainty. Do not claim a delivery receipt proves reading or that request idempotency guarantees exactly-once delivery.
7. Keep production cutover and retiring the old provider as explicit steps in the approved rollout. Finish with the diff, evidence, unresolved requirements and the next action.

सेंड कॉल को मैप करें

क्या करता हैConnectivity PlatformBird
प्राप्तकर्ताrecipients (अधिकतम 50)to, प्रति रिक्वेस्ट एक
प्रेषकoriginatorfrom
बॉडीbodytext
इंटेंट(कोई नहीं)category, फ़्री टेक्स्ट पर आवश्यक
एन्कोडिंगdatacodingअपने-आप पहचाना जाता है
ट्रांसलिटरेशन(कोई नहीं)options.smart_encoding (डिफ़ॉल्ट false)
क्लाइंट रेफ़रेंसreferencemetadata, या tags जब आप इस पर फ़िल्टर करते हैं
स्टेटस रिपोर्टreportUrlनीचे दिए गए डिलीवरी इवेंट्स के लिए सब्सक्राइब्ड वर्कस्पेस webhook
सुरक्षित पुनः प्रयास(कोई नहीं)Idempotency-Key हेडर
शेड्यूलिंगscheduledDatetimeकोई समतुल्य नहीं: scheduled_at रिजेक्ट किया जाता है
वैलिडिटीvalidityकोई समतुल्य नहीं: validity_period रिजेक्ट किया जाता है
रूट सेलेक्शनgatewayBird रूट सेलेक्ट करता है
मैसेज क्लासmclassकोई समतुल्य नहीं
बाइनरी और फ़्लैशtype, typeDetailsकेवल टेक्स्ट
दोनों रिजेक्ट किए गए फ़ील्ड रिज़र्व्ड हैं और 422 SMSUnsupportedFeature का उत्तर देते हैं।
पोर्टिंग नोट्स:
  • recipients ऐरे प्रति प्राप्तकर्ता एक कॉल बन जाती है। 50 प्राप्तकर्ताओं वाली एक Connectivity Platform कॉल 50 सेंड्स बन जाती है, या स्वतंत्र मैसेजों का एक बैच। बैच एक बॉडी का fan-out नहीं है: प्रत्येक एंट्री अपना प्राप्तकर्ता, प्रेषक और टेक्स्ट ले जाती है।
  • datacoding का कोई समतुल्य नहीं है, और यह जानबूझकर है। Bird बॉडी से एन्कोडिंग पहचानता है और मैसेज पर सेगमेंट काउंट रिपोर्ट करता है। यदि आप मैसेज को GSM-7 के अंदर रखने के लिए datacoding: auto सेट करते हैं, तो सबसे करीबी व्यवहार options.smart_encoding है, जो Bird की डॉक्यूमेंटेड रिप्लेसमेंट टेबल लागू करता है। यह सामान्य ट्रांसलिटरेटर नहीं है; असमर्थित कैरेक्टर्स के लिए अभी भी Unicode एन्कोडिंग की आवश्यकता हो सकती है।
  • reference दो फ़ील्ड में विभाजित होता है। इंटरनल आइडेंटिफ़ायर metadata में रखें, जो हर webhook इवेंट पर echo होता है, और tags का उपयोग उन कम-कार्डिनैलिटी लेबल्स के लिए करें जिन पर आप फ़िल्टर और एनालिटिक्स स्लाइस करना चाहते हैं।
  • फ़्लैश मैसेज, बाइनरी पेलोड और UDH कॉन्कैटेनेशन पोर्ट नहीं होते। यदि आप आज mclass या typeDetails पर निर्भर हैं, तो कटओवर की योजना बनाने से पहले सपोर्ट से बात करें, बाद में नहीं।
  • Connectivity Platform Verify API पर भी हैं? यह पोर्ट अपनी अलग गाइड वाला एक अलग काम है: देखें किसी अन्य प्रोवाइडर से Verify माइग्रेट करें

Opt-outs ट्रांसफ़र करें

Connectivity Platform ने stop-keyword हैंडलिंग आप पर छोड़ी थी, चाहे आपने इसे Flows में बनाया हो या इनबाउंड मैसेज पर अपने एप्लिकेशन में। Bird यह काम खुद करता है: यह समर्थित देशों में आपके नंबरों पर stop, start और help कीवर्ड पहचानता है, सप्रेशन रिकॉर्ड करता है, और हर सेंड पर लागू करता है। पुराने हैंडलर को तभी रिटायर करें जब आप पुष्टि कर लें कि Bird का कैटलॉग उसके व्यवहार को कवर करता है और आपकी व्यापक प्रेफ़रेंस प्रक्रिया अभी भी काम करती है।
जो रिटायर नहीं होती वह सूची है। आज जो भी आप रखते हैं उसे एक्सपोर्ट करें, सब्सक्राइबर नंबर और जिस originator को उन्होंने रोका उसके जोड़ों के रूप में, और अपने पहले प्रोडक्शन सेंड से पहले इसे सप्रेशन लूप के ज़रिए इंपोर्ट करें। यदि आपने केवल opt-out करने वाले सब्सक्राइबर्स की एक ग्लोबल सूची रखी थी, तो प्रत्येक सब्सक्राइबर को उस हर originator के लिए एक बार इंपोर्ट करें जिससे आप अभी भी सेंड करते हैं।

स्टेटस रिपोर्ट्स का अनुवाद करें

इस टेबल का उपयोग लाइफ़साइकल कॉन्सेप्ट्स की तुलना के लिए करें, इवेंट्स का यांत्रिक रूप से नाम बदलने के लिए नहीं। Bird रिपोर्ट किए गए स्टेटस और कारण से एक फ़ेलियर इवेंट चुनता है। रिफ़्यूज़ की गई API रिक्वेस्ट कोई मैसेज नहीं बनाती; स्वीकृति के बाद रिजेक्शन sms.rejected उत्पन्न कर सकता है, जिसमें कैरियर रिजेक्शन भी शामिल है। डिलीवरी का साक्ष्य न मिलने पर स्थिति unknown रहती है। अपने normalized outcome के साथ raw प्रोवाइडर स्टेटस और कोड को भी संरक्षित रखें।
परिणामConnectivity PlatformBird
API द्वारा स्वीकृत(सिंक्रोनस)sms.accepted
कैरियर को सौंपा गयाsent, bufferedsms.sent
कैरियर ने डिलीवरी की पुष्टि कीdeliveredsms.delivered
डिलीवरी विफलdelivery_failedsms.failed
वैलिडिटी विंडो समाप्तexpiredsms.expired
एडमिशन पर रिक्वेस्ट रिफ़्यूज़रिक्वेस्ट एररHTTP एरर; कोई मैसेज या इवेंट नहीं
भेजे जाने की प्रतीक्षा मेंscheduledअभी कोई समतुल्य नहीं
डिलीवरी मैकेनिज़्म शब्दावली से अधिक बदलता है:
  • Signed JSON पोस्ट reportUrl GET कॉलबैक की जगह लेते हैं। स्टेटस रिपोर्ट GET रिक्वेस्ट के रूप में आती थीं जिनमें परिणाम क्वेरी स्ट्रिंग में होता था (status, statusReason, statusErrorCode, mccmnc, price[amount])। Bird आपके वर्कस्पेस द्वारा रजिस्टर किए गए endpoints पर एक JSON इवेंट POST करता है, जो Standard Webhooks के अनुसार signed होता है। हैंडलर एक URL बदलाव नहीं बल्कि एक रीराइट है।
  • कोरिलेशन अब reference पर निर्भर नहीं है। एक स्टेटस रिपोर्ट तभी उपयोगी थी जब आपने रेफ़रेंस सेट किया हो; एक Bird इवेंट हमेशा sms_id, दोनों नंबर, और आपके echoed metadata और tags ले जाता है।
  • फिर से प्रयास करने की सिमैंटिक्स अलग हैं। Connectivity Platform विफल रिपोर्ट को 10 बार तक फिर से प्रयास करता था। Bird की डिलीवरी at-least-once और अनॉर्डर्ड हैं, इसलिए webhook-id हेडर पर डीडुप्लिकेट करें और पेलोड timestamp के अनुसार सॉर्ट करें।
  • मैसेज और बिलिंग ओनर्स के ज़रिए लागत का मिलान करें। Connectivity Platform रिपोर्ट में price[amount] और price[currency] होता था। मैसेज की रिकॉर्ड की गई लागत GET /v1/sms/messages/{id} से पढ़ें और बिलिंग के साथ चार्जेज़ का मिलान करें। Stats API डिलीवरी मेट्रिक्स के लिए है, आधिकारिक बिलिंग टोटल नहीं।
इनबाउंड मैसेज उसी तरह काम करते हैं: हर नंबर को एक URL पर पॉइंट करने के बजाय वर्कस्पेस के लिए एक बार sms.received को सब्सक्राइब करें।

कटओवर करें

डेस्टिनेशन, सेंडर्स, और ट्रैफ़िक रैंप प्रोवाइडर-इंडिपेंडेंट हैं और मुख्य गाइड में शामिल हैं। जल्दी उठाने वाला मुद्दा आपके originators हैं: alphanumeric sender IDs फिर से बनाए जाते हैं और, जहाँ देश को इसकी ज़रूरत होती है, यहाँ फिर से रजिस्टर किए जाते हैं, और Connectivity Platform पर आपके नंबर एक ऐसे पोर्ट के ज़रिए मूव होते हैं जो सपोर्ट अरेंज करता है, न कि कोई सेटिंग जिसे आप फ़्लिप करें।

अगले कदम

  • Bird SMS एक्सप्लोर करें: प्रोडक्ट वर्कफ़्लो और इम्प्लीमेंटेशन पाथ
  • SMS भेजना: वह पेलोड जिस पर आप पोर्ट कर रहे हैं, पूरी डिटेल में
  • Opt-outs और कीवर्ड्स: Bird आपके लिए क्या हैंडल करता है, और सप्रेशन कैसे मैनेज करें
  • SMS इवेंट्स: वह इवेंट शब्दावली जिस पर आपका स्टेटस हैंडलर मूव होता है
  • Webhooks & events: endpoint सेटअप और Standard Webhooks सत्यापन

संबंधित संसाधन

इस विषय के लिए डॉक्यूमेंटेशन, गाइड और उदाहरणों के साथ आगे बढ़ें। संसाधन अंग्रेज़ी में हैं।