Hindi ako gusto ng webhooks. Pwede bang i-poll lang?

Oo. Ang GET /v1/numbers/{id}/messages ay nagbabalik ng hanggang 50 recent messages. I-set ang since_iso para makakuha lang ng messages pagkatapos ng timestamp. Karamihan ng agents ay nag-poll bawat 2-3 segundo habang naghihintay ng verification.

Pwede ba akong tumanggap ng SMS mula sa short codes (5-digit numbers)?

Oo. Ang verification SMS mula sa US banks, dating apps, crypto exchanges, at karamihan ng apps na ipinapadala through short codes ay dumating normally. Ito ang pangunahing dahilan kung bakit nabibigo ang VoIP at napakaganda ng real carrier numbers.

Pwede ko ba itong gamitin para sa Cash App verification?

Oo, perpekto para sa Cash App, Coinbase, PayPal, Venmo, Zelle, Apple Pay, at iba pang fintech apps. Real carrier numbers ay tumatanggap ng verification SMS mula sa lahat ng major US services.

Suportado ba ang international countries o Pilipinas lang?

Real US numbers kami nag-aalok, pero pwede itong gamitin kahit saan ka naroroon sa mundo. Maraming Filipino users ang gumagamit mula sa Pilipinas para makakuha ng US verification codes.

Ano ang maximum timeout para sa webhook delivery?

Ang webhook call ay dapat mag-return ng HTTP 200 sa loob ng 10 segundo. Kung hindi, nag-retry kami gamit ang exponential backoff hanggang 4 attempts total sa loob ng 6 minuto.

Pwede ba itong gamitin para sa Coinbase, Kraken, o Binance verification?

Oo, perfect para sa lahat ng crypto exchanges. Real carrier SMS ay always accepted ng Coinbase, Kraken, Gemini, Robinhood, at ibang platforms.

Guide · SMS API

SMS API para sa chatbots at AI agents

TL;DR

Kailangan ng iyong AI agent ng phone number na makakatanggap ng SMS verification codes mula sa Cash App, Coinbase, Tinder, banking apps, o anumang 2FA flow. Ang Twilio ay nag-re-reject sa karamihan dahil VoIP. Dito kung paano i-wire ang chatbot o agent mo para makatanggap ng real SMS through sa MeiSIM's webhook API.

Kumuha ng API key

5 free numbers. Webhook delivery sa loob ng 3 segundo.

Tingnan ang API →

Ang workflow sa isang tingin

Ang iyong agent ay tumatawag ng POST /v1/numbers/provision kasama ang webhook URL.
Mga ~60s mamaya, ang iyong agent ay may real US phone number (eSIM QR + ICCID + LPA na returned sa response).
Agent ay gumagamit ng number para mag-sign up sa Cash App / Coinbase / atbp.
Ang signup service ay nag-send ng verification SMS sa number.
MeiSIM ay nakakatanggap ng SMS through ang carrier's network (~1s).
MeiSIM ay nag-POST ng message sa iyong webhook URL (~1-2s pa).
Ang iyong agent ay nag-read ng body, nag-extract ng code, kumpleto ang signup.

Webhook contract at integration

Nag-POST kami ng JSON body sa iyong URL. Dapat kang mag-return ng HTTP 200 sa loob ng 10 segundo para mag-acknowledge. Kung mag-fail ka o time out, nag-retry kami gamit ang backoff (immediate, +15s, +60s, +300s — total 4 attempts sa loob ng 6 minuto). Messages ay pwede ring i-query through ang messages endpoint hanggang 30 araw.

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 option

Kung mas gugustuhin mo ang polling kaysa mag-maintain ng webhook endpoint (common para sa stateless agents), tawagan ang:

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": "..." }, ...] }

Karamihan ng agents ay nag-poll bawat 2-3 segundo habang naghihintay ng verification. Verification SMS ay karaniwang dumadating sa loob ng 30 segundo; failed attempts ay umabot hanggang 5 minuto bago mag-retry.

Pag-extract ng OTP code

Ang SMS body ay nag-vary depende sa service pero ang code ay laging 4-8 digit number. Karamihan ng agents ay gumagamit ng regex tulad ng /\b\d{4,8}\b/ para mag-extract. Para sa mas mataas na reliability, hayaan ang LLM na mag-read ng text at mag-return lang ng code — Claude o GPT-4o ay kaya nitong gawin sa milliseconds.

Authentication at security

Bawat webhook POST ay signed gamit ang HMAC-SHA256. I-verify ang X-MeiSIM-Signature gamit ang iyong API secret para ma-confirm na mula talaga sa amin, hindi galing sa spoofer. Code sample ay makikita sa API docs.

Supported services at verification flows

Ang SMS API ay perpekto para sa verification codes mula sa lahat ng major US services: fintech (Cash App, Venmo, Zelle, PayPal, Apple Pay, Google Pay, Wise, Revolut), crypto (Coinbase, Kraken, Binance.US, Gemini, Robinhood), dating apps (Tinder, Bumble, Hinge, Match, OnlyFans), social media (Discord, WhatsApp Business, Telegram, WeChat, Xiaohongshu/RedNote, Instagram, TikTok, Facebook), marketplaces (Amazon seller, eBay, Etsy, Walmart Marketplace, Shopify, Mercari, Poshmark), gig economy (Uber driver, Lyft, DoorDash, Instacart, Uber Eats, Grubhub), banking (Chime, Mercury, Brex, US bank account opening), at streaming (Netflix US, Hulu, Disney+ US, Peacock, HBO Max US, Paramount+). Real carrier numbers ay always accepted saan Twilio at ibang VoIP providers ay nag-fail.

Simulan ngayong gabi

API key + unang 5 numbers ay free. Email kami at ise-set up ka namin.

Email →

Frequently Asked Questions

Gaano kabilis dumating ang SMS sa aking webhook?

Ang median latency ay mas mababa sa 3 segundo. Nag-retry sa failed attempts gamit ang exponential backoff. Messages ay naka-store 30 araw para sa polling fallback.

Pwede ba akong mag-poll lang instead ng webhook?

Oo. Gamitin ang GET /v1/numbers/{id}/messages, optionally kasama ang since=ISO. Karamihan ng agents ay nag-poll bawat 2-3 segundo during verification waits.

Pwede ba akong tumanggap mula sa short codes (5-digit)?

Oo — ito ang main reason kung bakit dapat mag-switch sa real carrier numbers. Karamihan ng bank/crypto/dating-app verification SMS ay nanggagaling sa short codes, at VoIP ay nag-block.

Ano ang tungkol sa MMS (may images)?

SMS lang para sa ngayon. MMS ay nasa roadmap na.

Pwede ko ba magkaroon ng multiple webhooks per number?

Isang webhook lang per number. Para sa fan-out, i-route through sa sarili mong dispatcher.

Paano ko mare-verify ang webhook signature?

Bawat POST ay signed gamit ang HMAC-SHA256. I-verify ang X-MeiSIM-Signature header gamit ang iyong API secret key.

Gaano katagal bago makakuha ng eSIM number?

Karamihan ay 60 segundo o mas mabilis. Kasama sa response ang eSIM QR code at ICCID ready for use.

Pwede ko itong gamitin para sa Tinder at dating apps?

Oo. Marami sa users ay gumagamit para sa Tinder, Bumble, Hinge, Match, at ibang dating platforms na kailangan ng real US number.

Pwede ko ba itong gamitin kahit international kami, tulad ng Pilipinas?

Oo. US numbers kami, pero pwede itong gamitin kahit saan ka sa mundo. Maraming Filipino users ang gumagamit mula Philippines para makakuha ng US verification codes.

Ano ang maximum timeout para sa webhook?

10 segundo. Kung hindi mag-return ng HTTP 200 sa time na ito, nag-retry kami hanggang 4 times sa 6 minuto.

Pwede ko ba i-change ang webhook URL after provisioning?

Hindi directly, pero pwede through API. Contact support para sa details.

Gaano katagal ma-store ang messages?

30 araw. Pwede mong i-poll anytime within na window gamit ang messages endpoint.

Pwede itong gamitin para sa Coinbase, Kraken, Binance verification?

Oo, perfect para sa lahat ng crypto exchanges. Real carrier SMS ay always accepted ng major platforms.

Ano ang fastest median SMS delivery time?

Under 3 segundo. Fastest cases ay 1-2 segundo lang, depende sa carrier at SMS originator.

Pwede para sa Stripe, PayPal, Wise verification?

Oo. Payment platforms ay tumatanggap ng SMS mula sa real carrier numbers. Perfect para sa international freelancers.