Wat als ik geen webhooks wil? Kan ik gewoon polling gebruiken?

Ja. GET /v1/numbers/{id}/messages geeft tot 50 recente berichten terug. Zet since_iso in om alleen berichten na een bepaalde tijd op te halen. De meeste agents pollen elke 2-3 seconden terwijl ze op een verificatie wachten.

Kan ik SMS van korte codes (5-cijferig) ontvangen?

Ja. Verificatie-SMS van Amerikaanse banken, dating-apps, crypto-exchanges en de meeste apps die via korte codes worden verzonden, arriveren normaal. Dit is de voornaamste reden waarom VoIP faalt en echte carrier-nummers slagen.

Wat kost dit na de gratis tier?

Gratis beginnen met 5 nummers. Betaalde plannen beginnen rond $15-25 per maand per nummer, afhankelijk van je SMS-volume en gebruikspatroon.

Ondersteunt jullie USSD of andere protocolten?

Momenteel SMS en binnenkomende spraak alleen. USSD is niet beschikbaar op onze echte nummers.

Gids · SMS API

SMS API voor chatbots en AI-agents

TL;DR

Je AI-agent heeft een telefoonnummer nodig dat SMS-verificatiecodes kan ontvangen van Cash App, Coinbase, Tinder, bankingapps en elk ander twee-factorauthenticatieproces. Twilio weigert er de meeste omdat ze VoIP detecteren. Hier lees je hoe je een chatbot of agent inricht om echte SMS te ontvangen via MeiSIM's webhook API.

Haal een API-sleutel op

5 gratis nummers. Webhook-bezorging in <3 seconden.

Bekijk de API →

De werkflow in vogelvlucht

Je agent roept POST /v1/numbers/provision aan met een webhook-URL.
~60 seconden later heeft je agent een echt Amerikaans telefoonnummer (eSIM QR-code + ICCID + LPA in het antwoord).
Agent gebruikt het nummer om zich aan te melden op Cash App / Coinbase / etc.
De aanmeldingsservice verstuurt een verificatie-SMS naar het nummer.
MeiSIM ontvangt de SMS via het carrier-netwerk (~1 seconde).
MeiSIM POST het bericht naar je webhook-URL (~1-2 seconden meer).
Je agent leest de body, extraheert de code, voltooit de aanmelding.

Webhook-contract

We sturen een JSON-body naar je URL. Je stuurt HTTP 200 terug binnen 10 seconden om bevestiging te geven. Als je faalt of timeout, herhalen we met backoff (onmiddellijk, +15s, +60s, +300s — totaal 4 pogingen in 6 minuten). Berichten zijn ook te bevragen via het messages-endpoint gedurende 30 dagen.

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 als fallback

Als je liever wilt pollen dan een webhook-endpoint onderhouden (gebruikelijk voor stateless agents), roep je dit aan:

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

Meeste agents pollen elke 2-3 seconden terwijl ze op een verificatie wachten. Verificatie-SMS arriveert meestal binnen 30 seconden; mislukte pogingen duurt tot 5 minuten voordat er opnieuw wordt geprobeerd.

De OTP-code uitpakken

De SMS-body varieert per service, maar de code is altijd een getal van 4-8 cijfers. De meeste agents gebruiken een regex als /\b\d{4,8}\b/ om deze uit te pakken. Voor hogere betrouwbaarheid kun je de LLM het bericht laten lezen en alleen de code teruggeven — Claude of GPT-4o doen dit in milliseconden.

Authenticatie en veiligheid

Elke webhook-POST wordt ondertekend met HMAC-SHA256. Verifieer X-MeiSIM-Signature met je API-secret om te bevestigen dat het verzoek echt van ons afkomstig is, niet van een vervalsing. Codevoorbeeld in API-documentatie.

Bouw het vanavond

API-sleutel + eerste 5 nummers gratis. Stuur ons een email en we zetten je in.

Email →

Veelgestelde vragen

Hoe snel arriveert een SMS op mijn webhook?

Mediane latentie onder de 3 seconden. Herhaal bij mislukking met exponentiële backoff. Berichten opgeslagen 30 dagen voor polling fallback.

Kan ik in plaats van webhook gewoon pollen?

Ja. GET /v1/numbers/{id}/messages, optioneel met since=ISO. Meeste agents pollen elke 2-3s tijdens verificatiewachten.

Kan ik van korte codes (5-cijferig) ontvangen?

Ja — dat is de voornaamste reden om over te stappen op echte carrier-nummers. Meeste bank-/crypto-/dating-app verificatie-SMS komt van korte codes, en VoIP blokkeert die.

Wat zit er in voor MMS (met afbeeldingen)?

Momenteel alleen SMS. MMS staat op de roadmap.

Ondersteun je meerdere webhooks per nummer?

Eén webhook per nummer. Voor fan-out, route je door jouw eigen dispatcher.

Hoe beveilig ik mijn webhook tegen spoofing?

Elke webhook-POST wordt ondertekend met HMAC-SHA256. Verifieer X-MeiSIM-Signature met je API-secret om te bevestigen dat het echt van ons afkomstig is.

Welke verificatieservices werken met echte Amerikaanse nummers?

Vrijwel allemaal: Cash App, Coinbase, Tinder, Bumble, Match, Discord, Telegram, WhatsApp Business, PayPal, Stripe, Venmo, Apple Pay, Google Pay, Wise, Amazon, eBay, Etsy, Uber, Lyft en nog duizenden meer. VoIP-nummers worden meestal geweigerd.

Kan ik dit gebruiken voor internationale verificatie?

Dit is specifiek voor Amerikaanse verificatie-SMS en nummers. Voor Nederlandse of Europese verificatie heb je lokale nummers nodig.

Hoe snel kan ik starten?

Vandaag nog: maak een account aan, haal een gratis API-sleutel en 5 gratis nummers, en start je integratie. Setup duurt meestal minder dan een uur.

Wat kost dit nadat ik de gratis tier heb gebruikt?

Gratis beginnen met 5 nummers. Betaalde plannen starten rond $15-25 per maand per nummer, afhankelijk van je SMS-volume en gebruikspatroon.

Werkt dit met GPT-4, Claude en andere LLM's?

Ja, volledig. Je kunt onze API direct aanroepen in je agentencode, of je LLM kan zelf API-aanroepen doen met function-calling of tool-gebruik.

Kan ik offline in plaats van webhooks pollen?

Ja, volledig ondersteund. Poll GET /v1/numbers/{id}/messages elke 2-3 seconden. Berichten zijn 30 dagen beschikbaar.

Hoe zit het met privacy en GDPR?

Alle SMS-gegevens zijn versleuteld in transit en in rust. Je hebt volledige controle; berichten worden na 30 dagen automatisch verwijderd. Geen derden hebben toegang.

Ondersteun je USSD of andere protocolten?

Momenteel alleen SMS en inkomende spraak. USSD is niet beschikbaar op onze echte nummers.

Wat is het verschil tussen MeiSIM en Twilio?

Twilio blokkeert VoIP-verificatie voor veel services. Wij gebruiken echte carrier-nummers die vrijwel alles accepteert: korte codes, banking, crypto, dating-apps. We geven je ook webhook-integratie onder de 3 seconden latency.