Chatbot'lar ve AI ajanları için SMS API
AI ajanınızın Cash App, Coinbase, Tinder, bankacılık uygulamaları veya herhangi bir 2FA akışından SMS doğrulama kodlarını alabilecek bir telefon numarasına ihtiyacı var. Twilio çoğunluğunu VoIP olarak reddeder.
AI ajanınızın Cash App, Coinbase, Tinder, bankacılık uygulamaları veya herhangi bir 2FA akışından SMS doğrulama kodlarını alabilecek bir telefon numarasına ihtiyacı var. Twilio çoğunluğunu VoIP olarak reddeder. İşte bir chatbot'u veya ajanı MeiSIM'in webhook API'sı aracılığıyla gerçek SMS almak için nasıl bağlayacağınızın kılavuzu.
API Anahtarı Alın
5 ücretsiz numara. Webhook teslimati 3 saniyenin altında.
Akış bir bakışta
- Ajanınız webhook URL'si ile
POST /v1/numbers/provision'ı çağırır. - ~60 saniye sonra, ajanınız gerçek bir US telefon numarasına sahiptir (yanıtta eSIM QR + ICCID + LPA döndürülür).
- Ajan numarayı Cash App / Coinbase / vb. üzerinde kaydolmak için kullanır.
- Kaydolma hizmeti numaraya doğrulama SMS'i gönderir.
- MeiSIM, SMS'i taşıyıcı ağı aracılığıyla alır (~1 saniye).
- MeiSIM, mesajı webhook URL'inize POST eder (~1-2 saniye daha).
- Ajanınız gövdeyi okur, kodu çıkartır, kaydolmayı tamamlar.
Webhook sözleşmesi
URL'nize JSON gövdesi POST'larız. Onaylamak için 10 saniye içinde HTTP 200 döndürün. Başarısız olur veya timeout'a uğrarsanız, geri çekilme ile yeniden deniyoruz (hemen, +15s, +60s, +300s — 6 dakika içinde toplam 4 deneme). Mesajlar ayrıca 30 gün boyunca messages endpoint'i aracılığıyla sorgulanabilir.
Polling geri planı
Webhook endpoint'i bakımını yapamıyorsanız (stateless ajanlar için yaygın), şunu çağırın:
Çoğu ajan doğrulama beklerken her 2-3 saniyede bir poll yapar. Doğrulama SMS'leri tipik olarak 30 saniye içinde ulaşır; başarısız denemeler yeniden denemeden önce 5 dakika kadar alabilir.
OTP kodunu çıkartmak
SMS gövdesi hizmete göre değişir ancak kod her zaman 4-8 haneli bir sayıdır. Çoğu ajan çıkartmak için /\b\d{4,8}\b/ gibi regex kullanır. Daha yüksek güvenilirlik için LLM'ye metni okumasını ve sadece kodu döndürmesini söyleyin — Claude veya GPT-4o bunu milisaniye içinde işler.
Kimlik doğrulama ve güvenlik
Her webhook POST, HMAC-SHA256 ile imzalanmıştır. İsteğin tamamen bizden gelip bir taklacıdan gelmediğini doğrulamak için API gizlilerinizi kullanarak X-MeiSIM-Signature'ı doğrulayın. API dokümantasyonunda kod örneği bulunmaktadır.
Bu gece derle
API anahtarı + ilk 5 numara ücretsiz. Bize e-posta gönderin ve sizi kuracağız.
Sık Sorulan Sorular
SMS webhook'a ne kadar hızlı ulaşır?
Ortanca 3 saniyenin altı. Başarısız olanlar üssel geri çekilme ile yeniden denenir. Mesajlar 30 gün boyunca poll geri planı için saklanır.
Webhook yerine sadece poll yapabilir miyim?
Evet. GET /v1/numbers/{id}/messages, isteğe bağlı olarak since=ISO ile. Çoğu ajan doğrulama beklerken her 2-3 saniyede bir poll yapar.
Kısa kodlardan (5 haneli) SMS alabilir miyim?
Evet — bu VoIP'ten gerçek taşıyıcı numaralarına geçişin ana sebebidir. Çoğu banka/kripto/çiftleşme-uygulaması doğrulama SMS'i kısa kodlardan gelir ve VoIP bunları bloke eder.
MMS (resimli) ne durumda?
Şimdilik sadece SMS. MMS yol haritasında.
Numara başına birden fazla webhook destekleniyor mu?
Numara başına bir webhook. Fan-out için kendi dispatcher'ınız aracılığıyla yönlendirin.
X-MeiSIM-Signature'ı nasıl doğrulayabilirim?
Her webhook POST HMAC-SHA256 ile imzalanmıştır. İstek tamamen bizden geldiğini doğrulamak için X-MeiSIM-Signature başlığını API gizlilerinizi kullanarak doğrulayın. API dokümantasyonunuzda sağlanan kod örneğini kullanın.
Başarısız doğrulama kaç dakika sürer?
Tipik doğrulama SMS'leri 30 saniye içinde ulaşır. Başarısız denemeler yeniden denenmeden önce 5 dakika kadar sürebilir.
Doğrulama kodunu çıkartmak için en iyi yol nedir?
Çoğu ajan 4-8 haneli sayı için /\b\d{4,8}\b/ regex'ini kullanır. Daha yüksek güvenilirlik için Claude veya GPT-4o gibi LLM'ye SMS metnini okumasını ve sadece kodu döndürmesini söyleyin; bunu milisaniye cinsinden gerçekleştirirler.
Webhook başarısız olursa ne olur?
Webhook başarısız olur veya 10 saniye içinde timeout olursa, üssel geri çekilme ile yeniden deneriz (hemen, +15s, +60s, +300s). Toplam 4 deneme yapılır. Mesajlar ayrıca polling yoluyla 30 gün boyunca sorgulanabilir.
Stateless ajanlar için polling önerilir mi?
Evet. Webhook endpoint'i açık tutamayan ajanlar için polling yaygındır. Doğrulama beklenirken her 2-3 saniyede bir /v1/numbers/{id}/messages endpoint'ini çağırın.
Hangi uygulamalardan doğrulama SMS'i alabilirim?
Cash App, Coinbase, Tinder, Bumble, Match, OnlyFans, Fanvue, PayPal, Stripe, Apple Pay, Google Pay, Wise, Revolut, Kraken, Binance, Gemini, Robinhood, Discord, WhatsApp Business, Telegram, Instagram, TikTok, Facebook, WeChat, Xiaohongshu, Uber, Lyft, DoorDash, Grubhub, Amazon, eBay, Etsy, Shopify, Mercari ve çoğu US 2FA hizmeti. VoIP'in bloke ettiği kısa kodları alabilmemiz ana avantajımızdır.
API anahtarım kaçaksa ne yapmam gerekir?
Hemen support@meisimusa.com ile iletişime geçin. Anahtarı döndüreceğiz ve etkilenen numaraları yeniden yaşlandıracağız.
Farklı ülkelerden ajanlar için eSIM edebilir miyim?
Evet. Provision çağrısında country parametresini geçirin. Geçerli ülkeleri /v1/countries'de kontrol edin. eSIM yalnızca uyumlu cihazlarda (iPhone XS+, çoğu Android 10+) ve taşıyıcılar US sınırları içinde desteklenir.
Bir numarayı devre dışı bırakabilir ve silip yeni bir tane alabilir miyim?
Evet. DELETE /v1/numbers/{id} numarayı döndürür ve kapatır. Yeni bir tane almak için tekrar provision edin. Silinen numaralar 48 saat sonra yeniden satın alınabilir.
SMS alındığında ağ gecikmesi nasıl işlenir?
Alım ~1 saniye, webhook teslimatı ~1-2 saniye daha alır. Toplam ortanca gecikme 3 saniyeden azdır. Ağ çeşitliliği ve taşıyıcı işlemi nedeniyle bazı durumlarda 10 saniyeye kadar gecikmeler görülebilir; 30 gün boyunca mesajlar saklanır.
Webhook imzasını doğrulayamadığımda neler olabilir?
API gizli anahtarınızı doğru şekilde kullandığınızdan emin olun (istek gövdesi üzerinde HMAC-SHA256). Zaman damgasını (t=...) ve imzayı (v1=...) kontrol edin. API dokümantasyonunuzda sağlanan kod örneğini kullanın.