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
Invia un SMS Classic e restituisce il numero di SMS residui
-
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 Messaggio da spedire fino a lunghezza massima di 765 caratteri ("5 SMS") concatenati in un unico messaggio.
Visualizza metriche fatturazione per invio SMS lunghi (oltre 160 caratteri)
SMS lunghi: il destinatario riceverà il testo su un unico messaggio concatenato: Caratteri Numero di SMS addebitati 0-160 1 161-306 2 307-459 3 460-612 4 613-765 5
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 delle lingue straniere (Arabo, Cinese, Coreano, Cirillico, Giapponese e simili)
Valori accettati:- normal (7 bit, default)
- 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.
Visualizza metriche fatturazione per invio SMS lunghi (oltre 160 caratteri)
SMS lunghi: il destinatario riceverà il testo su un unico messaggio concatenato: Caratteri Numero di SMS addebitati 0-70 1 71-134 2 135-201 3 202-268 4 269-335 5 Integer 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, 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
*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 Messaggio da spedire fino a lunghezza massima di 765 caratteri ("5 SMS") concatenati in un unico messaggio
Visualizza metriche fatturazione per invio SMS lunghi (oltre 160 caratteri)
SMS lunghi: il destinatario riceverà il testo su un unico messaggio concatenato: Caratteri Numero di SMS addebitati 0-160 1 161-306 2 307-459 3 460-612 4 613-765 5
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 delle lingue straniere (Arabo, Cinese, Coreano, Cirillico, Giapponese e simili)
Valori accettati:- normal (7 bit, default)
- 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.
Visualizza metriche fatturazione per invio SMS lunghi (oltre 160 caratteri)
SMS lunghi: il destinatario riceverà il testo su un unico messaggio concatenato: Caratteri Numero di SMS addebitati 0-70 1 71-134 2 135-201 3 202-268 4 269-335 5 Integer 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, 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
*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 Messaggio da spedire fino a lunghezza massima di 765 caratteri ("5 SMS") concatenati in un unico messaggio
Visualizza metriche fatturazione per invio SMS lunghi (oltre 160 caratteri)
SMS lunghi: il destinatario riceverà il testo su un unico messaggio concatenato: Caratteri Numero di SMS addebitati 0-160 1 161-306 2 307-459 3 460-612 4 613-765 5
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 .]
*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
Esempio: 00393334455666@classic.skebby.comDestinatari multipli/Invio massivo Puoi inviare un SMS a più destinatari simultaneamente, basta aggiungere l'indirizzo email per ciascun destinatario aggiuntivo nel campo "A" o "CC" o dopo il carattere ## di fine SMS. 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. 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 notifica)
Invia un SMS Classic con Notifica e restituisce il numero
di SMS residui e il codice identificativo (id) della spedizione.
-
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 Messaggio da spedire fino a lunghezza massima di 765 caratteri ("5 SMS") concatenati in un unico messaggio
Visualizza metriche fatturazione per invio SMS lunghi (oltre 160 caratteri)
SMS lunghi: il destinatario riceverà il testo su un unico messaggio concatenato: Caratteri Numero di SMS addebitati 0-160 1 161-306 2 307-459 3 460-612 4 613-765 5
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 delle lingue straniere (Arabo, Cinese, Coreano, Cirillico, Giapponese e simili)
Valori accettati:- normal (7 bit, default)
- 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.
Visualizza metriche fatturazione per invio SMS lunghi (oltre 160 caratteri)
SMS lunghi: il destinatario riceverà il testo su un unico messaggio concatenato: Caratteri Numero di SMS addebitati 0-70 1 71-134 2 135-201 3 202-268 4 269-335 5 Integer 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, default 2gg = 2880(60*48)**Varchar(20) user_reference Stringa di riferimento personalizzabile che verrà restituita insieme alla notifica di consegna.
Caratteri supportati: [a-zA-Z0-9-_+:;]
Esempio di body HTTP per invio multiplo SMS Classic con Notifica 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
*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 Messaggio da spedire fino a lunghezza massima di 765 caratteri ("5 SMS") concatenati in un unico messaggio
Visualizza metriche fatturazione per invio SMS lunghi (oltre 160 caratteri)
SMS lunghi: il destinatario riceverà il testo su un unico messaggio concatenato: Caratteri Numero di SMS addebitati 0-160 1 161-306 2 307-459 3 460-612 4 613-765 5
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 delle lingue straniere (Arabo, Cinese, Coreano, Cirillico, Giapponese e simili)
Valori accettati:- normal (7 bit, default)
- 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.
Visualizza metriche fatturazione per invio SMS lunghi (oltre 160 caratteri)
SMS lunghi: il destinatario riceverà il testo su un unico messaggio concatenato: Caratteri Numero di SMS addebitati 0-70 1 71-134 2 135-201 3 202-268 4 269-335 5 Integer 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, default 2gg = 2880(60*48)**Varchar(20) user_reference Stringa di riferimento personalizzabile che verrà restituita insieme alla notifica di consegna.
Caratteri supportati: [a-zA-Z0-9-_+:;]
Esempio di body REST per invio multiplo SMS Classic con Notifica con mittente personalizzato numerico:
method=send_sms_classic_report&username=user&password=pass&recipients['393471234567','393477654321']&text=Ciao+Mario+come+stai&sender_number=393334455666
*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 Messaggio da spedire fino a lunghezza massima di 765 caratteri ("5 SMS") concatenati in un unico messaggio
Visualizza metriche fatturazione per invio SMS lunghi (oltre 160 caratteri)
SMS lunghi: il destinatario riceverà il testo su un unico messaggio concatenato: Caratteri Numero di SMS addebitati 0-160 1 161-306 2 307-459 3 460-612 4 613-765 5
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 .]
*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
Esempio: 00393334455666@classicplus.skebby.comDestinatari multipli/Invio massivo Puoi inviare un SMS a più destinatari simultaneamente, basta aggiungere l'indirizzo email per ciascun destinatario aggiuntivo nel campo "A" o "CC" o dopo il carattere ## di fine SMS. 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. 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 le notifiche di consegna per SMS Classic Plus (vers. aggiornata)
È possibile ricevere la notifica di consegna dei messaggi inviati se utilizzi SMS Classic Plus.
Per configurarla vai su Skebby.it > Accedi > Impostazioni > Invio SMS > Inolto notifica di consegna dei messaggi
e indica lì il protocollo di invio desiderato (GET/POST/REST/SOAP) e la url di destinazione per le notifiche.
Nel momento in cui il server Skebby invoca la URL indicataci per l'inoltro delle notifiche e la stessa URL non fosse raggiungibile, il server Skebby proverà a riconsegnare la notifica 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 delle notifiche di consegna andando su Skebby.it > Accedi > Contabilità SMS > Traffico e notifiche > Messaggi e stato di consegna.
Verranno restituiti i seguenti codici per la variabile status:
Verranno restituiti i seguenti codici per la variabile error_code:
Clicca qui per visualizzare un esempio di risposta del server in caso di invio di SMS Classic Plus
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 notifica di consegna dei messaggi.
Nel momento in cui il server Skebby invoca la URL indicataci per l'inoltro delle notifiche e la stessa URL non fosse raggiungibile, il server Skebby proverà a riconsegnare la notifica 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 delle notifiche 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 della notifica (Vedi sotto per il dettaglio) String error_code Dettaglio della notifica (Vedi sotto) String user_reference Stringa di riferimento, viene restituita se specificata durante l'invio di SMS Classic con notifica String skebby_date_time Data di ricezione dai nostri sistemi della notifica in formato RFC 2822
Vedi specifica RFC 2822String operator_date_time Data di ricezione della notifica fornita del provider in formato RFC 2822
Vedi specifica RFC 2822
Esempio di body HTTP per ricezione notifica SMS Classic Plus:
method=notify&skebby_dispatch_id=33146039&skebby_message_id=33433208&recipient=393471234567&status=DELIVERED
-
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 della notifica (Vedi sotto per il dettaglio) String error_code Dettaglio della notifica (Vedi sotto) String user_reference Stringa di riferimento, viene restituita se specificata durante l'invio di SMS Classic con notifica String skebby_date_time Data di ricezione dai nostri sistemi della notifica in formato RFC 2822
Vedi specifica RFC 2822String operator_date_time Data di ricezione della notifica fornita del provider in formato RFC 2822
Vedi specifica RFC 2822
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 notifica di consegna dei messaggi.
Invio SMS Skebby 0cent
Invia un SMS Skebby 0cent a tutti gli utenti con Skebby sul cellulare
-
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
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 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
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 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 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 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
Esempio: 00393334455666@0cent.skebby.comDestinatari multipli/Invio massivo Puoi inviare un SMS a più destinatari simultaneamente, basta aggiungere l'indirizzo email per ciascun destinatario aggiuntivo nel campo "A" o "CC" o dopo il carattere ## di fine SMS. 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. 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 Basic
Invia un SMS Basic e restituisce il numero di SMS residui
-
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
Esempio: 00393334455666@basic.skebby.comDestinatari multipli/Invio massivo Puoi inviare un SMS a più destinatari simultaneamente, basta aggiungere l'indirizzo email per ciascun destinatario aggiuntivo nel campo "A" o "CC" o dopo il carattere ## di fine SMS. 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. 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
Questi metodi non inviano veramente l'SMS, servono per testare l'invio
di SMS Classic, SMS Classic Plus e SMS Basic.
-
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:
method=get_credit&username=user&password=pass
In alternativa è possibile visualizzare il credito residuo andando su Skebby.it > Accedi
Charset
In caso di richiesta SOAP il parametro charset
NON deve essere specificato e verrà ignorato.
Per i protocolli HTTP e REST, il parametro charset può
essere impostato con uno dei seguenti valori:
- ISO-8859-1 (Valore di default)
- UTF-8
Caratteri speciali
Alcuni caratteri speciali, che hanno bisogno di essere gestiti in maniera differente, durante la composizione
del messaggio verranno contati come doppi nella lunghezza complessiva dell'SMS.
I caratteri speciali sono i seguenti:
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
In caso di invio di una spedizione che contenga un messaggio indirizzato ad un numero di cellulare ripetuto più di una volta, il sistema permette l’invio in modalità asincrona dei messaggi duplicati. Infatti il messaggio verrà inoltrato al primo numero di cellullare mentre il secondo/successivo verranno scartati. Andando su Skebby.it > Accedi > Contabilità SMS > Traffico e notifiche > Messaggi e stato di consegna potrà visualizzare il dettaglio dell’errore generato: "Destinatari duplicati".
| 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 la notifica devi specificare obbligatoriatamente anche il campo user_reference |
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.
Se stai provando gratuitamente il servizio di "ricezione SMS" con 10 SMS
in omaggio, ricorda che non è possibile inviare un SMS Basic o Classic per testare la ricezione,
ma è necessario inviare l'SMS direttamente da un cellulare italiano o estero via SIM.
Tipi di inoltro disponibili:
Skebby inoltrerà il messaggio via Email utilizzando i seguenti parametri:
| 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
Skebby chiamerà l'URL specificato nell'area riservata passando i seguenti parametri in GET:
Esempio di body HTTP per ricezione SMS con parametri in 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:
type=GET&sender=393471234567&receiver=393477654321&text=Ciao+Mario+come+stai&encoding=ISO-8859-1&date=2011-05-20&time=10%3A32%3A32×tamp=1305880352&smsType=standard
http POST
Skebby chiamerà l'URL specificato nell'area riservata passando i seguenti parametri in POST:
Esempio di body HTTP per ricezione SMS con parametri in 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:
type=POST&sender=393471234567&receiver=393477654321&text=Ciao+Mario+come+stai&encoding=ISO-8859-1&date=2011-05-20&time=10%3A32%3A32×tamp=1305880352&smsType=standard
REST
Skebby chiamerà l'URL specificato nell'area riservata invocando
il metodo REST "restGet" a cui passa l'url e i seguenti parametri:
Esempio di body HTTP per ricezione SMS con metodo 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:
method=smsin&sender=393471234567&receiver=393477654321&text=Ciao+Mario+come+stai&encoding=ISO-8859-1&date=2011-05-20&time=10%3A32%3A32×tamp=1305880352&smsType=standard
SOAP
Skebby chiamerà l'URL specificato nell'area riservata invocando il metodo SOAP
"smsin" con i seguenti parametri (nell'ordine in cui sono qui indicati):
Esempio di body HTTP per ricezione SMS con metodo 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