Documentazione
Semplici API SMS ti consentono di integrare il potente gateway SMS Skebby con la tua applicazione o server web in modo facile ed immediato. Nei capitoli che seguono ti illustreremo come inviare e ricevere SMS usando diversi linguaggi di programmazione. Se hai bisogno di aiuto per far funzionare le nostre API saremo felici di aiutarti.
Invio SMS
Invio SMS Classic
-
Url per richieste HTTP:
http://gateway.skebby.it/api/send/smseasy/advanced/http.php
https://gateway.skebby.it/api/send/smseasy/advanced/http.php
I parametri devono essere passati con metodo POST, nello standard urlencode. È stato disabilitato il metodo GET perchè con tanti destinatari la richiesta potrebbe essere troncata.
Parametri obbligatori:
Parametro Descrizione String method send_sms_classic String username Username con cui ci si è registrati String password Password con cui ci si è registrati String[] recipients Destinatario/i, in formato internazionale senza + o 00, sotto forma di Array ad esempio:
recipients[]=393334455666&recipients[]=393334455667
Personalizzazione testo per ogni destinatario
Variabili dinamiche: è possibile personalizzare il testo del messaggio per ogni destinatario con delle variabili dinamiche (es. "Nome") che permettono di attivare le variabili con il valore specifico per ciascun destinatario. Ogni variabile sarà valorizzata per complessivi 20 caratteri indipendentemente dalla lunghezza dei singoli valori associati alla variabile per ciascun destinatario. Esempio:
Gentile ${nome}, le inviamo un buono sconto del 10% sul prossimo acquisto. Mostri questo SMS in negozio.
La stringa dei destinatari, sotto forma di Array multidimensionale, diverrà quindi:
recipients[0][recipient]=393471234567&recipients[0][nome]=Mario&recipients[1][recipient]=393477654321&recipients[1][nome]=Marco
String text Testo del messaggio fino a lunghezza massima di 765 caratteri o 5 SMS concatenati in un unico messaggio. Per le modalità di conteggio si veda Modalità di conteggio SMS lunghi tradizionali
Parametri opzionali:
Parametro Descrizione String sender_number* Permette di specificare un qualsiasi numero di telefono come mittente, il numero deve essere in formato internazionale senza + o 00, ad esempio: 393334455666 String sender_string* Permette di specificare una stringa alfanumerica di lunghezza massima di 11 caratteri da utilizzare come mittente, caratteri supportati: [a-zA-Z0-9 .] String charset Vedi nota sull'utilizzo del charset String delivery_start Per programmare invio SMS, usare il formato RFC 2822.
Vedi specifica RFC 2822String encoding_scheme Per usare i caratteri non appartenenti all'alfabeto latino (es. Arabo, Cinese, Coreano, Cirillico, Giapponese e simili)
Valori accettati:- normal (7 bit, default)
- UCS2
Testo del messaggio fino alla lunghezza massima di 335 caratteri o 5 SMS concatenati in un unico messaggio. Per le modalità di conteggio si veda Modalità conteggio SMS lunghi UCS2Integer validity_period È possibile specificare per quanti minuti (o ore) l'operatore deve riprovare ad inviare l'SMS in caso di cellulare spento o non raggiungibile.
Espresso in minuti, numero intero (valore minimo 5 minuti), default 2gg = 2880(60*48)**
Esempio di body HTTP per invio multiplo SMS Classic con mittente personalizzato alfanumerico:
method=send_sms_classic&username=user&password=pass&recipients[]=393471234567&recipients[]=393477654321&text=Ciao+Mario+come+stai&sender_string=LucaRossi
Modalità di conteggio dei messaggi per invio SMS lunghi
SMS tradizionali:Il costo del messaggio sarà conteggiato ogni 153 caratteri, ad eccezione del primo SMS che ne avrà a disposizione 160, fino ad un massimo di 765 o 5 SMS concatenati.
Caratteri Numero di SMS addebitati 0-160 1 161-306 2 307-459 3 460-612 4 613-765 5
Alcuni caratteri contano doppio:
[ Parentesi quadra aperta \ Backslash ] Parentesi quadra chiusa ^ Potenza { Parentesi graffa aperta | Barra verticale } Parentesi graffa chiusa ~ Tilde € Simbolo dell'euro Per maggiori dettagli consulta http://en.wikipedia.org/wiki/GSM_03.38
SMS UCS2:Il costo del messaggio sarà conteggiato ogni 67 caratteri, ad eccezione del primo SMS che ne avrà a disposizione 70, fino ad un massimo di 335 caratteri o 5 SMS concatenati.
Caratteri Numero di SMS addebitati 0-70 1 71-134 2 135-201 3 202-268 4 269-335 5
Invio SMS multipli
Per inviare SMS multipli di tipo massivo e ottimizzare i tempi di consegna ti consigliamo di effettuare "l'invio con una singola richiesta" avendo la possibilità, se necessario, di personalizzare il testo del messaggio attraverso l'utilizzo delle "Variabili dinamiche" la cui documentazione è disponibile qui cliccando su "Personalizzazione testo per ogni destinatario".
Con questa modalità è possibile fare un'unica richiesta al server ed inviare dei testi differenti ad ogni singolo destinatario e ricevere il rapporto di consegna per ogni singolo SMS inviato come specificato qui. Per chi avesse necessità di effettuare invii di SMS massivi l'utilizzo dell' "invio di SMS multipli con singola richiesta" è molto più rapido ed efficiente rispetto all'invio di un messaggio alla volta tramite "chiamate singole" in sequenza. Quest'ultima modalità richiede tempi molto più lunghi per la gestione della spedizione.
Un esempio può aiutare a chiarire la differenza: per una spedizione di 50.000 SMS con invio multiplo su account base con capacità di 10 sms al secondo sarebbe necessario effettuare richieste consecutive per 83 minuti tra il server di partenza dell'SMS ed il gateway di Skebby mentre con l'invio singolo è sufficiente un'unica richiesta della durata di meno di un secondo, successivamente il gateway Skebby gestirà la richiesta e la completerà dopo pochi minuti.
*Per motivi di sicurezza l'utilizzo dei parametri (sender_number e sender_string) è abilitato solamente agli utenti che hanno verificato il proprio numero di cellulare sul sito altrimenti questi valori sono ignorati.
Se vengono specificati contemporaneamente verrà utilizzato il valore contenuto in sender_string.
Per verificare e modificare il proprio numero di telefono sul sito è possibile utilizzare questo indirizzo:
http://www.skebby.it/webclient/index/index/**Il valore di default del Validity Period (VP) è di 48 ore che è lo standard utilizzato dalla quasi totalità degli operatori mobili nel mondo. È possibile, tuttavia, specificare per quante ore l'operatore dovrà riprovare ad inviare l'SMS in caso di cellulare spento o non raggiungibile a vostro piacere entro il limite massimo di 48 ore. -
Url per richieste REST:
http://gateway.skebby.it/api/send/smseasy/advanced/rest.php
https://gateway.skebby.it/api/send/smseasy/advanced/rest.php
I parametri delle richieste REST devono essere passati con metodo POST. È stato disabilitato il metodo GET perchè con tanti destinatari la richiesta potrebbe essere troncata.
Parametri obbligatori:
Parametro Descrizione String method send_sms_classic String username Username con cui ci si è registrati String password Password con cui ci si è registrati String[] recipients Destinatario/i, in formato internazionale senza + o 00, sotto forma di array JSON ad esempio:
recipients = [ "393334455666" , "393334455667" ];
Personalizzazione testo per ogni destinatario
Variabili dinamiche: è possibile personalizzare il testo del messaggio per ogni destinatario con delle variabili dinamiche (es. "Nome") che permettono di attivare le variabili con il valore specifico per ciascun destinatario. Ogni variabile sarà valorizzata per complessivi 20 caratteri indipendentemente dalla lunghezza dei singoli valori associati alla variabile per ciascun destinatario. Esempio:
Gentile ${nome}, le inviamo un buono sconto del 10% sul prossimo acquisto. Mostri questo SMS in negozio.
La stringa dei destinatari, sotto forma di Array JSON, diverrà quindi:
?recipients=[{recipient:'393471234567',nome:'Mario'},{recipient:'393477654321',nome:'Marco'}]
String text Testo del messaggio fino a lunghezza massima di 765 caratteri o 5 SMS concatenati in un unico messaggio. Per le modalità di conteggio si veda Modalità di conteggio SMS lunghi tradizionali
Parametri opzionali:
Parametro Descrizione String sender_number* Permette di specificare un qualsiasi numero di telefono come mittente, il numero deve essere in formato internazionale senza + o 00, ad esempio: 393334455666 String sender_string* Permette di specificare una stringa alfanumerica di lunghezza massima di 11 caratteri da utilizzare come mittente, caratteri supportati: [a-zA-Z0-9 .] String charset Vedi nota sull'utilizzo del charset String delivery_start Per programmare invio SMS, usare il formato RFC 2822.
Vedi specifica RFC 2822String encoding_scheme Per usare i caratteri non appartenenti all'alfabeto latino (es. Arabo, Cinese, Coreano, Cirillico, Giapponese e simili)
Valori accettati:- normal (7 bit, default)
- UCS2
Testo del messaggio fino alla lunghezza massima di 335 caratteri o 5 SMS concatenati in un unico messaggio. Per le modalità di conteggio si veda Modalità conteggio SMS lunghi UCS2Integer validity_period È possibile specificare per quanti minuti (o ore) l'operatore deve riprovare ad inviare l'SMS in caso di cellulare spento o non raggiungibile.
Espresso in minuti, numero intero (valore minimo 5 minuti), default 2gg = 2880(60*48)**
Esempio di body REST per invio multiplo SMS Classic con mittente personalizzato alfanumerico:
method=send_sms_classic&username=user&password=pass&recipients['393471234567','393477654321']&text=Ciao+Mario+come+stai&sender_string=LucaRossi
Modalità di conteggio dei messaggi per invio SMS lunghi
SMS tradizionali:Il costo del messaggio sarà conteggiato ogni 153 caratteri, ad eccezione del primo SMS che ne avrà a disposizione 160, fino ad un massimo di 765 o 5 SMS concatenati.
Caratteri Numero di SMS addebitati 0-160 1 161-306 2 307-459 3 460-612 4 613-765 5
Alcuni caratteri contano doppio:
[ Parentesi quadra aperta \ Backslash ] Parentesi quadra chiusa ^ Potenza { Parentesi graffa aperta | Barra verticale } Parentesi graffa chiusa ~ Tilde € Simbolo dell'euro Per maggiori dettagli consulta http://en.wikipedia.org/wiki/GSM_03.38
SMS UCS2:Il costo del messaggio sarà conteggiato ogni 67 caratteri, ad eccezione del primo SMS che ne avrà a disposizione 70, fino ad un massimo di 335 caratteri o 5 SMS concatenati.
Caratteri Numero di SMS addebitati 0-70 1 71-134 2 135-201 3 202-268 4 269-335 5
Invio SMS multipli
Per inviare SMS multipli di tipo massivo e ottimizzare i tempi di consegna ti consigliamo di effettuare "l'invio con una singola richiesta" avendo la possibilità, se necessario, di personalizzare il testo del messaggio attraverso l'utilizzo delle "Variabili dinamiche" la cui documentazione è disponibile qui cliccando su "Personalizzazione testo per ogni destinatario".
Con questa modalità è possibile fare un'unica richiesta al server ed inviare dei testi differenti ad ogni singolo destinatario e ricevere il rapporto di consegna per ogni singolo SMS inviato come specificato qui. Per chi avesse necessità di effettuare invii di SMS massivi l'utilizzo dell' "invio di SMS multipli con singola richiesta" è molto più rapido ed efficiente rispetto all'invio di un messaggio alla volta tramite "chiamate singole" in sequenza. Quest'ultima modalità richiede tempi molto più lunghi per la gestione della spedizione.
Un esempio può aiutare a chiarire la differenza: per una spedizione di 50.000 SMS con invio multiplo su account base con capacità di 10 sms al secondo sarebbe necessario effettuare richieste consecutive per 83 minuti tra il server di partenza dell'SMS ed il gateway di Skebby mentre con l'invio singolo è sufficiente un'unica richiesta della durata di meno di un secondo, successivamente il gateway Skebby gestirà la richiesta e la completerà dopo pochi minuti.
*Per motivi di sicurezza l'utilizzo dei parametri (sender_number e sender_string) è abilitato solamente agli utenti che hanno verificato il proprio numero di cellulare sul sito altrimenti questi valori sono ignorati.
Se vengono specificati contemporaneamente verrà utilizzato il valore contenuto in sender_string.
Per verificare e modificare il proprio numero di telefono sul sito è possibile utilizzare questo indirizzo:
http://www.skebby.it/webclient/index/index/**Il valore di default del Validity Period (VP) è di 48 ore che è lo standard utilizzato dalla quasi totalità degli operatori mobili nel mondo. È possibile, tuttavia, specificare per quante ore l'operatore dovrà riprovare ad inviare l'SMS in caso di cellulare spento o non raggiungibile a vostro piacere entro il limite massimo di 48 ore. -
Il file wsdl con la descrizione dei metodi è disponibile a questo indirizzo:
http://gateway.skebby.it/api/send/smseasy/advanced/soap.php?wsdl
https://gateway.skebby.it/api/send/smseasy/advanced/soap.php?wsdl
Parametri obbligatori:
Parametro Descrizione String username Username con cui ci si è registrati String password Password con cui ci si è registrati String[] recipients Destinatario/i, in formato internazionale senza + o 00, sotto forma di array di stringhe ad esempio in VB .NET:
Dim wnum = New String() {"393471234567", "393477654321"}
String text Testo del messaggio fino a lunghezza massima di 765 caratteri o 5 SMS concatenati in un unico messaggio. Per le modalità di conteggio si veda Modalità di conteggio SMS lunghi tradizionali
Parametri opzionali:
Parametro Descrizione String sender_number* Permette di specificare un qualsiasi numero di telefono come mittente, il numero deve essere in formato internazionale senza + o 00, ad esempio: 393334455666 String sender_string* Permette di specificare una stringa alfanumerica di lunghezza massima di 11 caratteri da utilizzare come mittente, caratteri supportati: [a-zA-Z0-9 .]
Modalità di conteggio dei messaggi per invio SMS lunghi
SMS tradizionali:Il costo del messaggio sarà conteggiato ogni 153 caratteri, ad eccezione del primo SMS che ne avrà a disposizione 160, fino ad un massimo di 765 o 5 SMS concatenati.
Caratteri Numero di SMS addebitati 0-160 1 161-306 2 307-459 3 460-612 4 613-765 5
Alcuni caratteri contano doppio:
[ Parentesi quadra aperta \ Backslash ] Parentesi quadra chiusa ^ Potenza { Parentesi graffa aperta | Barra verticale } Parentesi graffa chiusa ~ Tilde € Simbolo dell'euro Per maggiori dettagli consulta http://en.wikipedia.org/wiki/GSM_03.38
Invio SMS multipli
Per inviare SMS multipli di tipo massivo e ottimizzare i tempi di consegna ti consigliamo di effettuare "l'invio con una singola richiesta" avendo la possibilità, se necessario, di personalizzare il testo del messaggio attraverso l'utilizzo delle "Variabili dinamiche" la cui documentazione è disponibile qui cliccando su "Personalizzazione testo per ogni destinatario".
Con questa modalità è possibile fare un'unica richiesta al server ed inviare dei testi differenti ad ogni singolo destinatario e ricevere il rapporto di consegna per ogni singolo SMS inviato come specificato qui. Per chi avesse necessità di effettuare invii di SMS massivi l'utilizzo dell' "invio di SMS multipli con singola richiesta" è molto più rapido ed efficiente rispetto all'invio di un messaggio alla volta tramite "chiamate singole" in sequenza. Quest'ultima modalità richiede tempi molto più lunghi per la gestione della spedizione.
Un esempio può aiutare a chiarire la differenza: per una spedizione di 50.000 SMS con invio multiplo su account base con capacità di 10 sms al secondo sarebbe necessario effettuare richieste consecutive per 83 minuti tra il server di partenza dell'SMS ed il gateway di Skebby mentre con l'invio singolo è sufficiente un'unica richiesta della durata di meno di un secondo, successivamente il gateway Skebby gestirà la richiesta e la completerà dopo pochi minuti.
*Per motivi di sicurezza l'utilizzo dei parametri (sender_number e sender_string) è abilitato solamente agli utenti che hanno verificato il proprio numero di cellulare sul sito altrimenti questi valori sono ignorati.
Se vengono specificati contemporaneamente verrà utilizzato il valore contenuto in sender_string.
Per verificare e modificare il proprio numero di telefono sul sito è possibile utilizzare questo indirizzo:
http://www.skebby.it/webclient/index/index/ -
Come usare il protocollo SMTP per inviare SMS Classic anche da client/server email
Per inviare SMS con protocollo SMTP occorre abilitare prima di tutto il servizio indicando la casella email da usare per l'invio. Per configurarlo vai su Skebby.it > Accedi > Impostazioni > Email to SMS. Per inviare SMS da un'altra casella email, sarà sufficiente aggiungerla. Puoi aggiungere tutte le caselle email che desideri.
Parametri
Parametro Descrizione Destinatario dell'SMS Il numero del destinatario dell'SMS deve essere inserito all'interno del campo "A" o "CC" utilizzando il seguente formato: NUMERODICELLULARE@classic.skebby.com. Il numero di cellulare deve essere inserito nel formato internazionale secondo uno tra i seguenti esempi a scelta del cliente:
0039320XXXXXXX@classic.skebby.com
+39320XXXXXXX@classic.skebby.com
39320XXXXXXX@classic.skebby.com
Nota bene: è possibile utilizzare questa modalità solo per effettuare spedizioni fino a 50 email/SMS in simultanea. Se si inviano più di 50 email con questa modalità il servizio verrà bloccato.
Esempio: 00393334455666@classic.skebby.comDestinatari multipli/Invio massivo Per inviare fino a 100 email/SMS è possibile fare un invio multiplo inserendo l'indirizzo email di ciascun destinatario aggiuntivo nel campo "CC". Per invii maggiori di 100 e fino a 50.000 email/SMS aggiungi i destinatari dell'SMS nel formato standard nel corpo della mail dopo il carattere ## che indica la fine del testo SMS da inviare. Non è necessario inserire spazi o altri caratteri tra un destinatario e il successivo. Invio a gruppi Puoi inviare un SMS ad un gruppo precedentemente salvato su Skebby.it > Accedi > Contatti > Gruppi inserendolo nel campo "A" o "CC" dell'email utilizzando il seguente formato: NOMEGRUPPO@classic.skebby.com
Esempio: colleghi@classic.skebby.com
Il NOMEGRUPPO deve essere una parola unica, corrispondere al nome del gruppo salvato e contenere almeno un carattere alfabetico.
Per inviare SMS ai gruppi predefiniti:
- contatti "Preferiti" invia una mail a preferiti@classic.skebby.com
- contatti "Rubrica cellulare" invia una mail a rubricacellulare@classic.skebby.com
- "a tutti i contatti" invia una mail a tutti@classic.skebby.com
Mittente dell'SMS Tutti gli SMS avranno come mittente quello di default impostato sul proprio account Skebby. Puoi personalizzare il mittente ad ogni invio specificando una stringa alfanumerica di massimo 11 caratteri nel campo "Oggetto" della email, caratteri supportati [a-zA-Z0-9 .] Testo dell'SMS Il testo dell'SMS deve essere scritto all'interno dello spazio dove solitamente scrivi il testo delle email e la lunghezza massima è 765 caratteri ("5"). Se scrivi testo più lungo di 765 caratteri l'SMS non verrà inviato e verrai allertato con una email. Se il corpo della mail è vuoto, l'email verrà inviata ma l'SMS non partirà (non verrà addebitato alcun SMS). Fine dell'SMS La coppia di caratteri ## indica la fine del testo del messaggio da inviare e identifica infatti la fine dell'SMS. Deve sempre essere inserito. Tutto il testo dopo di ## non verrà quindi inviato. Autenticazione tramite PIN È possibile richiedere l'autenticazione tramite PIN durante l'invio degli SMS da email, per una maggior sicurezza, configurandolo all'interno delle impostazioni del tuo account Skebby. Per inviare SMS da email con autenticazione PIN devi inserire tra i destinatari un indirizzo es. tuopin123@pin.skebby.com, dove "tuopin123" corrisponde ad un codice alfanumerico di sicurezza (minimo 6 caratteri di cui almeno un numero), che devi indicare nell'Area Riservata ovvero Skebby.it > Accedi > Impostazioni > Email to SMS. Se si opta per l'autenticazione tramite PIN, per inviare un SMS da qualunque indirizzo email registrato, sarà obbligatorio inserire anche come destinatario l'indirizzo email con PIN, altrimenti l'SMS non verrà inviato.
Invio SMS Classic Plus (con rapporto di consegna)
-
Url per richieste HTTP:
http://gateway.skebby.it/api/send/smseasy/advanced/http.php
https://gateway.skebby.it/api/send/smseasy/advanced/http.php
I parametri devono essere passati con metodo POST, nello standard urlencode. È stato disabilitato il metodo GET perchè con tanti destinatari la richiesta potrebbe essere troncata.
Parametri obbligatori:
Parametro Descrizione String method send_sms_classic_report String username Username con cui ci si è registrati String password Password con cui ci si è registrati String[] recipients Destinatario/i, in formato internazionale senza + o 00, sotto forma di Array ad esempio:
recipients[]=393334455666&recipients[]=393334455667
Personalizzazione testo per ogni destinatario
Variabili dinamiche: è possibile personalizzare il testo del messaggio per ogni destinatario con delle variabili dinamiche (es. "Nome") che permettono di attivare le variabili con il valore specifico per ciascun destinatario. Ogni variabile sarà valorizzata per complessivi 20 caratteri indipendentemente dalla lunghezza dei singoli valori associati alla variabile per ciascun destinatario. Esempio:
Gentile ${nome}, le inviamo un buono sconto del 10% sul prossimo acquisto. Mostri questo SMS in negozio.
La stringa dei destinatari, sotto forma di Array multidimensionale, diverrà quindi:
recipients[0][recipient]=393471234567&recipients[0][nome]=Mario&recipients[1][recipient]=393477654321&recipients[1][nome]=Marco
String text Testo del messaggio fino a lunghezza massima di 765 caratteri o 5 SMS concatenati in un unico messaggio. Per le modalità di conteggio si veda Modalità di conteggio SMS lunghi tradizionali
Parametri opzionali:
Parametro Descrizione String sender_number* Permette di specificare un qualsiasi numero di telefono come mittente, il numero deve essere in formato internazionale senza + o 00, ad esempio: 393334455666 String sender_string* Permette di specificare una stringa alfanumerica di lunghezza massima di 11 caratteri da utilizzare come mittente, caratteri supportati: [a-zA-Z0-9 .] String charset Vedi nota sull'utilizzo del charset String delivery_start Per programmare invio SMS, usare il formato RFC 2822.
Vedi specifica RFC 2822String encoding_scheme Per usare i caratteri non appartenenti all'alfabeto latino (es. Arabo, Cinese, Coreano, Cirillico, Giapponese e simili)
Valori accettati:- normal (7 bit, default)
- UCS2
Testo del messaggio fino alla lunghezza massima di 335 caratteri o 5 SMS concatenati in un unico messaggio. Per le modalità di conteggio si veda Modalità conteggio SMS lunghi UCS2Integer validity_period È possibile specificare per quanti minuti (o ore) l'operatore deve riprovare ad inviare l'SMS in caso di cellulare spento o non raggiungibile.
Espresso in minuti, numero intero (valore minimo 5 minuti), default 2gg = 2880(60*48)**Varchar(20) user_reference Stringa di riferimento personalizzabile che verrà restituita insieme al rapporto di consegna.
Caratteri supportati: [a-zA-Z0-9-_+:;]
Esempio di body HTTP per invio multiplo SMS Classic con rapporto di consegna con mittente personalizzato numerico:
method=send_sms_classic_report&username=user&password=pass&recipients[]=393471234567&recipients[]=393477654321&text=Ciao+Mario+come+stai&sender_number=393334455666
Modalità di conteggio dei messaggi per invio SMS lunghi
SMS tradizionali:Il costo del messaggio sarà conteggiato ogni 153 caratteri, ad eccezione del primo SMS che ne avrà a disposizione 160, fino ad un massimo di 765 o 5 SMS concatenati.
Caratteri Numero di SMS addebitati 0-160 1 161-306 2 307-459 3 460-612 4 613-765 5
Alcuni caratteri contano doppio:
[ Parentesi quadra aperta \ Backslash ] Parentesi quadra chiusa ^ Potenza { Parentesi graffa aperta | Barra verticale } Parentesi graffa chiusa ~ Tilde € Simbolo dell'euro Per maggiori dettagli consulta http://en.wikipedia.org/wiki/GSM_03.38
SMS UCS2:Il costo del messaggio sarà conteggiato ogni 67 caratteri, ad eccezione del primo SMS che ne avrà a disposizione 70, fino ad un massimo di 335 caratteri o 5 SMS concatenati.
Caratteri Numero di SMS addebitati 0-70 1 71-134 2 135-201 3 202-268 4 269-335 5
Invio SMS multipli con rapporto di consegna per ogni singolo messaggio
Per inviare SMS multipli di tipo massivo e ottimizzare i tempi di consegna, ti consigliamo di effettuare "l'invio con una singola richiesta" avendo la possibilità, ove richiesto, di riconciliare ciascuna notifica di ricezione ad ogni singolo messaggio inviato.
Basta utilizzare congiuntamente i campi "ID spedizione" e "numero di cellulare del destinatario" messi a disposizione per ogni notifica inoltrata che rendono ogni notifica di consegna unica.
Per chi avesse necessità di effettuare quindi invii di SMS massivi l'utilizzo dell'invio di SMS multipli "con singola richiesta" è molto più rapido ed efficiente rispetto all'invio di un messaggio alla volta tramite "chiamate singole" in sequenza.
*Per motivi di sicurezza l'utilizzo dei parametri (sender_number e sender_string) è abilitato solamente agli utenti che hanno verificato il proprio numero di cellulare sul sito altrimenti questi valori sono ignorati.
Se vengono specificati contemporaneamente verrà utilizzato il valore contenuto in sender_string.
Per verificare e modificare il proprio numero di telefono sul sito è possibile utilizzare questo indirizzo:
http://www.skebby.it/webclient/index/index/**Il valore di default del Validity Period (VP) è di 48 ore che è lo standard utilizzato dalla quasi totalità degli operatori mobili nel mondo. È possibile, tuttavia, specificare per quante ore l'operatore dovrà riprovare ad inviare l'SMS in caso di cellulare spento o non raggiungibile a vostro piacere entro il limite massimo di 48 ore. -
Url per richieste REST:
http://gateway.skebby.it/api/send/smseasy/advanced/rest.php
https://gateway.skebby.it/api/send/smseasy/advanced/rest.php
I parametri delle richieste REST devono essere passati con metodo POST. È stato disabilitato il metodo GET perchè con tanti destinatari la richiesta potrebbe essere troncata.
Parametri obbligatori:
Parametro Descrizione String method send_sms_classic_report String username Username con cui ci si è registrati String password Password con cui ci si è registrati String[] recipients Destinatario/i, in formato internazionale senza + o 00, sotto forma di array JSON ad esempio:
recipients = [ "393334455666" , "393334455667" ];
Personalizzazione testo per ogni destinatario
Variabili dinamiche: è possibile personalizzare il testo del messaggio per ogni destinatario con delle variabili dinamiche (es. "Nome") che permettono di attivare le variabili con il valore specifico per ciascun destinatario. Ogni variabile sarà valorizzata per complessivi 20 caratteri indipendentemente dalla lunghezza dei singoli valori associati alla variabile per ciascun destinatario. Esempio:
Gentile ${nome}, le inviamo un buono sconto del 10% sul prossimo acquisto. Mostri questo SMS in negozio.
La stringa dei destinatari, sotto forma di Array JSON, diverrà quindi:
?recipients=[{recipient:'393471234567',nome:'Mario'},{recipient:'393477654321',nome:'Marco'}]
String text Testo del messaggio fino a lunghezza massima di 765 caratteri o 5 SMS concatenati in un unico messaggio. Per le modalità di conteggio si veda Modalità di conteggio SMS lunghi tradizionali
Parametri opzionali:
Parametro Descrizione String sender_number* Permette di specificare un qualsiasi numero di telefono come mittente, il numero deve essere in formato internazionale senza + o 00, ad esempio: 393334455666 String sender_string* Permette di specificare una stringa alfanumerica di lunghezza massima di 11 caratteri da utilizzare come mittente, caratteri supportati: [a-zA-Z0-9 .] String charset Vedi nota sull'utilizzo del charset String delivery_start Per programmare invio SMS, usare il formato RFC 2822.
Vedi specifica RFC 2822String encoding_scheme Per usare i caratteri non appartenenti all'alfabeto latino (es. Arabo, Cinese, Coreano, Cirillico, Giapponese e simili)
Valori accettati:- normal (7 bit, default)
- UCS2
Testo del messaggio fino alla lunghezza massima di 335 caratteri o 5 SMS concatenati in un unico messaggio. Per le modalità di conteggio si veda Modalità conteggio SMS lunghi UCS2Integer validity_period È possibile specificare per quanti minuti (o ore) l'operatore deve riprovare ad inviare l'SMS in caso di cellulare spento o non raggiungibile.
Espresso in minuti, numero intero (valore minimo 5 minuti), default 2gg = 2880(60*48)**Varchar(20) user_reference Stringa di riferimento personalizzabile che verrà restituita insieme al rapporto di consegna.
Caratteri supportati: [a-zA-Z0-9-_+:;]
Esempio di body REST per invio multiplo SMS Classic con rapporto di consegna con mittente personalizzato numerico:
method=send_sms_classic_report&username=user&password=pass&recipients['393471234567','393477654321']&text=Ciao+Mario+come+stai&sender_number=393334455666
Modalità di conteggio dei messaggi per invio SMS lunghi
SMS tradizionali:Il costo del messaggio sarà conteggiato ogni 153 caratteri, ad eccezione del primo SMS che ne avrà a disposizione 160, fino ad un massimo di 765 o 5 SMS concatenati.
Caratteri Numero di SMS addebitati 0-160 1 161-306 2 307-459 3 460-612 4 613-765 5
Alcuni caratteri contano doppio:
[ Parentesi quadra aperta \ Backslash ] Parentesi quadra chiusa ^ Potenza { Parentesi graffa aperta | Barra verticale } Parentesi graffa chiusa ~ Tilde € Simbolo dell'euro Per maggiori dettagli consulta http://en.wikipedia.org/wiki/GSM_03.38
SMS UCS2:Il costo del messaggio sarà conteggiato ogni 67 caratteri, ad eccezione del primo SMS che ne avrà a disposizione 70, fino ad un massimo di 335 caratteri o 5 SMS concatenati.
Caratteri Numero di SMS addebitati 0-70 1 71-134 2 135-201 3 202-268 4 269-335 5
Invio SMS multipli con rapporto di consegna per ogni singolo messaggio
Per inviare SMS multipli di tipo massivo e ottimizzare i tempi di consegna, ti consigliamo di effettuare "l'invio con una singola richiesta" avendo la possibilità, ove richiesto, di riconciliare ciascuna notifica di ricezione ad ogni singolo messaggio inviato.
Basta utilizzare congiuntamente i campi "ID spedizione" e "numero di cellulare del destinatario" messi a disposizione per ogni notifica inoltrata che rendono ogni notifica di consegna unica.
Per chi avesse necessità di effettuare quindi invii di SMS massivi l'utilizzo dell'invio di SMS multipli "con singola richiesta" è molto più rapido ed efficiente rispetto all'invio di un messaggio alla volta tramite "chiamate singole" in sequenza.
*Per motivi di sicurezza l'utilizzo dei parametri (sender_number e sender_string) è abilitato solamente agli utenti che hanno verificato il proprio numero di cellulare sul sito altrimenti questi valori sono ignorati.
Se vengono specificati contemporaneamente verrà utilizzato il valore contenuto in sender_string.
Per verificare e modificare il proprio numero di telefono sul sito è possibile utilizzare questo indirizzo:
http://www.skebby.it/webclient/index/index/**Il valore di default del Validity Period (VP) è di 48 ore che è lo standard utilizzato dalla quasi totalità degli operatori mobili nel mondo. È possibile, tuttavia, specificare per quante ore l'operatore dovrà riprovare ad inviare l'SMS in caso di cellulare spento o non raggiungibile a vostro piacere entro il limite massimo di 48 ore. -
Il file wsdl con la descrizione dei metodi è disponibile a questo indirizzo:
http://gateway.skebby.it/api/send/smseasy/advanced/soap.php?wsdl
https://gateway.skebby.it/api/send/smseasy/advanced/soap.php?wsdl
Parametri obbligatori:
Parametro Descrizione String username Username con cui ci si è registrati String password Password con cui ci si è registrati String[] recipients Destinatario/i, in formato internazionale senza + o 00, sotto forma di array di stringhe ad esempio in VB .NET:
Dim wnum = New String() {"393471234567", "393477654321"}
String text Testo del messaggio fino a lunghezza massima di 765 caratteri o 5 SMS concatenati in un unico messaggio. Per le modalità di conteggio si veda Modalità di conteggio SMS lunghi tradizionali
Parametri opzionali:
Parametro Descrizione String sender_number* Permette di specificare un qualsiasi numero di telefono come mittente, il numero deve essere in formato internazionale senza + o 00, ad esempio: 393334455666 String sender_string* Permette di specificare una stringa alfanumerica di lunghezza massima di 11 caratteri da utilizzare come mittente, caratteri supportati: [a-zA-Z0-9 .]
Modalità di conteggio dei messaggi per invio SMS lunghi
SMS tradizionali:Il costo del messaggio sarà conteggiato ogni 153 caratteri, ad eccezione del primo SMS che ne avrà a disposizione 160, fino ad un massimo di 765 o 5 SMS concatenati.
Caratteri Numero di SMS addebitati 0-160 1 161-306 2 307-459 3 460-612 4 613-765 5
Alcuni caratteri contano doppio:
[ Parentesi quadra aperta \ Backslash ] Parentesi quadra chiusa ^ Potenza { Parentesi graffa aperta | Barra verticale } Parentesi graffa chiusa ~ Tilde € Simbolo dell'euro Per maggiori dettagli consulta http://en.wikipedia.org/wiki/GSM_03.38
Invio SMS multipli con rapporto di consegna per ogni singolo messaggio
Per inviare SMS multipli di tipo massivo e ottimizzare i tempi di consegna, ti consigliamo di effettuare "l'invio con una singola richiesta" avendo la possibilità, ove richiesto, di riconciliare ciascuna notifica di ricezione ad ogni singolo messaggio inviato.
Basta utilizzare congiuntamente i campi "ID spedizione" e "numero di cellulare del destinatario" messi a disposizione per ogni notifica inoltrata che rendono ogni notifica di consegna unica.
Per chi avesse necessità di effettuare quindi invii di SMS massivi l'utilizzo dell'invio di SMS multipli "con singola richiesta" è molto più rapido ed efficiente rispetto all'invio di un messaggio alla volta tramite "chiamate singole" in sequenza.
*Per motivi di sicurezza l'utilizzo dei parametri (sender_number e sender_string) è abilitato solamente agli utenti che hanno verificato il proprio numero di cellulare sul sito altrimenti questi valori sono ignorati.
Se vengono specificati contemporaneamente verrà utilizzato il valore contenuto in sender_string.
Per verificare e modificare il proprio numero di telefono sul sito è possibile utilizzare questo indirizzo:
http://www.skebby.it/webclient/index/index/ -
Come usare il protocollo SMTP per inviare SMS Classic con Notifica anche da client/server email
Per inviare SMS con protocollo SMTP occorre abilitare prima di tutto il servizio indicando la casella email da usare per l'invio. Per configurarlo vai su Skebby.it > Accedi > Impostazioni > Email to SMS. Per inviare SMS da un'altra casella email, sarà sufficiente aggiungerla. Puoi aggiungere tutte le caselle email che desideri.
Parametri
Parametro Descrizione Destinatario dell'SMS Il numero del destinatario dell'SMS deve essere inserito all'interno del campo "A" o "CC" utilizzando il seguente formato: NUMERODICELLULARE@classicplus.skebby.com. Il numero di cellulare deve essere inserito nel formato internazionale secondo uno tra i seguenti esempi a scelta del cliente:
0039320XXXXXXX@classicplus.skebby.com
+39320XXXXXXX@classicplus.skebby.com
39320XXXXXXX@classicplus.skebby.com
Nota bene: è possibile utilizzare questa modalità solo per effettuare spedizioni fino a 50 email/SMS in simultanea. Se si inviano più di 50 email con questa modalità il servizio verrà bloccato.
Esempio: 00393334455666@classicplus.skebby.comDestinatari multipli/Invio massivo Per inviare fino a 100 email/SMS è possibile fare un invio multiplo inserendo l'indirizzo email di ciascun destinatario aggiuntivo nel campo "CC". Per invii maggiori di 100 e fino a 50.000 email/SMS aggiungi i destinatari dell'SMS nel formato standard nel corpo della mail dopo il carattere ## che indica la fine del testo SMS da inviare. Non è necessario inserire spazi o altri caratteri tra un destinatario e il successivo. Invio a gruppi Puoi inviare un SMS ad un gruppo precedentemente salvato su Skebby.it > Accedi > Contatti > Gruppi inserendolo nel campo "A" o "CC" dell'email utilizzando il seguente formato: NOMEGRUPPO@classicplus.skebby.com
Esempio: colleghi@classicplus.skebby.com
Il NOMEGRUPPO deve essere una parola unica, corrispondere al nome del gruppo salvato e contenere almeno un carattere alfabetico.
Per inviare SMS ai gruppi predefiniti:
- contatti "Preferiti" invia una mail a preferiti@classicplus.skebby.com
- contatti "Rubrica cellulare" invia una mail a rubricacellulare@classicplus.skebby.com
- "a tutti i contatti" invia una mail a tutti@classicplus.skebby.com
Mittente dell'SMS Tutti gli SMS avranno come mittente quello di default impostato sul proprio account Skebby. Puoi personalizzare il mittente ad ogni invio specificando una stringa alfanumerica di massimo 11 caratteri nel campo "Oggetto" della email, caratteri supportati [a-zA-Z0-9 .] Testo dell'SMS Il testo dell'SMS deve essere scritto all'interno dello spazio dove solitamente scrivi il testo delle email e la lunghezza massima è 765 caratteri ("5"). Se scrivi testo più lungo di 765 caratteri l'SMS non verrà inviato e verrai allertato con una email. Se il corpo della mail è vuoto, l'email verrà inviata ma l'SMS non partirà (non verrà addebitato alcun SMS). Fine dell'SMS La coppia di caratteri ## indica la fine del testo del messaggio da inviare e identifica infatti la fine dell'SMS. Deve sempre essere inserito. Tutto il testo dopo di ## non verrà quindi inviato. Autenticazione tramite PIN È possibile richiedere l'autenticazione tramite PIN durante l'invio degli SMS da email, per una maggior sicurezza, configurandolo all'interno delle impostazioni del tuo account Skebby. Per inviare SMS da email con autenticazione PIN devi inserire tra i destinatari un indirizzo es. tuopin123@pin.skebby.com, dove "tuopin123" corrisponde ad un codice alfanumerico di sicurezza (minimo 6 caratteri di cui almeno un numero), che devi indicare nell'Area Riservata ovvero Skebby.it > Accedi > Impostazioni > Email to SMS. Se si opta per l'autenticazione tramite PIN, per inviare un SMS da qualunque indirizzo email registrato, sarà obbligatorio inserire anche come destinatario l'indirizzo email con PIN, altrimenti l'SMS non verrà inviato.
Come ricevere il rapporto di consegna per SMS Classic Plus
Nel momento in cui il server Skebby invoca la URL indicataci per l'inoltro del rapporto di consegna e la stessa URL non fosse raggiungibile, il server Skebby proverà a riconsegnare il rapporto ogni 30 minuti per un massimo di 6 tentativi (3 ore massimo dall'invio), successivamente ai quali l'inoltro verrà scartato.
Inoltre è possibile visualizzare il dettaglio dei rapporti di consegna andando su Skebby.it > Accedi > Contabilità SMS > Traffico e notifiche > Messaggi e stato di consegna.
-
I parametri inviati all'URL specificato sono:
Parametro Descrizione String skebby_dispatch_id Numero identificativo della spedizione String skebby_message_id Numero identificativo del singolo SMS String recipient Numero di telefono a cui è stato inviato l'SMS String status Codice del rapporto di consegna (vedi sotto per il dettaglio) String error_code Dettaglio del rapporto di consegna (vedi sotto) String user_reference Stringa di riferimento, viene restituita se specificata durante l'invio di SMS Classic con rapporto di consegna String skebby_date_time Data di ricezione dai nostri sistemi del rapporto di consegna in formato RFC 2822
Vedi specifica RFC 2822String operator_date_time Data di ricezione del rapporto di consegna fornita del provider in formato RFC 2822
Vedi specifica RFC 2822
Esempio di body HTTP per ricezione rapporto di consegna SMS Classic Plus:
method=notify&skebby_dispatch_id=33146039&skebby_message_id=33433208&recipient=393471234567&status=DELIVERED
Come ricevere il rapporto di consegna con un invio di SMS multipli
Basta utilizzare congiuntamente i campi "ID spedizione" e "numero di cellulare del destinatario" messi a disposizione per ogni notifica inoltrata che rendono ogni notifica di consegna unica.
-
Per le richieste SOAP/REST dovrà essere implementato un metodo chiamato "notify" con argomenti:
Parametro Descrizione String skebby_dispatch_id Numero identificativo della spedizione String skebby_message_id Numero identificativo del singolo SMS String recipient Numero di telefono a cui è stato inviato l'SMS String status Codice del rapporto di consegna (vedi sotto per il dettaglio) String error_code Dettaglio del rapporto di consegna (vedi sotto) String user_reference Stringa di riferimento, viene restituita se specificata durante l'invio di SMS Classic con rapporto di consegna String skebby_date_time Data di ricezione dai nostri sistemi del rapporto di consegna in formato RFC 2822
Vedi specifica RFC 2822String operator_date_time Data di ricezione del rapporto di consegna fornita del provider in formato RFC 2822
Vedi specifica RFC 2822
Come ricevere il rapporto di consegna con un invio di SMS multipli
Basta utilizzare congiuntamente i campi "ID spedizione" e "numero di cellulare del destinatario" messi a disposizione per ogni notifica inoltrata che rendono ogni notifica di consegna unica.
Verranno restituiti i seguenti codici per la variabile status:
| Parametro | Significato |
|---|---|
| DELIVERED | Messaggio consegnato |
| EXPIRED | Messaggio scaduto (telefono spento/non raggiungibile) |
| DELETED | Errore rete operatore |
| UNDELIVERABLE | Messaggio non spedito (Vedi sotto variabile error_code) |
| UNKNOWN | Errore generico |
| REJECTD | Messaggio rifiutato dall'operatore |
Verranno restituiti i seguenti codici per la variabile error_code:
| Codice di errore | Significato |
|---|---|
| 401 | Messaggio scaduto (telefono spento/non raggiungibile) |
| 201 | Malfunzionamento rete operatore |
| 203 | Destinatario non raggiungibile (in roaming) |
| 301 | Destinatario non valido (inesistente/in portabilità/non abilitato) |
| 302 | Numero errato |
| 303 | Servizio SMS non abilitato |
| 304 | Testo riconosciuto come spam |
| 501 | Telefono non supporta l'SMS |
| 502 | Telefono con memoria piena |
| 901 | Mappatura errata del malfunzionamento |
| 902 | Servizio temporaneamente non disponibile |
| 903 | Nessun operatore disponibile |
| 904 | Messaggio privo di testo |
| 905 | Destinatario non valido |
| 906 | Destinatari duplicati |
| 907 | Compilazione messaggio non corretta |
| 909 | User_reference non corretta |
| 910 | Testo troppo lungo |
| 101 | Malfunzionamento generico operatore |
| 202 | Messaggio rifiutato dall'operatore |
Nota bene:
Qualora ricevevessi la versione precedente dei codici di consegna/errore e volessi attivare la ricezione dei parametri aggiornati sopra descritti vai su Skebby.it > Accedi > Impostazioni > Invio SMS > Inoltro rapporto di consegna dei messaggi.
Invio SMS Basic
-
Url per richieste HTTP:
http://gateway.skebby.it/api/send/smseasy/advanced/http.php
https://gateway.skebby.it/api/send/smseasy/advanced/http.php
I parametri devono essere passati con metodo POST, nello standard urlencode. È stato disabilitato il metodo GET perchè con tanti destinatari la richiesta potrebbe essere troncata.
Parametri obbligatori:
Parametro Descrizione String method send_sms_basic String username Username con cui ci si è registrati String password Password con cui ci si è registrati String[] recipients Destinatario/i, in formato internazionale senza + o 00, sotto forma di Array ad esempio:
recipients[]=393334455666&recipients[]=393334455667
Personalizzazione testo per ogni destinatario
Variabili dinamiche: è possibile personalizzare il testo del messaggio per ogni destinatario con delle variabili dinamiche (es. "Nome") che permettono di attivare le variabili con il valore specifico per ciascun destinatario. Ogni variabile sarà valorizzata per complessivi 20 caratteri indipendentemente dalla lunghezza dei singoli valori associati alla variabile per ciascun destinatario. Esempio:
Gentile ${nome}, le inviamo un buono sconto del 10% sul prossimo acquisto. Mostri questo SMS in negozio.
La stringa dei destinatari, sotto forma di Array multidimensionale, diverrà quindi:
recipients[0][recipient]=393471234567&recipients[0][nome]=Mario&recipients[1][recipient]=393477654321&recipients[1][nome]=Marco
String text Messaggio da spedire fino a lunghezza massima di 1404 caratteri spezzati su 9 messaggi consecutivi (1 di 9, 2 di 9, ...)
Visualizza metriche fatturazione per invio SMS lunghi (oltre 160 caratteri)
SMS lunghi: il destinatario riceverà il testo su più messaggi separati (1 di 3, 2 di 3 ...) Caratteri Numero di SMS addebitati 0-160 1 161-312 2 313-468 3 469-624 4 625-780 5 781-936 6 937-1092 7 1093-1248 8 1249-1404 9
Parametri opzionali:
Parametro Descrizione String charset Vedi nota sull'utilizzo del charset String delivery_start Per programmare invio SMS, usare il formato RFC 2822.
Vedi specifica RFC 2822
Esempio di body HTTP per invio multiplo SMS Basic:
method=send_sms_basic&username=user&password=pass&recipients[]=393471234567&recipients[]=393477654321&text=Ciao+Mario+sono+Luca+come+stai
-
Url per richieste REST:
http://gateway.skebby.it/api/send/smseasy/advanced/rest.php
https://gateway.skebby.it/api/send/smseasy/advanced/rest.php
I parametri delle richieste REST devono essere passati con metodo POST. È stato disabilitato il metodo GET perchè con tanti destinatari la richiesta potrebbe essere troncata.
Parametri obbligatori:
Parametro Descrizione String method send_sms_basic String username Username con cui ci si è registrati String password Password con cui ci si è registrati String[] recipients Destinatario/i, in formato internazionale senza + o 00, sotto forma di array JSON ad esempio:
recipients = [ "393334455666" , "393334455667" ];
Personalizzazione testo per ogni destinatario
Variabili dinamiche: è possibile personalizzare il testo del messaggio per ogni destinatario con delle variabili dinamiche (es. "Nome") che permettono di attivare le variabili con il valore specifico per ciascun destinatario. Ogni variabile sarà valorizzata per complessivi 20 caratteri indipendentemente dalla lunghezza dei singoli valori associati alla variabile per ciascun destinatario. Esempio:
Gentile ${nome}, le inviamo un buono sconto del 10% sul prossimo acquisto. Mostri questo SMS in negozio.
La stringa dei destinatari, sotto forma di Array JSON, diverrà quindi:
?recipients=[{recipient:'393471234567',nome:'Mario'},{recipient:'393477654321',nome:'Marco'}]
String text Messaggio da spedire fino a lunghezza massima di 1404 caratteri spezzati su 9 messaggi consecutivi (1 di 9, 2 di 9, ...)
Visualizza metriche fatturazione per invio SMS lunghi (oltre 160 caratteri)
SMS lunghi: il destinatario riceverà il testo su più messaggi separati (1 di 3, 2 di 3 ...) Caratteri Numero di SMS addebitati 0-160 1 161-312 2 313-468 3 469-624 4 625-780 5 781-936 6 937-1092 7 1093-1248 8 1249-1404 9
Parametri opzionali:
Parametro Descrizione String charset Vedi nota sull'utilizzo del charset String delivery_start Per programmare invio SMS, usare il formato RFC 2822.
Vedi specifica RFC 2822
Esempio di body REST per invio multiplo SMS Basic:
method=send_sms_basic&username=user&password=pass&recipients['393471234567','393477654321']&text=Ciao+Mario+sono+Luca+come+stai
-
Il file wsdl con la descrizione dei metodi è disponibile a questo indirizzo:
http://gateway.skebby.it/api/send/smseasy/advanced/soap.php?wsdl
https://gateway.skebby.it/api/send/smseasy/advanced/soap.php?wsdl
Parametri obbligatori:
Parametro Descrizione String username Username con cui ci si è registrati String password Password con cui ci si è registrati String[] recipients Destinatario/i, in formato internazionale senza + o 00, sotto forma di array di stringhe ad esempio in VB .NET:
Dim wnum = New String() {"393471234567", "393477654321"}
String text Messaggio da spedire fino a lunghezza massima di 1404 caratteri spezzati su 9 messaggi consecutivi (1 di 9, 2 di 9, ...)
Visualizza metriche fatturazione per invio SMS lunghi (oltre 160 caratteri)
SMS lunghi: il destinatario riceverà il testo su più messaggi separati (1 di 3, 2 di 3 ...) Caratteri Numero di SMS addebitati 0-160 1 161-312 2 313-468 3 469-624 4 625-780 5 781-936 6 937-1092 7 1093-1248 8 1249-1404 9
-
Come usare il protocollo SMTP per inviare SMS Basic anche da client/server email
Per inviare SMS con protocollo SMTP occorre abilitare prima di tutto il servizio indicando la casella email da usare per l'invio. Per configurarlo vai su Skebby.it > Accedi > Impostazioni > Email to SMS. Per inviare SMS da un'altra casella email, sarà sufficiente aggiungerla. Puoi aggiungere tutte le caselle email che desideri.
Parametri
Parametro Descrizione Destinatario dell'SMS Il numero del destinatario dell'SMS deve essere inserito all'interno del campo "A" o "CC" utilizzando il seguente formato: NUMERODICELLULARE@basic.skebby.com. Il numero di cellulare deve essere inserito nel formato internazionale secondo uno tra i seguenti esempi a scelta del cliente:
0039320XXXXXXX@basic.skebby.com
+39320XXXXXXX@basic.skebby.com
39320XXXXXXX@basic.skebby.com
Nota bene: è possibile utilizzare questa modalità solo per effettuare spedizioni fino a 50 email/SMS in simultanea. Se si inviano più di 50 email con questa modalità il servizio verrà bloccato.
Esempio: 00393334455666@basic.skebby.comDestinatari multipli/Invio massivo Per inviare fino a 100 email/SMS è possibile fare un invio multiplo inserendo l'indirizzo email di ciascun destinatario aggiuntivo nel campo "CC". Per invii maggiori di 100 e fino a 50.000 email/SMS aggiungi i destinatari dell'SMS nel formato standard nel corpo della mail dopo il carattere ## che indica la fine del testo SMS da inviare. Non è necessario inserire spazi o altri caratteri tra un destinatario e il successivo. Invio a gruppi Puoi inviare un SMS ad un gruppo precedentemente salvato su Skebby.it > Accedi > Contatti > Gruppi inserendolo nel campo "A" o "CC" dell'email utilizzando il seguente formato: NOMEGRUPPO@basic.skebby.com
Esempio: colleghi@basic.skebby.com
Il NOMEGRUPPO deve essere una parola unica, corrispondere al nome del gruppo salvato e contenere almeno un carattere alfabetico.
Per inviare SMS ai gruppi predefiniti:
- contatti "Preferiti" invia una mail a preferiti@basic.skebby.com
- contatti "Rubrica cellulare" invia una mail a rubricacellulare@basic.skebby.com
- "a tutti i contatti" invia una mail a tutti@basic.skebby.com
Testo dell'SMS Il testo dell'SMS deve essere scritto all'interno dello spazio dove solitamente scrivi il testo delle email e la lunghezza massima è 1404 caratteri ("9"). Se scrivi testo più lungo di 1404 caratteri l'SMS non verrà inviato e verrai allertato con una email. Se il corpo della mail è vuoto, l'email verrà inviata ma l'SMS non partirà (non verrà addebitato alcun SMS). Fine dell'SMS La coppia di caratteri ## indica la fine del testo del messaggio da inviare e identifica infatti la fine dell'SMS. Deve sempre essere inserito. Tutto il testo dopo di ## non verrà quindi inviato. Autenticazione tramite PIN È possibile richiedere l'autenticazione tramite PIN durante l'invio degli SMS da email, per una maggior sicurezza, configurandolo all'interno delle impostazioni del tuo account Skebby. Per inviare SMS da email con autenticazione PIN devi inserire tra i destinatari un indirizzo es. tuopin123@pin.skebby.com, dove "tuopin123" corrisponde ad un codice alfanumerico di sicurezza (minimo 6 caratteri di cui almeno un numero), che devi indicare nell'Area Riservata ovvero Skebby.it > Accedi > Impostazioni > Email to SMS. Se si opta per l'autenticazione tramite PIN, per inviare un SMS da qualunque indirizzo email registrato, sarà obbligatorio inserire anche come destinatario l'indirizzo email con PIN, altrimenti l'SMS non verrà inviato.
Invio SMS Skebby 0cent
-
Url per richieste HTTP:
http://gateway.skebby.it/api/send/smsskebby/advanced/http.php
https://gateway.skebby.it/api/send/smsskebby/advanced/http.php
I parametri devono essere passati con metodo POST, nello standard urlencode. È stato disabilitato il metodo GET perchè con tanti destinatari la richiesta potrebbe essere troncata.
Parametri obbligatori:
Parametro Descrizione String method send_sms String username Username con cui ci si è registrati String password Password con cui ci si è registrati String[] recipients Destinatario/i, in formato internazionale senza + o 00, sotto forma di Array ad esempio:
recipients[]=393334455666&recipients[]=393334455667
String text Messaggio da spedire, lunghezza massima 1600 caratteri String sender_number* Permette di specificare un qualsiasi numero di telefono come mittente, il numero deve essere in formato internazionale senza + o 00, ad esempio: 393334455666
Parametri opzionali:
Parametro Descrizione String charset Vedi nota sull'utilizzo del charset
Esempio di body HTTP per invio multiplo SMS Skebby 0cent con mittente numerico:
method=send_sms&username=user&password=pass&recipients[]=393471234567&recipients[]=393477654321&text=Ciao+Mario+come+stai&sender_number=393334455666
*Per motivi di sicurezza l'utilizzo del parametro (sender_number) è abilitato solamente agli utenti che hanno verificato il proprio numero di cellulare sul sito.
Per verificare e modificare il proprio numero di telefono sul sito è possibile utilizzare questo indirizzo:
http://www.skebby.it/webclient/index/index/ -
Url per richieste REST:
http://gateway.skebby.it/api/send/smsskebby/advanced/rest.php
https://gateway.skebby.it/api/send/smsskebby/advanced/rest.php
I parametri delle richieste REST devono essere passati con metodo POST. È stato disabilitato il metodo GET perchè con tanti destinatari la richiesta potrebbe essere troncata.
Parametri obbligatori:
Parametro Descrizione String method send_sms String username Username con cui ci si è registrati String password Password con cui ci si è registrati String[] recipients Destinatario/i, in formato internazionale senza + o 00, sotto forma di array JSON ad esempio:
recipients = [ "393334455666" , "393334455667" ];
String text Messaggio da spedire, lunghezza massima 1600 String sender_number* Permette di specificare un qualsiasi numero di telefono come mittente, il numero deve essere in formato internazionale senza + o 00, ad esempio: 393334455666
Parametri opzionali:
Parametro Descrizione String charset Vedi nota sull'utilizzo del charset
Esempio di body REST per invio multiplo SMS Skebby 0cent con mittente numerico:
method=send_sms&username=user&password=pass&recipients['393471234567','393477654321']&text=Ciao+Mario+come+stai&sender_number=393334455666
*Per motivi di sicurezza l'utilizzo del parametro (sender_number) è abilitato solamente agli utenti che hanno verificato il proprio numero di cellulare sul sito.
Per verificare e modificare il proprio numero di telefono sul sito è possibile utilizzare questo indirizzo:
http://www.skebby.it/webclient/index/index/ -
Come usare il protocollo SMTP per inviare SMS Skebby 0cent anche da client/server email
Per inviare SMS con protocollo SMTP occorre abilitare prima di tutto il servizio indicando la casella email da usare per l'invio. Per configurarlo vai su Skebby.it > Accedi > Impostazioni > Email to SMS. Per inviare SMS da un'altra casella email, sarà sufficiente aggiungerla. Puoi aggiungere tutte le caselle email che desideri.
Parametri
Parametro Descrizione Destinatario dell'SMS Il numero del destinatario dell'SMS deve essere inserito all'interno del campo "A" o "CC" utilizzando il seguente formato: NUMERODICELLULARE@0cent.skebby.com. Il numero di cellulare deve essere inserito nel formato internazionale secondo uno tra i seguenti esempi a scelta del cliente:
0039320XXXXXXX@0cent.skebby.com
+39320XXXXXXX@0cent.skebby.com
39320XXXXXXX@0cent.skebby.com
Nota bene: è possibile utilizzare questa modalità solo per effettuare spedizioni fino a 50 email/SMS in simultanea. Se si inviano più di 50 email con questa modalità il servizio verrà bloccato.
Esempio: 00393334455666@0cent.skebby.comDestinatari multipli/Invio massivo Per inviare fino a 100 email/SMS è possibile fare un invio multiplo inserendo l'indirizzo email di ciascun destinatario aggiuntivo nel campo "CC". Per invii maggiori di 100 e fino a 50.000 email/SMS aggiungi i destinatari dell'SMS nel formato standard nel corpo della mail dopo il carattere ## che indica la fine del testo SMS da inviare. Non è necessario inserire spazi o altri caratteri tra un destinatario e il successivo. Testo dell'SMS Il testo dell'SMS deve essere scritto all'interno dello spazio dove solitamente scrivi il testo delle email e la lunghezza massima è 1600 caratteri. Se scrivi testo più lungo di 1600 caratteri l'SMS non verrà inviato e verrai allertato con una email. Se il corpo della mail è vuoto, l'email verrà inviata ma l'SMS non partirà (non verrà addebitato alcun SMS). Fine dell'SMS La coppia di caratteri ## indica la fine del testo del messaggio da inviare e identifica infatti la fine dell'SMS. Deve sempre essere inserito. Tutto il testo dopo di ## non verrà quindi inviato. Autenticazione tramite PIN È possibile richiedere l'autenticazione tramite PIN durante l'invio degli SMS da email, per una maggior sicurezza, configurandolo all'interno delle impostazioni del tuo account Skebby. Per inviare SMS da email con autenticazione PIN devi inserire tra i destinatari un indirizzo es. tuopin123@pin.skebby.com, dove "tuopin123" corrisponde ad un codice alfanumerico di sicurezza (minimo 6 caratteri di cui almeno un numero), che devi indicare nell'Area Riservata ovvero Skebby.it > Accedi > Impostazioni > Email to SMS. Se si opta per l'autenticazione tramite PIN, per inviare un SMS da qualunque indirizzo email registrato, sarà obbligatorio inserire anche come destinatario l'indirizzo email con PIN, altrimenti l'SMS non verrà inviato.
Testing invio SMS
-
Parametri obbligatori:
Parametro Descrizione String method - test_send_sms_classic
- test_send_sms_classic_report
- test_send_sms_basic
String username Username con cui ci si è registrati String password Password con cui ci si è registrati String[] recipients Destinatario/i, in formato internazionale senza + o 00, sotto forma di Array ad esempio:
recipients[]=393334455666&recipients[]=393334455667
String text Messaggio da spedire
Lunghezza massima:- Classic 765 caratteri "5 SMS"
- Basic 1404 caratteri "9 SMS"
Parametri opzionali:
Parametro Descrizione String sender_number Permette di specificare un qualsiasi numero di telefono come mittente, il numero deve essere in formato internazionale senza + o 00, ad esempio: 393334455666 String sender_string Permette di specificare una stringa alfanumerica di lunghezza massima di 11 caratteri da utilizzare come mittente, caratteri supportati: [a-zA-Z0-9 .] String charset Vedi nota sull'utilizzo del charset
-
Parametri obbligatori:
Parametro Descrizione String method - test_send_sms_classic
- test_send_sms_classic_report
- test_send_sms_basic
String username Username con cui ci si è registrati String password Password con cui ci si è registrati String[] recipients Destinatario/i, in formato internazionale senza + o 00, sotto forma di array JSON ad esempio:
recipients = [ "393334455666" , "393334455667" ];
String text Messaggio da spedire
Lunghezza massima:- Classic 765 caratteri "5 SMS"
- Basic 1404 caratteri "9 SMS"
Parametri opzionali:
Parametro Descrizione String sender_number Permette di specificare un qualsiasi numero di telefono come mittente, il numero deve essere in formato internazionale senza + o 00, ad esempio: 393334455666 String sender_string Permette di specificare una stringa alfanumerica di lunghezza massima di 11 caratteri da utilizzare come mittente, caratteri supportati: [a-zA-Z0-9 .] String charset Vedi nota sull'utilizzo del charset
-
Parametri obbligatori:
Parametro Descrizione String username Username con cui ci si è registrati String password Password con cui ci si è registrati String[] recipients Destinatario/i, in formato internazionale senza + o 00, sotto forma di array di stringhe ad esempio in VB .NET:
Dim wnum = New String() {"393471234567", "393477654321"}
String text Messaggio da spedire
Lunghezza massima:- Classic 765 caratteri "5 SMS"
- Basic 1404 caratteri "9 SMS"
Parametri opzionali:
Parametro Descrizione String sender_number Permette di specificare un qualsiasi numero di telefono come mittente, il numero deve essere in formato internazionale senza + o 00, ad esempio: 393334455666 String sender_string Permette di specificare una stringa alfanumerica di lunghezza massima di 11 caratteri da utilizzare come mittente, caratteri supportati: [a-zA-Z0-9 .]
Controllo credito residuo
Parametri obbligatori:
| Parametro | Descrizione |
|---|---|
| String method | get_credit - Obbligatorio per HTTP e REST |
| String username | Username con cui ci si è registrati |
| String password | Password con cui ci si è registrati |
Parametri opzionali:
| Parametro | Descrizione |
|---|---|
| String charset | Vedi nota sull'utilizzo del charset |
Esempio di body HTTP per il controllo del credito residuo:
Charset
- ISO-8859-1 (Valore di default)
- UTF-8
Caratteri speciali
I caratteri speciali sono i seguenti:
| Carattere speciale | Descrizione |
|---|---|
| [ | Parentesi quadra aperta |
| \ | Backslash |
| ] | Parentesi quadra chiusa |
| ^ | Potenza |
| { | Parentesi graffa aperta |
| | | Barra verticale |
| } | Parentesi graffa chiusa |
| ~ | Tilde |
| € | Simbolo dell'euro |
Codici di errore
| Codice di errore | Significato |
|---|---|
| 10 | Errore generico |
| 11 | Charset non valido |
| 12 | Qualche parametro obbligatorio non è stato specificato |
| 20 | Parametri non validi |
| 21 | Username o password non validi |
| 22 | Mittente non valido |
| 23 | Mittente troppo lungo (oltre gli 11 caratteri) |
| 24 | Testo troppo lungo |
| 25 | Destinatario non valido |
| 26 | Mittente non impostato |
| 27 | Troppi destinatari |
| 29 | Il tuo account non è configurato per usare il gateway SMS |
| 30 | Credito insufficiente per inviare il messaggio |
| 31 | Sono accettatte solo richieste HTTP con metodo POST |
| 32 | Il formato del delivery_start non è valido, usa il formato RFC 2822 es: Mon, 15 Aug 2005 15:52:01 +0000 |
| 33 | L' encoding_scheme non è valido, valori accettati: normal, ucs2 visita http://en.wikipedia.org/wiki/GSM_03.38 per maggiori informazioni. |
| 34 | Il validity_period non è valido, deve essere un valore intero (espresso in minuti) più grande di 0 e minore di 2880 (2 giorni) |
| 35 | L' user_reference non è valido, deve avere una lunghezza massima di 20 caratteri [a-zA-Z0-9-_+:;] |
| 36 | Se hai impostato il delivery_start e vuoi il rapporto di consegna devi specificare obbligatoriatamente anche il campo user_reference |
| 37 | Stai inviando al gateway dei caratteri nel charset sbagliato, controlla il prametro charset |
Il limite massimo di destinatari che si possono inserire per un invio multiplo è di 50.000, per poter effettuare invii fino a 100.000 destinatari invia una mail a supporto@skebby.com
Ricezione SMS
Il servizio di "ricezione SMS" permette di ricevere SMS su un numero dedicato o su un numero condiviso tramite keyword, direttamente sul proprio server tramite una chiamata HTTP / Rest / Soap o attraverso l'invio di una email agli indirizzi indicati su Skebby.it > Accedi > Ricezione SMS. Alla ricezione di un SMS partirà una chiamata server-to-server (s2s) da Skebby verso l'url o l'indirizzo email impostato.
Charset
Tipi di inoltro disponibili:
| Parametro | Descrizione |
|---|---|
| String userDateTime | L'orario di arrivo dell'SMS |
| String sender | Numero del mittente dell'SMS in formato internazionale senza + o 00, ad esempio: 393334455666 |
| String text | Testo dell'SMS |
http GET
| Parametro | Descrizione |
|---|---|
| String sender | Numero del mittente dell'SMS in formato internazionale senza + o 00, ad esempio: 393334455666 |
| String receiver | Il numero su cui è arrivato l'SMS in formato internazionale senza + o 00, ad esempio: 393334455666 |
| String text | Testo dell'SMS |
| String encoding | Il set di caratteri usati per il testo (ISO-8859-1) |
| String date | La data di arrivo dell'SMS |
| String time | L'orario di arrivo dell'SMS |
| String timestamp | Il timestamp di arrivo dell'SMS; per comodità del programmatore passiamo tre formati differenti di data / ora |
| String smsType | Il tipo di SMS ricevuto (standard o Skebby) |
Esempio di body HTTP per ricezione SMS con parametri in GET:
http POST
| Parametro | Descrizione |
|---|---|
| String sender | Numero del mittente dell'SMS in formato internazionale senza + o 00, ad esempio: 393334455666 |
| String receiver | Il numero su cui è arrivato l'SMS in formato internazionale senza + o 00, ad esempio: 393334455666 |
| String text | Testo dell'SMS |
| String encoding | Il set di caratteri usati per il testo (ISO-8859-1) |
| String date | La data di arrivo dell'SMS |
| String time | L'orario di arrivo dell'SMS |
| String timestamp | Il timestamp di arrivo dell'SMS; per comodità del programmatore passiamo tre formati differenti di data / ora |
| String smsType | Il tipo di SMS ricevuto (standard o Skebby) |
Esempio di body HTTP per ricezione SMS con parametri in POST:
REST
| Parametro | Descrizione |
|---|---|
| String sender | Numero del mittente dell'SMS in formato internazionale senza + o 00, ad esempio: 393334455666 |
| String receiver | Il numero su cui è arrivato l'SMS in formato internazionale senza + o 00, ad esempio: 393334455666 |
| String text | Testo dell'SMS |
| String encoding | Il set di caratteri usati per il testo (ISO-8859-1) |
| String date | La data di arrivo dell'SMS |
| String time | L'orario di arrivo dell'SMS |
| String timestamp | Il timestamp di arrivo dell'SMS; per comodità del programmatore passiamo tre formati differenti di data / ora |
| String smsType | Il tipo di SMS ricevuto (standard o Skebby) |
Esempio di body HTTP per ricezione SMS con metodo REST:
SOAP
| Parametro | Descrizione |
|---|---|
| String sender | Numero del mittente dell'SMS in formato internazionale senza + o 00, ad esempio: 393334455666 |
| String receiver | Il numero su cui è arrivato l'SMS in formato internazionale senza + o 00, ad esempio: 393334455666 |
| String text | Testo dell'SMS |
| String date | La data di arrivo dell'SMS |
| String time | L'orario di arrivo dell'SMS |
| String timestamp | Il timestamp di arrivo dell'SMS; per comodità del programmatore passiamo tre formati differenti di data / ora |
| String smsType | Il tipo di SMS ricevuto (standard o Skebby) |
Esempio di body HTTP per ricezione SMS con metodo SOAP:
<?xml version="1.0" encoding="UTF-8"?>
<env:Envelope xmlns:env="http://www.w3.org/2003/05/soap-envelope" xmlns:ns1="url richiamata"
xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:enc="http://www.w3.org/2003/05/soap-encoding">
<env:Body>
<ns1:smsin env:encodingStyle="http://www.w3.org/2003/05/soap-encoding">
<sender xsi:type="xsd:string">393471234567</sender>
<receiver xsi:type="xsd:int">393477654321</receiver>
<text xsi:type="xsd:string">Ciao Mario come stai</text>
<date xsi:type="xsd:string">2011-05-20</date>
<time xsi:type="xsd:string">10:32:32</time>
<timestamp xsi:type="xsd:string">1305880352</timestamp>
<smsType xsi:type="xsd:string">standard</smsType>
</ns1:smsin>
</env:Body>
</env:Envelope>
Nota bene
Non è consentito l'uso delle API per invio o ricezione SMS da parte di applicazioni mobili di terze parti se queste hanno come finalità la pubblicazione sui market (App Store/Apple, Android Market/Google, App Store/Blackberry, Ovi Store/Nokia, Windows Phone Marketplace/Microsoft, Getjar, Mobango ed ogni altro market per applicazioni mobili in italia o all'estero). Ciò per evitare confusione tra utenti delle nostre app Skebby per cellulari e quelle di terze parti. Per eventuali chiarimenti e per saperne di più scrivici su supporto@skebby.com