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
Unirse a chats mediante un enlace y crear chats nuevos con el comando /new
Gestionar los miembros del chat cuando el bot o la cuenta conectada tiene los permisos administrativos necesarios
Filtrado por palabras clave — activación automática de transmisión cuando aparecen palabras especificadas en parámetros GROUPS_KEYWORDS y CHANNELS_KEYWORDS

Monitoreo de Chats Grandes (nuevo)

Hotline ahora permite el monitoreo fiable de grupos y canales grandes con un alto volumen de mensajes y miles de miembros.

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¶

Para BotsPara Cuentas

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 /new especificando 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¶

Para BotsPara Cuentas

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

Más información sobre el comando /new

Gestión de Chats Grupales¶

Desde el tema del diálogo grupal correspondiente en el grupo backend, puede gestionar el chat original en nombre del bot o cuenta conectada:

Comando	Acción
`/invite USER`	Agregar un usuario al chat
`/kick USER`	Eliminar un usuario del chat
`/members [QUERY]`	Mostrar los miembros o buscar miembros que coincidan con la consulta
`/leave`	Hacer que el bot o la cuenta conectada abandone el chat
`/title NEW_TITLE`	Cambiar el título del chat representado por el tema del grupo backend

El parámetro USER puede ser un username, un número de teléfono en formato internacional o *USER_ID, por ejemplo: /invite example_user, /invite +79991234567 o /invite *123456789.

El parámetro QUERY es una cadena de búsqueda opcional que coincide con el nombre o username de un miembro. El comando /members sin parámetros devuelve hasta 200 miembros, mientras que /members QUERY devuelve hasta 200 coincidencias.

Los comandos funcionan para chats grupales normales y temas en supergrupos. El bot o la cuenta conectada debe tener los permisos de Telegram necesarios para la acción seleccionada.

Solo los operadores incluidos en el parámetro EXTENSIONS_ALLOWED pueden usar estos comandos. Si la lista del parámetro está vacía, los comandos están disponibles para todos los operadores del grupo backend.

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_KEYWORDS o CHANNELS_KEYWORDS
En cualquier mensaje entrante con parámetro LEAVE_CLOSED activo

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.

Detener el Monitoreo de Chats

Eliminar un tema del grupo backend no detiene el monitoreo del chat ni impide que el tema se reactive cuando recibe mensajes que cumplen las reglas del parámetro GROUPS_KEYWORDS.

Para dejar de monitorear un chat sin salir de él, usa el comando /ignore en su tema (o /unignore para reanudar el monitoreo).

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).

Más información sobre el parámetro

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).

Más información sobre el parámetro

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.

Más información sobre el parámetro

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.

Más información sobre el parámetro

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).

Más información sobre el parámetro

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).

Más información sobre el parámetro

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).

Antes de usarlo, debe establecer AUTO_INFO en FALSE.

Valor por defecto: NONE (toda la información está disponible).

Más información sobre el parámetro

Controlar mensajes salientes por palabras clave:

RESTRICTED_KEYWORDS_FRONTEND

Lista de palabras clave prohibidas y sus combinaciones para mensajes entrantes. Las palabras individuales funcionan como condiciones O y las listas anidadas como grupos Y. Los mensajes coincidentes no se reenvían al grupo backend.

Valor por defecto: NONE (sin filtrado).

Más información sobre el parámetro

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).

Más información sobre el parámetro

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 empresa, productos o competidores en chats y canales temáticos.
Publicaciones Periódicas

Publica noticias, anuncios o contenido en chats en nombre de una cuenta o bot a través del grupo backend.
Copia de Seguridad de Mensajes

Guarda y duplica mensajes de chats cerrados o importantes en tu grupo backend privado.