INVIO SMS CON CHIAMATA DIRETTA ALLO SCRIPT

Transcript

1 INVIO SMS CON CHIAMATA DIRETTA ALLO SCRIPT La chiamata diretta allo script può essere effettuata in modo GET o POST. Il metodo POST è il più sicuro dal punto di vista della sicurezza. Invio sms a un numero o a una serie di numeri url: &testo=xxxxxxxxxxxxxxx&numero=xxxxxxxxx&mittente=xxxxxxxxxxxx è possibile anche la chiamata tramite ssl con gli stessi parametri: url: &testo=xxxxxxxxxxxxxxx&numero=xxxxxxxxx&mittente=xxxxxxxxxxxx Poiché si passano via internet le proprie credenziali di accesso, si consiglia di utilizzare la chiamata https (crittata a 2048 bit) PARAMETRI login: login assegnato pwd: password assegnata testo: messaggio da inviare (max 160 caratteri) url encoded numero: numero di cellulare nel formato zzzxxxyyyyyyyy dove zzz è il prefisso internazionale (senza lo 0 e senza il + davanti al prefisso internazionale) xxx è il prefisso è yyyyyyy è il numero. E' possibile inviare lo stesso messaggio a più numeri telefonici inserendo più numeri telefonici separati dalla virgola. Si consiglia di non superare i 20 numeri per ogni chiamata dello script. mittente: testo alfanumerico di 11 caratteri (non usare spazi e caratteri sopra ascii 128. Si suggerisce di utilizzare solo lettere e numeri), oppure numero di cellulare compreso di prefisso internazionale senza zeri iniziali e con il + iniziale. Se utilizzate il mittente numerico, poichè va utilizzato il carattere '+', il mittente va passato url encoded. PARAMETRI OPZIONALI longtext: se settato a 1 permette di spedire messaggi fino a 480 caratteri. I testi più lunghi di 480 caratteri vengono troncati dopo il 480esimo carattere. Il costo viene calcolato con 1 credito sms ogni 160 caratteri o frazione. Esempio un testo di 190 caratteri viene tariffato con 2 crediti. è possibile aggiungere un campo per definire la data/ora di spedizione: date=aaaammgghhii dove: aaaa=anno di 4 cifre mm=mese di 2 cifre gg=giorno di 2 cifre hh=ora di 2 cifre ii=minuti di 2 cifre

2 Vanno sempre rispettate le lunghezze indicate, altrimenti la spedizione del messaggio avverrà a una data/ora non corretta. Per esempio per spedire un messaggio il 5 aprile 2009 alle ore 8 e 2 minuti, il valore della variabile date è: credit: se settato a 1 ritorna oltre all'ok il numero di crediti disponibili nel formato Credit=xxx dove xxx rappresenta il numero di crediti disponibili ref: permette di inserire un indentificatore per la spedizione in formato alfanumerico di massimo 20 caratteri Invio sms a un gruppo E' possibile inviare un sms a un intero gruppo precedentemente configurato sul server. Il gruppo deve essere stato creato tramite interfaccia web e deve contenere almeno un numero di telefono. Si consiglia di non utilizzare lettere accentate nella definizione del nome del gruppo. La sintassi è simile alla precedente: url: &testo=xxxxxxxxxxxxxxx&gruppo=xxxxxxxxx&mittente=xxxxxxxxxxxx login: login assegnato pwd: password assegnata testo: messaggio da inviare (max 160 caratteri) url encoded gruppo: nome esatto definito tramite interfaccia utente. Il sistema NON fa differenza tra maiuscolo e minuscolo. La spedizione degli sms di un intero gruppo potrebbe comportare parecchio tempo. Si consiglia pertanto di aumentare il tempo di latenza dello script chiamante per evitare perdite di sms spediti. mittente: testo alfanumerico di 11 caratteri (non usare spazi e caratteri sopra ascii 128. Si suggerisce di utilizzare solo lettere e numeri), oppure numero di cellulare compreso di prefisso internazionale senza zeri iniziali e con il + iniziale. Se utilizzate il mittente numerico, poichè va utilizzato il carattere '+', il mittente va passato url encoded. PARAMETRI OPZIONALI longtext: se settato a 1 permette di spedire messaggi fino a 480 caratteri. I testi più lunghi di 480 caratteri vengono troncati dopo il 480esimo carattere. Il costo viene calcolato con 1 credito sms ogni 160 caratteri o frazione. Esempio un testo di 190 caratteri viene tariffato con 2 crediti. è possibile aggiungere un campo per definire la data/ora di spedizione: date=aaaammgghhii dove: aaaa=anno di 4 cifre mm=mese di 2 cifre gg=giorno di 2 cifre hh=ora di 2 cifre ii=minuti di 2 cifre Vanno sempre rispettate le lunghezze indicate, altrimenti la spedizione del messaggio avverrà a una data/ora non corretta. Per esempio per spedire un messaggio il 5 aprile 2009 alle ore 8 e 2 minuti, il valore della variabile date è:

3 ref: permette di inserire un indentificatore per la spedizione in formato alfanumerico di massimo 20 caratteri RISPOSTE ERROR=1702 mancanza di crediti ERROR=1703 login e/o password errate ERROR=1704 manca il testo del messaggio ERROR=1705 manca il numero di cellulare ERROR=1706 gruppo non trovato ERROR=1707 nessun numero telefonico presente nel gruppo richiesto ERROR=1708 data di spedizione errata ERROR=1709 sms verso una nazione/gestore non raggiungibile ERROR=1710 il testo dell' sms contiene parole non consentite OK messaggio spedito NOTE 1) Per il mittente utilizzate solo le lettere e i numeri. Lo spazio NON è ammesso e viene eliminato in fase di spedizione. Non usate lettere accentate o simboli!!!!!!!! 2) Non utilzzate accenti, trattini, apostofi eccetera nel mittente che alcuni gateway non accettano: il messaggio non verrà consegnato ma verrà ugualmente addebitato in quanto ricevuto dal gateway di spedizione. 3) Se utilizzate un mittente numerico ricordatevi di mettere anche il prefisso internazionale preceduto dal '+'. Un mittente numerico senza il '+' iniziale genererà un errore a livello gateway di ricezione: sms non spedito ma credito tolto perchè il rifiuto avviene a livello del destinatario. Se utilizzate il mittente numerico, poichè va utilizzato il carattere '+', il mittente va passato url encoded. 4) Se utilizzate caratteri diversi da 0-9A-z, dovete inviare il messaggio in UTF-8 altrimenti i gateway riceventi potrebbero rifiutare/troncare il messaggio 5) Se è indispensabile la spedizione di caratteri accentati, assicuratevi della corretta codifica. In caso contrario il messaggio può non essere accettato dal gateway di destinazione o essere spedito troncato. Tenete presente che i caratteri accentati e i simboli sono calcolati come 2 caratteri, pertanto se utilizzate tutti i 160 caratteri, vi verrà un credito extra per la parte eccedente i 160 caratteri o multipli. La tabella dei caratteri calcolati doppi è in fondo a questo documento. CONTROLLO DEI CREDITI DISPONIBILI url: RISPOSTA Credit=xxxx dove xxxx è il numero di sms disponibili

4 REPORT DEGLI SMS SPEDITI url: login=xxxxxxx&pwd=xxxxxxx&datestart=aaaammgg&dateend=aaaammgg Tramite il programma report.php è possibile richiedere la lista degli sms spediti nell'intervallo di due date. Per ragioni di banda e di occupazione server, l'intervallo massimo tra le due date deve essere di 7 giorni. I parametri da passare per la richiesta sono i seguenti: login: login assegnato pwd: password assegnata datestart: data di inizio del report nel formato AAAAMMGG dateend: data di fine del report nel formato AAAAMMGG dove: AAAA rappresenta l'anno con 4 cifre MM rappresenta il mese di due cifre (per mesi inferiori a 10 aggiungere uno 0 prima del numero del mese) GG rappresenta il giorno di due cifre (per giorni inferiori a 10 aggiungere uno 0 prima del numero del mese) Anche se si desiderta il report di un solo giorno, dateend deve comunque essere presente. Nel caso di singolo giorno, datestart e dateend conterranno gli stessi dati. Il risultato viene inviato via web con una struttura XML come la seguente: <Risposta> <Line> <Data>xxxxxxxxx</Data> <Testo>xxxxxxxxxxxxxxxx</Testo> <Destinatario>xxxxxxxxx</Destinatario> <Esito>Consegnato</Esito> (*) <Ref>xxxxxxxxxxxxx</Ref> </Line> </Risposta> (*) il valore può essere: Consegnato: sms ricevuto dal destinatario NON CONSEGNATO: sms non ricevuto (numero errato, numero non attivo,eccetera) In attesa di DR: sms acquisito per la spedizione ma non ancora consegnato (cellulare spento o fuori copertura. Se sono passate più di 24 ore il messaggio non verrà più consegnato). LA MANCATA CONSEGNA DI UN SMS NON COMPORTA NESSUN DIRITTO DI RIACCREDITO IN QUANTO L'ADDEBITO REALTIVO ALLA SPEDIZIONE A NOI VIENE COMUNQUE EFFETTUATO DAI GESTORI

5 ERRORI 1701 = manca la data di inizio 1702 = manca la data di fine 1703 = data di inizio errata 1704 = data di fine errata 1705 = intervallo tra le date superiore ai 7 giorni 1706 = data di fine inferiore alla data di inizio 1707 = login/pwd errati 1708 = nessun messaggio spedito nell'intervallo di date richiesto INVIO SMS TRAMITE Va inviata una a xxxxxxxxxxx@gtw.gatewaysms.it xxxxxxxxxx viene comunicato all atto della configurazione La struttura del messaggio deve essere la seguente: oggetto: TEL=zzxxxyyyyyy dove zz è il prefisso internazionale (a richiesta possiamo forzare noi 39 per l Italia). Il prefisso deve essere passato SENZA lo 0 iniziale e senza il + xxx prefisso yyyyyyyy numero di celluare corpo del messaggio: testo da spedire (massimo 160 caratteri), i caratteri oltre i 160 vengono ignorati. Non viene inviato nessun codice di risposta. Si rammenta di spedire il messaggio in plain text altrimenti i primi 160 caratteri sono la definizione del tipo di messaggio e NON il messaggio stesso! La spedizione di sms tramite è attivata solo su richiesta. Scriveteci indicando la vostra login (nome utente) e vi verrà attivata gratuitamente questa funzione. NOTE GENERALI Nei limiti del possibile conviene NON utilizzare le lettere accentate in quanto non tutti i telefoni visualizzano i caratteri accentati nello stesso modo. Si fa presente che il carattere & tronca il testo del messaggio su molti cellulari. La parte che segue il carattere & non verrà visualizzata sul cellulare del destinatario. L'utilizzo dei caratteri accentati a causa delle diverse codifiche potrebbe non venire accettata dal gestore. Si suggersice pertanto di effettuare un test sulla corretta codifica dei caratteri accentati inviati per utilizzando un sms di test sul vostro cellulare di servizio.tenete presente che i caratteri accentati e i simboli sono calcolati come 2 caratteri, pertanto se utilizzate tutti i 160

6 caratteri, vi verrà addebitato un credito extra per la parte eccedente i 160 caratteri o multipli. La tabella dei caratteri calcolati doppi è in fondo a questo documento. Elenco dei carattari calcolati doppi Questa è la lista dei caratteri che i gateway calcolano doppio. Ogni carattere viene calcolato come 2 caratteri, pertanto dovete tenerne conto all'atto della spedizione: se utilizzate tutti i 160 caratteri il sistema addebiterà un credito in più. L'elevamento a potenza ^ codice ascii 94 La parentesi graffa aperta { codice ascii 123 La parentesi graffa chiusa } codice ascii 125 Il backslash \ codice ascii 92 La parentesi quadra aperta [ codice ascii 91 La parentesi quadra chiusa ] codice ascii 93 La tilde ~ codice ascii 126 Il pipe codice ascii 124 Il simbolo dell'euro codice ascii 164

7 2013 gatewaysms.it a Servitel Limited division