Configurar y operar el bot de Telegram

El bot de Telegram ofrece un canal auxiliar para consultar y distribuir información operativa. No sustituye las tareas, permisos ni registros de Holidario: el dato de referencia sigue estando en el producto.

Solo administradores autorizados deben configurar el token, dar acceso administrativo o crear envíos programados. Recibir un mensaje del bot no concede acceso a Holidario.

Antes de empezar#

Necesitas:

• el plan Agencia con la integración de Telegram disponible;
• permiso read-telegram-bot para consultar y update-telegram-bot para cambiar o enviar;
• autorización sobre el bot del equipo;
• un bot creado para la agencia mediante la herramienta oficial de Telegram;
• su token completo y el idioma de respuesta, español o inglés;
• el identificador numérico de cada usuario o grupo que deba recibir información.

Usa un bot exclusivo para este equipo. No reutilices un token compartido con otra agencia o con automatizaciones que puedan cambiar el webhook.

Conectar el bot#

1. Cambia al equipo correcto.
2. Abre Integraciones > Bot de Telegram.
3. Si aparece Desconectado, entra en Editar.
4. Introduce el token del bot y elige su idioma.
5. Guarda y vuelve a la integración.
6. Comprueba que aparece Conectado y que el nombre de usuario corresponde al bot esperado.

Al guardar un token nuevo, Holidario intenta configurar su webhook. No necesitas copiar una URL ni crearla manualmente en Telegram.

Una vez guardado, el token no se vuelve a mostrar: su campo aparece vacío en la pantalla de edición. Déjalo vacío para mantener el guardado o escribe otro para sustituirlo. Limita esta pantalla a administradores de agencia de confianza. Para sustituir el token, introduce el nuevo valor completo; no pegues una versión parcialmente oculta ni la envíes a soporte.

Registrar usuarios y administradores#

1. Pide a cada destinatario que abra el bot correcto en Telegram y pulse Iniciar o envíe /start.
2. Vuelve a Holidario y revisa la tarjeta Usuarios del bot: se carga al abrir la pantalla con el bot conectado; usa Actualizar usuarios si la persona acaba de escribir al bot.
3. Comprueba el nombre y el identificador numérico antes de enviar nada.
4. En Usuarios administradores, introduce el identificador numérico y pulsa Agregar administrador únicamente para quien deba ejecutar consultas operativas.
5. Pide a esa persona que use /help para ver las órdenes disponibles para su acceso.

Los administradores del bot pueden usar consultas de estado y limpieza que no están disponibles para un usuario normal. Esta lista es independiente de los roles de Holidario; debes mantener ambas de forma deliberada.

Consultar actividad y enviar un mensaje#

Con el bot conectado, la pantalla muestra al abrirla el Panel de actividad y los Usuarios del bot; Actualizar estadísticas y Actualizar usuarios los vuelven a leer. Para un envío manual desde Enviar mensaje:

1. selecciona un usuario que ya haya iniciado el bot;
2. confirma que es el destinatario correcto;
3. redacta solo la información necesaria;
4. envía una vez y comprueba el resultado antes de repetir.

El historial de Telegram y el de Holidario pueden conservar copias del mensaje. No utilices este canal para contraseñas, códigos de acceso, documentos de identidad ni información personal que no sea necesaria para la tarea.

Avisos programados#

La automatización disponible envía asignaciones de limpieza para un intervalo de fechas. Antes de activarla:

1. comprueba que la persona o proveedor está activo en Holidario;
2. elige el destinatario de Telegram correcto;
3. revisa fecha inicial, fecha final o longitud del intervalo;
4. configura la frecuencia y la Hora de Envío, que se aplica en la zona horaria del equipo;
5. guarda inicialmente con Activo desmarcado;
6. revisa el Próximo envío;
7. activa solo cuando el resultado sea inequívoco.

La acción Envío de Prueba, en el menú del aviso, envía un mensaje real inmediatamente. No es una previsualización. Utiliza primero un destinatario controlado y evita probar contra grupos operativos amplios.

Telegram es un aviso, no una confirmación de que la tarea fue leída o completada. El equipo debe actualizar el trabajo en Holidario.

Cuándo está listo#

El bot está preparado cuando:

• la conexión figura como Conectada;
• el nombre de usuario coincide con el bot de la agencia;
• un usuario de prueba aparece después de /start;
• ese usuario recibe una respuesta de prueba;
• la lista de administradores contiene solo identificadores verificados;
• cualquier aviso programado muestra la hora y el próximo envío esperados.

Recuperar una conexión#

Si el bot aparece desconectado:

1. confirma que el token no fue revocado;
2. introduce el token completo de sustitución y guarda: al guardarlo, Holidario intenta volver a configurar el webhook;
3. vuelve a comprobar el nombre de usuario;
4. pide al usuario de prueba que envíe /start otra vez.

Si conecta pero no responde, conserva la hora exacta y el nombre de usuario del bot. No crees varios bots ni alternes tokens como método de prueba: dificultaría saber qué webhook recibe cada mensaje.

Si un usuario o aviso falla#

• Si el usuario no aparece, debe iniciar primero una conversación con el bot.
• Si el destinatario es incorrecto, desactiva el aviso antes de editarlo.
• Si una persona deja el equipo, retírala también de administradores y avisos programados.
• Si el próximo envío no coincide con la hora esperada, desactiva el aviso y revisa la hora de envío y la zona horaria del equipo antes de reactivarlo.
• Si una prueba informa errores parciales, verifica cada destinatario; no asumas que todos recibieron el aviso.

Seguridad y privacidad#

• El token controla el bot completo: no lo compartas por correo, chat ni soporte.
• Revisa periódicamente administradores, grupos y programaciones activas.
• Telegram es un proveedor externo; tu agencia debe evaluar sus condiciones y el tratamiento de datos.
• Utiliza el mínimo contenido personal y evita incluir códigos de acceso a propiedades.
• Revocar un usuario en Holidario no lo elimina automáticamente de grupos externos de Telegram.

Qué enviar a soporte#

Incluye equipo, nombre de usuario del bot, acción, destinatario parcialmente oculto, hora y zona horaria, y el error visible. No incluyas el token ni una copia innecesaria del mensaje completo.