Products

La guida rapida all’API SMS Infobip

Con un'API SMS semplice da integrare, iniziare a inviare SMS ai clienti è più semplice che mai.

May 31 2016

Iniziare a usare l'API SMS Infobip è semplice. L'API è progettata in modo tale da poter essere integrata rapidamente in qualsiasi applicazione per iniziare a inviare messaggi fin da subito.

Una volta approvato l'accesso per lo sviluppatore e impostata la messaggistica SMS sul tuo account, potrai raggiungere i tuoi clienti ovunque siano, in qualsiasi angolo del mondo. L'API SMS Infobip di base è composta da sole 8 righe di codice, quanto basta per iniziare a mandare messaggi ai clienti.

Gli sviluppatori con un account approvato possono usare l'API per:

  • Inviare SMS in ogni parte del mondo
  • Monitorare il costo e il tasso di consegna dei messaggi in ogni Paese
  • Inviare inviti e condivisioni social (ad es. link per scaricare le app)
  • Inviare SMS flash in ogni parte del mondo

PARLIAMO LA STESSA LINGUA

L'API SMS è basata su standard REST. Tutte le richieste vengono generate con metodi PUSH, POST e GET. L'API Infobip accetta contenuti JSON e XML e supporta Java, PHP, python, C# e Ruby on Rails.

Per qualsiasi domanda, il nostro API Developer Hub può fornirti tutorial ed esempi dettagliati in grado di risolvere i tuoi dubbi e aiutarti a iniziare a usare subito l'API.

INIZIARE A INVIARE SMS CON L'API SMS

Scopriamo insieme l'API SMS Infobip con qualche esempio e campione di codici. Iniziamo dalle basi degli SMS. Gli standard degli SMS sono semplici:

  • Ogni messaggio può contenere un massimo di 160 caratteri
  • Il numero di telefono a cui invii il messaggi deve utilizzare la formattazione numerica E.164

L'API SMS Infobip può gestire diversi operatori di telefonia mobile (MNO) e soddisfare i requisiti specifici di ogni Paese, così l'unica cosa di cui devi preoccuparti è scrivere il codice. Ecco qualche esempio di base per illustrare l'invio di un messaggio tramite l'API in tutte le sue 8 righe:

JSON
POST /sms/1/text/single HTTP/1.1
Host: api.infobip.com
Authorization: Basic QWxhZGRpbjpvcGVuIHNlc2FtZQ==
Content-Type: application/json
Accept: application/json

{  
   "from":"InfoSMS",
   "to":"41793026727",
   "text":"Test SMS."
}

 

 

INVIO A CLIENTI MULTIPLI

Usare l'API per inviare diversi SMS (o SMS a diversi destinatari) è appena più complesso che utilizzarla per inviare un solo messaggio (vedi di seguito):

JSON
POST /sms/1/text/multi HTTP/1.1
Host: api.infobip.com
Authorization: Basic QWxhZGRpbjpvcGVuIHNlc2FtZQ==
Content-Type: application/json
Accept: application/json

{  
   "messages":[  
      {  
         "from":"InfoSMS",
         "to":[  
            "41793026727",
            "41793026731"
         ],
         "text":"May the Force be with you!"
      },
      {  
         "from":"41793026700",
         "to":"41793026785",
         "text":"A long time ago, in a galaxy far, far away... It is a period of civil war. Rebel spaceships, striking from a hidden base, have won their first victory against the evil Galactic Empire."
      }
   ]
}

 

 

INVIARE SOCIAL INVITES E LINK ALLE APP

L'API consente di integrare i Social Invites e di condividere l'app. Il campione di codice che trovi di seguito invia il link e ti consente di monitorarlo tramite il portale Infobip. I Social Invites sono un modo semplice ma potente di coinvolgere più utenti e accrescere il numero di download.

JSON
POST /sms/1/text/advanced HTTP/1.1
Host: api.infobip.com
Authorization: Basic QWxhZGRpbjpvcGVuIHNlc2FtZQ==
Content-Type: application/json

{
   "bulkId":"BULK-ID-123-xyz",
   "messages":[
      {
         "from":"InfoSMS",
         "destinations":[
            {
               "to":"41793026727",
               "messageId":"MESSAGE-ID-123-xyz"
            },
            {
               "to":"41793026731"
            }
         ],
         "text":"Hey, take a look at this awesome application :  https://play.google.com/store/apps/details?id=com.myApp"
      }
    ],
   "tracking":{
         "track":"URL",
         "type":"SOCIAL_INVITES"
    }
}

 

 

MESSAGGISTICA COMPLETA

Le opzioni di messaggistica SMS completa integrate nell'API SMS ti consentono di specificare ulteriori parametri in grado di accrescere il successo delle tue campagne e consentirti di monitorarle e analizzarle meglio.

SUPPORTO LINGUISTICO

I clienti vogliono ricevere i messaggi nel loro alfabeto preferito, ma non tutte le lettere sono include nell'alfabeto standard utilizzato dagli SMS. Puoi utilizzare caratteri Unicode, ma così facendo ridurrai la lunghezza massima dell'SMS. Se fossi costretto a inviare due messaggi, i costi raddoppierebbero. Infobip ha due soluzioni per ridurre i costi e migliorare l'esperienza dei clienti che utilizzano alfabeti complessi.

Transliteration converte automaticamente i caratteri Unicode in caratteri regolari. Allo sviluppatore basta impostare un parametro del codice su uno degli alfabeti supportati (turco, greco, cirillico, cirillico serbo, centro Europa o baltico), ci penserà l'API a fare il resto.

National Language Identifier è una tecnologia di codifica che consente di raggiungere un risultato simile alla translitterazione anche per quelle lingue che richiedono l'utilizzo di segni diacritici. Anche questa può essere impostata come parametro. La nostra API al momento supporta turco, spagnolo e portoghese.

SMS FLASH

Una banca individua una possibile frode, una compagnia aerea cambia gate all'ultimo minuto: se è necessario che i tuoi messaggi vengano visti da subito, gli SMS Flash possono evitare di finire nella casella Messaggi ed essere visualizzati direttamente sulla schermata principale del telefono del cliente. Con l'API SMS, per abilitare l'invio di SMS Flash basta aggiungere una nuova riga di codice.

LA TEMPISTICA PERFETTA PER I TUOI MESSAGGI

La nostra API di messaggistica include due parametri di determinazione dei tempiper aiutarti a inviare messaggi nei momenti della giornata in cui saranno più efficienti:

  • Con “sendAt” puoi fare in modo che i messaggi vengano consegnati a un'ora specifica

  • “Validity Period” ti consente invece di inviare messaggi entro un determinato intervallo di tempo

Non devi preoccuparti neanche del formato utilizzato per l'orario (12 o 24 ore): la documentazione dell'API Infobip ti indicherà il formato richiesto.

Nessuno vuole ricevere un SMS alle 4 del mattino, ma una tempistica corretta non ti aiuterà solo a non svegliare i clienti, ma anche ad evitare di violare le regolamentazioni e le normative locali. In India ad esempio è possibile inviare messaggi di marketing solamente dalle 9:00 alle 21:00 (anche quando il cliente ha acconsentito a ricevere tali messaggi). L'API SMS e il nostro team di esperti di messaggistica mobile ti aiuteranno a rispettare le normative dei Paesi in cui la tua azienda si espanderà man mano che cresce. L'orientamento tra queste normative è solo un esempio dei tanti modi in cui supportiamo gli sviluppatori senza costi aggiuntivi.

MONITORAGGIO DELLA CAMPAGNA

Semplici e potenti, i nostri strumenti per la creazione e la gestione di report ti aiutano a identificare quali parti della tua campagna funzionano e quali no. L'API SMS ti fornisce i dati per consentirti di effettuare rapidamente i cambiamenti necessari a migliorare i tassi di apertura, azione e consegna.

REPORT DI BASE

Ogni messaggio che invii genera un codice di rispostache ti verrà fornito tramite l'API. 200 OK vuol dire che il messaggio è stato consegnato. Se qualcosa è andato storto, l'API te lo farà subito sapere. Il codice di risposta indica il problema, mentre la documentazione e le risorse che mettiamo a disposizione degli sviluppatori ti aiuteranno a capirne le cause e a risolverlo.

L'API ti dà accesso ai report di consegna delle tue applicazioni e campagne. Con questi report puoi identificare ogni singolo SMS e avere accesso a dati come:

  • Prezzo per messaggio
  • Stato del messaggio
  • Eventuali errori

Puoi utilizzare i dati come ti vengono forniti o inserirli in report personalizzati per mostrarli agli stakeholder e ai membri del team

REPORTISTICA COMPLETA

L'API SMS ti consente di impostare parametri di monitoraggio per campagne e messaggi specifici. Un monitoraggio accurato è fondamentale per una messaggistica di successo (è il caso ad esempio dell'invio di PIN monouso per l'autenticazione a due fattori), e ti aiuta a determinare i risultati delle tue campagne.

ID DI GRUPPO E ID MESSAGGI PERSONALIZZATI

Puoi monitorare le performance di una singola campagna impostando un ID per un gruppo di messaggi. Gli ID possono essere definiti da te o generati automaticamente. Impostare il monitoraggio degli ID con l'API SMS è semplice:

JSON
POST /sms/1/text/advanced HTTP/1.1
Host: api.infobip.com
Authorization: Basic QWxhZGRpbjpvcGVuIHNlc2FtZQ==
Content-Type: application/json

{
   "bulkId":"CUSTOM-BULK-ID-1",
   "messages":[
      {
         "from":"InfoSMS",
         "destinations":[
            {
               "to":"41793026727",
               "messageId":"CUSTOM-MESSAGE-ID-1"
            },
            {
               "to":"41793026731",
               "messageId":"CUSTOM-MESSAGE-ID-2"
            }
         ],
         "text":"A long time ago, in a galaxy far, far away..."
      },
      {
         "from":"41793026700",
         "destinations":[
            {
               "to":"41793026785"
            }
         ],
         "text":"It is a period of civil war. Rebel spaceships, striking from a hidden base, have won their first victory against the evil Galactic Empire."
      }
   ]
}

 

 

REPORT DI CONSEGNA INTERMEDI IN TEMPO REALE

L'API può inviare report in tempo reale quando si verifica un errore di consegna per consentirti di agire da subito, senza dover attendere il termine della campagna per risolvere eventuali problemi (ad es. nel caso alcuni PIN non vengano recapitati ai clienti).Puoi inoltre sapere quali Paesi e operatori di rete mobile causano più errori. Con i report in tempo reale puoi modificare le tue campagne mentre sono ancora in corso e ottimizzarne il tasso di azione e consegna.

TASSI DI CONVERSIONE

I tuoi messaggi vengono aperti? Gli utenti fanno clic sui tuoi link? Quali, e in quali paesi? Gli utenti iOS sono maggiormente coinvolti rispetto al pubblico Android?

Basta impostare un semplice parametro nel codiceper segnalare un'azione come parametro di conversione. Quando quell'azione viene eseguita, le informazioni vengono restituite a Infobip. Penseremo noi ad abbinarle al nostro report e a inviarti i tassi di conversione, che potrai segmentare per:

  • Paese
  • Operatore di telefonia mobile
  • Sistema operativo
  • Orario di ricezione

Puoi usare l'API SMS per creare report personalizzati sugli errori, sul marketing o sul costo della campagna.

MONITORAGGIO E ACCORCIAMENTO DEGLI URL

Puoi monitorare il numero di clic dal tuo messaggio al tuo sito web o ad altre destinazioni. L'API può accorciare gli URL in modo che rispettino il limite di caratteri del messaggio e monitorare automaticamente i clic al posto tuo.

Ogni volta che qualcuno fa clic su un link, riceverai un report con le seguenti informazioni sull'utente:

  • Numero di telefono
  • Paese
  • Operatore di telefonia mobile
  • Sistema operativo del telefono

AL DI LÀ DELL'SMS

Ora che hai compreso le basi dell'utilizzo dell'API SMS Infobip puoi utilizzarla per generare, monitorare e ottimizzare le tue campagne SMS internazionali in modo rapido e semplice.

Se sei pronto a implementare nuove funzioni nella tua app, con l'API SMS puoi inoltre gestire la ricerca del numero,l'autenticazione a due fattorila messaggistica sulle piattaforme tradizionali (email, messaggi vocali e chat/OTT). Tutte queste funzioni sono disponibile sulla stessa API, e implementabili riutilizzando la maggior parte del codice già scritto per le campagne iniziali.

Inizia a collegare la tua app con gli SMS con l'API SMS Infobip, e aiuta la tua azienda a raggiungere miliardi di utenti in tutto il mondo.

La nostra piattaforma di test