Conexión Paralela de Bots¶

Hotline permite conectar bots en paralelo con otros sistemas: constructores de bots, scripts personalizados o servicios externos. Casi cualquier bot puede ser conectado a Hotline en modo paralelo y obtener capacidad instantánea para trabajar con su flujo de mensajes a través de un grupo de temas de trabajo.

Diferencia entre sesiones de Hotline y API de Bot de Telegram

Enviar un token de bot para conectar a Hotline no termina la sesión existente, como sucede al usar la API de Bot de Telegram estándar. Ambas sesiones en este caso funcionan simultáneamente, complementando la funcionalidad de cada una.

Cómo Funciona¶

Con conexión paralela, Hotline continúa desempeñando su rol principal: retransmite mensajes de usuarios del bot conectado al grupo backend y de vuelta, de operadores en el lado del grupo backend a usuarios (más detalles en descripción general de capacidades).

Hotline también ve mensajes salientes de la sesión paralela del bot conectado a usuarios y puede mostrarlos en el grupo como interceptados (mensajes intercepted).

La conexión paralela no impone ninguna restricción en usar ningún parámetro de Hotline disponible, lo que abre muchas opciones de uso para tales combinaciones.

Al mismo tiempo, el bot conectado en paralelo puede:

Mostrar su propia bienvenida (con medios o botones)
Procesar sus comandos y pulsaciones de botones de usuarios
Analizar mensajes entrantes de usuarios
Proporcionar interfaz webapp y mucho más

Activación flexible de temas

Usando el parámetro PRIVATE_KEYWORDS, puedes configurar la activación de temas en el grupo backend solo después de recibir un comando especial del usuario (por ejemplo: "llamar operador", "ayuda", /help, /chat).

La conexión paralela es segura

La sesión paralela no se desconectará y no afectará de ninguna manera la sesión existente de tu bot. Tu bot aún podrá ver todos los mensajes entrantes de usuarios y callbacks de pulsaciones de botones. Al mismo tiempo, tu bot no verá mensajes salientes a través de la sesión de Hotline.

Principales Escenarios de Uso¶

Contactar Operadores

Capacidad de contactar a un operador de soporte directamente desde el bot con tu funcionalidad (botones, webapps, escenarios, formularios).
Control de Bot IA

Interfaz conveniente para monitorear correspondencia de bot IA con usuarios, con capacidad de intervención del operador en el diálogo.
Sistema de Respaldo

Preservar el flujo de mensajes a través del bot y capacidad de comunicarse a través de Hotline en caso de fallos de la herramienta principal.
Acceso Móvil

Respuestas rápidas en nombre del bot desde cualquier dispositivo vía Telegram, cuando trabajar con un CRM grande es inconveniente.
Transmisiones y Segmentación

Usar el sistema de transmisión de Hotline en paralelo con tu sistema de comunicación principal.
Extensión de Funcionalidad

Agregar botones, menús, WebApp o análisis adicional de mensajes a la funcionalidad básica de Hotline.

Ejemplo de Implementación¶

Nuestro bot de demostración muestra el trabajo de conexión paralela:

Inicia @demobuttons_bot y envíale algún mensaje interesante
Este bot está conectado por su token en paralelo a Hotline y al popular constructor n8n, en el cual se implementa la visualización de botones y reacciones a sus pulsaciones
El bot responde al comando /start y muestra una bienvenida con botones para seleccionar el tema de la apelación, mientras Hotline retransmite mensajes salientes con botones y mensajes entrantes del usuario al grupo backend, desde donde los operadores pueden entonces responder al usuario
Puedes unirte al grupo de trabajo a través del enlace https://t.me/+GCqhEvR4iKM2NWJi, allí serán visibles mensajes interceptados del bot paralelo y puedes probar enviarte un mensaje
Para la conexión, el parámetro HIDE_INFO está activado, por lo que los nombres de usuario están ocultos, también el comando /info está deshabilitado en el grupo
El bot también tiene un botón WebApp con un formulario a través del cual puedes enviarnos comentarios sobre el trabajo de conexión paralela

Parámetros para Conexiones Paralelas¶

A menudo al usar conexiones paralelas, se pueden usar los siguientes parámetros.

Deshabilitar o configurar bienvenida:

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

Doble bienvenida

Si el bot paralelo emite una bienvenida, se le agrega una bienvenida de Hotline. En la versión gratuita de Hotline, el mensaje con derechos de autor del sistema no puede ser eliminado.

Deshabilitar salida de posibles errores:

SILENT_MODE

Si mostrar a los clientes posibles errores al procesar sus mensajes.

Valor por defecto: mostrar.

Más información sobre el parámetro

Deshabilitar intercepción de Hotline de mensajes salientes:

INTERCEPT_EXTERNAL

Desactiva la duplicación en el grupo backend de mensajes salientes interceptados desde sesiones paralelas de bots o cuentas conectadas.

Valor por defecto: TRUE (los mensajes se duplican).

Más información sobre el parámetro

Crear temas solo por palabras clave en diálogo:

PRIVATE_KEYWORDS

Arreglo de palabras clave y frases para filtrar mensajes privados. Activa solo cuando se detectan palabras clave en el mensaje del usuario.

Valor por defecto: OFF (sin filtrado).

Más información sobre el parámetro

Retransmisión de mensajes

Si el parámetro PRIVATE_KEYWORDS no se usa, todos los mensajes del usuario se retransmiten al grupo backend desde el momento de la primera apelación.

Notas Importantes

Enfoque alternativo

Si tienes un bot con gran funcionalidad y flujo de usuarios significativo, puede ser más correcto crear un bot separado específicamente para Hotline y servicio de soporte, en lugar de usar conexión paralela a él (esto puede consumir muchas actualizaciones).

Limitaciones del constructor

Algunos constructores de bots no permiten recibir mensajes arbitrarios de usuarios y dan errores. Para tales sistemas, la conexión paralela no es aconsejable.

Obtener Ayuda¶

Si deseas comprar una versión de pago del sistema Hotline, o necesitas ayuda personal configurando una conexión paralela, contacta a nuestro servicio de soporte.