SMS

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.

Evasione

In tempo reale

API

SMS

Disponibile in
  • gz

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.

INVIO SMS

Il metodo POST/messages consente di inviare uno o più messaggi sms direttamente dal gateway di Openapi.

ESEMPIO RICHIESTA

POST/messages

Questo è un esempio di richiesta:

{
  "test": false,
  "sender": "alberto",
  "body": "test invio",
  "recipients": "+39-349xxxxx18"
}

ESEMPIO RISPOSTA

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
}

VERIFICA LISTA SMS INVIATI

GET /messages

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
}

OTTENERE INFORMAZIONI SUL MESSAGGIO INVIATO

GET /messages/{id}

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
   
}

VERIFICA DATI DEI DESTINATARI

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
}

VERIFICA DATI DI UN SINGOLO DESTINATARIO

GET /messages/{id}/recipients/{number}

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.

Registrati

Hai bisogno di aiuto?

Non hai trovato la risposta che cercavi?

Compila tutti i campi, ti ricontatteremo al più presto!

Domande frequenti

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.

Cos’è l’SMS API e a cosa serve?

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.

Quali sono i principali vantaggi dell’SMS API?

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.

È possibile monitorare lo stato dei messaggi inviati?

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.

Posso ottenere informazioni dettagliate su un messaggio inviato?

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.

Posso inviare SMS a livello internazionale?

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.

È possibile utilizzare il servizio API SMS per l'invio di codici OTP?

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.

Cosa sono gli SMS Flash e come posso utilizzarli?

Il servizio SMS può essere utilizzato per vari scopi, tra cui:

  • Alert e notifiche transazionali.
  • Autenticazione a due fattori.
  • Promemoria per appuntamenti.
  • Comunicazioni scolastiche, aziendali o di pubblica utilità.
  • Marketing.
  • Flussi di onboarding o attivazione su piattaforme.
Per chi è pensato il servizio SMS?

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.

È possibile inviare gli SMS in tempo reale?

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.

Quali sono i costi del servizio SMS?