API SMS


API SMS

Un servizio semplice e affidabile per inviare SMS in tutto il mondo.

Integrare l'invio di SMS in algoritmi e processi aziendali permette di usufruire di un mezzo di comunicazione istantaneo e universale.

 

Modalità di utilizzo

Promemoria e appuntamenti SMS

Ricordare un appuntamento via SMS è un modo affidabile per assicurarsi che gli orari vengano rispettati. Se la tua struttura riceve il pubblico su appuntamento, invia promemoria tramite SMS per evitare incontri mancati.

PROMEMORIA: appuntamento il 15/09/23 alle 11:00 al centro medico San Gabriel.

SMS marketing

Approfitta dell'elevato tasso di lettura degli SMS per migliorare il ROI delle tue campagne di SMS marketing o annunciare i tuoi eventi... Grazie all'invio massivo, in flash o in differita, per raggiungere tutti i tuoi contatti basta un click!

Auguri ERIC! Nel mese del tuo compleanno, i tuoi punti fedeltà valgono il doppio :)

SMS transazionali

Resta in contatto con i clienti, informa automaticamente i destinatari di un pacco inviato e gestisci le attività dei tuoi team via SMS, inviando promemoria e notifiche con ricevuta di consegna.

Il pacco 13618678 è disponibile fino al 05/11/23 presso il punto di ritiro scelto.

Alert SMS - Monitoring SMS

Monitorare lo stato di un hardware o di un server... Con le API di OVHcloud puoi trasformare qualsiasi oggetto connesso a Internet in un oggetto che comunica tramite SMS.

L'allarme di sorveglianza è stato attivato il 04/08/2022 alle 14:48 nella zona C, edificio 3.

I vantaggi

API Rest

Icons/concept/Pen Created with Sketch.

Mittente personalizzabile

Icons/concept/Cloud/Cloud Eye Created with Sketch.

Ricevuta di consegna

SMS differiti

Icons/concept/Envelop/Envelop Created with Sketch.

200.000 SMS

Icons/concept/Gear/Gear Arrow Created with Sketch.

Garanzia di consegna

Icons/concept/Hands/Hand World Created with Sketch.

Copertura mondiale con oltre 600 operatori

Maggiori informazioni sull'invio di SMS tramite applicazioni

Inviare il primo SMS

POST https://api.ovh.com/1.0/sms/sms-aa1-1/jobs
{
  "messaggio": "Test Message",
  "ricevitori": ["+33601020304"],
  "senderForResponse": true
}

Il destinatario riceverà un SMS proveniente da un numero breve con contenuto "Test message".
L'API restituirà il numero di crediti utilizzato, i destinatari validi e non validi e gli identificativi degli SMS necessari per consultarne lo stato.

 

Programmare l'invio di un SMS

POST https://api.ovh.com/1.0/sms/sms-aa1-1/jobs
{
  "messaggio": "Test Message",
  "ricevitori": ["+33601020304"],
  "differedPeriod": 120,
  "senderForResponse": true
}

OVHcloud permette di pianificare l'invio di un SMS a una data successiva.


Il campo "differedPeriod" consente di posticipare l'invio di 120 minuti.

 

Monitorare l'invio di un SMS

Lo stato dell'SMS è disponibile nel campo "deliveryReceipt":

GET https://api.ovh.com/1.0/sms/sms-aa1-1/outgoing/123456

Il campo "deliveryReceipt" può contenere i seguenti valori:

  • 0 → In corso di invio
  • 1 → Inviato
  • 2 → Respinto o Scaduto
  • 4 → In attesa sulla rete dell'operatore del destinatario
  • 8 → Trasmesso alla rete dell'operatore del destinatario
  • 16 → Impossibile consegnare

Il campo "ptt" contiene un'informazione aggiuntiva.

Questa informazione viene visualizzata sotto forma di codice, la cui descrizione è disponibile tramite la seguente chiamata:

https://api.ovh.com/1.0/sms/ptts
{
  "ptt":  4
}

Ricevere una notifica alla modifica di stato di un SMS

OVHcloud permette di ricevere notifiche in tempo reale in caso di modifica di stato di un SMS tramite chiamata HTTP.

Per configurare l'URL a cui effettuare la chiamata:

PUT https://api.ovh.com/1.0/sms/sms-aa1-1                        {                            "callBack": "http://www.monsite.com/callbackSmsOvh.php"                        }                    

Una volta effettuata la configurazione, a ogni modifica di stato di un SMS verrà effettuata una chiamata all'URL indicato con questi parametri:

  • ID → ID dell'SMS
  • dlr → Stato "deliveryReceipt"
  • ptt → Stato “ptt”
  • date → Data di aggiornamento dello stato
  • sender → Mittente dell'SMS
  • receiver → Numero del destinatario dell'SMS

Ricaricare manualmente un account SMS

Per generare un buono d'ordine è possibile utilizzare l'API di OVHcloud:

POST https://api.ovh.com/1.0/order/sms/sms-aa1-1/credits                        {                            "quantity":     100                        }                    

Ricaricare automaticamente un account al raggiungimento di una certa soglia

OVHcloud permette di ricaricare automaticamente l’account al raggiungimento di una soglia di crediti precedentemente definita.


In questo caso, sull'account cliente OVHcloud verrà generato automaticamente un buono d'ordine, che sarà saldato utilizzando la modalità di pagamento predefinita.


Per configurare la ricarica automatica di 100 crediti quando la soglia raggiunta sull'account è inferiore a 10 crediti:

PUT https://api.ovh.com/1.0/sms/sms-aa1-1                        {                            "automaticRecreditAmount":              100,                            "creditThresholdForAutomaticRecredit":  10,                        }                    

Conoscere il prezzo degli SMS verso una destinazione

Per sapere in anticipo la tariffa del proprio invio, è possibile utilizzare questa chiamata:

GET https://api.ovh.com/1.0//sms/sms-aa1-1/seeOffers)                        {                            "countryDestination": "it",                            "countryCurrencyPrice": "it",                            "quantity": 1000,                        }                    

Il risultato restituito dalla chiamata d'esempio permetterà di conoscere la tariffa di 1.000 SMS verso l’Italia, nella valuta utilizzata in questo Paese (€).

Inviare una campagna SMS a più destinatari

Per ottimizzare gli invii massivi è possibile precaricare i destinatari in un file CSV.

Per creare un file di destinatari:

POST https://api.ovh.com/1.0/sms/sms-aa1-1/receivers                        {                            "csvUrl":       "http://monsite.com/mes_destinataires.csv",                            "description":  "Lista dei clienti",                            "slotId":       1                        }                    

Il file deve includere almeno una colonna "number" con il numero di destinatari. È possibile aggiungere altre colonne, da utilizzare per sostituire variabili negli invii. Esempio di file:

number;name;age                        +33601020304;Bianchi;47                        +33602030405;Rossi;36                        +33603040506;Russo;39                    

Per inviare un SMS a tutti i destinatari del file, è sufficiente eseguire questa chiamata:

POST https://api.ovh.com/1.0/sms/sms-aa1-1/jobs                        {                            "message":              "Buongiorno, signor. #NAME#. Hai #AGE# anni.", "receiversSlotId":      1,                            "senderForResponse":    true                            "tag": "MiaCampagna"                        }                    

In questo modo i tre destinatari riceveranno un messaggio personalizzato.
Il signor Bianchi, ad esempio, riceverà il messaggio "Buongiorno, signor Bianchi, è il suo compleanno!".

L'aggiunta del parametro "tag" permetterà inoltre di ricercare gli SMS corrispondenti a questo invio tramite la chiamata:

GET https://api.ovh.com/1.0//sms/sms-aa1-1/outgoing)                            {                                "tag": "MiaCampagna"                        }                    

Ti ricordiamo che, con questo metodo, la chiamata non restituirà gli ID degli SMS, in quanto l'invio verrà effettuato in modo asincrono.

SDK PHP per inviare SMS