GRATIS 2 richieste/anno
0,004 € + IVA
Chiamate GRATUITE
Invia SMS di Alta Qualità in tutto il mondo, in modalità singola o multipla e con report di consegna.
SMS via API è il servizio che consente di inviare in tutto il mondo SMS certificati, di alta qualità e professionali, con mittente personalizzato e report di consegna.
L'SMS è il primo canale di comunicazione mobile, che offre la certezza di ricezione del messaggio anche in mancanza di copertura di rete. Per questa ragione rappresenta lo strumento ideale per comunicazioni real time e sicure come alert, messaggi transazionali, autenticazione a due fattori, disponibilità referti.
Il service di Openapi consente di inviare velocemente lo stesso messaggio ad uno o più destinatari.
Il metodo POST/messages consente di inviare uno o più messaggi sms direttamente dal gateway di Openapi.
POST/messages
Questo è un esempio di richiesta:
{
"test": false,
"sender": "alberto",
"body": "test invio",
"recipients": "+39-349xxxxx18"
}
POST/messages
La risposta restituisce i dettagli dell'invio appena effettuato:
{
"data": [
{
"test": false,
"sender": "alberto",
"body": "test invio",
"recipients": {
"valid": {
"count": 1
},
"invalid": {
"total": 0,
"list": []
}
},
"transaction": false,
"options": {
"flash": false,
"realtime": false,
"timestamp_send": "1564752494920"
},
"statistics": {
"error": 0,
"sent": 0,
"delivered": 0,
"total": 1,
"sms_total": 1
},
"base_price": 0.0315,
"timestamp": "1564752494920",
"last_update": "1564752494920",
"priority": 1,
"price": 0.0315,
"state": 0,
"id": "5d443a6e9f2725660f3db347"
}
],
"message": "Message Queued",
"credit": "90.90849999999988",
"success": true,
"error": null
}
Tramite l'endpoint GET/messages è possibile verificare in qualsiasi momento la lista di tutti gli SMS inviati.
{
"data": [
{
"sender": "alberto",
"timestamp": "1564411330117",
"id": "5d3f05c29f2725610c2b4e60"
},
{
"sender": "3939989741",
"timestamp": "1563554978976",
"id": "5d31f4a29f27257de166d960"
},
{
"sender": "3939989741",
"timestamp": "1562686328690",
"id": "5d24b3789f27257de1645bda"
},
{
"sender": "Nome del mittente",
"timestamp": "1562142688118",
"id": "5d1c67e09f27255e2f4079a3"
},
{
"sender": "Nome del mittente",
"timestamp": "1562142398400",
"id": "5d1c66be9f272563102e8045"
}
],
"success": true,
"message": "5 Results",
"credit": "91.00299999999986",
"error": null
}
Il metodo il GET /messages/{id} permette di ottenere tutte le informazioni sul messaggio inviato, es. mittente, contenuto, numero destinatari, statistiche generali di consegna, costi.
{
"data": [
{
"test": false,
"sender": "Simone",
"body": "Production test 4 ",
"recipients": {
"valid": {
"count": 1
},
"invalid": {
"total": 0,
"list": []
}
},
"priority": 1,
"options": {
"flash": true,
"realtime": true,
"timestamp_send": "326152800000",
"custom": {
"test": 123,
"best": 321,
"trest": [
12,
3,
12,
3
]
},
"callback_url": "https://test.ws.messaggisms.com/callbackTest.php"
},
"transaction": false,
"statistics": {
"error": 0,
"sent": 1,
"delivered": 1,
"total": 1,
"sms_total": 1
},
"base_price": 0.03,
"timestamp": "1559743507600",
"last_update": "1559743510156",
"price": 0.036,
"state": 2,
"id": "5cf7cc139f272546624d3795"
}
],
"message": "1 Result",
"credit": "90.97149999999986",
"success": true,
"error": null
}
GET /messages/{id}/recipients
Con GET /messages/{id}/recipients, a partire dall'id del messaggio, si può risalire ai dati del o dei destinatari di un SMS, come ad esempio numero, prefisso, testo ricevuto, stato invio e descrizione.
{
"data": [
{
"number": "+39-3xxxxx5018",
"prefix": "+39",
"send_id": "5e5e65429f272510fb6adcc0_0",
"body": "test summary2",
"sms": 1,
"remaining_chr": 147,
"state": "DELIVERED",
"state_description": "DELIVERED_TO_HANDSET",
"price": 0.03,
"fields": [],
"message_id": "5e5e65429f272510fb6adcc0",
"i": 0,
"state_detail": "Message delivered to handset",
"timestamp_sent": {
"$date": {
"$numberLong": "1583244661371"
}
},
"real_cost": 0.03,
"report": {
"price": {
"pricePerMessage": 0.03,
"currency": "EUR"
},
"status": {
"id": 5,
"groupId": 3,
"groupName": "DELIVERED",
"name": "DELIVERED_TO_HANDSET",
"description": "Message delivered to handset"
},
"error": {
"id": 0,
"name": "NO_ERROR",
"description": "No Error",
"groupId": 0,
"groupName": "OK",
"permanent": false
},
"messageId": "5e5e65429f272510fb6adcc1",
"doneAt": "2020-03-03T15:11:03.168+0100",
"smsCount": 1,
"sentAt": "2020-03-03T15:11:01.467+0100",
"to": "393495155018"
},
"timestamp_delivery": {
"$date": {
"$numberLong": "1583244663000"
}
},
"id": "5e5e65429f272510fb6adcc1"
}
],
"message": "1 Result",
"credit": 90.20949999999985,
"success": true,
"error": null
}
Il metodo GET /messages/{id}/recipients/{number} consente di verificare gli stessi dati ma di uno specifico destinatario.
{
"data": [
{
"number": "+39-3xxxxx5018",
"prefix": "+39",
"send_id": "5e5e65429f272510fb6adcc0_0",
"body": "test summary2",
"sms": 1,
"remaining_chr": 147,
"state": "DELIVERED",
"state_description": "DELIVERED_TO_HANDSET",
"price": 0.03,
"fields": [],
"message_id": "5e5e65429f272510fb6adcc0",
"i": 0,
"state_detail": "Message delivered to handset",
"timestamp_sent": {
"$date": {
"$numberLong": "1583244661371"
}
},
"real_cost": 0.03,
"report": {
"price": {
"pricePerMessage": 0.03,
"currency": "EUR"
},
"status": {
"id": 5,
"groupId": 3,
"groupName": "DELIVERED",
"name": "DELIVERED_TO_HANDSET",
"description": "Message delivered to handset"
},
"error": {
"id": 0,
"name": "NO_ERROR",
"description": "No Error",
"groupId": 0,
"groupName": "OK",
"permanent": false
},
"messageId": "5e5e65429f272510fb6adcc1",
"doneAt": "2020-03-03T15:11:03.168+0100",
"smsCount": 1,
"sentAt": "2020-03-03T15:11:01.467+0100",
"to": "393495155018"
},
"timestamp_delivery": {
"$date": {
"$numberLong": "1583244663000"
}
},
"id": "5e5e65429f272510fb6adcc1"
}
],
"message": "1 Result",
"credit": 90.20949999999985,
"success": true,
"error": null
}
Tramite l'API SMS è consentito anche modificare la data di invio di un SMS pianificato, tramite l'endpoint PUT/messages/{id} ed il valore timestamp_send. Nel caso in cui l'SMS non sia stato già inviato, è possibile cancellarlo tramite l'endpoint DELETE/messages/{id}.
Gateway SMS è stato integrato spesso per remind appuntamenti o comunicazioni scolastiche, aziendali, di pubblica utilità, marketing e flussi di onboarding/attivazioni per piattaforme.
Il service consente di inviare anche gli SMS Flash, messaggi che non è necessario aprire ma sono visualizzabili direttamente sul display dello smartphone.
Con l'API SMS è possibile inoltre rendere ancora più immediato l'invio impostando una priorità maggiore o selezionando l'opzione "realtime", molto utile per l'invio degli OTP. L'importo dell'opzione realtime ha una maggiorazione del costo del singolo SMS del 20%, mentre il costo della priorità dipende dal valore impostato, che diviene moltiplicatore del costo dell'SMS.
I prezzi di invio degli SMS possono cambiare a seconda del paese di destinazione. Per l'elenco completo dei costi ti invitiamo a consultare la sezione dedicata in Console.
Hai bisogno di aiuto?
Non hai trovato la risposta che cercavi?
Compila tutti i campi, ti ricontatteremo al più presto!
SMS via API è un servizio che consente di inviare SMS certificati, di alta qualità e professionali a livello globale. Permette di personalizzare il mittente e offre report di consegna dettagliati per ogni messaggio inviato.
L’SMS API offre alta scalabilità, tempi di invio rapidi e integrazione semplice con i tuoi sistemi. Ti consente di automatizzare l'invio di messaggi e di personalizzare i contenuti per ogni destinatario. Con lo stesso endpoint potrai inviare SMS a livello globale (in ogni paese del mondo), inoltre è possibile inviarli a destinatari singoli o multipli.
Sì, l'API dispone di un endpoint dedicato per monitorare lo stato di ciascun messaggio. Grazie a questa funzionalità, puoi ottenere informazioni dettagliate sui messaggi inviati, come i destinatari, lo stato di consegna e le statistiche complessive.
Si, puoi visualizzare tutte le informazioni di un messaggio specifico, come il mittente, il contenuto, il numero di destinatari, lo stato di consegna e il costo. È semplice e ti permette di tenere traccia di tutti i dettagli.
Sì, il servizio SMS API supporta l'invio di SMS in tutto il mondo. I prezzi variano a seconda del paese di destinazione e possono essere consultati nella sezione dedicata della Console.
Sì, il servizio API SMS è perfetto per l'invio di codici OTP (One-Time Password). Grazie alla sua rapidità e affidabilità, puoi garantire l'autenticità delle transazioni e l'accesso sicuro agli utenti. Puoi integrare l'API nelle tue piattaforme per inviare automaticamente codici OTP in tempo reale, con conferma di consegna e dettagli sullo stato dell'invio.
Gli SMS Flash sono messaggi che vengono visualizzati direttamente sul display dello smartphone senza necessità di aprirli. Questa funzionalità è supportata dall'API e può essere attivata tramite le opzioni di invio.
Il servizio SMS può essere utilizzato per vari scopi, tra cui:
Oltre alla "priority" è possibile utilizzare l'opzione “realtime” che rende immediato l'invio degli SMS. È la soluzione ottimale per quelle comunicazioni che devono essere inviate e ricevute in pochi secondi, come ad esempio l'invio degli OTP.
Il costo per una singola richiesta parte da €0,004. I prezzi per l'invio degli SMS variano in base al Paese di destinazione. Per consultare l'elenco completo dei costi, ti invitiamo a visitare la sezione Prezzi sul portale CONSOLE.