SMS-API für Chatbots und KI-Agenten
Dein KI-Agent brauchst eine Telefonnummer, um SMS-Verifizierungscodes von Cash App, Coinbase, PayPal, Stripe, Tinder, Banking-Apps oder anderen 2FA-Flows zu empfangen. Twilio lehnt die meisten Dienste ab, weil es als VoIP erkannt wird.
Dein KI-Agent brauchst eine Telefonnummer, um SMS-Verifizierungscodes von Cash App, Coinbase, PayPal, Stripe, Tinder, Banking-Apps oder anderen 2FA-Flows zu empfangen. Twilio lehnt die meisten Dienste ab, weil es als VoIP erkannt wird. Hier erfährst du, wie du einen Chatbot oder Agenten mit MeiSIMs Webhook-API verbindest, um echte SMS zu empfangen — schnell, zuverlässig und ohne Blockierungen.
Hole dir einen API-Schlüssel
5 kostenlose Nummern. Webhook-Lieferung in unter 3 Sekunden.
Der Ablauf im Überblick
- Dein Agent ruft
POST /v1/numbers/provisionmit einer Webhook-URL auf. - Nach etwa 60 Sekunden hat der Agent eine echte US-Telefonnummer (eSIM-QR, ICCID und LPA werden in der Antwort zurückgegeben).
- Agent nutzt die Nummer, um sich bei Cash App, Coinbase, PayPal, Stripe oder einem anderen Dienst anzumelden.
- Der Anmeldedienst sendet einen Verifizierungs-SMS an die Nummer.
- MeiSIM empfängt die SMS über das Carrier-Netz (~1s Latenz).
- MeiSIM POSTet die Nachricht zu deiner Webhook-URL (~1-2s zusätzlich).
- Dein Agent liest die Nachricht, extrahiert den Code und schließt die Anmeldung ab.
Webhook-Kontrakt und Spezifikation
Wir senden einen JSON-Body an deine URL. Du gibst innerhalb von 10 Sekunden HTTP 200 zurück, um zu bestätigen. Bei Fehler oder Timeout versuchen wir es mit Backoff (sofort, +15s, +60s, +300s — insgesamt 4 Versuche über 6 Minuten). Nachrichten sind auch über den Messages-Endpoint 30 Tage lang abrufbar.
Polling als Fallback
Falls du lieber Polling nutzen möchtest, statt einen Webhook-Endpoint zu betreiben (häufig bei zustandslosen Agenten), rufe auf:
Die meisten Agenten fragen alle 2-3 Sekunden ab, während sie auf Verifizierung warten. Verifizierungs-SMS kommt üblicherweise innerhalb von 30 Sekunden an; fehlgeschlagene Versuche dauern bis zu 5 Minuten, bevor es erneut versucht wird.
OTP-Code extrahieren
Der SMS-Text variiert je nach Dienst, aber der Code ist immer eine 4-8-stellige Zahl. Die meisten Agenten nutzen einen Regex wie /\b\d{4,8}\b/ zum Extrahieren. Für höhere Zuverlässigkeit kann dein LLM (Claude, GPT-4o, Gemini) den Text lesen und direkt den Code zurückgeben — das dauert nur Millisekunden.
Authentifizierung und Sicherheit
Jeder Webhook-POST ist mit HMAC-SHA256 signiert. Verifiziere den X-MeiSIM-Signature Header mit deinem API-Secret, um sicherzugehen, dass die Anfrage wirklich von uns kommt und nicht von einem Angreifer. Code-Beispiele findest du in der API-Dokumentation.
Häufige Anwendungsfälle
Entwickler nutzen die SMS-API für:
- Finanzielle Apps und Krypto: Cash App, PayPal, Stripe, Coinbase, Kraken, Binance.US, Gemini und andere Börsen und Payment-Dienste
- Dating und Social: Tinder, Bumble, Hinge, Match, Discord, WhatsApp Business, Telegram
- Marktplätze: Amazon Seller Central, eBay, Etsy, Shopify, Mercari, Poshmark
- Gig-Economy: Uber Driver, Lyft, DoorDash, Instacart, Grubhub
- Banking und Fintech: Chime, Mercury, Brex, US Bankkonten, ITIN Anwendungen
- Streaming und Region-Locked Services: Netflix US, Hulu, Disney+ US, Peacock, HBO Max, Paramount+
Starte heute noch
API-Schlüssel + erste 5 Nummern kostenlos. Schreib uns und wir richten dich ein.
Häufig gestellte Fragen
Wie schnell kommt eine SMS zu meinem Webhook an?
Medianlatenz unter 3 Sekunden. Wir versuchen fehlgeschlagene Webhook-Aufrufe mit exponentiellem Backoff (sofort, 15s, 60s, 300s) zu wiederholen und speichern Nachrichten 30 Tage lang, sodass du sie über Polling abrufen kannst, wenn dein Webhook ausfiel.
Muss ich Webhooks verwenden oder kann ich einfach nur Polling nutzen?
Ja, Polling ist möglich. GET /v1/numbers/{id}/messages gibt bis zu 50 aktuelle Nachrichten zurück. Setze since_iso um nur Nachrichten nach einem bestimmten Zeitstempel zu erhalten. Die meisten Agenten fragen alle 2-3 Sekunden ab, während sie auf eine Verifizierung warten.
Kann ich SMS von Short Codes (5-stelligen Nummern) empfangen?
Ja. Verifizierungs-SMS von US-Banken, Dating-Apps, Krypto-Börsen und den meisten Apps, die über Short Codes versendet werden, kommen normal an. Das ist einer der Hauptgründe, warum VoIP fehlschlägt und echte Carrier-Nummern funktionieren.
Funktioniert die API mit internationalen VPN oder Proxies?
Ja, die API arbeitet weltweit. Du kannst von jedem Land aus auf die US-Nummern zugreifen und SMS empfangen, solange dein Server eine ausgehende HTTPS-Verbindung herstellen kann.
Wie unterscheidet sich MeiSIM von Twilio oder anderen SMS-Anbietern?
Twilio und ähnliche VoIP-basierte Anbieter werden von vielen Verifizierungsdiensten (Cash App, Coinbase, Tinder, PayPal, Stripe) blockiert. MeiSIM nutzt echte Carrier-Nummern von AT&T, T-Mobile und anderen, die nicht als VoIP erkannt werden.
Was ist die maximale Anzahl von SMS, die ich pro Tag empfangen kann?
Je nach Plan gibt es keine Obergrenze. Mit dem Standard-Plan kannst du hunderte oder tausende SMS pro Tag empfangen. Kontaktiere support@meisimusa.com für Enterprise-Limits.
Kann ich die API für Spamming oder Phishing verwenden?
Nein. Jede SMS-Verifizierung wird überwacht. Missbrauch führt sofort zu Konto-Sperrung und möglicher rechtlicher Verfolgung.
Unterstützt ihr auch MMS (Bilder)?
Derzeit nur SMS. MMS steht auf der Roadmap und wird in den nächsten Monaten verfügbar sein.
Wie viel kostet eine SMS-Verifizierung mit eurer API?
Die ersten 5 Nummern sind kostenlos. Danach zahlst du je nach Plan zwischen 25-49 USD pro Monat für Nummern + SMS-Empfang. Keine versteckten Gebühren.
Kann ich mehrere Webhooks pro Nummer registrieren?
Nein, nur ein Webhook pro Nummer. Für Fan-Out-Szenarien routest du einfach über deinen eigenen Dispatcher weiter.
Wie lange werden empfangene SMS gespeichert?
SMS werden 30 Tage lang gespeichert und können über die Messages-API abgerufen werden. Nach 30 Tagen werden sie automatisch gelöscht.
Funktioniert die API mit Python, Node.js und anderen Sprachen?
Ja, die REST-API ist sprachenunabhängig. Wir haben Beispiele für Python, Node.js, Go, Java und Bash. Jede Sprache mit HTTP-Support funktioniert.
Was passiert, wenn mein Agent offline geht oder der Webhook ausfällt?
MeiSIM speichert SMS und versucht bis zu 4 Mal, sie zu liefern (sofort, +15s, +60s, +300s). Die Nachricht bleibt 30 Tage abrufbar. Du kannst die Nachrichten später über Polling abrufen.
Kann ich SMS-Nummern für verschiedene Verifikationsdienste mieten?
Ja, absolut. Viele Kunden mieten mehrere Nummern, eine pro Dienst (eine für Cash App, eine für PayPal, eine für Coinbase usw.) zur besseren Kontrolle und zum Tracking.
Gibt es eine Testumgebung oder Sandbox-API?
Die kostenlosen 5 Nummern funktionieren als Test-Account. Du kannst damit experimentieren, bevor du für einen bezahlten Plan zahlst.