Un'API SMS è un'interfaccia di programmazione che permette al tuo software di inviare e ricevere messaggi di testo tramite un fornitore: fai una richiesta HTTP (o apri una connessione SMPP) con numero, mittente e testo, e il fornitore consegna il messaggio e ti restituisce l'esito. È il modo in cui le app inviano codici OTP, alert e notifiche senza alcuna infrastruttura telecom propria.
Cos'è un'API SMS?
Un'API SMS espone agli sviluppatori il gateway SMS di un fornitore. La maggior parte sono API REST su HTTPS: ti autentichi con una API key o un token, invii il messaggio con una POST e ricevi un ID del messaggio. Il fornitore si occupa dell'instradamento verso gli operatori, della codifica, della suddivisione dei messaggi lunghi e dei report di consegna. Molti fornitori offrono anche SMPP per chi invia grandi volumi. Il sistema dietro l'API è spiegato in cos'è un gateway SMS.
Come funziona un'API SMS?
- Autenticazione. Ogni richiesta porta una API key, un bearer token o credenziali basic.
- Invio della richiesta. Di solito una POST con il numero di destinazione in formato E.164, un sender ID o un numero, il testo del messaggio e, se vuoi, un URL di callback.
- Ricezione di un ID. L'API restituisce un ID del messaggio (o un errore come numero non valido o credito insufficiente).
- Il fornitore instrada il messaggio verso l'operatore di destinazione, direttamente o tramite un aggregatore.
- Ricezione dello stato. I report di consegna arrivano al tuo webhook a ogni cambio di stato: in coda, inviato, consegnato, fallito, con un codice di errore.
- Ricezione delle risposte. Gli SMS in entrata verso il tuo numero o short code vengono inviati a un altro webhook.
Una tipica richiesta di invio, in parole semplici: to = +447700900123, from = YourBrand, text = "Your code is 482917", callback = il tuo URL di stato. I nomi dei campi cambiano da fornitore a fornitore. Salva i numeri nel formato internazionale descritto in formato dei numeri E.164.
Integrazione di un'API SMS: passo dopo passo
- Scegli il protocollo. HTTP per la maggior parte delle app; SMPP se invii grandi volumi o rivendi. Vedi SMPP e HTTP per gli SMS.
- Registra i mittenti. Prima di andare in produzione, registra sender ID, numeri o template nei paesi che lo richiedono. Vedi registrazione del sender ID SMS.
- Tieni segrete le chiavi. Chiama l'API dal tuo server, mai da un'app mobile o dal browser, così la chiave non può essere estratta.
- Gestisci i webhook. Verifica le firme se il fornitore le offre, rispondi in fretta ed elabora in modo asincrono.
- Gestisci errori e tentativi. Ripeti con backoff in caso di errori di rete e temporanei; non ripetere sugli errori permanenti come numero non valido.
- Controlla codifica e lunghezza. Resta in GSM-7 quando possibile. Vedi GSM-7 e Unicode.
- Proteggi ciò che fa partire gli invii. Limita la frequenza su ogni modulo pubblico che invia SMS, per fermare l'SMS pumping.
- Prova su telefoni reali in ogni paese di destinazione prima del lancio. Vedi come testare una rotta SMS.
Cos'è la API key SMS?
La API key SMS è la credenziale segreta che identifica il tuo account in ogni richiesta. Chiunque la possieda può inviare messaggi fatturati a te, quindi trattala come una password: conservala in variabili d'ambiente o in un secrets manager, limitala per IP dove il fornitore lo consente, ruotala periodicamente e revocala subito se trapela.
Cosa cercare in un'API SMS per sviluppatori
| Area | Cosa controllare |
|---|---|
| Qualità delle rotte | Quali rotte ci sono dietro l'API nei tuoi paesi, e se i report di consegna arrivano dagli operatori |
| Report di consegna | Webhook con stati e codici di errore chiari. Vedi codici di stato dei DLR SMS |
| Documentazione e SDK | Esempi chiari, sandbox o modalità di test, librerie per il tuo linguaggio |
| Limiti | Richieste al secondo, lunghezza dei messaggi, endpoint per invii massivi |
| Supporto alla compliance | Aiuto con la registrazione di sender ID, 10DLC, DLT e template |
| Controlli antifrode | Liste di paesi consentiti, limiti di frequenza, alert di spesa |
| Modello di prezzo | Per parte di messaggio e per paese, fatturato sull'inviato o sul consegnato |
Altri criteri in come scegliere un fornitore di SMS A2P.
Quanto costa un'API SMS?
Il prezzo di un'API SMS è quasi sempre per parte di messaggio, fissato per paese di destinazione, perché le tariffe di terminazione degli operatori sono la parte principale del costo. Alcuni fornitori aggiungono canoni mensili per numeri o sender ID. L'API più economica non è sempre la più economica per messaggio consegnato: vedi come funzionano i prezzi degli SMS.
Le rotte dietro la tua API SMS
Se gestisci una piattaforma o un'API tua e ti servono rotte a monte, VoIPMatcher procura dai suoi carrier rotte SMS A2P via HTTP e SMPP e le gestisce. Richiedi una rotta SMS per la tua API.
Domande frequenti
Che differenza c'è tra un'API SMS e un gateway SMS?
Il gateway SMS è il sistema che instrada i messaggi verso le reti mobili; l'API SMS è l'interfaccia che gli sviluppatori usano per raggiungerlo. Quando si confrontano le API SMS, in realtà si confrontano il gateway, le rotte e il supporto dietro ciascuna API, più la qualità di documentazione e strumenti.
Posso inviare SMS dal mio sito web con un'API?
Sì. Il backend del tuo sito chiama l'API SMS per inviare messaggi come conferme d'ordine, promemoria o codici di verifica. Fai la chiamata dal server, mai dal codice nel browser, così la API key resta segreta. Proteggi ogni modulo pubblico che fa partire SMS con rilevamento dei bot e limiti di frequenza per evitare abusi.
Esiste un'API SMS gratuita?
Alcuni fornitori offrono credito di prova gratuito o modalità sandbox per i test, ma inviare SMS veri costa sempre, perché gli operatori mobili fanno pagare ogni messaggio consegnato. I servizi che promettono invii SMS gratuiti per sempre si basano di solito su rotte non autorizzate o pubblicità, il che rende la consegna inaffidabile e inadatta all'uso aziendale.
Un'API SMS può ricevere messaggi?
Sì, se hai un numero o uno short code che accetta SMS in entrata. Il fornitore inoltra ogni messaggio ricevuto al tuo webhook con mittente, testo e orario. Questo permette usi bidirezionali come risposte, disiscrizioni con parole chiave come STOP e conversazioni di assistenza. I sender ID alfanumerici non possono ricevere risposte.
Quanto tempo richiede l'integrazione di un'API SMS?
Un'integrazione di base che invia un messaggio e gestisce i report di consegna può richiedere a uno sviluppatore poche ore con un'API REST ben documentata. Arrivare alla produzione richiede di più: registrazione di sender ID e template in ogni paese, gestione degli errori, tentativi ripetuti, gestione delle disiscrizioni, monitoraggio e controlli antifrode possono aggiungere da giorni a settimane, a seconda dei paesi.
Ti serve una rotta?
Mandaci destinazione, tipo di rotta e tariffa target. Ti rispondiamo con quello che possiamo offrirti.