API SMS per chatbot e agenti IA
Il tuo agente IA ha bisogno di un numero di telefono che possa ricevere codici di verifica SMS da Cash App, Coinbase, Tinder, app bancarie o qualsiasi flusso di autenticazione a due fattori. I numeri Twilio VoIP vengono rifiutati dalla maggior parte dei servizi.
Il tuo agente IA ha bisogno di un numero di telefono che possa ricevere codici di verifica SMS da Cash App, Coinbase, Tinder, app bancarie o qualsiasi flusso di autenticazione a due fattori. I numeri Twilio VoIP vengono rifiutati dalla maggior parte dei servizi. Qui ti mostriamo come collegare un chatbot o agente IA per ricevere SMS reali tramite l'API webhook di MeiSIM USA con latenza inferiore a 3 secondi.
Ottieni una chiave API
5 numeri gratuiti. Consegna webhook in meno di 3 secondi.
Il flusso in sintesi
- Il tuo agente chiama
POST /v1/numbers/provisioncon un URL webhook. - ~60 secondi dopo, il tuo agente ha un numero telefonico USA reale (eSIM QR + ICCID + LPA vengono restituiti nella risposta).
- L'agente usa il numero per registrarsi su Cash App, Coinbase, ecc.
- Il servizio di registrazione invia un SMS di verifica al numero.
- MeiSIM riceve l'SMS tramite la rete del carrier (~1 secondo).
- MeiSIM invia il messaggio al tuo webhook URL (~1-2 secondi in più).
- Il tuo agente legge il corpo del messaggio, estrae il codice, completa la registrazione.
Contratto webhook
Inviamo un corpo JSON al tuo URL. Tu restituisci HTTP 200 entro 10 secondi per riconoscere la ricezione. Se fallisci o scade il tempo, ripetiamo con backoff (immediatamente, +15s, +60s, +300s — totale 4 tentativi in 6 minuti). I messaggi sono anche interrogabili tramite l'endpoint dei messaggi per 30 giorni.
Fallback con polling
Se preferisci fare polling piuttosto che mantenere un endpoint webhook (comune per gli agenti stateless), chiama:
La maggior parte degli agenti IA fa polling ogni 2-3 secondi durante l'attesa di una verifica. I codici SMS di verifica normalmente arrivano entro 30 secondi; i tentativi falliti richiedono fino a 5 minuti prima che il servizio riprovi.
Estrazione del codice OTP
Il corpo del messaggio SMS varia a seconda del servizio, ma il codice è sempre un numero da 4 a 8 cifre. La maggior parte degli agenti usa un'espressione regolare come /\b\d{4,8}\b/ per estrarre il codice. Per una maggiore affidabilità, fai leggere il testo al tuo modello linguistico (LLM) e restituisci solo il codice — Claude o GPT-4o lo gestiscono in millisecondi.
Autenticazione e sicurezza
Ogni POST webhook è firmato con HMAC-SHA256. Verifica X-MeiSIM-Signature usando il tuo API secret per confermare che la richiesta viene effettivamente da noi, non da un impostore. Troverai codici di esempio nella documentazione API.
Costruiscilo stasera
Chiave API + primi 5 numeri gratuiti. Contattaci e ti configureremo.
Domande frequenti
Quanto velocemente arriva un SMS al mio webhook?
Latenza mediana inferiore a 3 secondi. Ripetiamo in caso di fallimento con backoff esponenziale. I messaggi vengono conservati per 30 giorni per il fallback tramite polling.
Posso fare solo polling invece di usare webhook?
Sì. Usa GET /v1/numbers/{id}/messages, opzionalmente con since=ISO. La maggior parte degli agenti fa polling ogni 2-3 secondi durante l'attesa di verifica.
Posso ricevere SMS da brevi codici (5 cifre)?
Sì — questo è il motivo principale per passare ai numeri reali da carrier. La maggior parte degli SMS di verifica da banche/criptovalute/app di dating proviene da brevi codici e VoIP li blocca.
E per gli MMS (con immagini)?
Solo SMS per ora. Gli MMS sono nella roadmap.
Supportate più webhook per numero?
Un webhook per numero. Per distribuire a più destinazioni, inoltrate tramite il vostro dispatcher interno.
Come verifico la firma HMAC del webhook?
Usa l'header X-MeiSIM-Signature e il tuo API secret. La firma è calcolata come HMAC-SHA256 del corpo della richiesta.
Qual è il costo per usare l'API SMS?
I primi 5 numeri sono gratuiti. Consulta la pagina dei piani per i prezzi dei numeri aggiuntivi e dei volumi di SMS.
Posso ricevere SMS da numeri internazionali?
Sì, il tuo numero USA reale riceve SMS da qualsiasi numero nel mondo, inclusi numeri internazionali, brevi codici e linee aziendali.
Per quanto tempo rimane valido un numero provisioned?
Finché continui a pagare l'abbonamento mensile. I numeri non utilizzati per 90 giorni possono essere disattivati.
Funziona con agenti IA come Claude, GPT-4o o altri LLM?
Perfetto. Integra l'API nei tuoi agenti IA per automatizzare completamente il flusso di verifica SMS.
Qual è la differenza tra webhook e polling?
Webhook è più rapido e reattivo (~3 sec totali). Polling è più affidabile se hai problemi di connettività e richiede meno infrastruttura lato server.
I messaggi SMS contengono metadati aggiuntivi?
Sì. Ricevi il numero di provenienza (from), il timestamp di ricezione (received_at), l'ID del numero (number_id) e il corpo completo del messaggio.
Cosa succede se il webhook rimane offline per un po'?
MeiSIM conserva i messaggi per 30 giorni. Puoi recuperarli tramite polling su /v1/numbers/{id}/messages quando il webhook è di nuovo online.
È possibile ricevere SMS da app italiane o europee?
I numeri USA ricevono SMS da tutto il mondo, incluse app italiane ed europee che inviano codici di verifica. Funziona perfettamente.