integrazione spazio web hosting rubalo - registrazione domini internet

Integrazione Servizi

SMS

Il servizio Rubalo.it!-SMS permette di inviare
dal tuo sito web messaggi a costi ridottissimi
fino a € 0,045 per SMS inviato.

INTERFACCIA DEL PANNELLO DI CONTROLLO:

Nel pannello di controllo messo a disposizione di tutti gli utenti Rubalo.it un apposita sezione è dedicata alla gestione del servizio SMS, e consente di:

- inviare un singolo SMS ad un singolo utente

- inviare un singolo SMS ad una pluralità di utenti

- visualizzare il credito rimasto (come numero di sms spedibili)

- visualizzare l'elenco degli ultimi invii effettuati

- consultare istruzioni più dettagliate di queste per utilizzare il gateway sms direttamente dal sito web

- ottenere le esatte credenziali ed indirizzi da usare per utilizzare il gateway sms direttamente dal sito web

- ordinare ricarica del credito in sms

- modificare la propria password di accesso al servizio sms.

USO DIRETTO DEL GATEWAY:

E' possibile inviare SMS direttamente dalle tue pagine od applicazioni web, effettuando una chiamata HTTP al nostro stesso gateway sms.
Tale chiamata può essere fatta digitando direttamente l'indirizzo nella barra degli indirizzi di un browser, oppure effettuata automaticamente da programma (php, asp, java, perl).
Dalle tue pagine accedi via modo GET oppure POST all' indirizzo del gateway passando i seguenti parametri:

user è il numero del tuo abbonamento rubalo.it, deve venire indicato in ogni chiamata, es:1409
word è la password del tuo servizio sms, deve venire indicata in ogni chiamata, es:X0nosXa
dest è il numero telefonico del destinatario oppure una lista di numeri di destinatari, da indicare solo negli invii, es:3383457121 oppure 3381234567;33398765432
mitt è il numero o nome del mittente che vuoi indicare, da indicare solo negli invii, es:+393371234568 oppure "XYZ spa"
body è il testo del messaggio, sino ad un massimo di 160 caratteri, da indicare solo negli invii, es:messaggio+di+prova
op è la operazione da compiere, deve sempre venire indicato e può essere solamente uno di questi valori:
- invia1 (invia-uno) per inviare un singolo sms
- multiplo per inviare un sms a molti destinatari
- credito per leggere il credito rimasto
- report per leggere il report degli ultimi invii o ricariche effettuati.

Nota che tutti i paramentri dovranno venire codificati per il web (urlencode) sostituendo gli spazi con + ed i caratteri particolari con i relativi codici http.

RESPONSO:
La tua pagina od applicazione dovrà poi leggere il responso ottenuto dal gateway per ricavarne le informazioni desiderate e l'esito della operazione.
Il responso sarà costituito da una stringa di testo semplice ed avrà un formato facilmente leggibile sia direttamente che da programma.
Se la operazione richiesta ha avuto esito positivo la stringa ritornata inizierà con i caratteri OK! mentre inizierà con KO! se ci sono stati problemi.
A tali primi caratteri seguiranno i dati richiesti (credito/report) oppure una descrizione dei messaggi inviati oppure ancora una descrizione dell'errore verificatosi.

ESEMPI DI INDIRIZZI DA CHIAMARE:

esempio di chiamata per leggere il credito rimasto:

http://cpanel.rubalo.it/smsgate.php?user=1409&word=gh28yUT53&op=credito

che restituirà un responso di questo genere:

OK!
credito=427

esempio di chiamata per leggere il report degli utimi invii effettuati e ricariche:

http://cpanel.rubalo.it/smsgate.php?user=5532&word=Hjk99Rt6&op=report

che restituirà un responso di questo genere:

OK! log invii:
(data operazione esito destinatario costo)
2010-01-18 10:22:15 ricarica ok 1000
2010-01-18 10:28:03 invio singolo ok +39338351234561 -1
2010-01-18 10:37:21 invio multiplo ok +393342524231,+393385567842,+393337432165 -3
2010-01-18 10:38:52 invio singolo ok +393374213567 -1

esempio di chiamata per inviare un singolo messaggio:

http://cpanel.rubalo.it/smsgate.php?user=4003&word=grAz87We&op=invia1&dest=393381234567&mitt=rubalo&body=messaggio+di+prova

che invierà il messaggio e fornirà un responso di questo genere:

OK!
da XYZ srl a +3933456789421
responso = +OK

qualora viceversa vi fossero dei problemi, allora il responso restituito dal gateway sarà:

KO!
descrizione dell'errore o problema

dove la descrizione dell'errore permetterà di identificarne la natura e correggerlo.

Gli errori più comuni comprendono:
- utente sconosciuto, assente o non autorizzato che indica problemi di autenticazione (user/word);
- destinatario assente o malformato quando il parametro manca o non ha il formato consentito;
- mittente assente o malformato quando il parametro manca o non ha il formato consentito;
- impossibile inviare per mancanza di credito quando il credito rimasto non basta per l'invio;
- sms gateway non raggiungibile indica down del server sms oppure indirizzo errato;

UTILIZZO DA PROGRAMMA:
Da programma è possibile chiamare il gateway sms come se fosse un file remoto, ad esempio con fopen/fget/fclose in php:

//prepara url da chiamare
$url=$indirizzo_del_gateway;
$url.="?user=4003&word=grAz87We&op=invia1";
$url.="&dest=".urlencode($numero_del_destinatario);
$url.="&mitt".urlencode($mittente_del_sessaggio);
$url.="&body=".urlencode($testo_del_messaggio);

//effettua la chiamata
$sms_conn=fopen($url,"r");
$responso=fget($sms_conn,1024);
fclose($sms_conn);

//interpreta il responso
if(stristr($response,"OK!")){
//...istruzioni per gestire esito positivo...
}else{
//...istruzioni per gestire errore...
};

INVIO MULTIPLO:
E'possibile inviare lo stesso messaggio sino a 40 diversi destinatari con una singola operazione.
Per farlo basterà porre il parametro op=multiplo e come destinatario (dest) indicare un elenco di numeri telefonici dei destinatari separati da punti e virgola (urlencoded=%3B).

http://cpanel.rubalo.it/smsgate.php?user=2743&word=z3nz3r0&op=multiplo&dest=3381234567%3B3335524869%3B3312831547&mitt=rubalo&body=messaggio+di+prova

Torna indietro