SMS Gateway

Template

SMS Gateway - Template - Personalizzazione SMS di testo
La modalità template, diversamente dall'utilizzo dei file header, body e footer, permette una maggiore dinamicità e personalizzazione delle vostre pagine web per l'invio di sms.

Il funzionamento è semplice e consiste in un riempimento da parte nostra delle vostre pagine html oppure dei vostri script con dei valori di variabili globali precedentemente stabiliti; dopo di che siamo noi che provvederemo all'output della vostra applicazione. Voi dovrete passare alle nostre applicazioni dei valori tra cui un file all'interno del quale sono situate variabili nella forma <#nome_variabile#>, il nostro cgi provederà al riempimento di questi valori e alla stampa a video del file prodotto.

Programmi da richiamare a valori in input e output
Tutti i programmi devono essere richiamati utilizzando il seguente url: http://195.62.227.122/cgi-bin/wbc_xxxnomeapplicazionexxx?parametri=parametri dove wbc_xxxnomeapplicazionexxx è l'applicazione da richiamare e parametri sono i valori di cui l'applicazione ha bisogno per un corretto funzionamento. Da come vi renderete conto guardando i programmi messi a disposizione sulla tabella, non compare un'applicazione che permette di inserire il numero di destinazione ed il messaggio stesso; questo perchè viene lasciato all'utente la creazione della form di immissione dati per una personalizzazione completa del servizio (form che poi dovrà richiamare wbc_smsinvioweb con i corretti parametri).
Descrizione Applicazione
Applicazione da richiamare
Parametri da passare al CGI
Variabili da inserire nel Template
Applicazione che permette l'invio di un messaggio con relativo ritorno dell'errore
wbc_smsinvioweb template = “on” (obbligatorio)

urltmp = url assoluta del file passato (obbligatorio)

redirect = “1” (facoltativo – per effettuare una redirect) [*]

varmsg = testo del messaggio (obbligatorio)

vartype = “TX” (tipo sms – obbligatorio)

varpref = prefisso internazionale [es.: +39] (obbligatorio)

varnum = numerazione mobile di dest. (obbligatorio)

<#errcode#> - codice di errore dopo invio

<#errstring#> - descrizione errore dopo invio

[*] - Quando si effettua un invio si può decidere sia di avere un ritorno su due variabili come ad esempio <#errcode#> <#errstring#> utilizzando sempre il metodo template, oppure se si specifica il parametro redirect=1, dopo l'inoltro della richiesta di invio del messaggio viene fatta una redirect all'url specificata su urltmp passando come parametri aggiuntivi errcode ed errstring che contangono lo stato dell'invio.

Di seguito una tabella con il dettaglio degli errori che possono ritornare sulle variabili <#errcode#> ed <#errstring#>:

ERRCODE
ERRStrING
0
SMS / Logo / Suoneria inoltrata correttamente
1
Errore durante la query per ricavare appartenenza Logo / Suoneria
2
Prefisso Internazionale inesistente
3
Prefisso Internazionale non corretto
4
Telefono Destinazione in forma non corretta
5
Telefono Destinazione inesistente
6
Errore durante estrazione Logo / Suoneria
7
Non ci sono Records per l'ID immesso
8
Errore durante classifica TOPX
9
Errore durante la richiesta di invio Messaggio / Logo / Suoneria
10
Non si effettuano invii di Messaggi superiori ad 800 caratteri (5 sms)