Conectar Telegram a ¡Hola! Suite
Ruta: ¡Hola! Store → Telegram → Instalar
Visión general
La app de Telegram te permite atender, dentro de ¡Hola! Suite, a los clientes que conversan con el bot de tu empresa en Telegram. Así, esas conversaciones entran en la misma fila de atención de los demás canales y pueden pasar por el agente virtual y por el flujo de comunicación.
La integración funciona por medio de un bot: creas el bot en el propio Telegram, con el nombre de tu empresa, y conectas ese bot a ¡Hola! Suite. Telegram no usa plantillas de mensaje (template) como WhatsApp y no tiene cobro por mensaje: el costo es el de la licencia de la app.
Requisitos previos
- Licencia de la app Telegram contratada. Sin licencia, la página de la app muestra el botón Obtener, que abre una conversación con el equipo comercial. Cada bot conectado usa una licencia.
- Permiso para visualizar ¡Hola! Store en tu grupo de permisos.
- Agente virtual ya creado en ¡Hola! Suite. Será el responsable del canal.
- Cuenta en Telegram para crear el bot en @BotFather, el bot oficial de Telegram para crear y administrar bots.
Paso a paso
- Accede a ¡Hola! Store y abre la app Telegram.
- Haz clic en Instalar. Se abre la ventana Agregar app de Telegram con dos etapas.
- En la etapa Datos iniciales, completa los campos:
- Nombre: nombre para identificar el canal dentro de ¡Hola! Suite.
- Agente virtual: el agente virtual que recibirá las conversaciones de este canal.
- Haz clic en Continuar.
- En la etapa Conexión, haz clic en Iniciar creación. Telegram Web se abre en una nueva pestaña, en la conversación con @BotFather.
- En el chat de BotFather, envía el comando
/newbot. - Cuando BotFather lo pida, informa el nombre del bot. Es el nombre que verán los clientes, por eso usa el nombre de tu empresa.
- Informa el Nombre de usuario del bot. Debe terminar con la palabra bot (ej.:
minhaempresa_bot) y no puede tener espacios ni acentos. - Copia el token que BotFather envía como respuesta (una secuencia de números y letras).
- Vuelve a ¡Hola! Suite y pega el token en el campo Token.
- Haz clic en Agregar Telegram.
Quien tiene el token puede controlar el bot. No compartas el token ni lo publiques en lugares abiertos.
Resultado esperado
La app aparece como instalada y el botón Acceder pasa a abrir la lista de canales de Telegram, con las columnas Nombre, Estado, Agente Virtual y Flujo de comunicación.
Para probar, abre Telegram, busca el bot por el nombre de usuario y envía un mensaje. Si el agente virtual responde, la integración está funcionando.
Para conectar otro bot, accede a ¡Hola! Store → Telegram → Acceder y haz clic en Añadir nuevo. El proceso es el mismo. La cantidad de bots conectados depende de las licencias contratadas. Si no hay licencia libre, aparece el botón Obtener en su lugar.
Configuraciones disponibles
Para ajustar el canal, accede a ¡Hola! Store → Telegram → Acceder y haz clic en el registro. La pantalla tiene dos secciones. En cada una, haz clic en Editar información, haz los cambios y guarda.
Datos de registro
| Campo | Qué hace |
|---|---|
| Nombre | Nombre de identificación del canal. |
| Estado | Activo o Inactivo. Para activarlo, necesitas tener una licencia de Telegram libre. |
| Agente virtual | Agente virtual responsable del canal. |
| Token | Token del bot, oculto. Para cambiar de bot o actualizar un token revocado, escribe el nuevo token. En blanco, mantiene el actual. |
Preferencias
| Campo | Qué hace |
|---|---|
| Prioridad de atención en la fila | Orden del canal en la fila: Muy alta, Alta, Media, Baja o Muy baja. Los canales con mayor prioridad aparecen primero. |
| Mostrar el nombre del agente en el encabezado de los mensajes | Muestra al cliente el nombre del agente en la parte superior de los mensajes. |
| Verificar si el contacto es humano | Confirma que quien escribe es una persona antes de abrir la atención. |
Con Verificar si el contacto es humano activo, el agente virtual pregunta "¿Eres humano?" antes de abrir la primera atención del contacto, con las opciones Sí y No en orden aleatorio. La atención solo se abre si la persona responde Sí. Después de eso, la pregunta no se repite para ese contacto. Si la respuesta es No, no se abre ninguna atención y la pregunta vuelve en el próximo mensaje.
El aviso automático de posición en la fila no se configura en el canal. Está en el departamento, en Avisar posición en la fila.
Cómo se comportan los mensajes
- ¡Hola! Suite recibe de Telegram textos, fotos, videos, audios y mensajes de voz, documentos, Stickers, ubicación y Contactos compartidos.
- Los archivos enviados por el agente llegan al cliente como documento en Telegram.
Desinstalar la app
- Accede a ¡Hola! Store → Telegram → Acceder y abre el registro.
- Haz clic en Desinstalar app.
- Escribe el Nombre del Canal exactamente como está registrado. El botón Desinstalar solo se habilita cuando el nombre coincide.
- Haz clic en Desinstalar.
Al desinstalar, se deshace la conexión con el bot. Las atenciones en curso se interrumpen, y las atenciones ya finalizadas pierden el vínculo con el canal, lo que puede afectar las métricas.
Problemas comunes
| Síntoma | Qué verificar |
|---|---|
| BotFather rechaza el nombre de usuario | El nombre debe terminar con bot, no puede tener espacios ni acentos y no puede estar en uso por otro bot. |
| El bot no responde después de la instalación | Verifica si el canal está Activo y si el token es del bot correcto. Si el token fue revocado en BotFather, genera otro y actualiza el campo Token. |
| Aparece el botón Obtener aun con la app contratada | Usa Sincronizar licencia en Configuraciones → Acerca de. Si continúa, habla con el equipo comercial. |
| No es posible activar el canal | Todas las licencias de Telegram están en uso por otros canales activos. Inactiva otro canal o contrata más licencias. |
Buenas prácticas
- Usa el Nombre de la empresa en el nombre del bot. Es por él que los clientes encontrarán tu canal.
- Divulga el enlace del bot (
https://t.me/seguido del nombre de usuario) en el sitio web, en las redes sociales y en la firma de correo electrónico. - No conectes el mismo bot a otra herramienta. La última herramienta conectada pasa a recibir los mensajes del bot.
- Registra las respuestas más usadas en Mensajes rápidos para agilizar la atención.