# Come si invia un SMS tramite API? > L'invio di un SMS tramite un'API HTTP significa passare il numero di destinazione, l'ID del mittente e il testo del messaggio a un endpoint REST che inoltra il messaggio alle reti degli operatori e restituisce un ID del messaggio che è possibile tracciare per la consegna. - URL canonico: https://www.broadnet.me/it/answers/how-to-send-sms-via-api - Lingua: it - Ultima revisione: 2026-09-24 - Editore: BroadNet (https://www.broadnet.me) ## La richiesta Il gateway di BroadNet accetta una richiesta POST a https://api.broadnet.me/sms/sendSms con un token nell'header Authorization: Bearer e un corpo JSON: senderId (l'ID mittente), destinationNumber (il numero di destinazione in formato internazionale, solo cifre, senza segno +), message (il testo) e messageType (TEXT per GSM-7, UNICODE per arabo, emoji e altri alfabeti non latini). Una chiamata riuscita restituisce 200 OK con l'ID del messaggio nel corpo della risposta. ## Codifica e lunghezza Un messaggio GSM-7 contiene 160 caratteri per segmento (153 quando si estende su più segmenti); passando a Unicode per emoji o alfabeti non latini il limite scende a 70 (67 nei messaggi concatenati). Imposta messageType su TEXT per il GSM-7 semplice e su UNICODE quando il testo richiede Unicode o l'arabo, così i caratteri non vengono corrotti; POST /sms/identify restituisce codifica e numero di segmenti prima dell'invio. ## Traccia la consegna, non dare per scontato che L'ID del messaggio restituito è l'identificativo per le conferme di consegna (DLR). Configura un webhook per ricevere lo stato finale dell'operatore (consegnato, non riuscito o scaduto) anziché considerare un codice 200 all'invio come prova che il dispositivo mobile ha ricevuto il messaggio. ## Passaggio alla produzione Utilizza numeri E.164 internazionali, registra il tuo ID mittente in ogni mercato di destinazione prima di scalare e invia tramite rotte dirette dell'operatore per una latenza costante. Per volumi elevati, lo stesso account è raggiungibile sia tramite SMPP che REST, quindi puoi iniziare con HTTP e cambiare tipo di autenticazione senza dover ripetere la procedura di onboarding. ## Domande frequenti ### Posso inviare un SMS con una richiesta GET, oppure devo utilizzare una richiesta POST? Usa POST. L'endpoint REST POST /sms/sendSms accetta un corpo JSON e un token Bearer, quindi il testo del messaggio e le credenziali non compaiono mai negli URL o nei log del server. L'API HTTP legacy (/websmpp/websms) accetta ancora GET per le integrazioni esistenti dell'era SMPP, ma le nuove integrazioni dovrebbero usare l'API REST. ### Ho bisogno di SMPP o l'API HTTP è sufficiente? L'API REST/HTTP è sufficiente per la maggior parte dei volumi ed è la più veloce da integrare. SMPP è più adatto a throughput sostenuti molto elevati e connessioni persistenti. Lo stesso account BroadNet funziona su entrambi i protocolli, quindi è possibile iniziare con HTTP e aggiungere SMPP in seguito senza dover effettuare una nuova configurazione. ### Come faccio a sapere se un messaggio è stato effettivamente consegnato? L'invio restituisce un ID messaggio; lo stato finale del dispositivo arriva in modo asincrono come ricevuta di consegna (DLR) sul tuo webhook: consegnato, non riuscito o scaduto. Non considerare la risposta di invio come prova di consegna. ## Correlati - [Tutte le risposte](https://www.broadnet.me/it/answers) - [Glossario](https://www.broadnet.me/it/answers) - [Che cos'è un'API SMS?](https://www.broadnet.me/it/answers/what-is-sms-api) - [Che cos'è un SMS A2P?](https://www.broadnet.me/it/answers/what-is-a2p-sms) - [Che cos'è una DLR (ricevuta di consegna)?](https://www.broadnet.me/it/answers/what-is-dlr) - [Come posso migliorare il tasso di consegna degli SMS?](https://www.broadnet.me/it/answers/how-to-improve-sms-delivery-rates) - [SMS API](https://www.broadnet.me/it/products/sms-api) - [A2P SMS](https://www.broadnet.me/it/products/a2p-sms)