Benvenuto Ospite  • Login



Marcom Wiki

Marcom S.r.l. Wiki
Supporto ai prodotti

RSS

MENU


CATEGORIE


Cerca nel wiki
»

AMMINISTRAZIONE


Immagine Cambia/Change

 

SMS Gateway

RSS
Modificata il 20/06/2011 10:37 da Alberto Categorizzata come Gateway, Home Automation, Telecontrollo, Utility
In un impianto al verificarsi di un allarme o di un'anomalia di funzionamento è indispensabile che il responsabile venga avvertito tempestivamente per poter agire rapidamente, minimizzando le perdite di produzione o eventuali danni!

Marcom s.r.l., per venire incontro a queste esigenze, fornisce un servizio in grado di inviare automaticamente un SMS a qualsiasi numero di telefono mobile. Questo consente ad esempio di eliminare l'utilizzo del combinatore telefonico in impianti dove sia presente un collegamento ad Internet sempre aperto.I vantaggi sono molteplici: non è più necessario gestire un'apparecchiatura hardware e la relativa SIM; è possibile inviare in maniera semplice messaggi testuali esplicativi dell'evento avvenuto; è disponibile un log storico che certifica la consegna del messaggio e data ed ora della stessa.


Collegamento alla sezione


Generale

Il servizio di invio SMS tramite web, offerto da Marcom S.r.l. ai suoi clienti, utilizza un sistema di autenticazione e gestione credito basato su tre campi:

  • App ID: è il codice che identifica il servizio configurato che si occupa di gestire l'invio del SMS.
  • Nome Utente: è il nomeutente assegnato da Marcom S.r.l. in fase di registrazione al servizio. Tale utente ha poi una serie di servizi dedicati, ciascuno identificato da un suo App_id.
  • Password: è una password alfanumerica generata automaticamente dal sistema. Non è possibile cambiare la password.

Servizi per l'invio

I servizi sono attivati su richiesta del cliente e sono:

  • Invio SMS tramite servizio SOAP: consente di inviare gli SMS utilizzando un servizio SOAP (Marcom S.r.l. offre un software sviluppato in ambiente .NET, da riga di comando, per l'invio degli SMS in questa modalità)
  • Invio SMS tramite HTTP/HTTPS: l'invio del SMS è effettuato tramite POST o GET, utilizzando una connessione libera o criptata (HTTPS).
  • Invio SMS tramite FTP: l'upload di un file formattato con un determinato schema, permette di inviare messaggi multipli a più destinatari con un solo comando. L'invio con questa modalità ha una duplice sicurezza: viene richiesta una password sia al momento dell'upload del file che a livello di lettura del file stesso (come avviene per i metodi precedenti).
  • Invio SMS tramite mail: il servizio consente di inviare una mail, con una formattazione ben definita, che viene interpretata e trasformata in SMS.

Gestione del Credito

Il credito prepagato è quantificato in numero di SMS. In particolare, è possibile acquistare pacchetti di SMS che andranno a ricaricare la propria capacità di invio, per tutti i servizi configurati. Se si è proprietari di più account presso Marcom SMS Gateway, è possibile acquistare un pacchetto unico e suddividere i messaggi acquistati tra i vari account (possibilità di gestire impianti differenti).

E' inoltre possibile attivare un servizio di notifica tramite mail che, al superamento di una soglia impostata, invia una mail all'indirizzo specificato. Viene fornito un report dettagliato in formato excel degli SMS inviati con dettaglio del numero a cui è stato inviato, del contenuto, della avvenuta ricezione dello stesso con data ed ora. Il servizio non presenta vincoli od obblighi di alcun tipo. Il credito non utilizzato non può essere rimborsato.

Esempi di applicazione

SMS Gateway è una soluzione molto flessibile e introduce numerosi vantaggi rispetto all'utilizzo di un combinatore telefonico:
  1. Innanzitutto la spesa: si evitano i costi di acquisto e configurazione del combinatore.
  2. Il credito acquistato non ha scadenza. Perciò non è necessario ricaricare la scheda sim perchè non venga disattivata. Il credito resterà disponibile fino ad esaurimento.
  3. Sempre disponibile da qualsiasi punto: basta un collegamento ad internet (ADSL, UMTS flat, GPRS flat...).
  4. Assolve la funzione di combinatore telefonico ma può essere condiviso tra più impianti.
  5. Per inviare messaggi di allarme da sistemi di supervisione (SCADA) o da PLC. Per inviare messaggi SMS da applicazioni dedicate tramite collegamento di rete.

Esempio di invio da console

L'invio da riga di comando utilizza il software sviluppato da Marcom S.r.l.. L'utilizzo del software prevede la presenza nella stessa directory del programma del file auth.xml fornito al momento del primo acquisto. Tale file contiene le informazioni di autenticazione al servizio personali del cliente.

ATTENZIONE: tale file è strettamente legato al proprio conto SMS. Può essere utilizzato diverse volte, anche su postazioni diverse. Se smarrito è possibile richiederne una copia per mail a Marcom S.r.l.. E' possibile richiedere la disattivazione del conto legato al file, nel caso di sospetto uso inappropriato, e la generazione di un nuovo conto ed un nuovo file.

Lanciando il file eseguibile senza parametri si ottiene il seguente output:

Marcom SMS Gateway - Utilizzo del servizio

I parametri da passare quando viene richiamato l'eseguibile sono:

  • numeri di telefono: racchiusi tra doppi apici, comprensivi di prefisso internazionale e separati da virgola
  • messaggio: racchiuso tra doppi apici, lunghezza massima 160 carateri
  • verbose: impostare ad 1 per attivare la modalità diagnostica, a 0 o non impostato per disattivarla

Marcom SMS Gateway - log applicazione

Esempio con il verbose non attivato

Marcom SMS Gateway - log applicazione verbose

Esempio con il verbose attivato



Esempio di invio tramite email

L'invio dei messaggi SMS tramite mail è molto semplice: i campi necessari all'invio sono in totale 5:

  • campo api_id: codice abbonamento relativo al servizio.
  • campo user: nome utente per accedere al servizio.
  • campo password: password per autenticarsi al servizio invio sms.
  • campo to: indica il destinatario o i destinatari del messaggio.
  • campo text: specifica il testo del messaggio.

Il campo to può indicare un singolo numero di telefono comprensivo di prefisso internazionale, oppure una lista di numeri di telefono ai quali lo stesso sms dev'essere inviato.



Esempio invio a numero singolo

to:xxxxxxxxxxxxxxxx 



Esempi invio a lista di numeri

to:xxxxxxxxxxxxxxxx,xxxxxxxxxxxxxxxx,xxxxxxxxxxxxxxxx,xxxxxxxxxxxxxxxx 


oppure
 

to:xxxxxxxxxxxxxxxx 
to:xxxxxxxxxxxxxxxx 
to:xxxxxxxxxxxxxxxx 
to:xxxxxxxxxxxxxxxx 



Il campo text è il messaggio da inviare. Questo testo può anche essere su più linee, consentendo in tal modo di inserire caratteri "capo riga" all'interno dell'SMS.

Esempio invio sms

api_id:1234 
user:xxxxxxxxx 
password:xxxxxxxxxxx 
to:1234567890,1234567890 
text:This is my first test SMS 




ATTENZIONE: E' consigliato che ciascuna riga non superi i 40 caratteri. Il numero massimo di caratteri per linea è comunque determinato dal proprio client email (il software che invia la mail al nostro servizio), perciò tale limite potrebbe essere maggiore o minore di 40 caratteri.



Codici di ritorno

Il software conclude la sua esecuzione restituendo un codice numerico che indica l'avvenuto invio o, in caso di errore, il tipo di errore incontrato. Di seguito la tabella con i codici d'errore che si possono incontrare.

Marcom SMS Gateway - Codici errore

Un codice d'errore generico è il 9999 che indica Errore interno al software. Se compare tale errore contattare il supporto tecnico.



Valuta il contenuto dell'articolo



Marcom Wiki. Supporto al sito marcomweb.

Basato su Screwturn Wiki © All right reserved - version 3.0.4.560. Distribuito con licenza GPL v2.