```html चैटबॉट और AI एजेंट के लिए SMS API — रियल US नंबर से SMS प्राप्त करें
गाइड · SMS API

चैटबॉट और AI एजेंट के लिए SMS API

TL;DR

आपके AI एजेंट को एक फोन नंबर की जरूरत है जो Cash App, Coinbase, Tinder, बैंकिंग ऐप्स या किसी भी 2FA flow से SMS verification codes प्राप्त कर सके। Twilio अधिकांश को VoIP के रूप में अस्वीकार करता है। यहाँ बताया गया है कि MeiSIM के webhook API के माध्यम से एक chatbot या agent को री

आपके AI एजेंट को एक फोन नंबर की जरूरत है जो Cash App, Coinbase, Tinder, बैंकिंग ऐप्स या किसी भी 2FA flow से SMS verification codes प्राप्त कर सके। Twilio अधिकांश को VoIP के रूप में अस्वीकार करता है। यहाँ बताया गया है कि MeiSIM के webhook API के माध्यम से एक chatbot या agent को रीयल SMS प्राप्त करने के लिए कैसे wire करें।

API key प्राप्त करें

5 मुफ्त नंबर। 3 सेकंड से कम में webhook delivery।

API देखें →

प्रवाह एक नज़र में

  1. आपका एजेंट webhook URL के साथ POST /v1/numbers/provision को कॉल करता है।
  2. लगभग 60 सेकंड बाद, आपके एजेंट के पास एक असल US फोन नंबर है (eSIM QR + ICCID + LPA response में लौटाया जाता है)।
  3. एजेंट Cash App / Coinbase / आदि पर साइन अप करने के लिए नंबर का उपयोग करता है।
  4. Signup service नंबर को एक verification SMS भेजता है।
  5. MeiSIM SMS को कैरियर नेटवर्क के माध्यम से प्राप्त करता है (लगभग 1 सेकंड)।
  6. MeiSIM आपके webhook URL को संदेश POST करता है (1-2 सेकंड अतिरिक्त)।
  7. आपका एजेंट body पढ़ता है, कोड को निकालता है, signup को पूरा करता है।

Webhook अनुबंध

हम आपके URL को एक JSON body POST करते हैं। आप 10 सेकंड के भीतर HTTP 200 को लौटाते हैं यह स्वीकार करने के लिए। यदि आप विफल होते हैं या समय समाप्त हो जाता है, तो हम backoff के साथ दोबारा कोशिश करते हैं (तुरंत, +15s, +60s, +300s — 6 मिनट में कुल 4 प्रयास)। संदेश 30 दिनों के लिए messages endpoint के माध्यम से भी query किए जा सकते हैं।

POST https://your-agent.com/sms Content-Type: application/json X-MeiSIM-Signature: t=1716...,v1=hmac-sha256-of-body { "event": "sms.received", "number_id": "num_01HXY3...", "phone": "+14155551234", "from": "245-78", "text": "Your Cash App code is 583921. Don't share.", "received_at": "2026-05-19T14:23:01Z" }

Polling fallback

यदि आप एक webhook endpoint बनाए रखने के बजाय polling करना पसंद करते हैं (stateless agents के लिए सामान्य), तो कॉल करें:

GET /v1/numbers/{id}/messages?since=2026-05-19T14:22:00Z Authorization: Bearer YOUR_API_KEY → { "messages": [{ "from": "245-78", "text": "Your Cash App code is 583921", "received_at": "..." }, ...] }

अधिकांश एजेंट एक verification की प्रतीक्षा करते समय हर 2-3 सेकंड में polling करते हैं। Verification SMS आमतौर पर 30 सेकंड के भीतर आता है; विफल प्रयास दोबारा कोशिश करने से पहले 5 मिनट तक ले सकते हैं।

OTP कोड को निकालना

SMS body service के आधार पर भिन्न होता है लेकिन कोड हमेशा एक 4-8 अंकीय नंबर होता है। अधिकांश एजेंट /\b\d{4,8}\b/ जैसे regex का उपयोग करते हैं। उच्च विश्वसनीयता के लिए, LLM को text को पढ़ने और केवल कोड लौटाने दें — Claude या GPT-4o इसे milliseconds में handle करते हैं।

प्रमाणीकरण और सुरक्षा

प्रत्येक webhook POST HMAC-SHA256 से signed है। X-MeiSIM-Signature को verify करें अपने API secret का उपयोग करके यह पुष्टि करने के लिए कि request वास्तव में हमसे है, किसी spoofer से नहीं। Code sample API docs में है।

इसे आज रात build करें

API key + पहले 5 नंबर मुफ्त। हमें email करें और हम आपको सेट अप कर देंगे।

Email करें →

FAQ

SMS मेरे webhook तक कितनी तेजी से पहुंचता है?

Median 3 सेकंड से कम। विफल होने पर retry exponential backoff के साथ। संदेश polling fallback के लिए 30 दिनों के लिए stored।

क्या मैं webhook के बजाय सिर्फ polling कर सकता हूँ?

हाँ। GET /v1/numbers/{id}/messages, वैकल्पिक रूप से since=ISO के साथ। अधिकांश एजेंट verification waits के दौरान हर 2-3s में polling करते हैं।

क्या मैं short codes (5-अंकीय) से SMS प्राप्त कर सकता हूँ?

हाँ — यह असल कैरियर नंबर्स पर स्विच करने का मुख्य कारण है। अधिकांश बैंक/क्रिप्टो/डेटिंग-ऐप verification SMS short codes से आता है, और VoIP उन्हें ब्लॉक करता है।

MMS (इमेज के साथ) के बारे में क्या?

अभी के लिए सिर्फ SMS। MMS roadmap पर है।

क्या आप प्रति नंबर कई webhooks को support करते हैं?

प्रति नंबर एक webhook। fan-out के लिए, अपने dispatcher के माध्यम से रूट करें।

क्या Twilio के बजाय MeiSIM क्यों उपयोग करें?

Twilio VoIP नंबर्स short codes और अधिकांश बैंक/क्रिप्टो verification SMS को ब्लॉक करते हैं। MeiSIM असल AT&T, T-Mobile और Verizon कैरियर नंबर्स का उपयोग करता है।

क्या यह stateless AI एजेंट्स के लिए काम करता है?

हाँ। webhook के बजाय polling का उपयोग करें — stateless agents के लिए ideal, कोई persistent connection नहीं।

API key कितने समय में active हो जाता है?

तुरंत। POST /v1/numbers/provision के बाद 60 सेकंड में आपको एक नया असल US नंबर मिल जाता है।

क्या मुझे webhook के लिए backup की जरूरत है?

नहीं। webhook विफल होने पर, संदेश 30 दिनों के लिए stored रहते हैं और आप polling से fetch कर सकते हैं।

Verification SMS आमतौर पर कितने समय में आता है?

अधिकांश services 30 सेकंड के भीतर OTP भेजते हैं। कुछ failed attempts के बाद 5 मिनट delay हो सकता है।

क्या मैं एक नंबर से कई ऐप्स को verify कर सकता हूँ?

हाँ। एक नंबर एक बार में एक verification के लिए। Parallel verification के लिए कई नंबर provision करें।

क्या HMAC signature verify करना आवश्यक है?

अत्यधिक अनुशंसित। X-MeiSIM-Signature verify करें ताकि आप पुष्टि करें कि webhook वास्तव में MeiSIM से है।

OTP कोड को कैसे निकालूँ?

regex /\\b\\d{4,8}\\b/ का उपयोग करें या LLM को SMS body पढ़ने दें और केवल कोड लौटाएँ।

क्या Vonage या Plivo के बजाय MeiSIM है?

हाँ — MeiSIM असल कैरियर नंबर्स के साथ विशेष है। Vonage/Plivo VoIP का उपयोग करते हैं जो most short codes ब्लॉक करता है।

क्या billing API calls पर आधारित है?

नहीं। SMS प्राप्त करने के लिए कोई API call charge नहीं। आप प्रति नंबर प्रति महीने charge किए जाते हैं।

क्या मैं विभिन्न regions से numbers provision कर सकता हूँ?

फिलहाल सिर्फ US numbers। हम जल्द ही UK, Canada और अन्य देशों का विस्तार कर रहे हैं।

```