Il gateway SMS MAItaly

Smmari PREMESSA... 3 GLOSSARIO... 3 OVERVIEW ARCHITETTURALE... 4 ARCHITETURA DI SISTEMA DEL GATEWAY... 5 FRONT-END UTENTE FINALE... 6 GESTIONE DELLA RUBRICA...7 GESTIONE DEI GRUPPI...8 INVIO A NUMERO SINGOLO...9 INVIO A PIÙ NUMERI (LISTE DI DISTRIBUZIONE)... 10 INVIO MMS... 11 LOG... 12 RICEZIONE MESSAGGI... 12 FRONT-END AMMINISTRATORE... 13 GESTIONE UTENTI... 13 GESTIONE INVII... 13 GESTIONE RICEZIONI... 14 MONITORING... 14 BACK-END (ENGINE)... 15 CONNESSIONE CON GLI OPERATORI... 16

1. Premessa Nel presente dcument viene descritt il gateway per l invi di SMS ed MMS sviluppat da MAItaly e le cmpnenti nelle quali è suddivis. 2. Glssari ASP Licensing Utente finale Amministratre Crediti SMS HIGH SMS LOW Persnalizzazine mittente Ricevuta di ritrn Applicatin Service Prvider. Mdalità di frnitura di un servizi che prevede che il sistema (in quest cas l inter gateway parti di ess) risieda su server di prprietà MAItaly. Mdalità di frnitura di un servizi che prevede che il sistema (in quest cas l inter gateway parti di ess) risieda su server di prprietà del cliente. Persna fisica sistema autmatic che esegua l invi di messaggi di tip SMS MMS. Persna MAItaly (se in mdalità ASP) del cliente (se in mdalità licensing) in grad di agire su tutti i parametri del gateway. Sistema mnetari intern al gateway grazie al quale nn è necessari acquistare e quindi utilizzare single tiplgie di SMS ma, al cntrari, pter decidere di vlta in vlta quale tiplgia di SMS utilizzare per gni spedizine. Si tratta di SMS inviati tramite gli peratri italiani per i quali si hann tempi di cnsegna bassi, percentuale di cnsegna elevata e prezz elevat. Si tratta di SMS inviati tramite gli peratri stranieri per i quali nn si ha garanzia né sui tempi né sulla cnsegna stessa ma prezzi bassi. Il sistema in mdalità ASP indica quand questa tiplgia di SMS nn è dispnibile. Tecnica grazie alla quale è pssibile fare in md che sul telefn del destinatari appaia, per il messaggi ricevut, un mittente alfanumeric di max 11 caratteri numeric di max 14 numeri. Messaggi inviat dal telefn cellulare quand questi riceve l SMS

3. Overview architetturale Il gateway SMS MAItaly è in grad di gestire flussi BIDIREZIONALI di messaggi: quindi nn sl INVIO da internet vers terminali mbili, ma anche RICEZIONE da terminali mbili vers internet. Grazie a questa pssibilità le aziende che utilizzan il gateway in mdalità sia ASP che licensing sn in grad di sviluppare e frnire ai prpri clienti sistemi interattivi basati su SMS. MAItaly stessa prpne una serie di sluzini per il mbile ffice, che si basan su questa funzinalità, descritte nel dcument MAItaly_MO.pdf liberamente scaricabile nella sezine dwnlad del nstr sit www.maitaly.it. L architettura ad alt livell è quindi la seguente: Gli utenti finali che utilizzan tutt il gateway di MAItaly sl alcuni layer in mdalità ASP si cllegan ai servers MAItaly tramite internet. Per particlari esigenze (sicurezza ecc.) siam in grad di attrezzarci per implementare VPN, tunnel IPSec altri sistemi di sicurezza e cittgrafia pint-t-pint. I servers MAItaly sn a lr vlta cllegati, tramite VPN CDN, ai backbne degli peratri nazinali. Essend tutte queste cnnessini BIDIREZIONALI siam quindi in grad nn sl si inviare ma anche di ricevere SMS dai terminali mbili.

4. Architetura di sistema del gateway Nel seguente schema è descritta l architettura di massima del GW. Frnt-end utente finale Back-end (engine) Frnt-end amministratre Cnnessine cn gli peratri TIM VO WIND H3G altri Cme si può ntare l intera applicazine è scmpnibile in quattr macraree: frnt-end utente finale frnt-end amministratre back-end (engine del gateway) cnnessine cn gli peratri Queste quattr cmpnenti sn indipendenti tra lr e pssn essere utilizzate sia in mdalità ASP (residenti su servers MAItaly) che in mdalità licensing (residenti sulle macchine dei clienti) cn l unica limitazine che, se si vule utilizzare il frnt-end di amministrazine in mdalità licensing, anche il back-end, seppur residente su macchine MAItaly, sarà cnsiderat in licensing. Quest è dvut al fatt che il pannell di amministrazine che agisce sul backend ASP viene gestit direttamente dai tecnici MAItaly. È quindi pssibile, per esempi, acquistare e quindi installare i frnt end utente finale ed amministratre sulle prprie macchine ed utilizzare il back-end e la cnnessine cn gli peratri in mdalità ASP, vver su macchine MAItaly. In quest specific cas sui servers MAItaly verrà istanziat un nuv back-end dedicat al cliente. L intera piattafrma è sviluppata su framewrk dt.net e utilizza una serie di Web Services per facilitare il cllqui cn l utente finale.

5. Frnt-end utente finale Si tratta di una parte WEB tramite la quale gni utente/cliente dtat di username e passwrd può inviare SMS, gestire una prpria rubrica di numeri di telefn, rganizzare i prpri nminativi in gruppi, cnsultare i lg di invi per gni girnata. Ogni pagina cntiene, in testa, l indicazine dei crediti residui. Frnt-end utente finale Back-end (engine) Frnt-end amministratre Cnnessine cn gli peratri TIM VO WIND H3G altri Le funzinalità previste sn le seguenti: gestine della rubrica gestine dei gruppi invi a numer singl invi a più numeri (liste di distribuzine) invi MMS lg ricezine messaggi

5.1 Gestine della rubrica Tramite quest pannell è pssibile inserire, mdificare cancellare numeri di telefn e nminativi. Il caricament può avvenire in md manuale ppure tramite files di test fgli excel. Nella figura è mstrat il pannell presente sul gateway in mdalità ASP. Nella mdalità licensing è pssibile naturalmente brandizzare il layut cn i prpri template.

5.2 Gestine dei gruppi È il pannell dal quale pss raggruppare i nminativi presenti in rubrica in categrie mgenee. Utile quand si deve eseguire l invi di un unic messaggi a più nminativi senza dver gni vlta selezinarli un ad un. Nella figura è mstrat il pannell presente sul gateway in mdalità ASP. Nella mdalità licensing è pssibile naturalmente brandizzare il layut cn i prpri template.

5.3 Invi a numer singl Tramite quest pannell è pssibile inviare un SMS nel md più semplice ed immediat pssibile: si digita il test, si sceglie la tiplgia di messaggi da inviare (HIGH LOW) e l eventuale mittente, si inserisce il numer ( l si sceglie dalla prpria rubrica) e si preme Invia SMS. È inltre pssibile definire una data ed un ra futuri per eseguire un invi differit. Nella figura è mstrat il pannell presente sul gateway in mdalità ASP. Nella mdalità licensing è pssibile naturalmente brandizzare il layut cn i prpri template.

5.4 Invi a più numeri (liste di distribuzine) Si tratta del csiddett invi cmplet dal mment che mi cnsente di inserire il test di un messaggi e di indirizzarl a numeri presenti in rubrica, a gruppi (se definiti) e a numeri nn presenti in rubrica. Anche in quest cas, quindi, dp aver digitat il test, scelta la tiplgia (HIGH LOW) e l eventuale mittente, inserisc tutti i numeri ai quali l vgli destinare e prem il tast di invi. Cme nel cas dell invi a singli numeri è pssibile definire una data ed un ra futuri per eseguire un invi differit. Nella figura è mstrat il pannell presente sul gateway in mdalità ASP. Nella mdalità licensing è pssibile naturalmente brandizzare il layut cn i prpri template.

5.5 Invi MMS Grazie a questa utility è pssibile preparare un messaggi cntenente test ed immagini da far visualizzare sul telefn cellulare del destinatari. Anche in quest cas il funzinament è estremamente semplice ed intuitiv: si inserisce il test e l immagine da assciare e si carica il frame. A quest punt pss decidere di aggiungere altri frame (sempre cmpsti da test+immagine) di eseguire l invi. Cliccand su Invia MMS il sistema esegue una cnversine delle immagini in base al mdell del telefn cellulare scelt e prepara i frame cme single pagine xhtml linkate tra lr. Una vlta preparat quest mini-sit invia un SMS di tip WAP PUSH al telefn cellulare del destinatari. Quest particlare SMS cntiene un link al mini-sit e, una vlta ricevut, prpne all utente finale di cllegarsi - per scaricare i frame che cmpngn il messaggi cn la semplice pressine di un tast. Nella figura è mstrat il pannell presente sul gateway in mdalità ASP. Nella mdalità licensing è pssibile naturalmente brandizzare il layut cn i prpri template.

5.6 Lg Si tratta della schermata dalla quale vedere tutti i messaggi spediti nei vari girni. Ordinata per ra di invi, la lista cntiene l rari, il numer di cellulare del destinatari e i primi caratteri del test del messaggi inviat. Vengn inltre espsti gli SMS presenti nella cda di invi differit, vver quegli SMS per i quali è stat richiest l invi in una data rari futuri. Nella figura è mstrat il pannell presente sul gateway in mdalità ASP. Nella mdalità licensing è pssibile naturalmente brandizzare il layut cn i prpri template. 5.7 Ricezine messaggi Essend un applicazine BIDIREZIONALE, il gateway MAItaly nn sl è in grad di inviare messaggi, ma anche di riceverne dagli peratri. È infatti pssibile richiedere ad un più peratri dei numeri dedicati ai quali far spedire SMS che verrann ricevuti dal gateway e quindi instradati all utente finale. Le mdalità di instradament, nella gestine ASP del gateway, pssn essere di divers tip: pst a pagina http invi smtp (mail) invi ftp

6. Frnt-end amministratre Questa parte del gateway cnsente all amministratre del sistema di impstare una serie di parametri tramite i quali agire sui seguenti frnti: gestine utenti gestine invii gestine ricezini mnitring Frnt-end utente finale Back-end (engine) Frnt-end amministratre Cnnessine cn gli peratri TIM VO WIND H3G altri 6.1 Gestine utenti Tramite quest area è pssibile: aggiungere, mdificare rimuvere utenti aggiungere, mdificare rimuvere la persnalizzazine del mittente per gni utente persnalizzare il cst di invi SMS per gni singl utente (per utilizz ASP del gateway) inserire eventuali limitazini di invi per gni singl utente 6.2 Gestine invii Tramite quest area è pssibile agire direttamente sul layer di Cnnessine cn gli Operatri vver: aggiungere, mdificare eliminare tipi di servizi. Pss infatti decidere, per esempi, di mdificare il tip di servizi predefinit 4 (SMS di tip HIGH cn persnalizzazine del mittente) cambiand il numer di crediti necessari per gni invi. aggiungere, mdificare eliminare canali di invi. In quest cas pss definire, per esempi, l aggiunta di un nuv canale di spedizine nel cas in cui faccia un accrd cn un nuv peratre. per gni tiplgia definire il canale dal quale sarà inviat. Pss assciare la tiplgia di servizi al canale di uscita. Per esempi pss decidere che gli SMS di tip servizi 1 (HIGH) sian TUTTI inltrati tramite VODAFONE. Quest si rende particlarmente utile nel cas in cui si abbian determinate cndizini di favre da parte di singli peratri. impstare eventuali limitazini di invi per gni singl canale. Pss impstare un limite massim di messaggi che girnalmente pssn essere inltrati tramite un canale di invi.

6.3 Gestine ricezini In questa sezine è pssibile settare e gestire i messaggi in arriv da terminali mbili vers il gateway. La parte standard dell applicazine cnsente di: assegnare numeri di ricezine a un più utenti se un numer è assegnat a più utenti, impstare il prefiss che indica al sistema a che cliente inviare i messaggi ricevuti che inizian cn quel prefiss. impstare la mdalità di cmunicazine dei dati vers il cliente al quale è assegnat il numer tra le seguenti: pst http, invi smtp, invi ftp. Selezinand la mdalità sarann richiesti i dati relativi. La parte custmizzabile dell applicazine cnsente di integrare il gestre cn le specifiche richieste dal cliente in md da inviare sl i messaggi che rispndn a determinati requisiti e quindi: 6.4 Mnitring sistema di parsing del messaggi (verifica sintattica) mdul di rispsta negativa in cas di sintassi errata nrmalizzazine e cnversine dei dati presenti qualunque altr tip di maniplazine del messaggi prima che sia inviat al cliente Funzinalità che cnsente di cnscere, in temp reale, il numer di invii eseguit sia a livell di dettagli che in rappresentazine grafica. È inltre pssibile eseguire delle visualizzazini degli invii dei singli utenti. Nell utilizz in mdalità ASP i lg di invi vengn memrizzati mensilmente su di un CD per eventuali future richieste. Il frnt-end di amministrazine è estremamente ptente dal mment che cnsente di agire su tutti i parametri di funzinament del gateway agend direttamente sull engine stess e sulle tabelle che ne reglan il funzinament. Quest strument viene naturalmente frnit sl in mdalità licensing dal mment che l amministrazine del gateway MAItaly in mdalità ASP è demandata ai tecnici MAItaly.

7. Back-end (engine) Si tratta della parte più crpsa e cmplessa dell inter sistema. Si appggia su un cmpless DB di tip Micrsft SQL Server e tutte le prcedure che l cmpngn sn scritte in VB.NET. Frnt-end utente finale Back-end (engine) Frnt-end amministratre Cnnessine cn gli peratri TIM VO WIND H3G altri Al su intern si trvan una serie di layer che cnsentn la gestine del messaggi sia in uscita che in entrata. Messaggi in uscita: ricezine da parte del frnt-end dell utente finale verifica della validità del numer di cellulare del destinatari verifica del numer dei crediti e dell effettiva dispnibilità di invi dell utente finale verifica della dispnibilità del canale di invi (se k se chius per prblemi di cnnessine altr) accdament del messaggi nel canale di invi definit dall amministratre scdament dei messaggi cn gestine delle cde in md da nn penalizzare i singli invii a frnte di invii crpsi eseguiti da altri utenti memrizzazine e gestine dell identificativ del messaggi per la gestine dell eventuale ricevuta di ritrn Messaggi in entrata: ricezine da parte dell peratre smistament vers l utente finale al quale è abbinat il numer dal quale arriva, per numeri cndivisi, in base al prefiss cntenut nel messaggi stess. L smistament viene svlt in base alla mdalità di smistament richiesta dall utente finale.

8. Cnnessine cn gli peratri Si tratta dell ultim layer del gateway, vver di quell che si ccupa di trascdificare i messaggi spediti dagli utenti finali nel prtcll prprietari di gni singl peratre. Quest si rende necessari dal mment che gni peratre ha una prpria mdalità di cmunicazine ed un prpri prtcll: nn sl prtclli standard (UCP, SMPP3.3, CIMD2 ecc.) ma anche prtclli prprietari (un esempi su tutti la MAM di Vdafne). L aggiunta di un nuv peratre è quindi trasparente al rest del gateway, interessand sl ed esclusivamente quest layer. Il layer è fisicamente separat dal back-end del gateway dal mment che difficilmente viene frnit in mdalità licensing: cllquiand direttamente cn gli peratri è cstrett a utilizzare il canale di cmunicazine impst: slitamente CDN ed in pchi casi VPN. Per evitare al cliente che vule acquistare il gateway in mdalità licensing tutte le prblematiche tecniche ed ecnmiche di cllegament, slitamente quest layer viene sempre frnit in mdalità ASP: il back-end frnit in mdalità licensing e quindi residente sulle macchine del cliente ptrà cmunicare tramite il prtcll intern del gateway cn quest layer, residente su server MAItaly, tramite una semplice cnnessine VPN cn un sistema di crittgrafia pint t pint. Nel cas in cui si desideri acquistare il gateway in mdalità licensing ma si hann già le cnnessini cn gli peratri, quest layer nn sarà inclus nel pacchett di installazine. Pur residend su macchine MAItaly, l instradament del messaggi sarà svlt in base alle caratteristiche specificate tramite il pannell di amministrazine. Frnt-end utente finale Back-end (engine) Frnt-end amministratre Cnnessine cn gli peratri TIM VO WIND H3G altri