Docs Italia beta

Documenti pubblici, digitali.

Funzionalità BOT Telegram Gestione Emergenze Comune di Genova

Per utilizzare le funzionalità del Bot Telegram Gestione emergenze Comune di Genova (@emergenze_genova_bot) è necessario essere un utente del Sistema Emergenze ed avere un profilo assegnato. Inoltre è necessario attivare le notifiche Telegram secondo quanto indicato nel capitolo Profilo utente e attivazione notifiche telegram

Tramite il bot Telegram è possibile ricevere notifiche dal Sistema Emergenze, ad esempio in caso di apertura di un nuovo evento, di assegnazione di un incarico/presidio alla propria squadra, ecc. Inoltre è anche possibile interagire direttamente con il Sistema Emergenze ad esempio segnalando la propria presenza alla Centrale Operativa, accettando o rifiutando un incarico assegnato alla propria squadra, inserendo la lettura di una mira o inviando una comunicazione alla Centrale.

Avvertimento

E” fondamentale per il corretto funzionamento del bot rispettare e seguire tutti i passaggi richiesti dai comandi e nell’ortdine indicato per poterli eseguire correttamente. Qualora non venissero esguiti tutti gli step, il comando non viene terminato e quindi gli altri comandi/funzioni del bot non potranno essere utilizzati fino al completamento del comando.

Comandi Telegram

Una volta installato il bot su Telegram è possibile accedere ai diversi comandi sviluppati. La lista dei comandi disponibili è accessibile cliccando sul pulsante Menu nella barra degli strumenti dell’applicazione Telegram oppure digitando il simbolo slash /

_images/barra_t.png

I comandi disponibili sono:

  • /start - avvia il bot per la prima volta e viene automaticamente lanciato all’installazione del bot
  • /help - restituisce un messaggio con una breve descrizione dei comandi del bot
  • /telegram_id - restituisce il proprio codice identificativo Telegram. Questo codice univoco deve essere inserito nel Sistema per consentire l’attiovazione delle notifiche
  • /sito - restituisce il link web al Portale di Sistema Emergenze
  • /registra_presenza - consente all’utente di registrare a sistema la propria presenza ad inizio turno (per maggiori dettagli si veda il paragrafo Registra Presenza)
  • /registra_uscita - consente all’utente di registrare a sistema la fine del proprio turno (per maggiori dettagli si veda il paragrafo Registra Presenza)
  • /inserisci_mira - consente di inserire il valore della lettura di una mira (per maggiori dettagli si veda il paragrafo Inserimento lettura mire)
  • /comunicazione - consente di inviare una comunicazione (testo ed eventuali immagini) relativa a una segnalazione alla Centrale operativa (per maggiori dettagli si veda il paragrafo Comunicazioni con la centrale operativa)
_images/comandi_t_cut.png

I comandi possono essere lanciati con tre modalità:

  • cliccando sul comando desiderato dalla lista dei comandi che si ottiene con il pulsante Menu
  • cliccando sul comando desiderato dalla lista dei comandi che si ottiene digitando il simbolo /
  • digitando il nome del comando preceduto da simbolo slash /
_images/comandi_t2.png

Funzioni Telegram

Registra Presenza

La funzionalità Registra presenza consente all’utente di indicare l’inizio e la fine del proprio turno.

Il comando /registra_presenza, disponibile nella lista dei comandi, consente di indicare l’inizio del proprio turno. Il comando restituisce all’utente un messaggio in cui viene chiesto di specificare la durata del turno, l’utente dovrà quindi cliccare sul bottone corrispondente al numero di ore del turno

_images/presenza_durata.png

Una volta indicata la durata del proprio turno, il bot restituisce un messaggio di avvenuta registrazione della presenza e l’indicazione dell’orario presunto di fine turno

_images/presenza_ok.png

Avvertimento

Qualora fosse già stata indicata la propria presenza tramite il comando /registra_presenza, il bot restituirà un messaggio che informa l’utente che la presenza è già stata registrata.

Il comando /registra_uscita, disponibile nella lista dei comandi, consente di indicare la fine del proprio turno. Il comando restituisce all’utente un messaggio in cui viene chiesto di confermare la chiusura del turno

_images/registra_uscita.png

Avvertimento

Qualora fosse già stata indicata la fine del proprio turno tramite il comando /registra_uscita, il bot restituirà un messaggio che informa l’utente che non risulta a sistema un tunro attivo.

A partire da 10 minuti prima dell’ora presunta di fine turno, l’utente riceverà una notifica automatica di remind sul bot per ricordare di utilizzare il comando /registra_uscita per indicare la fine del turno. L’utente riceverà una notifica ogni 10 minuti finchè non verrà chiuso il turno

Ricezione della presenza sul Sistema Emergenze

Quando l’operatore registra la propria presenza tramite il comando /registra_presenza del bot Telegram, i dettagli del suo turno saranno visibili sulla pagina web Utenti presenti del Sistema Emergenze. Oltre ai dati dell’utente (matricola/CF, nome e cognome) sono indicati anche data e ora di inizio turno e la durata del turno. Gli utenti del Sistema con profilo Amministratore possono dalla pagina Utenti presenti:

  • chiudere il turno di un operatore utilizzando il bottone Termina Turno
  • modificare i dettagli (inizio e durata) del turno di un operatore utilizzando il bottone Modifica Turno
_images/presenti.png

Quando il turno di un operatore viene terminato, utilizzando il comando /registra_uscita del bot Telegram o dall’Amministratore di Sistema, i dettagli del turno appena chiuso saranno visibili nella pagina web Storico utenti presenti del Sistema Emergenze.

La presenza degli operatori è visibile anche sulla pagina web Gestione squadre. Nella tabella delle squadre attive o attivabili, la colonna Telegram indica se il Capo squadra ha registrato la propria presenza:

  • icona X arancione = è stato assegnato un Capo squadra ma non ha registrato la propria presenza
  • icona V verde = è stato assegnato un Capo squadra e ha registrato la propria presenza
  • “-” = non è stato assegnato un Capo squadra
_images/presenza_squadre.png

Accettazione/rifiuto incarichi interni, presidi e incarichi

Durante la gestione di una segnalazione registrata sul Sistema Emergenze, l’ente che ne detiene la titolarità ha la possibilità di assegnare incarichi interni e presidi fissi alle squadre attivabili o incarichi a Direzioni, Municipi, Distretti di PM e Unità Operative Esterne. Questa funzione gestisce anche l’accettazione o il rifiuto di presidi fissi assegnati a una squdara indipendentemente da una segnalazione.

  • Quando viene assegnato un incarico interno o un presidio fisso il Sistema Emergenze invierà una notifica sul bot Telegram a tutti gli operatori facenti parte della squadra a cui è stato assegnato l’incarico interno/presidio fisso. In questo caso è possibile per gli operatori gestire l’accettazione o il rifiuto dell’incarico/presidio direttamente dal bot Telegram.
  • Quando viene assegnato un presidio mobile il Sistema Emergenze invierà una notifica sul bot Telegram a tutti gli operatori facenti parte della squadra a cui è stato assegnato il presidio mobile. In questo caso viene solamente inviata la notifica e non è possibile per gli operatori gestire l’accettazione del presidio direttamente dal bot Telegram.
  • Quando viene assegnato un incarico il Sistema Emergenze invierà una notifica sul bot Telegram ai contatti registrati a sistema per la notifica degli incarichi a Direzioni, Municipi, Distretti di PM e Unità Operative Esterne. In questo caso viene solamente inviata la notifica e non è possibile per gli operatori gestire l’accettazione o il rifiuto dell’incarico direttamente dal bot Telegram.

Nota

E” buona norma che l’accettazione/rifiuto dell’incarico o presidio venga gestita via Telegram dal Capo squadra. In ogni caso qualora un componente accettasse l’incarico/presidio, non sarà possibile per gli altri componenti della squadra rifiutarlo o accettarlo nuovamente.

Accettazione/rifiuto incarichi interni

In caso di assegnazione di un incarico interno a una squadra, tutti gli operatori facenti parte della squadra riceveranno una notifica di assegnazione incarico sul bot Telegram con indicato:

  • il numero della segnalazione a cui fa riferimento l’incarico
  • il nome della squadra di appartenenza
  • i dettagli dell’incarico (breve descrizione operativa)
  • le istruzioni per accettare o rifiutare l’incarico
  • una mappa con la geolocalizzazione dell’incarico (cliccando sulla mappa si viene reindirazzati allo strumento per la ricerca delle indicazioni stradali)
_images/notifica_inc_int.png

L’operatore può accettare l’incarico con due modalità:

  • cliccando sul comando /accetto direttamente dal messaggio di notifica ricevuto
  • digitando il comando /accetto nell’area di testo di Telegram

La funzione di accettazione dell’incarico assegnato è composta dai seguenti step:

  • comando /accetto - restiruisce un messaggio sul bot in cui viene chiesto all’operatore di indicare tra quanti minuti sarà sul posto.
  • invio del messaggio da parte dell’operatore con indicazione il numero di minuti espresso in cifre (es. 20). NB. Se il numero di minuti viene espresso in caratteri (es. venti) il bot restituirà un messaggio di errore e sarà necessario indicare nuovamente i minuti in cifre.
  • indicazione da parte dell’operatore se la presa in carico è regolare o parziale cliccando sui bottoni che compaiono nella barra degli strumenti di telegram

Conclusi questi tre step, l’operatore riceverà un messaggio di riepilogo con quanto indicato negli step recedenti e le istruzioni per chiudere l’incarico una volta completato

_images/accetto_inc_int.png

L’operatore può successivamente chiudere l’incarico con due modalità:

  • cliccando sul comando /chiudo direttamente dal messaggio di notifica ricevuto terminata la funzione di accettazione dell’incarico
  • digitando il comando /chiudo nell’area di testo di Telegram

La funzione di chiusura dell’incarico assegnato è composta dai seguenti step:

  • comando /chiudo - restiruisce un messaggio sul bot in cui viene chiesto all’operatore di indicare una nota di chiusura
  • invio del messaggio da parte dell’operatore con un breve testo di nota per la chiusura
_images/chiudo_inc_int.png

Oltre ad accettare/chiudere l’incarico è possibile anche dal bot telegram rifiutare l’incarico.

L’operatore può rifiutare l’incarico con due modalità:

  • cliccando sul comando /rifiuto direttamente dal messaggio di notifica ricevuto all’assegnazione dell’incarico
  • digitando il comando /rifiuto nell’area di testo di Telegram

La funzione di rifiuto dell’incarico assegnato è composta dai seguenti step:

  • comando /rifiuto - restiruisce un messaggio sul bot in cui viene chiesto all’operatore di indicare una motivazione per il rifiuto
  • invio del messaggio da parte dell’operatore con un breve testo di motivazione per il rifiuto
_images/rifiuto_inc_int.png

Avvertimento

I comandi /accetto, /chiudo e /rifiuto funzionano solo se l’operatore è parte di una squadra e se a quella squadra è stato assegnato un incarico. Quando l’operatore lancia uno di questi comandi il bot verifica se l’operatore è inserito in una squadra e se ad essa è assegnato un incarico interno, qualora queste condizioni non fossero verificate, il bot restituisce un messaggio di errore.

Accettazione presidio fisso

In caso di assegnazione di un presidio fisso a una squadra, tutti gli operatori facenti parte della squadra riceveranno una notifica di assegnazione presidio sul bot Telegram con indicato:

  • il numero della segnalazione a cui fa riferimento il presidio
  • il nome della squadra di appartenenza
  • i dettagli del presidio (breve descrizione operativa)
  • le istruzioni per accettare il presidio (nel caso dei presidi non è previsto il rifiuto)
  • una mappa con la geolocalizzazione del presidio (cliccando sulla mappa si viene reindirazzati allo strumento per la ricerca delle indicazioni stradali)
_images/notifica_pres_fis.png

L’operatore può accettare il presidio fisso con due modalità:

  • cliccando sul comando /presidio direttamente dal messaggio di notifica ricevuto
  • digitando il comando /presidio nell’area di testo di Telegram

La funzione di accettazione del presidio assegnato è composta dai seguenti step:

  • comando /presidio - restiruisce un messaggio sul bot in cui viene chiesto all’operatore di indicare tra quanti minuti sarà sul posto.
  • invio del messaggio da parte dell’operatore con indicazione il numero di minuti espresso in cifre (es. 20). NB. Se il numero di minuti viene espresso in caratteri (es. venti) il bot restituirà un messaggio di errore e sarà necessario indicare nuovamente i minuti in cifre.

Conclusi questi due step, l’operatore riceverà un messaggio di riepilogo con quanto indicato negli step recedenti e le istruzioni per chiudere il presidio una volta completato

_images/accetto_pres_fis.png

L’operatore può successivamente chiudere il presidio con due modalità:

  • cliccando sul comando /stop direttamente dal messaggio di notifica ricevuto terminata la funzione di accettazione del presidio
  • digitando il comando /stop nell’area di testo di Telegram

La funzione di chiusura del presidio assegnato è composta dai seguenti step:

  • comando /stop - restiruisce un messaggio sul bot in cui viene chiesto all’operatore di indicare una nota di chiusura
  • invio del messaggio da parte dell’operatore con un breve testo di nota per la chiusura
_images/chiudo_pres_fis.png

Avvertimento

I comandi /presidio e /stop funzionano solo se l’operatore è parte di una squadra e se a quella squadra è stato assegnato un presidio. Quando l’operatore lancia uno di questi comandi il bot verifica se l’operatore è inserito in una squadra e se ad essa è assegnato un presidio fisso, qualora queste condizioni non fossero verificate, il bot restituisce un messaggio di errore.

Inserimento lettura mire

La funzionalità Inserimento lettura mira consente di inserire le letture delle mire sui corsi d’acqua.

Avvertimento

Il comando /inserisci_mira può essere utilizzato solo nei casi in cui è attiva una Fase Operativa Comunale (FOC) e solo dai componenti della squadre a cui sono assegnati dei presidi mobili. Qualora non fosse verificata una di queste condizioni, il comando restiuirà un messaggio di errore.

Il comando /inserisci_mira, disponibile dalla lista dei comandi, restituisce l’elenco delle mire relative al presidio mobile (percorso) assegnato alla squadra. L’operatore dovrà quindi cliccare sulla mira per cui vuole inserire la lettura.

_images/mira_elenco.png

Una volta indicata la mira, il bot restituisce un messaggio in cui si chiede all’operatore di inserire la lettura. Per inerire la lettura sono disponibili 3 bottoni (verde, giallo e rosso) reggiungibili cliccando sul pulsante evidenziato in verde nell’immagine sotto

_images/mire_tool.png

L’operatore dovrà quindi cliccare sul bottone corrispondente alla lettura della mira scelta

_images/mire_valore.png

Una volta indicata la lettura della mira, il bot restituisce un messaggio di riepilogo dei dati inseriti e la lettura così inviata sarà immediatamente visibile nella pagine web Mire sui corsi d’acqua del Sistema emergenze

_images/mire_web.png

Comunicazioni con la centrale operativa

La funzionalità Comunicazioni con la centrale operativa consente di inviare comunicazioni (testo e immagini) alla Centrale Operativa che recepirà tali comunicazioni tramite il portale web di Sistema Emergenze.

Avvertimento

Il comando /comunicazione può essere utilizzato solo dai componenti della squadre a cui sono assegnati dei incarichi interni, presidi fissi (relativi a una segnalazione), o presidi mobili. Qualora non fosse verificata una di queste condizioni, il comando restiuirà un messaggio di errore.

Il comando /comunicazione, disponibile dalla lista dei comandi, restituisce un messaggio in cui si chiede all’operatore di inserire il testo della comunicazione. L’operatore dovrà quindi digitare il testo e inviarlo. Una volta inviato il testo, il bot restituisce un messaggio in cui si chiede se si vuole inserire una foto

La funzione di comunicazione con la centrale operativa è composta dai seguenti step:

  • comando /comunicazione - restituisce un messaggio in cui si chiede all’operatore di inserire il testo della comunicazione.
  • invio del messaggio da parte dell’operatore con il testo
  • indicazione da parte dell’operatore se desidera allegare un’immagine o inviare il solo testo inserito cliccando sui bottoni che compaiono nella barra degli strumenti di telegram.
_images/comunicazione.png

Se viene scelto il tasto Foto l’operatore dovrà scattare una foto dal suo dispositivo o sceglierne una dalla gallerie immagini del dispositivo. Entrambe le opzioni sono raggiungibili cliccando sul tasto evidenziato in verde nell’immagine sotto

_images/comunicazione_foto.png

Conclusi questi tre step, l’operatore riceverà un messaggio conferma di avvenuto invio della comunicazione

_images/comunicazione_invio.png

La comunicazione sarà quindi immediatamente visibile sul portale web Sistema Emergenze nella pagina relativa all’incarico interno, presidio fisso o mobile.

Funzionalità BOT Telegram Convocazione COC Genova (Paragrafo in fase di compilazione)

Per utilizzare le funzionalità del Bot Telegram Convocazione COC Genova (@emergenze_genova_bot) non è necessario essere un utente del Sistema Emergenze con un profilo assegnato, ma è necessario essere registrato a sistema con membro del COC Direttivo.

Tramite il bot Telegram è possibile ricevere notifiche dal Sistema Emergenze, ad esempio in caso di emanazione di un’allerta e in caso di convocazione del COC.

Avvertimento

E” fondamentale per il corretto funzionamento del bot rispettare e seguire tutti i passaggi richiesti dai comandi e nell’ortdine indicato per poterli eseguire correttamente. Qualora non venissero esguiti tutti gli step, il comando non viene terminato e quindi gli altri comandi/funzioni del bot non potranno essere utilizzati fino al completamento del comando.

Notifica di emanazione di un’allerta

Sistema Emergenze riceve in tempo quasi reale i bollettini emessi da ARPAL (https://allertaliguria.regione.liguria.it/). All’emissione del bollettino, viene inviata da Sistema Emergenze una notifica sul BOT Telegram a tutti i componenti del COC Direttivo. Il messaggio di notifica contiene:

  • il link pe la consultazione del bollettino appena emesso
  • la comunicazione dell’emanazione dell’allerta
  • il bottone per inviare al Sistema la conferma di lettura del messaggio
_images/invio_bollettino.png

L’utente deve cliccare sul pulsante OK mostrato nell’immagine sopra per inviare a Sistema Emergenze la conferma di lettura del messaggio.

Avvertimento

Qualora l’utente non invii la conferma di lettura, riceverà ogni 5 minuti una notifica di remind di invio della conferma di lettura

_images/notifica.png

I dettagli relativi all’invio del bollettino e della relativa conferma di lettura da parte dell’utente, sono visibili agli utenti amministratori tramite le pagine web dedicate su Sistema Emergenze (si veda sezione dedicata Convocazione del COC da Sistema Emergenze e gestione dello storico)

Notifica di Convocazione del COC

Tramite un apposito tool sviluppato su Sistema Emergenze (si veda sezione dedicata Convocazione del COC da Sistema Emergenze e gestione dello storico), gli amministratori di sistema possono inviare la convocazione del COC. All’invio della convocazione, viene quindi inviata una notifica sul BOT Telegram a tutti i componenti del COC Direttivo. Il messaggio di notifica contiene:

  • Il testo del messaggio inviato dagli amministratori di sistema tramite l’apposito tool di Sistema Emergenze
  • il bottone per inviare al Sistema la conferma di lettura del messaggio
_images/messaggio_conv.png

L’utente deve cliccare sul pulsante OK mostrato nell’immagine sopra per inviare a Sistema Emergenze la conferma di lettura del messaggio.

Avvertimento

Qualora l’utente non invii la conferma di lettura, riceverà ogni 5 minuti una notifica di remind di invio della conferma di lettura

_images/notifica_conv.png

I dettagli relativi all’invio della convocazione e della relativa conferma di lettura da parte dell’utente, sono visibili agli utenti amministratori tramite le pagine web dedicate su Sistema Emergenze (si veda sezione dedicata Convocazione del COC da Sistema Emergenze e gestione dello storico)

Convocazione del COC da Sistema Emergenze e gestione dello storico

Gli utenti amministratori di sistema possono accedere a due pagine dedicate alla Convocazione del COC Direttivo su Sistema Emergenze. In particolare sono state implementate due pagine dedicate:

  1. Ultima Convocazione COC
  • tabella contenete i dettagli relativi all’ultima convocazione inviata con indicazione delle relative conferme di lettura da parte degli utenti facenti parte del COC
  • Tool per l’invio della Convocazione del COC Direttivo
  1. Storico Convocazioni
  • tabella contenete i dettagli relativi alle convocazioni precedenti
_images/pagine_coc.png

Ultima Convocazione COC

In questa pagina è possibile concultare i dettagli dell’ultima convocazione del COC inviata da Sistema Emergenze. La tabella contiene, per ogni utente facente parte del COC, i dettagli relativi a:

  • Nome, Cognome e Funzione ricoperta dall’utente
  • Data/ora di invio della notifica di emanazione dell’allerta con relativa conferma di lettura (simbolo verde/rosso a seconda che sia stata data conferma da parte dell’utente e data/ora di invio della conferma)
  • Data/ora di invio della Convocazione del COC con relativa conferma di lettura (simbolo verde/rosso a seconda che sia stata data conferma da parte dell’utente e data/ora di invio della conferma)

La tabella può essere esportata in formato pdf tramite l’apposito tool presente nella pagina web.

_images/ultima_conv.png

Sempre dalla pagina con i dettagli dell’ultima Convocazione del COC Direttivo, è possibile per gli amministratori di sistema inviare il messaggio agli utenti facenti parte del COC Direttivo con i dettgali dell Convocazione (es. data, orario, luogo, eventuali link e informazioni utili), tramite l’apposito tool Convoca COC. Cliccando sul pulsante compare un popup con un’area di testo in cui inserire il testo del messaggio, cliccando su Invia il messaggio verrà automaticamente inviato sul BOT Telegram Convocazione COC Genova.

_images/convocazione_coc.png

Storico Convocazioni

In questa pagina è possibile concultare i dettagli delle precedenti convocazioni del COC inviate da Sistema Emergenze. La tabella contiene, per ogni utente facente parte del COC, i dettagli relativi a:

  • Nome, Cognome e Funzione ricoperta dall’utente
  • Data/ora di invio della notifica di emanazione dell’allerta con relativa conferma di lettura (simbolo verde/rosso a seconda che sia stata data conferma da parte dell’utente)
  • Data/ora di invio della Convocazione del COC con relativa conferma di lettura (simbolo verde/rosso a seconda che sia stata data conferma da parte dell’utente)
_images/storico_conv.png

Gestione utenti del COC da Sistema Emergenze

Gli utenti amministratori possono visualizzare, gestire, aggiungere/eliminare e modificare gli utenti registrati come componenti del COC Direttivo accedendo alla pagina dedicata Componenti COC Direttivo dal menù Gestione Utenti di Sistema Emergenze.

_images/utenti_COC.png

In questa pagina è possibile visualizzare l’elenco degli utenti facenti parte del COC Direttivo con relativa funzione ricoperta. E” inoltre possibile rimuovere l’utente cliccando sul corrispondente pulsante nella colonna Rimuovi o modificarne i dettagli cliccando sul corrispondente pulsante nella colonna Edit.

Da questa pagina è inoltre possibile aggiungere nuovi utenti facenti parte del COC utilizzando il tool dedicato Aggiungi Componente. Cliccando il bottone, compare un popup con le informazioni relative al nuovo utente da inserire, tra cui ovviamente l’id Telegram dell’utente necessario affinche l’utente possa ricevere i messaggi sul BOT.

_images/new_user_coc.png

L’utente può recuperare il proprio id Telegram, da comunicare all’amministratore di sistema, utilizzando il comando /telegram_id del BOT Convocazione COC Genova. Il comando può essere lanciato con tre modalità:

  • cliccando sul comando dalla lista dei comandi che si ottiene con il pulsante Menu
  • cliccando sul comando dalla lista dei comandi che si ottiene digitando il simbolo /
  • digitando il nome del comando preceduto da simbolo slash /