Contacts   02 40 70 72 40
IT IT flag-down
PROVA GRATIS         ACCEDI

Documentazione SMS API

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
    Secure 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

    New 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. In caso di utilizzo di variabili il numero totale di caratteri/SMS verrà valorizzato durante l'invio in funzione della lunghezza effettiva del testo delle variabili di ciascun contatto in rubrica.
    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 1530 caratteri o 10 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 2822
    String 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 670 caratteri o 10 SMS concatenati in un unico messaggio. Per le modalità di conteggio si veda Modalità conteggio SMS lunghi UCS2

    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 (valore minimo 5 minuti), default 2gg = 2880(60*48)**

    Esempio di body HTTP per invio multiplo SMS Classic con mittente personalizzato alfanumerico:

    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 1530 o 10 SMS concatenati.

    Caratteri Numero di SMS addebitati
    0-160 1
    161-306 2
    307-459 3
    460-612 4
    613-765 5
    766-918 6
    919-1071 7
    1072-1224 8
    1225-1377 9
    1378-1530 10

    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 670 caratteri o 10 SMS concatenati.

    Caratteri Numero di SMS addebitati
    0-70 1
    71-134 2
    135-201 3
    202-268 4
    269-335 5
    336-402 6
    403-469 7
    470-536 8
    537-603 9
    604-670 10

    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://smsmessenger.skebby.it/
    **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
    Secure 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" ];

    New 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. In caso di utilizzo di variabili il numero totale di caratteri/SMS verrà valorizzato durante l'invio in funzione della lunghezza effettiva del testo delle variabili di ciascun contatto in rubrica.
    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 1530 caratteri o 10 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 2822
    String 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 670 caratteri o 10 SMS concatenati in un unico messaggio. Per le modalità di conteggio si veda Modalità conteggio SMS lunghi UCS2
    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 (valore minimo 5 minuti), default 2gg = 2880(60*48)**

    Esempio di body REST per invio multiplo SMS Classic con mittente personalizzato alfanumerico:

    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 1530 o 10 SMS concatenati.

    Caratteri Numero di SMS addebitati
    0-160 1
    161-306 2
    307-459 3
    460-612 4
    613-765 5
    766-918 6
    919-1071 7
    1072-1224 8
    1225-1377 9
    1378-1530 10

    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 670 caratteri o 10 SMS concatenati.

    0-70 1
    71-134 2
    135-201 3
    202-268 4
    269-335 5
    336-402 6
    403-469 7
    470-536 8
    537-603 9
    604-670 10

    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://smsmessenger.skebby.it/
    **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/soapv3.php?wsdl
    Secure https://gateway.skebby.it/api/send/smseasy/advanced/soapv3.php?wsdl

    Parametri obbligatori:
    Parametro Descrizione
    String username Username con cui ci si è registrati
    String password Password con cui ci si è registrati
    Recipient[] recipients Un Array di destinatari, in formato internazionale senza + o 00

    New 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. In caso di utilizzo di variabili il numero totale di caratteri/SMS verrà valorizzato durante l'invio in funzione della lunghezza effettiva del testo delle variabili di ciascun contatto in rubrica.
    Esempio:
    Gentile ${nome}, le inviamo un buono sconto del 10% sul prossimo acquisto. Mostri questo SMS in negozio.

    I destinatari vanno inviati sotto forma di Array di oggetti Recipient, ciascuno contenente il numero del destinatario ed un eventuale Array di variabili dinamiche.

    String text Testo del messaggio fino a lunghezza massima di 1530 caratteri o 10 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 delivery_start Per programmare invio SMS, usare il formato RFC 2822.
    Vedi specifica RFC 2822
    String 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 670 caratteri o 10 SMS concatenati in un unico messaggio. Per le modalità di conteggio si veda Modalità conteggio SMS lunghi UCS2

    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 (valore minimo 5 minuti), default 2gg = 2880(60*48)**

    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 1530 o 10 SMS concatenati.

    Caratteri Numero di SMS addebitati
    0-160 1
    161-306 2
    307-459 3
    460-612 4
    613-765 5
    766-918 6
    919-1071 7
    1072-1224 8
    1225-1377 9
    1378-1530 10

    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 670 caratteri o 10 SMS concatenati.

    Caratteri Numero di SMS addebitati
    0-70 1
    71-134 2
    135-201 3
    202-268 4
    269-335 5
    336-402 6
    403-469 7
    470-536 8
    537-603 9
    604-670 10

    *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://smsmessenger.skebby.it/

  • 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 www.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.com
    Destinatari 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 www.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 è 1530 caratteri ("10"). Se scrivi testo più lungo di 1530 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 www.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 + (con rapporto di consegna)

Invia un SMS Classic con rapporto di consegna 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
    Secure 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

    New 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. In caso di utilizzo di variabili il numero totale di caratteri/SMS verrà valorizzato durante l'invio in funzione della lunghezza effettiva del testo delle variabili di ciascun contatto in rubrica.
    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 1530 caratteri o 10 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 2822
    String 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 670 caratteri o 10 SMS concatenati in un unico messaggio. Per le modalità di conteggio si veda Modalità conteggio SMS lunghi UCS2
    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 (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:

    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 1530 o 10 SMS concatenati.

    Caratteri Numero di SMS addebitati
    0-160 1
    161-306 2
    307-459 3
    460-612 4
    613-765 5
    766-918 6
    919-1071 7
    1072-1224 8
    1225-1377 9
    1378-1530 10

    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 670 caratteri o 10 SMS concatenati.

    Caratteri Numero di SMS addebitati
    0-70 1
    71-134 2
    135-201 3
    202-268 4
    269-335 5
    336-402 6
    403-469 7
    470-536 8
    537-603 9
    604-670 10

    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://smsmessenger.skebby.it/
    **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
    Secure 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" ];

    New 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. In caso di utilizzo di variabili il numero totale di caratteri/SMS verrà valorizzato durante l'invio in funzione della lunghezza effettiva del testo delle variabili di ciascun contatto in rubrica.
    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 1530 caratteri o 10 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 2822
    String 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 670 caratteri o 10 SMS concatenati in un unico messaggio. Per le modalità di conteggio si veda Modalità conteggio SMS lunghi UCS2
    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 (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:

    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 1530 o 10 SMS concatenati.

    Caratteri Numero di SMS addebitati
    0-160 1
    161-306 2
    307-459 3
    460-612 4
    613-765 5
    766-918 6
    919-1071 7
    1072-1224 8
    1225-1377 9
    1378-1530 10

    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 670 caratteri o 10 SMS concatenati.

    0-70 1
    71-134 2
    135-201 3
    202-268 4
    269-335 5
    336-402 6
    403-469 7
    470-536 8
    537-603 9
    604-670 10

    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://smsmessenger.skebby.it/
    **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/soapv3.php?wsdl
    Secure https://gateway.skebby.it/api/send/smseasy/advanced/soapv3.php?wsdl

    Parametri obbligatori:
    Parametro Descrizione
    String username Username con cui ci si è registrati
    String password Password con cui ci si è registrati
    Recipient[] recipients Un Array di destinatari, in formato internazionale senza + o 00

    New 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. In caso di utilizzo di variabili il numero totale di caratteri/SMS verrà valorizzato durante l'invio in funzione della lunghezza effettiva del testo delle variabili di ciascun contatto in rubrica.
    Esempio:
    Gentile ${nome}, le inviamo un buono sconto del 10% sul prossimo acquisto. Mostri questo SMS in negozio.

    I destinatari vanno inviati sotto forma di Array di oggetti Recipient, ciascuno contenente il numero del destinatario ed un eventuale Array di variabili dinamiche.

    String text Testo del messaggio fino a lunghezza massima di 1530 caratteri o 10 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 delivery_start Per programmare invio SMS, usare il formato RFC 2822.
    Vedi specifica RFC 2822
    String 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 670 caratteri o 10 SMS concatenati in un unico messaggio. Per le modalità di conteggio si veda Modalità conteggio SMS lunghi UCS2
    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 (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-_+:;]

    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 1530 o 10 SMS concatenati.

    Caratteri Numero di SMS addebitati
    0-160 1
    161-306 2
    307-459 3
    460-612 4
    613-765 5
    766-918 6
    919-1071 7
    1072-1224 8
    1225-1377 9
    1378-1530 10

    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 670 caratteri o 10 SMS concatenati.

    0-70 1
    71-134 2
    135-201 3
    202-268 4
    269-335 5
    336-402 6
    403-469 7
    470-536 8
    537-603 9
    604-670 10

    *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://smsmessenger.skebby.it/

  • 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 www.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.com
    Destinatari 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 www.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 è 1530 caratteri ("10"). Se scrivi testo più lungo di 1530 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 www.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 +

Se utilizzi sms classic+ è possibile ricevere il rapporto di consegna (notifica o errore) dei messaggi inviati in tre modalità:
  1. In tempo reale con una chiamata per singolo SMS Inviato.
    Per configurarlo vai su Skebby.it > Accedi > Impostazioni > Invio SMS > Inoltro rapporto di consegna dei messaggi e indica lì il protocollo di invio desiderato (GET/POST/REST/SOAP) e la url di destinazione per il rapporto.
    Dopo aver modificato l'url di inoltro è necessario attendere 20 secondi prima che l'impostazione sia resa effettiva.
    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.
  2. In modalità batch una volta al giorno tramite l'invio di file CSV contenente tutti i rapporti di consegna del giorno precedente. Per attivare questa modalità scrivici a supporto@skebby.it specificando l'indirizzo email su cui ricevere quotidianamente il rapporto (deve essere un solo indirizzo), se il file CSV deve essere compresso (zip) oppure no e se desideri includere nel rapporto solo le notifiche relative agli errori oppure tutte le notifiche comprese quelle degli SMS consegnati correttamente.
  3. Puoi visualizzare e scaricare i rapporti di consegna dall'interfaccia web SMS Messenger andando su Skebby > 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 2822
    String 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 +:

    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 2822
    String 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
101 Malfunzionamento generico operatore
201 Malfunzionamento rete operatore
202 Messaggio rifiutato dall'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
401 Messaggio scaduto (telefono spento/non raggiungibile)
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
Clicca qui per visualizzare un esempio di risposta del server in caso di invio di SMS Classic +

Nota bene:

Qualora ricevessi 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.

Richiesta di approvazione mittente alfanumerico

Questa funzione ti consente di inserire le informazioni relative agli Alias, cioè i mittenti alfanumerici dei tuoi sms, come richiesto dalla Delibera N. 42/13/CIR dell'AGCOM (Autorità Garante delle Comunicazioni) entrata in vigore il 16/10/2013.
Visualizza ulteriori informazioni.
Oltre alla procedura manuale di richiesta di registrazione eseguibile dalla interfaccia web SMS Messenger di Skebby è possibile fare una richiesta di approvazione del nuovo utente alfanumerico in automatico seguendo la seguente documentazione.


  • Url per richieste HTTP:

    http://gateway.skebby.it/api/send/smseasy/advanced/http.php
    Secure https://gateway.skebby.it/api/send/smseasy/advanced/http.php

    I parametri devono essere passati con metodo POST, nello standard urlencode.

    Parametri obbligatori:
    Parametro Descrizione
    String method add_alias
    String username Username con cui ci si è registrati
    String password Password con cui ci si è registrati
    String alias Nome mittente alfanumerico
    String business_name Nome azienda
    String nation Nazione (2 caratteri, maiuscoli, ISO 3166-1 alpha-2)
    String vat_number Partita IVA
    String taxpayer_number Codice fiscale (eventualmente uguale alla Partita IVA, anche per Enti e associazioni)
    String street Indirizzo
    String city Città
    String postcode Codice postale
    String contact Informazioni di contatto (email, numero telefonico)

    Parametri opzionali:
    Parametro Descrizione
    String charset Vedi nota sull'utilizzo del charset


    Esempio di body HTTP per aggiungere un mittente alfanumerico:


    Valori accettati come mittente alfanumerico (Alias)
    Il mittente alfanumerico:
    • potrà essere lungo al più 11 caratteri (ad eccezione del carattere che corrisponde all'uso di 2 caratteri);
    • oltre ai comuni caratteri alfanumerici, può contenere i seguenti caratteri speciali èéùìòà!',.:;?"$£€%()+-=@_#&* e gli spazi (non consecutivi);
    • potranno essere presenti esclusivamente due virgolette: una come apertura ed una come chiusura. La prima non può precedere uno spazio e la seconda non può seguire uno spazio.

    Per informazioni dettagliate si vedano le regole AGCOM sul mittente SMS personalizzato.


  • Url per richieste REST:

    http://gateway.skebby.it/api/send/smseasy/advanced/rest.php
    Secure https://gateway.skebby.it/api/send/smseasy/advanced/rest.php

    I parametri delle richieste REST devono essere passati con metodo POST.

    Parametri obbligatori:
    Parametro Descrizione
    String method add_alias
    String username Username con cui ci si è registrati
    String password Password con cui ci si è registrati
    String alias Nome mittente alfanumerico
    String business_name Nome azienda
    String nation Nazione (2 caratteri, maiuscoli, ISO 3166-1 alpha-2)
    String vat_number Partita IVA
    String taxpayer_number Codice fiscale (eventualmente uguale alla Partita IVA, anche per Enti e associazioni)
    String street Indirizzo
    String city Città
    String postcode Codice postale
    String contact Informazioni di contatto (email, numero telefonico)

    Parametri opzionali:
    Parametro Descrizione
    String charset Vedi nota sull'utilizzo del charset


    Esempio di body REST per aggiungere un mittente alfanumerico:


    Valori accettati come mittente alfanumerico (Alias)
    Il mittente alfanumerico:
    • potrà essere lungo al più 11 caratteri (ad eccezione del carattere che corrisponde all'uso di 2 caratteri);
    • oltre ai comuni caratteri alfanumerici, può contenere i seguenti caratteri speciali èéùìòà!',.:;?"$£€%()+-=@_#&* e gli spazi (non consecutivi);
    • potranno essere presenti esclusivamente due virgolette: una come apertura ed una come chiusura. La prima non può precedere uno spazio e la seconda non può seguire uno spazio.

    Per informazioni dettagliate si vedano le regole AGCOM sul mittente SMS personalizzato.


  • Il file wsdl con la descrizione dei metodi è disponibile a questo indirizzo:

    http://gateway.skebby.it/api/send/smseasy/advanced/soapv3.php?wsdl
    Secure https://gateway.skebby.it/api/send/smseasy/advanced/soapv3.php?wsdl

    Parametri obbligatori:
    Parametro Descrizione
    String username Username con cui ci si è registrati
    String password Password con cui ci si è registrati
    String alias Nome mittente alfanumerico
    String business_name Nome azienda
    String nation Nazione (2 caratteri, maiuscoli, ISO 3166-1 alpha-2)
    String vat_number Partita IVA
    String taxpayer_number Codice fiscale (eventualmente uguale alla Partita IVA, anche per Enti e associazioni)
    String street Indirizzo
    String city Città
    String postcode Codice postale
    String contact Informazioni di contatto (email, numero telefonico)


    Valori accettati come mittente alfanumerico (Alias)
    Il mittente alfanumerico:
    • potrà essere lungo al più 11 caratteri (ad eccezione del carattere che corrisponde all'uso di 2 caratteri);
    • oltre ai comuni caratteri alfanumerici, può contenere i seguenti caratteri speciali èéùìòà!',.:;?"$£€%()+-=@_#&* e gli spazi (non consecutivi);
    • potranno essere presenti esclusivamente due virgolette: una come apertura ed una come chiusura. La prima non può precedere uno spazio e la seconda non può seguire uno spazio.

    Per informazioni dettagliate si vedano le regole AGCOM sul mittente SMS personalizzato.



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
    Secure 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

    New 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. In caso di utilizzo di variabili il numero totale di caratteri/SMS verrà valorizzato durante l'invio in funzione della lunghezza effettiva del testo delle variabili di ciascun contatto in rubrica.
    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 1560 caratteri spezzati su 10 messaggi consecutivi (1 di 10, 2 di 10, ...)

    New 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
    1405-1560 10

    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:



  • Url per richieste REST:

    http://gateway.skebby.it/api/send/smseasy/advanced/rest.php
    Secure 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" ];

    New 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. In caso di utilizzo di variabili il numero totale di caratteri/SMS verrà valorizzato durante l'invio in funzione della lunghezza effettiva del testo delle variabili di ciascun contatto in rubrica.
    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 1560 caratteri spezzati su 10 messaggi consecutivi (1 di 10, 2 di 10, ...)

    New 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
    1405-1560 10

    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:



  • Il file wsdl con la descrizione dei metodi è disponibile a questo indirizzo:

    http://gateway.skebby.it/api/send/smseasy/advanced/soapv3.php?wsdl
    Secure https://gateway.skebby.it/api/send/smseasy/advanced/soapv3.php?wsdl

    Parametri obbligatori:
    Parametro Descrizione
    String username Username con cui ci si è registrati
    String password Password con cui ci si è registrati
    Recipient[] recipients Un Array di destinatari, in formato internazionale senza + o 00

    New 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. In caso di utilizzo di variabili il numero totale di caratteri/SMS verrà valorizzato durante l'invio in funzione della lunghezza effettiva del testo delle variabili di ciascun contatto in rubrica.
    Esempio:
    Gentile ${nome}, le inviamo un buono sconto del 10% sul prossimo acquisto. Mostri questo SMS in negozio.

    I destinatari vanno inviati sotto forma di Array di oggetti Recipient, ciascuno contenente il numero del destinatario ed un eventuale Array di variabili dinamiche.

    String text Messaggio da spedire fino a lunghezza massima di 1560 caratteri spezzati su 10 messaggi consecutivi (1 di 10, 2 di 10, ...)

    New 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
    1405-1560 10

    Parametri opzionali:
    Parametro Descrizione
    String delivery_start Per programmare invio SMS, usare il formato RFC 2822.
    Vedi specifica RFC 2822





  • 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 www.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.com
    Destinatari 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 www.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 è 1560 caratteri ("10"). Se scrivi testo più lungo di 1560 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 www.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

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
    Secure 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:

    *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://smsmessenger.skebby.it/

  • Url per richieste REST:

    http://gateway.skebby.it/api/send/smsskebby/advanced/rest.php
    Secure 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:

    *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://smsmessenger.skebby.it/

  • 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 www.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.com
    Destinatari 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 www.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 + 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 1530 caratteri "10 SMS"
    • Basic 1560 caratteri "10 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 1530 caratteri "10 SMS"
    • Basic 1560 caratteri "10 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
    Recipient[] recipients Un Array di destinatari, in formato internazionale senza + o 00
    String text Messaggio da spedire
    Lunghezza massima:
    • Classic 1530 caratteri "10 SMS"
    • Basic 1560 caratteri "10 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


  • Url per richieste HTTP:

    http://gateway.skebby.it/api/send/smseasy/advanced/http.php
    Secure https://gateway.skebby.it/api/send/smseasy/advanced/http.php

    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:

    In alternativa è possibile visualizzare il credito residuo andando su Skebby.it > Accedi

  • Url per richieste REST:

    http://gateway.skebby.it/api/send/smseasy/advanced/rest.php
    Secure https://gateway.skebby.it/api/send/smseasy/advanced/rest.php

    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

    In alternativa è possibile visualizzare il credito residuo andando su Skebby.it > Accedi


  • Il file wsdl con la descrizione dei metodi è disponibile a questo indirizzo:

    http://gateway.skebby.it/api/send/smseasy/advanced/soapv3.php?wsdl
    Secure https://gateway.skebby.it/api/send/smseasy/advanced/soapv3.php?wsdl

    Parametri obbligatori:
    Parametro Descrizione
    String username Username con cui ci si è registrati
    String password Password con cui ci si è registrati

    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:

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 accettate 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 obbligatoriamente anche il campo user_reference
37 Stai inviando al gateway dei caratteri nel charset sbagliato, controlla il parametro 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, attraverso l'invio di una email agli indirizzi indicati su Skebby.it > Accedi > Ricezione SMS o ancora con inoltro su foglio elettronico di Google Drive. Alla ricezione di un SMS partirà una chiamata server-to-server (s2s) da Skebby verso l'url o l'indirizzo email o il link al foglio di Google Drive impostato.

Se stai provando gratuitamente il servizio di "ricezione SMS" con 100 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.

Charset
il parametro charset di default è ISO-8859-1. Per modificarlo accedi a Skebby.it > Ricezione SMS > Impostazioni > Inoltra SMS ricevuti su URL.

Tipi di inoltro disponibili:

Email

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

Foglio elettronico di Google Drive

Skebby inoltrerà il messaggio al link del foglio elettronico di Google Drive, 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
String contacts Il nome del contatto (se presente in rubrica)

http GET

Skebby chiamerà l'URL specificato nell'area riservata passando i seguenti 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:

http POST

Skebby chiamerà l'URL specificato nell'area riservata passando i seguenti 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:

REST

Skebby chiamerà l'URL specificato nell'area riservata invocando il metodo REST "restGet" a cui passa l'url e i seguenti parametri:
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

Skebby chiamerà l'URL specificato nell'area riservata invocando il metodo SOAP "smsin" con i seguenti parametri (nell'ordine in cui sono qui indicati):
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:




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

Sei un rivenditore?
Guarda le nostre API per White Label
API White Label