Accesso al servizio Sms Gateway Release 1.5.0 (ultimo aggiornamento 12 ottobre 2002) Sommario 1. Introduzione.2 2. Pre-requisiti.. 3 3. Specifiche tecniche......4 4. Parametri e variabili..5 5. Tutela della Privacy...7 2001, 2002, 2003 Digitel Mobile Srl Pescara (Italy) Pagina 1
1. Introduzione Possono accedere al servizio di invio di messaggi SMS solo gli Utenti autorizzati e regolarmente registrati. L accesso è consentito solo ed esclusivamente utilizzando uno dei seguenti metodi: Via Http con l uso di un comune browser direttamente dal sito web all indirizzo http://www.smsitaly.com. Attraverso il Client SmsGate applicativo windows distribuito in licenza d uso gratuita. Attraverso l uso della DLL Active-X SmsGate.Dll distribuita in licenza d uso gratuita. Via Http attraverso il servizio Sms Gateway per Webmaster. Via Http attraverso una connessione Server To Server. Via TCP con collegamento diretto a SMS GATE SERVER. Via E-mail senza l uso di plug-in o software aggiuntivi. Attraverso l Upload di un file formato txt. Attraverso l interfaccia EMI/UCP 2001, 2002, 2003 Digitel Mobile Srl Pescara (Italy) Pagina 2
2. Pre-requisiti Questo documento è stato predisposto per coloro che intendono sviluppare o integrare applicazioni utilizzando i messaggi Sms, pertanto si dà per scontata la conoscenza da parte dell utilizzatore di nozioni informatiche e di comunicazioni. Per accedere ai servizi di Sms Gateway occorre: avere un Account attivo su SmsItaly. L accesso avviene attraverso una User Name ed una Password che devono essere inviati ai nostri Server ad ogni richiesta di invio. Avere Credito disponibile e sufficiente altrimenti i messaggi non vengono inviati. Un messaggio di errore comunicherà la mancata trasmissione del messaggio. 2001, 2002, 2003 Digitel Mobile Srl Pescara (Italy) Pagina 3
3. Specifiche tecniche Per poter inviare un messaggio Sms attraverso un applicazione Custom con protocollo HTTP (sia Web che Windows) occorre stabilire una connessione Server To Server. I parametri da utilizzare sono: Host Primario: gateway.smsitaly.com (IP 212.131.251.60) Porta di accesso: 80 (solo Http) Url check: http://gateway.smsitaly.com/gate/check.asp Url send: http://gateway.smsitaly.com/gate/send.asp Host Secondario: backup.smsitaly.com (IP 212.131.251.50) Porta di accesso: 80 (solo Http) Url check: http://backup.smsitaly.com/gate/check.asp Url send: http://backup.smsitaly.com/gate/send.asp Per la richiesta dello status di un SMS: Host Primario: gateway.smsitaly.com (IP 212.131.251.60) Porta di accesso: 80 (solo HTTP) Url ID SMS: http://gateway.smsitaly.com/gate/query.asp Host Secondario: backup.smsitaly.com (IP 212.131.251.50) Porta di accesso: 80 (solo HTTP) Url ID SMS: http://backup.smsitaly.com/gate/query.asp SmsQuery=IdSms: richiede lo Status del Messaggio Sms SmsQuery=Balance: richiede il Credito residuo dell Account SmsQuery=Status: richiede lo Status attuale dell Account Per il collegamento diretto a SMS GATE SERVER attraverso l interfaccia proprietaria di SmsItaly.Com i parametri da utilizzare sono: Host Primario: tcp.smsitaly.com (IP 212.131.251.60) Host Secondario: backup.smsitaly.com (212.131.251.50) Porta di accesso: 27 Protocollo di comunicazione: TCP/IP Per il servizio Sms Gateway per Webmaster i parametri da utilizzare sono: Host Name: webmaster.smsitaly.com (IP 212.131.251.60) Porta di accesso: 80 (solo HTTP) Url: http://webmaster.smsitaly.com/ita/sms/sms.asp Per nessuna di queste connessioni viene attualmente supportato l accesso in modalità SSL. 2001, 2002, 2003 Digitel Mobile Srl Pescara (Italy) Pagina 4
Per l invio di Sms via E-mail specificare nel pannello di controllo gli indirizzi e-mail abilitati come mittenti, indicare nell oggetto del messaggio il numero di cellulare destinatario ed inviare l e-mail a smsgate@smsitaly.com 4. Parametri e variabili Per l invio corretto dei messaggi occorre specificare una serie di parametri che consentono di individuare l Account che sta inviando, il tipo di messaggio da inviare, il destinatario del messaggio, il mittente, il contenuto del messaggio, la data e ora dell invio. I parametri da passare sono: Account (Username di accesso a SmsItaly.Com) Password (Password di accesso a SmsItaly.Com) CountryCode (prefisso internazionale) GsmCode (prefisso del telefono Gsm) PhoneNumber (numero di telefono a cui si invia il messaggio) TextMessage (testo del messaggio da inviare) Sender (risulterà il mittente del messaggio Sms) Language (lingua utilizzata) SmsHour (ora dell'invio del messaggio) SmsMinute (minuti) SmsAmPm (anti o post meridian) SmsDay (giorno) SmsMonth (mese) SmsYear (anno) SmsType (tipo di Messaggio) Test (indica se il messaggio deve essere effettivamente inviato) IdSms (indicare 1 per Sms Gateway, indicare 2 per Sms Webmaster. Restituisce Id e Status dell ultimo Sms inviato al gateway di SmsItaly.Com oppure, se indicato l ID di un Sms specifico, ne ritorna lo status. SmsQuery (tipo di interrogazione del gateway) 2001, 2002, 2003 Digitel Mobile Srl Pescara (Italy) Pagina 5
Ad ogni chiamata il Server di SmsItaly ritornerà un valore di risposta che consentirà di conoscere l esito dell invio. I possibili risultati sono: 01 (Il messaggio è stato inviato senza errori) 02 (Il messaggio è stato accodato per l'invio in modalità differita) 77 (Udh non valido) 78 (Network Code non valido) 79 (Permesso negato) 80 (TCP/IP non consentito) 81 (Gateway non valido) 82 (ID SMS non trovato) 83 (Richiesta non valida) 84 (Mittente non valido) 85 (Indirizzo IP non abilitato dall'account) 86 (Numero destinatario bloccato dall'account) 87 (Indirizzo IP bloccato dall'account) 88 (Tipo di Sms Non Riconosciuto) 89 (Account non valido o non Attivo) 90 (Operatore Gsm Bloccato) 91 (Prefisso internazionale o operatore non abilitato) 92 (Data e ora dell'invio del messaggio irregolari) 93 (Non è stato inserito il testo del messaggio) 94 (Numero Gsm Non Valido o caratteri non validi) 95 (Prefisso Gsm Non Valido o caratteri non validi) 96 (Prefisso Internazionale non valido o caratteri non validi) 97 (Messaggio non inviato per un errore di connessione) 98 (Raggiunto il limite di Sms utilizzabili per ogni singola sessione) 99 (Il messaggio non è stato inviato in quanto l'account non ha più Credito) I messaggi attualmente inviabili sono: Messaggi di testo standard della lunghezza massima di 160 caratteri Messaggi di tipo Flash sempre di 160 caratteri Messaggi 8 bit encoded come Pictures Messages, Screen Saver, RingTones e Operator Logos (solo verso i telefonini abilitati Nokia) Messaggi 8 bit encoded con UDH I messaggi Sms possono essere inviati solo ed esclusivamente verso gli operatori internazionali con cui è abilitato il roaming (consultare la lista on-line all indirizzo http://www.smsitaly.com/ita/coverage.asp). 2001, 2002, 2003 Digitel Mobile Srl Pescara (Italy) Pagina 6
Inoltre, sempre on-line sul nostro sito web all indirizzo http://www.smsitaly.com/ita/tech_download.asp, sono riportati esempi di programmazione in vari linguaggi (VbScript, Perl, Php) liberamente utilizzabili e a cui fare riferimento. Nella stessa area di download sono disponibili dei Tools in grado di convertire files da formato binario o RTTL in Hex Dump. 5. Tutela della Privacy SmsItaly.Com si impegna a salvaguardare la privacy dei suoi Utenti: le informazioni in nostro possesso che riguardano gli Utenti di SmsItaly.Com saranno solamente quelle che l'utente stesso avrà voluto fornire, previo consenso informato, e non saranno MAI comunicate a terzi senza l'autorizzazione dell'utente. Condivideremo con terze parti (ad esempio inserzionisti e sponsor) solamente informazioni statistiche aggregate riguardanti i nostri Utenti, intesi come gruppo, e mai informazioni personali. Non leggeremo MAI le comunicazioni private on-line. LE INFORMAZIONI RACCOLTE DA SmsItaly.Com I Files di Log Quando un computer si connette ad Internet gli viene assegnato un numero che lo identifica, proprio come avviene per i telefoni, che gli consente di ricevere le immagini dei siti visitati per raccogliere informazioni, giocare, fare acquisti. Digitare sullo schermo il nome di un sito non è molto diverso dal fare una telefonata: dal computer parte una richiesta che, ricevuta dal Server del sito, genera una risposta: l immagine della Home Page, ad esempio. Il server del sito può essere paragonato ad un centralino di un Call Center per l assistenza clienti: registra tutte le chiamate in entrata e le classifica in base alla tipologia (richiesta di informazioni, reclami, ecc.). Nel server di un sito le "chiamate" provenienti dai computer degli utenti sono registrate nei Files di Log. Analizzando i dati contenuti nei Files di Log si è in grado di sapere quali sono state le pagine più richieste del sito, quanto è durata la visita, da che area geografica è partita la richiesta, se tutte le immagini presenti sulle pagine sono state visualizzate o se ci sono stati problemi. Noi di SmsItaly.Com analizziamo le informazioni contenute nei Files di Log che si trovano sul nostro server nel loro insieme, al fine di esaminare il comportamento degli utenti e migliorare i contenuti ed i servizi offerti. Per noi è molto importante sapere quali sezioni del portale hanno incontrato il successo del pubblico, come possiamo migliorare la grafica, quali sono i percorsi interni effettuati con maggior frequenza. Ovviamente saranno sempre benvenuti e fonte di stimolo a 2001, 2002, 2003 Digitel Mobile Srl Pescara (Italy) Pagina 7
fare meglio i commenti e suggerimenti che potrà inviarci l'utente cliccando sugli appositi bottoni. I Cookies I cookies sono dei piccoli file inviati dai siti Web nel programma di navigazione (browser) del computer dei loro visitatori. Nei cookies vengono archiviate informazioni riguardanti le pagine visualizzate, la durata della visita, le informazioni volontariamente e consapevolmente fornite dal visitatore. I contenuti dei cookies sono recuperati automaticamente dal sito Web nel corso di una successiva visita. Noi di SmsItaly.Com li utilizziamo per fornire contenuti e servizi coerenti con gli interessi che l'utente ha manifestato mediante espressa segnalazione o che abbiamo desunto in base a quali parti del portale hanno suscitato maggiore interesse. E quindi per noi molto importante sapere quanti sono i nostri "lettori" e cosa interessa loro per elaborare i contenuti. Ricordiamo comunque che quasi tutti i browser possono essere impostati in modo da non accettare cookies o informare tutte le volte che ne viene inviato uno. Se si decide di bloccare l invio da parte nostra di cookies è possibile che alcune funzioni non siano attive. Mailing list e sondaggi Chiederemo l'indirizzo e-mail ed altre informazioni al fine di effettuare sondaggi o fornire ulteriori servizi (ad esempio abbonamenti a newsletter, annunci, inviti ad eventi on-line). Tutte le volte che chiederemo all'utente di rivelarci l'identità, informeremo sui motivi della richiesta. Garantiamo comunque che non vendiamo e ne comunichiamo a terzi gli indirizzi e-mail dei nostri visitatori senza il loro esplicito consenso. Non manderemo messaggi E-Mail a meno che l'utente non abbia accettato di riceverle. La Community di SmsItaly.Com Se l'utente rende pubblico il Suo indirizzo di e-mail al fine di prendere parte attiva alla nostra comunità (chat, forum, newsgroup) potrà ricevere e-mail da parte di terzi. L indirizzo e-mail ed il nome o alias richiesti per partecipare attivamente alla comunità è registrato unicamente al fine di mantenere l'account. L informazione non è utilizzata per registrare l'attività all interno del Club né per identificare l'utente al di fuori di esso. L'Utente potrà sempre decidere di non dare informazioni personali senza pregiudicarne l'accesso al portale. Avrà sempre la possibilità di non ricevere più comunicazioni all indirizzo di e-mail fornitoci mandando una comunicazione all indirizzo staff@smsitaly.com. Potrà inoltre sempre contattarci per modificare o 2001, 2002, 2003 Digitel Mobile Srl Pescara (Italy) Pagina 8
chiederci di eliminare dai nostri database le informazioni personali che lo riguardano. La legge a tutela della Privacy La Legge 31 dicembre 1996 n. 675 e succ. mod. ha introdotto nell ordinamento italiano quanto previsto a livello comunitario e, al suo art. 1, prevede che il trattamento dei dati personali si svolga nel rispetto dei diritti, delle libertà fondamentali, nonché della dignità delle persone fisiche, con particolare riferimento alla riservatezza e all identità personale. L Autorità che vigila sul rispetto delle norme è il Garante per la protezione dei dati personali ed ha sede a Roma. La legge prevede alcune indicazioni relative al trattamento dei dati personali da parte del titolare del trattamento: in questo caso titolare del trattamento dei dati personali è: SmsItaly.Com c/o Digitel Mobile Srl con sede in Pescara (ITALIA) Via Raffaello,77 - tel. +39.085.75094 E-mail: staff@smsitaly.com. Garantiamo ai nostri utenti che i dati personali oggetto di trattamento saranno: trattati in modo lecito e secondo correttezza; raccolti e registrati per scopi determinati, espliciti e legittimi ed utilizzati anche in altre operazioni del trattamento in termini non incompatibili con tali scopi; esatti e, se necessario, aggiornati; pertinenti, completi e non eccedenti rispetto alle finalità per le quali sono raccolti o successivamente trattati; conservati in una forma che consenta l identificazione dell interessato. Informiamo che l'utente ha il diritto: di conoscere, mediante accesso gratuito al Registro del Garante per il trattamento dei dati personali, l esistenza di trattamenti di dati che lo riguardano; di ottenere, a nostra cura, senza ritardo: la conferma dell esistenza o meno di dati personali che lo riguardano, nonché la logica e le finalità su cui si basa il trattamento; la cancellazione, la trasformazione in forma anonima o il blocco dei dati trattati in violazione di legge; l aggiornamento, la rettificazione, l integrazione dei dati; di opporsi, in tutto o in parte, per motivi legittimi, al trattamento dei dati personali che lo riguardano. Sono stati ridotti al minimo i rischi di distruzione o perdita dei dati forniti dall'utente e di accesso non 2001, 2002, 2003 Digitel Mobile Srl Pescara (Italy) Pagina 9
autorizzato o di trattamento non consentito, o non conforme alle finalità della raccolta. 2001, 2002, 2003 Digitel Mobile Srl Pescara (Italy) Pagina 10