Trabajo con Chats¶
Los bots y cuentas conectados a Hotline pueden estar en chats de Telegram de diferentes tipos: grupos, grupos de temas y canales. Esto permite organizar el monitoreo de comunicación, respuestas rápidas del equipo y publicación de contenido en nombre del bot o cuenta conectada.
Características del Trabajo con Chats¶
Al activar los parámetros MONITOR_GROUPS o MONITOR_CHANNELS en la configuración de conexión, las siguientes funciones están disponibles:
- Recibir mensajes de chats al tema correspondiente del grupo backend de Hotline
- Enviar mensajes a chats en nombre del bot o cuenta conectada a través del grupo backend
- Filtrado por palabras clave — activación automática de transmisión cuando aparecen palabras especificadas en parámetros
GROUPS_KEYWORDSyCHANNELS_KEYWORDS
Características de Versión Gratuita
En la versión gratuita de Hotline, al activar cada tema de chat, se enviará un mensaje de bienvenida con derechos de autor de Hotline del parámetro WELCOME.
También los temas se cierran automáticamente después del tiempo de espera del parámetro AUTOCLOSE cuando no hay actividad en ellos.
Para configurar el cierre automático de temas y deshabilitar el mensaje de bienvenida, compre la versión paga del sistema, contacte al servicio de soporte.
Limitaciones con Protección de Contenido
Si el chat tiene protección de contenido habilitada (Content Protection), los archivos adjuntos de ese chat no se reenviarán al grupo backend, pero el texto del mensaje se transmitirá.
Características de Conexión¶
Capacidades:
-
El bot puede ver todos los mensajes en chats donde fue agregado por un administrador del chat
-
El equipo puede responder en nombre del bot en chats a través del grupo backend
- Filtrado de chat por palabras clave
- Monitoreo y duplicación de mensajes de chats privados
Características Importantes:
Agregar Bot al Chat
Solo un administrador del chat puede agregar el bot al chat. El bot no puede unirse independientemente a grupos.
Si necesitas enviar mensajes desde el bot en el chat, asegúrate de que el bot tenga suficientes derechos para esto.
Deshabilitar Privacy Mode en BotFather
Si planeas trabajar en grupos a través del bot, asegúrate de deshabilitar el parámetro Privacy Mode para él en @BotFather. Por defecto, el modo está activo para bots y no ven todos los mensajes en grupos.
Cómo deshabilitar:
- Abrir @BotFather
- Enviar
/mybots - Seleccionar tu bot
Bot Settings→Group Privacy→Turn off
Capacidades:
- Puede unirse independientemente a chats públicos y privados, incluidos grupos de temas (unirse a chats con comando
/newespecificando enlace o nombre de chat) - Crear nuevos chats en nombre de la cuenta conectada
-
API de Acciones para gestión programática de chats
-
Tu equipo de operadores puede responder en nombre de la cuenta en chats
- Filtrado de chat por palabras clave
- Monitoreo y duplicación de mensajes de chats privados
Agregar a Chats¶
Solo un administrador del chat puede agregar el bot al chat:
- Abrir el chat necesario en Telegram
- Hacer clic en el nombre del chat → Agregar Miembros
- Buscar tu bot por
username - Seleccionarlo y agregarlo al chat
- Otorgar derechos de administrador si es necesario
Método 1: Forma Estándar en Telegram
Una cuenta puede unirse independientemente a un chat público o ser invitada a un grupo privado de la manera habitual a través de la aplicación de Telegram.
Método 2: Comando /new a Través del Grupo Backend
Usa el comando /new en el tema General del grupo backend de Hotline:
/new CHAT_USERNAME
o
/new https://t.me/CHAT_USERNAME
o
/new https://t.me/+INVITE_HASH
Activación y Gestión de Temas¶
Con MONITOR_GROUPS o MONITOR_CHANNELS activo, el tema para el chat en el lado del grupo backend se crea y activa automáticamente:
- Al mencionar (@mention) la cuenta o bot conectado en el chat
- Al responder (reply) al mensaje de la cuenta o bot conectado
- Cuando aparecen palabras clave de los parámetros
GROUPS_KEYWORDSoCHANNELS_KEYWORDS - En cualquier mensaje entrante con parámetro
LEAVE_CLOSEDactivo
Gestión de Transmisión¶
La transmisión continua de todos los mensajes del chat al tema del grupo backend se realiza solo cuando el tema tiene un estado diferente de closed (amarillo 🟨 o morado 🟪, activado por comandos /wait o /hold).
Si cierras el tema con el comando /close, la transmisión de mensajes a él se detiene.
Más información sobre estados de temas
Parámetro LEAVE_CLOSED
Con el parámetro LEAVE_CLOSED activo, los nuevos temas se crean en estado cerrado. Solo los mensajes con palabras clave se reenviarán a él, y la transmisión se activa solo por decisión del operador.
Característica de Transmisiones desde Otros Grupos de Temas
Al monitorear un grupo de temas, cada tema es percibido por el sistema como un chat separado. En consecuencia, cada tema debe activarse por separado (por mención, respuesta o palabra clave).
Filtrado de Chats por Palabras Clave¶
Los temas para chats se pueden crear y activar automáticamente cuando aparecen mensajes con palabras clave especificadas en ellos.
Las palabras clave y reglas para filtrado se establecen en parámetros GROUPS_KEYWORDS o CHANNELS_KEYWORDS.
Como conjunto unificado de palabras de parada, el parámetro RESTRICTED_KEYWORDS_FRONTEND puede ser útil.
Trabajo con Temas Activados¶
Cuando el tema se activa por palabras clave:
- Todos los mensajes del chat se transmiten al tema, comenzando con el mensaje que contiene la palabra clave
- Los mensajes de transmisión muestran enlaces de perfil de autores
- Los operadores pueden responder en el chat en nombre del bot/cuenta
- Pueden escribir a DM del autor del mensaje
- O seguir pasivamente la conversación sin participación
Para detener la transmisión, envía el comando /close en el tema.
Configuración Avanzada de Filtros
Si necesitas configuraciones de filtro más flexibles (expresiones regulares, coincidencia exacta, condiciones complejas), contacta al servicio de soporte de Hotline.
Parámetros Utilizados¶
Activar monitoreo de mensajes desde grupos o canales:
MONITOR_GROUPS
Crear y activar temas cuando aparecen nuevos mensajes en chats grupales donde está la cuenta conectada o bot.
Valor por defecto: FALSE (los grupos no se monitorean).
MONITOR_CHANNELS
Crear y activar temas cuando aparecen nuevos mensajes en canales a los que está suscrita la cuenta conectada o donde está el bot.
Valor por defecto: FALSE (los canales no se monitorean).
Deshabilitar saludo:
WELCOME
Mensaje de bienvenida que el usuario recibe en el primer contacto y cuando su solicitud fue cerrada (cambiado a estado /close). Puede ser completamente desactivado en la versión de pago. La versión gratuita requiere un enlace de Hotline en el mensaje de bienvenida.
Valor por defecto: mensaje de bienvenida estándar en inglés.
Deshabilitar cierre automático de temas:
AUTOCLOSE
Período de cierre automático del diálogo después de la última respuesta del operador, especificado en horas.
Si el tema con el usuario fue cerrado, recibirá el mensaje de bienvenida del parámetro WELCOME en el próximo contacto. La versión gratuita tiene un período máximo de cierre automático de 48 horas.
Valor por defecto: 48 horas.
Las palabras clave y reglas para filtrado se establecen en parámetros:
GROUPS_KEYWORDS
Arreglo de palabras clave y frases para filtrar mensajes de chats grupales. Activa temas solo al coincidir con las palabras especificadas.
Valor por defecto: OFF (sin filtrado).
CHANNELS_KEYWORDS
Arreglo de palabras clave y frases para filtrar mensajes de canales. Activa temas solo al coincidir con las frases especificadas.
Valor por defecto: OFF (sin filtrado).
Ocultar información sobre participantes del chat de operadores:
HIDE_INFO
Determina qué información sobre los clientes se oculta de los operadores (nombres, nombres de grupos, enlaces a usuarios, salida del comando /info).
Valor por defecto: NONE (toda la información está disponible).
Controlar mensajes salientes por palabras clave:
RESTRICTED_KEYWORDS_FRONTEND
Arreglo de palabras clave prohibidas para mensajes entrantes. Los mensajes con las palabras especificadas no se reenvían al grupo backend.
Valor por defecto: NONE (sin filtrado).
Controlar mensajes entrantes por palabras clave:
RESTRICTED_KEYWORDS_BACKEND
Arreglo de palabras clave prohibidas para mensajes salientes. Causa un error al intentar enviar un mensaje con las palabras especificadas.
Valor por defecto: NONE (sin filtrado).
Escenarios de Uso Práctico¶
-
Soporte de Chat en Equipo
Soporte de chat de clientes 24/7 por equipo de operadores en nombre de bot o cuenta.
-
Búsqueda de Leads
Búsqueda automática de clientes potenciales en chats de Telegram por consultas de palabras clave.
-
Monitoreo de Menciones
Rastrea menciones de tu marca o producto en chats temáticos de Telegram.
-
Gestión de Comunidad
Gestiona múltiples chats de comunidad desde una única interfaz operacional.
-
Moderación de Contenido
Moderación automatizada de chats grupales con filtros de palabras clave y control de operadores.
-
Gestión de Canales
Publicación en equipo en canales con aprobación de contenido y programación.