Et si je ne veux pas de webhooks? Puis-je juste faire du polling?

Oui. GET /v1/numbers/{id}/messages retourne jusqu'à 50 messages récents. Définissez since_iso pour obtenir uniquement les messages après un timestamp. La plupart des agents font du polling toutes les 2-3 secondes en attendant une vérification.

Puis-je recevoir des SMS depuis les courts codes (numéros à 5 chiffres)?

Oui. Les SMS de vérification depuis les banques US, applications de rencontre, échanges crypto et la plupart des services envoyés via courts codes arrivent normalement. C'est l'une des principales raisons pour lesquelles VoIP échoue et les numéros réels opérateurs réussissent.

Puis-je recevoir des MMS (avec images)?

Pour le moment, SMS uniquement. Les MMS sont sur la feuille de route pour les versions futures.

Comment vérifier la signature HMAC du webhook?

Chaque POST webhook inclut un header X-MeiSIM-Signature avec une valeur HMAC-SHA256. Vérifiez-la avec votre clé API secrète pour confirmer que la requête provient vraiment de MeiSIM et non d'un usurpateur.

Quelle est la latence typique de livraison?

Les codes de vérification arrivent généralement en 30 secondes. La latence webhook est en médiane <3 secondes. Les tentatives échouées peuvent prendre jusqu'à 5 minutes avant de renvoyer.

Comment extraire le code OTP du message?

La plupart des codes sont des nombres à 4-8 chiffres. Utilisez une regex comme /\b\d{4,8}\b/ ou faites appel à un LLM (Claude, GPT-4o) pour analyser le texte — plus fiable pour les formats complexes.

Puis-je mettre à jour l'URL du webhook après la création du numéro?

Oui, via l'endpoint PATCH /v1/numbers/{id}. Vous pouvez changer l'URL du webhook sans reprendre le numéro.

Y a-t-il des frais cachés ou des quotas?

Non frais cachés. Les 5 premiers numéros sont gratuits pour tester. Après cela, les tarifs sont transparents par numéro et par SMS reçu — consultez nos tarifs.

Puis-je utiliser cette API pour de la vérification en masse?

Oui. Avec l'endpoint de provisionnement, vous pouvez créer des dizaines ou des centaines de numéros en parallèle. Chacun a son propre webhook et sa propre file d'attente de messages.

Fonctionne-t-elle avec les agents IA open-source comme LangChain ou CrewAI?

Oui. L'API SMS est indépendante du framework. Intégrez-la à n'importe quel agent Python, Node.js ou autre via notre SDK ou des appels HTTP directs.

Guide · API SMS

API SMS pour chatbots et agents IA

TL;DR

Votre agent IA a besoin d'un numéro de téléphone capable de recevoir des codes de vérification SMS depuis Cash App, Coinbase, Tinder, applications bancaires, ou n'importe quel flux 2FA. Twilio et les VoIP rejettent la plupart d'entre eux.

Obtenir une clé API

5 numéros gratuits. Livraison webhook en <3 secondes.

Voir l'API →

Le flux en un coup d'œil

Votre agent appelle POST /v1/numbers/provision avec une URL webhook.
~60s plus tard, votre agent a un vrai numéro de téléphone US (QR code eSIM + ICCID + LPA retournés dans la réponse).
L'agent utilise le numéro pour s'inscrire sur Cash App / Coinbase / etc.
Le service d'inscription envoie un SMS de vérification au numéro.
MeiSIM reçoit le SMS via le réseau opérateur (~1s).
MeiSIM poste le message sur votre URL webhook (~1-2s de plus).
Votre agent lit le corps, extrait le code, complète l'inscription.

Contrat webhook

Nous postons un corps JSON sur votre URL. Vous retournez HTTP 200 en moins de 10 secondes pour confirmer. Si vous échouez ou expirer un délai, nous réessayons avec backoff (immédiat, +15s, +60s, +300s — 4 tentatives total sur 6 min). Les messages sont aussi interrogeables via l'endpoint messages pendant 30 jours.

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": "Votre code Cash App est 583921. Ne le partagez pas.", "received_at": "2026-05-19T14:23:01Z" }

Fallback polling

Si vous préférez faire du polling plutôt que de maintenir un endpoint webhook (courant pour les agents sans état), appelez:

GET /v1/numbers/{id}/messages?since=2026-05-19T14:22:00Z Authorization: Bearer YOUR_API_KEY → { "messages": [{ "from": "245-78", "text": "Votre code Cash App est 583921", "received_at": "..." }, ...] }

La plupart des agents font du polling toutes les 2-3 secondes en attendant une vérification. Les SMS de vérification arrivent généralement en moins de 30 secondes; les tentatives échouées peuvent prendre jusqu'à 5 minutes avant de renvoyer.

Extraction du code OTP

Le corps du SMS varie selon le service mais le code est toujours un nombre de 4 à 8 chiffres. La plupart des agents utilisent une regex comme /\b\d{4,8}\b/ pour extraire. Pour une fiabilité plus élevée, laissez le LLM lire le texte et retourner juste le code — Claude ou GPT-4o traitent cela en millisecondes.

Authentification et sécurité

Chaque POST webhook est signé avec HMAC-SHA256. Vérifiez X-MeiSIM-Signature en utilisant votre secret API pour confirmer que la requête provient vraiment de nous, et non d'un usurpateur. Exemple de code dans la documentation API.

Construisez ce soir

Clé API + 5 premiers numéros gratuits. Envoyez-nous un email et nous vous configurerons.

Email →

FAQ

À quelle vitesse un SMS arrive-t-il à mon webhook?

Médiane <3 secondes. Retry en cas d'échec avec backoff exponentiel. Messages conservés 30 jours pour fallback polling.

Puis-je juste faire du polling au lieu de webhook?

Oui. GET /v1/numbers/{id}/messages, optionnellement avec since=ISO. La plupart des agents font du polling toutes les 2-3s pendant les attentes de vérification.

Puis-je recevoir depuis les courts codes (5 chiffres)?

Oui — c'est la principale raison de passer à des numéros réels. La plupart des SMS de vérification des banques/crypto/applis de rencontre viennent des courts codes, et VoIP les bloque.

Et pour les MMS (avec images)?

SMS seulement pour le moment. Les MMS sont sur la feuille de route.

Supportez-vous plusieurs webhooks par numéro?

Un webhook par numéro. Pour la distribution, routez via votre propre dispatcher.

Quelle est la différence entre webhook et polling?

Webhook: MeiSIM vous pousse le SMS immédiatement en POST. Polling: vous interrogez /messages régulièrement. Webhooks plus rapides; polling plus simple.

Combien de temps les messages sont-ils conservés?

30 jours. Vous pouvez les récupérer via polling même si votre webhook a échoué.

Que se passe-t-il si mon webhook est trop lent?

Si vous ne répondez pas HTTP 200 en 10 secondes, nous retentons avec backoff. Traitez rapidement.

Comment vérifier la signature HMAC?

Chaque POST inclut X-MeiSIM-Signature avec HMAC-SHA256. Vérifiez-la avec votre secret API pour confirmer l'authenticité.

Quels services fonctionnent avec cette API?

Cash App, Coinbase, Tinder, Bumble, PayPal, Stripe, Amazon, eBay, Uber, services bancaires, Discord, WhatsApp, Telegram, et la plupart des 2FA. Les numéros réels passent où VoIP échoue.

Quelle est la latence typique?

Les codes arrivent généralement en 30 secondes. Webhook médiane <3 secondes. Tentatives échouées jusqu'à 5 minutes.

Comment extraire le code OTP?

Utilisez regex /\b\d{4,8}\b/ ou appelez un LLM. Les LLM sont plus fiables pour les formats complexes.

Puis-je changer l'URL webhook après?

Oui, via PATCH /v1/numbers/{id}. Mettez à jour l'URL sans reprendre le numéro.

Y a-t-il des frais cachés?

Non. 5 numéros gratuits. Après, tarification transparente par numéro et SMS — voir nos tarifs.

Puis-je vérifier en masse?

Oui. Créez des dizaines ou centaines de numéros en parallèle. Chacun a son webhook et sa file.

Fonctionne avec LangChain ou CrewAI?

Oui. L'API est indépendante du framework. Intégrez via SDK ou appels HTTP directs.