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.

La imagen de documentación deja vacío deliberadamente el campo del token; no demuestra cómo trata una pantalla de edición real un token ya guardado. 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 carga la lista de usuarios del bot.
3. Comprueba el nombre y el identificador numérico antes de enviar nada.
4. Añade como administrador del bot únicamente a 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#

La pantalla permite cargar estadísticas, usuarios y mensajes registrados por el bot. Para un envío manual:

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 frecuencia, hora y zona horaria;
5. guarda inicialmente como inactiva;
6. revisa la próxima ejecución;
7. activa solo cuando el resultado sea inequívoco.

La acción de probar 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 hora y zona correctas.

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;
3. vuelve a comprobar el nombre de usuario;
4. usa Actualizar webhook solo después de validar el token;
5. 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 la zona horaria es incorrecta, corrígela antes de reactivar.
• 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.