Lavorare con le Chat¶
I bot e gli account collegati a Hotline possono essere in chat Telegram di diversi tipi: gruppi, gruppi a topic e canali. Questo consente di organizzare il monitoraggio delle comunicazioni, risposte rapide del team e pubblicazione di contenuti a nome del bot o account collegato.
Caratteristiche del Lavoro con le Chat¶
Quando si attivano i parametri MONITOR_GROUPS o MONITOR_CHANNELS nelle impostazioni di connessione, diventano disponibili le seguenti funzioni:
- Ricezione di messaggi dalle chat al topic corrispondente del gruppo backend di Hotline
- Invio di messaggi alle chat a nome del bot o account collegato tramite il gruppo backend
- Filtraggio per parole chiave — attivazione automatica della trasmissione quando appaiono parole specificate nei parametri
GROUPS_KEYWORDSeCHANNELS_KEYWORDS
Funzionalità della Versione Gratuita
Nella versione gratuita di Hotline, quando si attiva ogni topic di chat, verrà inviato un messaggio di benvenuto con il copyright di Hotline dal parametro WELCOME.
Inoltre, i topic vengono automaticamente chiusi dopo il timeout dal parametro AUTOCLOSE quando non c'è attività in essi.
Per configurare la chiusura automatica dei topic e disabilitare il messaggio di benvenuto, acquista la versione a pagamento del sistema, contatta il servizio di supporto.
Limitazioni con la Protezione dei Contenuti
Se una chat ha la protezione dei contenuti abilitata (Content Protection), gli allegati da tale chat non verranno inoltrati al gruppo backend, ma il testo del messaggio verrà trasmesso.
Caratteristiche di Connessione¶
Capacità:
-
Il bot può vedere tutti i messaggi nelle chat dove è stato aggiunto da un amministratore della chat
-
Il team può rispondere a nome del bot nelle chat tramite il gruppo backend
- Filtraggio delle chat per parole chiave
- Monitoraggio e duplicazione di messaggi dalle chat private
Caratteristiche Importanti:
Aggiunta del Bot alla Chat
Solo un amministratore della chat può aggiungere un bot a una chat. Il bot non può unirsi autonomamente ai gruppi.
Se devi inviare messaggi dal bot nella chat, assicurati che il bot abbia diritti sufficienti per questo.
Disabilita Privacy Mode in BotFather
Se prevedi di lavorare nei gruppi tramite bot, assicurati di disabilitare il parametro Privacy Mode per esso in @BotFather. Per impostazione predefinita, la modalità è attiva per i bot e non vedono tutti i messaggi nei gruppi.
Come disabilitare:
- Apri @BotFather
- Invia
/mybots - Seleziona il tuo bot
Bot Settings→Group Privacy→Turn off
Capacità:
- Può unirsi autonomamente a chat pubbliche e private, inclusi gruppi a topic (unione a chat con il comando
/newspecificando link o nome della chat) - Creazione di nuove chat a nome dell'account collegato
-
Actions API per la gestione programmatica delle chat
-
Il tuo team di operatori può rispondere a nome dell'account nelle chat
- Filtraggio delle chat per parole chiave
- Monitoraggio e duplicazione di messaggi dalle chat private
Aggiunta alle Chat¶
Solo un amministratore della chat può aggiungere un bot alla chat:
- Apri la chat necessaria in Telegram
- Clicca sul nome della chat → Aggiungi Membri
- Trova il tuo bot tramite
username - Selezionalo e aggiungilo alla chat
- Concedi diritti di amministratore se necessario
Metodo 1: Modo Standard in Telegram
Un account può unirsi autonomamente a una chat pubblica o essere invitato a un gruppo privato nel modo usuale tramite l'app Telegram.
Metodo 2: Comando /new Tramite Gruppo Backend
Usa il comando /new nel topic Generale del gruppo backend di Hotline:
/new CHAT_USERNAME
oppure
/new https://t.me/CHAT_USERNAME
oppure
/new https://t.me/+INVITE_HASH
Attivazione e Gestione dei Topic¶
Con MONITOR_GROUPS o MONITOR_CHANNELS attivi, un topic per la chat sul lato del gruppo backend viene creato e attivato automaticamente:
- Quando si menziona (@mention) l'account o bot collegato nella chat
- Quando si risponde (reply) a un messaggio dall'account o bot collegato
- Quando appaiono parole chiave dai parametri
GROUPS_KEYWORDSoCHANNELS_KEYWORDS - Su qualsiasi messaggio in arrivo con il parametro
LEAVE_CLOSEDattivo
Gestione della Trasmissione¶
La trasmissione continua di tutti i messaggi dalla chat al topic del gruppo backend viene condotta solo quando il topic ha uno stato diverso da closed (giallo 🟨 o viola 🟪, attivato dai comandi /wait o /hold).
Se chiudi il topic con il comando /close, la trasmissione dei messaggi ad esso si interrompe.
Scopri di più sugli stati dei topic
Parametro LEAVE_CLOSED
Con il parametro LEAVE_CLOSED attivo, i nuovi topic vengono creati in stato chiuso. Solo i messaggi con parole chiave verranno inoltrati ad esso, e la trasmissione viene attivata solo per decisione dell'operatore.
Caratteristica delle Trasmissioni da Altri Gruppi a Topic
Quando si monitora un gruppo a topic, ogni topic è percepito dal sistema come una chat separata. Di conseguenza, ogni topic deve essere attivato separatamente (per menzione, risposta o parola chiave).
Filtraggio delle Chat per Parole Chiave¶
I topic per le chat possono essere creati e attivati automaticamente quando appaiono messaggi con parole chiave specificate in essi.
Le parole chiave e le regole per il filtraggio sono impostate nei parametri GROUPS_KEYWORDS o CHANNELS_KEYWORDS.
Come insieme unificato di stop-word, può essere utile il parametro RESTRICTED_KEYWORDS_FRONTEND.
Lavorare con i Topic Attivati¶
Quando un topic viene attivato per parole chiave:
- Tutti i messaggi dalla chat vengono trasmessi al topic, a partire dal messaggio contenente la parola chiave
- I messaggi trasmessi mostrano link ai profili degli autori
- Gli operatori possono rispondere nella chat a nome del bot/account
- Possono scrivere in DM all'autore del messaggio
- Oppure seguire passivamente la conversazione senza partecipazione
Per fermare la trasmissione, invia il comando /close nel topic.
Configurazione Avanzata del Filtro
Se hai bisogno di impostazioni di filtro più flessibili (espressioni regolari, corrispondenza esatta, condizioni complesse), contatta il servizio di supporto Hotline.
Parametri Utilizzati¶
Attivazione del monitoraggio dei messaggi da gruppi o canali:
MONITOR_GROUPS
Creare e attivare argomenti quando nuovi messaggi compaiono nelle chat di gruppo in cui l'account o il bot connesso è membro.
Valore predefinito: FALSE (i gruppi non vengono monitorati).
MONITOR_CHANNELS
Creare e attivare argomenti quando nuovi messaggi compaiono nei canali a cui l'account connesso è iscritto o in cui il bot è membro.
Valore predefinito: FALSE (i canali non vengono monitorati).
Disabilitazione del saluto:
WELCOME
Messaggio di benvenuto che l'utente riceve al primo contatto e quando la sua richiesta viene chiusa (passa allo stato /close). Può essere completamente disabilitato nella versione a pagamento. La versione gratuita richiede il link Hotline nel messaggio di benvenuto.
Valore predefinito: messaggio di benvenuto standard in inglese.
Disabilitazione della chiusura automatica dei topic:
AUTOCLOSE
Periodo di chiusura automatica del dialogo dopo l'ultima risposta dell'operatore, specificato in ore.
Se l'argomento con l'utente è stato chiuso, riceverà il messaggio di benvenuto dal parametro WELCOME al contatto successivo. La versione gratuita ha un periodo massimo di chiusura automatica di 48 ore.
Valore predefinito: 48 ore.
Le parole chiave e le regole per il filtraggio sono impostate nei parametri:
GROUPS_KEYWORDS
Array di parole chiave e frasi per filtrare i messaggi dalle chat di gruppo. Attiva gli argomenti solo quando corrispondono alle parole specificate.
Valore predefinito: OFF (nessun filtro).
CHANNELS_KEYWORDS
Array di parole chiave e frasi per filtrare i messaggi dai canali. Attiva gli argomenti solo quando corrispondono alle frasi specificate.
Valore predefinito: OFF (nessun filtro).
Nascondere le informazioni sui partecipanti alla chat agli operatori:
HIDE_INFO
Determina quali informazioni del cliente sono nascoste agli operatori (nomi, titoli dei gruppi, link degli utenti, output del comando /info).
Valore predefinito: NONE (tutte le informazioni sono disponibili).
Controllo dei messaggi in uscita per parole chiave:
RESTRICTED_KEYWORDS_FRONTEND
Array di parole chiave proibite per i messaggi in arrivo. I messaggi con le parole specificate non vengono inoltrati al gruppo backend.
Valore predefinito: NONE (nessun filtro).
Controllo dei messaggi in arrivo per parole chiave:
RESTRICTED_KEYWORDS_BACKEND
Array di parole chiave proibite per i messaggi in uscita. Attiva un errore quando si tenta di inviare un messaggio con le parole specificate.
Valore predefinito: NONE (nessun filtro).
Scenari di Utilizzo Pratico¶
-
Supporto Chat del Team
Supporto chat clienti 24/7 da parte del team di operatori a nome del bot o account.
-
Ricerca di Lead
Ricerca automatica di potenziali clienti nelle chat Telegram tramite query di parole chiave.
-
Monitoraggio delle Menzioni
Traccia le menzioni del tuo brand o prodotto nelle chat Telegram tematiche.
-
Gestione della Comunità
Gestisci più chat della comunità da un'unica interfaccia operativa.
-
Moderazione dei Contenuti
Moderazione automatizzata delle chat di gruppo con filtri per parole chiave e controllo degli operatori.
-
Gestione del Canale
Pubblicazione di team sui canali con approvazione dei contenuti e programmazione.