SMS API untuk chatbot dan AI agent
AI agent atau chatbot Anda perlu nomor telepon yang bisa menerima SMS verifikasi dari Cash App, Coinbase, Tinder, aplikasi banking, atau flow 2FA apapun. Twilio sering diblok karena VoIP.
AI agent atau chatbot Anda perlu nomor telepon yang bisa menerima SMS verifikasi dari Cash App, Coinbase, Tinder, aplikasi banking, atau flow 2FA apapun. Twilio sering diblok karena VoIP. Di sini, kami jelaskan cara menghubungkan chatbot atau agent untuk menerima SMS asli melalui webhook API MeiSIM dengan latency kurang dari 3 detik.
Dapatkan API key
5 nomor gratis. Webhook delivery kurang dari 3 detik.
Alur singkat
- Agent Anda call
POST /v1/numbers/provisiondengan webhook URL Anda. - Dalam ~60 detik, agent punya nomor US asli (eSIM QR, ICCID, LPA dikembalikan di response).
- Agent gunakan nomor untuk signup di Cash App, Coinbase, atau aplikasi lain.
- Layanan signup mengirim SMS verifikasi ke nomor tersebut.
- MeiSIM terima SMS via network carrier (~1 detik).
- MeiSIM POST pesan ke webhook URL Anda (~1-2 detik lebih).
- Agent Anda baca body JSON, extract kode, selesaikan signup otomatis.
Kontrak webhook
Kami POST body JSON ke URL Anda. Anda return HTTP 200 dalam 10 detik untuk acknowledge. Jika Anda fail atau timeout, kami retry dengan backoff (segera, +15s, +60s, +300s — total 4 attempt dalam 6 menit). Pesan juga bisa di-query via messages endpoint selama 30 hari.
Fallback polling
Jika Anda lebih suka polling daripada maintain webhook endpoint (umum untuk agent stateless), panggil:
Kebanyakan agent melakukan polling setiap 2-3 detik saat menunggu verifikasi. SMS verifikasi biasanya tiba dalam 30 detik; jika gagal, bisa retry hingga 5 menit sebelum attempt ulang.
Extract kode OTP
Body SMS bervariasi tergantung layanan, tapi kode selalu 4-8 digit angka. Kebanyakan agent pakai regex seperti /\b\d{4,8}\b/ untuk extract. Untuk reliability lebih tinggi, suruh LLM membaca text dan return hanya kodenya — Claude atau GPT-4o selesaikan dalam milliseconds.
Autentikasi dan keamanan
Setiap POST webhook ditandatangani dengan HMAC-SHA256. Verifikasi X-MeiSIM-Signature menggunakan API secret Anda untuk memastikan request benar-benar dari kami, bukan spoofer. Contoh code ada di API docs.
Dukungan untuk berbagai layanan
SMS API MeiSIM cocok untuk verifikasi di platform populer global dan lokal Indonesia, termasuk:
- Payment & Money Transfer: Cash App, Coinbase, PayPal, Stripe, Wise, Revolut, GCash, Dana, OVO
- Dating & Social: Tinder, Bumble, Hinge, Match, OnlyFans, Fanvue, Xiaohongshu/RedNote, Instagram, TikTok, Discord, Telegram, WeChat
- E-commerce & Marketplace: Amazon seller, eBay, Etsy, Walmart Marketplace, Shopify, Mercari, Poshmark
- Cryptocurrency: Coinbase, Kraken, Binance.US, Gemini, Robinhood
- Gig Economy & Delivery: Uber driver, Lyft, DoorDash, Instacart, Uber Eats, Grubhub, Grab
- Streaming & Region-Locked: US Netflix, Hulu, Disney+ US, Peacock, HBO Max US, Paramount+
- Banking: Chime, Mercury, Brex, pembukaan akun bank US, aplikasi ITIN
Mulai malam ini
API key + 5 nomor pertama gratis. Email kami dan kami setup semuanya.
Tanya Jawab
Berapa lama SMS sampai ke webhook saya?
Median kurang dari 3 detik. Retry otomatis jika fail dengan exponential backoff. Pesan disimpan 30 hari untuk fallback polling.
Bisakah saya cuma polling tanpa webhook?
Ya. GET /v1/numbers/{id}/messages, opsional dengan since=ISO. Kebanyakan agent polling setiap 2-3 detik saat nunggu verifikasi.
Apakah bisa terima SMS dari short code (5 digit)?
Ya — itulah alasan utama switch ke nomor carrier real. Kebanyakan verifikasi bank/crypto/dating-app dikirim via short code, dan VoIP membloknya.
Apakah Anda support MMS (gambar)?
SMS saja untuk sekarang. MMS ada di roadmap kami.
Bisakah saya pakai multiple webhook per nomor?
Satu webhook per nomor. Untuk fan-out, route lewat dispatcher Anda sendiri.
Bagaimana jika agent saya butuh banyak nomor sekaligus?
Tidak masalah. Provision banyak nomor. Setiap nomor punya webhook sendiri atau bisa share satu endpoint dengan number_id di body untuk identifikasi.
Apakah nomor ini cocok untuk WhatsApp atau Telegram?
Nomor kami SMS standar GSM. WhatsApp dan Telegram pakai protokol berbeda (internet-based). Nomor kami untuk SMS verifikasi, 2FA, OTP — bukan untuk app messaging.
Ada limit berapa SMS per hari?
Tidak ada limit per-SMS. Unlimited receive SMS di nomor Anda. Billing hanya berdasarkan SMS terima atau paket bulanan.
Apa bedanya dengan VoIP provider lain?
VoIP diblok karena tidak teridentifikasi sebagai nomor real carrier. Nomor MeiSIM adalah real GSM dari AT&T, T-Mobile, atau carrier lain — tidak pernah diblok untuk verifikasi.
Berapa cost-nya?
5 nomor dan 100 SMS masuk gratis per bulan. Setelah itu, tarif per SMS atau paket bulanan kompetitif. Email support@meisimusa.com untuk pricing custom sesuai volume.
Bagaimana keamanan API key saya?
Setiap request authenticate dengan Bearer token di Authorization header. Jangan hardcode API key; simpan di environment variable atau secret manager. Rotate key secara berkala.
Apakah ada SLA atau uptime guarantee?
Kami target 99.9% uptime. SMS biasanya tiba dalam 30 detik. Jika ada issue, hubungi support@meisimusa.com.
Bisakah saya trace mana SMS yang sudah terproses?
Ya. Setiap webhook POST include timestamp dan message ID. Log di side Anda dan cross-check dengan polling untuk reconciliation.
Apakah saya bisa custom number format atau area code?
Nomor di-assign dari pool carrier. Untuk request specific area code, hubungi support — kami coba accommodate tergantung availability.