SMS

  • Openapi Erogazione : Immediata
  • Openapi a partire da € 0,038 + iva

Integra il servizio di invio SMS per autenticazione, notifiche, remind alla tua piattaforma tramite API.

Invia SMS di Alta Qualità in tutto il mondo, in modalità singola o multipla e con report di consegna. L'invio può avvenire in tempo reale o pianificato.

Vai alla Documentazione
Esempio SMS

SMS, il primo canale di comunicazione mobile, offre la certezza di ricezione del messaggio anche in mancanza di copertura del traffico mobile. Per questa ragione l'SMS rappresenta lo strumento ideale per comunicazioni real time e sicure come alert, messaggi transazionali, autenticazione a due fattori, disponibilità referti.

Con SMS è possibile inviare in tutto il mondo ed esclusivamente SMS certificati, di alta qualità e professionali con mittente personalizzato e report di consegna. 

Il service consente di inviare lo stesso messaggio ad uno o più destinatari. 

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

 

È possibile in qualsiasi momento verificare la lista di tutti gli SMS inviati con il GET /messages/

 

{
  "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
}

 

Inoltre tramite il GET /messages/{id} si possono ottenere tutte le informazioni sull'invio del messaggio come 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
   
}

 

Con GET /messages/{id}/recipients/, invece, a partire dall'id del messaggio si ottengono i dati del o dei destinatari di un SMS come 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
}

 

Con GET /messages/{id}/recipients/{number} sarà poi possibile ottenere 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
}

 

Si può 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 anche 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.

L'API SMS 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", così da rendere l'invio immediato. 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.