Development

Gestisci le tue campagne SMS con un’API flessibile

Disporre di diverse opzioni quando pianifichi i tuoi messaggi è un fattore rilevante quando metti in atto le tue strategie di comunicazione.

August 10 2017

undefined

Ottimizza i tuoi processi di marketing e informa i clienti sulle ultime promozioni al momento giusto facendo una programmazione e indicando un periodo di validità, ma non limitarti a questo. Utilizza la riprogrammazione e aggiorna lo stato del messaggio per permettere alla tua impresa di rispondere in modo ancora più adeguato alle richieste dei clienti. La programmazione, assieme ad altre azioni, può essere impostata tramite l’interfaccia web del portale Infobip o tramite la nostra API SMS.

Puoi utilizzare vari canali per assicurarti che i clienti siano ben informati e soddisfatti, ma se il tuo canale preferito è rappresentato dagli SMS, sai già quanto sia importante sviluppare una buona campagna di marketing e programmare i messaggi da consegnare al momento più opportuno per i clienti.

RIPROGRAMMAZIONE DEI MESSAGGI DI MASSA CON API SMS

Se stai già utilizzando l’API SMS di Infobip per inviare delle campagne SMS ai tuoi clienti, questi metodi ti consentiranno di avere un maggior controllo sui messaggi che invii. Sarai in grado di modificare il programma di consegna, lo stato dei messaggi e impostare il periodo di validità.

Per modificare il momento di invio dei messaggi, è possibile utilizzare la funzione di riprogrammazione. La riprogrammazione (e l’annullamento) dei messaggi di massa viene effettuata quando una richiesta SMS avanzata contiene un solo messaggio per gruppo e il messaggio “bulkId” è univoco. Se non fornisci un “bulkId” tramite la richiesta di invio SMS iniziale, il sistema creerà un ID univoco e lo inserirà come “bulkId” nella risposta. L’ID può essere utilizzato in seguito, quando avrai bisogno di recuperare le informazioni di consegna, modificare lo stato, la data o l’ora della consegna del messaggio. Inoltre, è importante sottolineare che i messaggi multipli in un’unica richiesta di invio di massa non possono essere aggiornati perché ogni messaggio può contenere una diversa data e ora di consegna e avere uno stato diverso.

Per avviare la riprogrammazione dei messaggi, è necessario inserire una richiesta JSON con un “bulkId”:

PUT /sms/1/bulks?bulkId=a6e6bf50-ade1-4dd5-8900-d5b3bb18c0cc HTTP/1.1

Host: api.infobip.com
Authorization: Basic QWxhZGRpbjpvcGVuIHNlc2FtZQ==
Content-Type: application/json
{
    "sendAt": "2021-08-25T16:00:00.000+0000"
}

La risposta a questa richiesta sarà:

{
  "bulkId": "a6e6bf50-ade1-4dd5-8900-d5b3bb18c0cc",
  "sendAt": "2021-08-26T16:00:00.000+0000"
}

2015-07-07T17:00:00.000+01:00 è il formato data/ora per la programmazione e riprogrammazione degli SMS.

AGGIORNARE LO STATO DEL MESSAGGIO

A volte aggiornare lo stato del messaggio può essere utile e può essere utilizzato per mettere in pausa, riprendere e/o annullare i messaggi programmati.

Lo stato “IN SOSPESO” può essere aggiornato con: “IN PAUSA” e “ANNULLATO”, mentre “IN PAUSA” può essere aggiornato con “IN SOSPESO” o “ANNULLATO”.

Gli stati “IN SOSPESO” e “IN PAUSA” possono essere modificati a piacimento prima che il messaggio inizi a essere elaborato o, per essere più precisi, quando l’orario programmato è trascorso e il messaggio è stato inviato. Tuttavia, se lo stato del messaggio viene modificato in “ANNULLATO”, il messaggio non potrà essere riprogrammato o aggiornato con un nuovo stato e risulterà pertanto non consegnato.

Puoi aggiornare facilmente lo stato dei messaggi. Se vuoi aggiornare lo stato del messaggio con “IN PAUSA”, puoi farlo con una semplice richiesta JSON:

PUT /sms/1/bulks/status?bulkId=a6e6bf50-ade1-4dd5-8900-d5b3bb18c0cc HTTP/1.1

Host: api.infobip.com
Authorization: Basic b25lYXBpOnRoZUJveA==
Content-Type: application/json

{
    "status": "PAUSED"
}

Con una risposta JSON:

{

  "bulkId": "a6e6bf50-ade1-4dd5-8900-d5b3bb18c0cc",
  "status": "PAUSED"
}

IMPOSTARE IL PERIODO DI VALIDITÀ

Oltre alla riprogrammazione e all’aggiornamento dello stato dei messaggi, anche il periodo di validità può rivelarsi molto utile. Questo può essere impostato mentre si invia un messaggio testuale articolato. Può essere impostato per un periodo massimo di 48 ore e anche se inserisci un intervallo di tempo maggiore, impostiamo il periodo automaticamente a 48 ore.

Per impostare il periodo di validità devi postare una richiesta JSON:

POST /sms/1/text/advanced HTTP/1.1

Host: api.infobip.com
Authorization: Basic QWxhZGRpbjpvcGVuIHNlc2FtZQ==
Content-Type: application/json

{
   "messages":[
      {
         "from":"InfoSMS",
         "destinations":[
            {
               "to":"41793026727",
            },
            {
               "to":"41793026731"
            }
         ],
         "text":"The time-traveling is just too dangerous. Better that I devote myself to study the other great mystery of the universe: women!",
         "validityPeriod": 1440
      }
   ]
}

Con una risposta;

HTTP/1.1 200 OK
Content-Type: application/json

{
  "bulkId": "a6e6bf50-ade1-4dd5-8900-d5b3bb18c0cc",
  "messages": [
    {
      "to": "41793026727",
      "status": {
        "groupId": 1,
        "groupName": "PENDING",
        "id": 7,
        "name": "PENDING_ENROUTE",
        "description": "Message sent to next instance"
      },
      "smsCount": 1,
      "messageId": "239a1bed-91d0-4454-a437-6663938465aa"
    },
    {
      "to": "41793026731",
      "status": {
        "groupId": 1,
        "groupName": "PENDING",
        "id": 7,
        "name": "PENDING_ENROUTE",
        "description": "Message sent to next instance"
      },
      "smsCount": 1,
      "messageId": "77a6e601-c12d-4a66-8e16-d8ec8c5fbc03"
    }
  ]
}

Ricorda che il periodo di validità è indicato in minuti. Dopo aver impostato il periodo, l’invio del messaggio non verrà effettuato alla scadenza del periodo.

Questi sono solo alcuni suggerimenti per assicurare il successo della tua impresa e mantenere i clienti soddisfatti. Per scoprire di più sulle integrazioni e i diversi canali visita il nostro developer hub.

INIZIA A CONTROLLARE I TUOI MESSAGGI

Scopri di più