qualità  di invio degli SMS

NOTA

La scelta tra tre differenti qualità d’invio è possibile solo per i servizi personalizzati, con accesso diretto al gateway (e destinati quindi a utenti con traffico rilevante, superiore a 5000 SMS/mese).
Per tutti gli utenti del servizio diretto (utilizzabile dal nostro pannello di controllo o tramite i nostri script) tutti gli invii avvenono automaticamente in “qualità alta”


Bassa Qualità

  • Consegna dei messaggi al terminale mobile: entro qualche minuto, la consegna sui servizi di Bassa Qualità è da ritenersi “Best Effort” (non garantita).
  • Notifica di avvenuta ricezione SMS: non disponibile.
  • personalizzazione mittente: non disponibile.
Media Qualità
  • Consegna dei messaggi al terminale mobile: entro pochi secondi, la consegna è garantita.
  • Notifica di avvenuta ricezione SMS: non disponibile.
  • personalizzazione mittente: disponibile, ma non garantito (dipende sia dal circuito d’invio selezionato dal sistema, sia dal destinatario; non è prevedibile a priori)
    Personalizzazione mittente: 13 caratteri numerici (es.: +393350000000) o 11 caratteri alfanumerico (es.: Nomeazienda)
Alta Qualità
  • Consegna dei messaggi al terminale mobile: entro pochi secondi, la consegna è garantita.
  • Notifica di avvenuta ricezione SMS: opzionale (la notifica di avvenuta ricezione ha il costo di un SMS)
  • personalizzazione mittente: disponibile e garantito
    Personalizzazione mittente: 13 caratteri numerici (es.: +393350000000) o 11 caratteri alfanumerico (es.: Nomeazienda)

script per l’invio di 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