Telegram

Le notifiche tramite Telegram passano attraverso un bot proprio del controller. Un amministratore lo configura una volta; dopodiché ogni persona collega il proprio Telegram al proprio account. I profili inviano poi:

• alle persone tramite il canale Telegram di un profilo,
• a un gruppo Telegram tramite un servizio del tipo Gruppo Telegram.

Il controller invia direttamente a Telegram, non tramite il cloud nomos.

Configurare il bot

Solo gli amministratori configurano il bot.

1. In Telegram crei un bot con @BotFather e /newbot. BotFather Le comunica poi il suo token.
2. Nella configurazione apra Notifiche → Servizi e clicchi su Nuovo servizio.
3. In Servizio scelga Bot Telegram. Questo tipo è proposto solo finché non è configurato alcun bot. L'editor ha allora solo il campo Token: nessun nome, nessun URL e nessun messaggio di prova.
4. Inserisca il token e clicchi in alto su Salva. Se Telegram accetta il token, il bot occupa la prima riga dell'elenco dei servizi: il suo nome Telegram come Nome, ad esempio @LaMiaCasaBot, e Bot Telegram come Servizio.

Configurare il bot nella scheda Telegram di un profilo apre Nuovo servizio con il tipo Bot Telegram già scelto.

Dopo il salvataggio il token non viene più mostrato. Chi lo conosce può scrivere come il bot e leggere ciò che gli viene scritto.

Modificare o rimuovere il bot

• Modifica nella riga del bot mostra il suo nome e il campo Nuovo token. Se resta vuoto, il bot rimane com'è. Il token di un altro bot scollega tutti i collegamenti, che vanno rifatti.
• Elimina nella riga del bot o nella barra dell'editor chiede conferma (Rimuovere il bot Telegram?) e poi rimuove il bot. Persone e gruppi non ricevono più messaggi Telegram; tutti i collegamenti vengono rimossi e vanno rifatti con un nuovo bot.

Collegare Telegram

Ogni persona collega il proprio Telegram nel proprio account. Gli amministratori possono farlo anche per altri utenti.

1. Apra il menu utente in alto a destra e scelga Profilo. Come amministratore apra Utenti → Modifica per un altro utente (vedi Utenti).
2. Nella sezione Telegram clicchi su Collegare Telegram. Compaiono un link e un codice QR.
3. Apra il link sul telefono o scansioni il codice QR e tocchi Avvia in Telegram. Il link vale 15 minuti; Creare un nuovo link ne crea uno nuovo.
4. Appena Telegram segnala l'avvio, la sezione mostra Collegato come … con il nome Telegram.

Scollegare rimuove il collegamento dopo una conferma; l'account non riceve più messaggi Telegram finché non viene collegato di nuovo. Se qualcuno blocca il bot in Telegram, il controller rimuove il collegamento da sé.

Senza un bot configurato, la sezione indica Ancora nessun bot Telegram configurato (Notifiche › Servizi › Nuovo servizio).

INFO

L'utente "guest" è un accesso condiviso e anonimo: non può collegare Telegram e non è proposto come destinatario nei profili.

Telegram in un profilo

Nella scheda Telegram di un profilo attiva Inviare tramite Telegram e sceglie i destinatari: Tutti (tutti quelli che hanno collegato Telegram), Amministratori o singoli utenti. Accanto a ogni utente compare il suo nome Telegram o non collegato. Un utente senza l’autorizzazione Notifica push è in grigio e contrassegnato con senza l’autorizzazione «Notifica push».

Un messaggio Telegram arriva a chi è scelto, ha collegato il proprio Telegram, ha un account attivo e ha Accesso completo per Notifica push nelle autorizzazioni.

Gruppo Telegram

Se una notifica deve andare in un gruppo Telegram, ad esempio il gruppo di famiglia, configuri il gruppo come servizio:

1. Apra Notifiche → Servizi e clicchi su Nuovo servizio.
2. In Servizio scelga Gruppo Telegram. Questo tipo è proposto solo quando è configurato un bot Telegram.
3. In Telegram aggiunga il bot al gruppo, oppure invii nel gruppo /start@ seguito dal nome del bot. Se il bot era già nel gruppo, lo rimuova e lo aggiunga di nuovo.
4. Clicchi su Cercare gruppi. Il controller cerca per 2 minuti; ogni gruppo in cui il bot si manifesta in quel tempo compare in Gruppo. Il primo gruppo trovato viene scelto subito e il suo nome viene ripreso come Nome, se quel campo è ancora vuoto.
5. Verifichi il gruppo con Inviare un messaggio di prova e clicchi in alto su Salva.

Poi scelga il gruppo in un profilo nella scheda Servizi.

Consegna al cliente

Configurazione per nuovo utente (vedi Configurazione) rimuove il bot Telegram e tutti i collegamenti: il telefono dell'integratore non deve ricevere le notifiche del cliente, e chi ha il token del bot legge ciò che gli viene scritto. Il cliente configura poi un proprio bot.

Una notifica inoltrata va, sui controller gestiti, tramite il loro bot a tutti coloro che lì hanno collegato il proprio Telegram.