Configurar y usar el agente de soporte interno

El agente de soporte interno es un chat opcional para resolver dudas usando únicamente dos fuentes: las FAQ privadas activas del equipo actual que el usuario puede consultar y la documentación pública de Holidario destinada a su tipo de usuario. También puede preparar algunas acciones definidas por Holidario, pero una modificación o un correo nunca se ejecutan sin una vista previa y tu confirmación explícita.

La agencia aporta una única clave OpenRouter para su equipo, contrata esa cuenta y paga directamente el consumo. Holidario proporciona la integración, permite elegir una pareja compatible de modelo y proveedor ZDR para este agente y no añade un cargo por uso de IA. Antes de transmitir cada mensaje nuevo del usuario, Holidario lo comprueba mediante su servicio Presidio autohospedado. Los valores personales admitidos por una búsqueda autorizada se sustituyen por tokens privados; el resto de información personal o sensible detectada bloquea la solicitud. Las conversaciones seguras para el proveedor usan después el endpoint exacto guardado, sin fallback.

Límite de conocimiento#

El agente no lee, indexa ni busca conversaciones internas, de empleados, huéspedes, reservas, tickets, WhatsApp o SMS. Tampoco navega libremente por Internet. Puede buscar metadatos mínimos de recursos autorizados únicamente para generar enlaces, pero no usa descripciones privadas, cuerpos de tickets o documentos, mensajes ni otros campos arbitrarios como fuente de conocimiento. Algunas API de proveedor ofrecen búsqueda web o lectura de URL integrada, pero Holidario no expone esas herramientas a este agente; la documentación pública procede del corpus local validado.

Al iniciar una respuesta, el proveedor recibe un catálogo compacto con todas las preguntas FAQ que el usuario puede consultar, pero sin sus respuestas, y los metadatos de todas las páginas públicas destinadas a su audiencia efectiva, pero sin sus cuerpos. Holidario calcula esa audiencia en el servidor a partir del equipo, plan y roles actuales; no acepta una audiencia elegida por el navegador ni por el modelo. El modelo elige identificadores concretos y Holidario vuelve a comprobar equipo, audiencia y permisos antes de recuperar solo las respuestas o secciones necesarias.

Para explicar funciones y flujos de Holidario, el modelo debe basarse en secciones o respuestas recuperadas desde ese catálogo autorizado, no en conocimiento previo del proveedor. Un slug adivinado de otra audiencia devuelve «no encontrado»: la restricción se repite al listar el catálogo, abrir el esquema de una página, leer secciones y generar un enlace.

No se envía un archivo de FAQ para que el proveedor lo recorra. Adjuntar un archivo no concede por sí mismo una búsqueda tipo grep: requeriría otra herramienta de archivos o indexación, seguiría enviando al contexto los fragmentos recuperados y complicaría aislamiento, actualización y conservación. La recuperación permanece dentro de Holidario.

Referencias opacas y resultados separados del proveedor#

Holidario ejecuta las búsquedas de recursos con los valores reales autorizados dentro de su propio servidor y separa el resultado en dos canales. El proveedor de IA recibe únicamente una referencia opaca y temporal, el tipo genérico de recurso, un índice de selección propio de la sesión, la cantidad de coincidencias y las capacidades definidas en código. No recibe el ID de base de datos, la URL administrativa, el nombre, la dirección, la referencia de reserva ni otro texto de presentación del registro.

El navegador autenticado recibe por separado una tarjeta construida desde el resultado original autorizado en el servidor. Esa tarjeta puede contener el enlace exacto y la etiqueta de presentación completa porque Holidario la devuelve directamente bajo el usuario y la sesión actuales; nunca se reconstruye desde la salida del modelo. El modelo no genera ni puede recuperar ese segundo canal. Si intenta escribir una URL de producto, Holidario rechaza la respuesta; los enlaces de FAQ y documentación pública continúan usando sus herramientas de conocimiento autorizadas.

La correspondencia entre la referencia opaca y el registro real se guarda cifrada y limitada a la sesión. Las capacidades posteriores —por ejemplo, abrir una liquidación asociada, crear un ticket o solicitar un bloqueo— reciben solo esa referencia. Holidario resuelve internamente el ID y vuelve a comprobar equipo, usuario, plan, permiso, autorización del registro, relación y configuración de la acción antes de continuar.

Una búsqueda con varias páginas crea además una referencia opaca para la consulta completa, distinta de las referencias de cada registro y de la continuación de página. Holidario guarda cifrados en la sesión el tipo de recurso, los filtros normalizados y el total conocido; el modelo solo recibe la referencia aleatoria, el tipo y la cantidad. La referencia representa el conjunto autorizado que coincida con esa consulta, no una lista de IDs elegida por el navegador. Al resolverla, Holidario vuelve a ejecutar la búsqueda y a comprobar el usuario, el equipo, la audiencia, el plan, los permisos y la autorización de cada resultado.

Las colecciones muestran después de los resultados sus acciones autorizadas y definidas en código. Holidario puede enumerar cualquier cantidad de acciones sin preparar ninguna; al pulsar un botón concreto crea únicamente la propuesta de confirmación de esa acción. Las colecciones de liquidaciones ofrecen actualmente Descargar documentos para impuestos e ingresos. Su propuesta se refiere a la consulta autorizada completa, por lo que incluye todas las liquidaciones coincidentes de todas las páginas y no solo las tarjetas visibles. La vista previa conserva el total completo y una huella calculada en el servidor. La confirmación repite la consulta y se niega a continuar si el conjunto cambió después de la vista previa; nunca acepta IDs de liquidaciones aportados por el modelo o el navegador.

Los enlaces privados para huéspedes reciben una protección adicional: la URL firmada de la reserva nunca se envía al proveedor. El modelo solo puede pedir a Holidario que muestre una tarjeta de entrega. La URL se genera después, cuando el usuario autenticado pulsa el botón de la tarjeta, y se entrega directamente a ese navegador tras volver a comprobar sesión, equipo, permisos, reserva, evento, cancelación y fecha de salida. Antes de la salida, la tarjeta entrega el acceso privado del huésped; después de la salida cambia claramente sus textos y entrega únicamente la vista caducada y anonimizada que impone el middleware de rutas firmadas.

En una modificación propuesta, el proveedor recibe esta vista previa enmascarada. La tarjeta de confirmación autenticada carga por separado la propuesta exacta y cifrada desde Holidario bajo el ámbito del usuario, equipo y sesión actuales, de modo que el usuario todavía puede revisar el cambio real antes de confirmarlo sin devolver esa vista completa al proveedor.

Presidio + ZDR antes del proveedor#

Inmediatamente antes de preparar una solicitud externa del agente de soporte interno, Holidario envía el mensaje nuevo del usuario —y, si existe, la respuesta inmediatamente anterior del asistente ya segura para el proveedor como contexto de reconocimiento— a su instancia autohospedada y local de Microsoft Presidio. La transcripción original no se reenvía repetidamente a Presidio ni se reconstruye para el proveedor de IA.

Cuando Presidio detecta un valor que una búsqueda de solo lectura ya implementada puede usar legítimamente, como el nombre de un huésped o una referencia de reserva, Holidario sustituye solo ese valor en la copia para el proveedor por un token opaco de corta duración. El mapeo cifrado queda ligado al tenant, usuario, sesión de chat, tipo de entidad, acción, campo de argumento y caducidad. El modelo solo puede copiar el token al campo de referencia privada correspondiente. Holidario autoriza primero la búsqueda solicitada y después resuelve el valor real únicamente en memoria; no devuelve ese valor en el resultado de la herramienta, la continuación, el contexto de recursos ni el historial del proveedor.

El mensaje original cifrado permanece únicamente dentro de Holidario durante 60 minutos después de la última actividad del chat. Las llamadas posteriores al proveedor reutilizan la copia segura guardada por separado, por lo que un valor escrito en un turno anterior no puede bloquear una continuación limpia y no relacionada por volver a analizar todo el historial. Los tokens privados de búsqueda también dejan de poder usarse a los 60 minutos. Holidario elimina el contenido de chat caducado mediante una limpieza automática cada cinco minutos y los mapeos de tokens caducados cada hora. Borrar conversación elimina inmediatamente sus mensajes y los mapeos de tokens privados.

Si Presidio detecta información personal o sensible que no es una entrada permitida para una búsqueda —como credenciales, datos de pago o documentos de identidad—, Holidario bloquea el turno y no envía nada al proveedor de IA. La tokenización no concede acceso: los tokens inventados, modificados, caducados, de otra sesión, usuario o tenant, o usados con una acción, campo o entidad incorrectos, se rechazan de forma segura.

Si Presidio no está disponible, agota el tiempo, rechaza la autenticación o devuelve una respuesta inválida, Holidario también bloquea el turno. El mensaje de error confirma que no se envió nada al proveedor de IA; vuelve a intentarlo más tarde. No existe un modo de continuar sin esta comprobación.

Las referencias opacas y las tarjetas autenticadas descritas arriba siguen siendo una capa independiente: evitan enviar al modelo IDs, URL y etiquetas completas de los registros. No protegen los identificadores que una persona escriba directamente en el chat.

Los historiales que superan Presidio se envían con ZDR obligatorio, la pareja exacta de modelo/proveedor ZDR en vivo guardada por el administrador, recopilación de datos rechazada y sin fallback. ZDR limita la conservación del proveedor; no anonimiza el contenido. La privacidad en el router todavía depende de que el administrador del tenant mantenga correctamente su cuenta de OpenRouter. Sigue el tutorial Configurar OpenRouter y el análisis de conversaciones y no actives Input & Output Logging, entrenamiento, publicación de prompts ni el descuento del 1 %.

Las preguntas FAQ forman parte del catálogo de descubrimiento y las respuestas o secciones documentales recuperadas llegan al modelo para que funcione la conversación. No incluyas en las FAQ datos personales, secretos ni credenciales.

Antes de activarlo#

Necesitas:

• el plan Agencia con mensajería mediante IA;
• permisos read-ai-provider y update-ai-provider para configurar el equipo;
• una cuenta propia de OpenRouter con créditos y cuota disponibles;
• una clave API OpenRouter dedicada al equipo;
• los cinco controles ZDR activos, los cuatro controles de Data Training desactivados e Input & Output Logging desactivado;
• FAQ revisadas, activas y sin datos personales ni secretos innecesarios;
• la confirmación de que los usuarios entienden qué valores personales se aceptan únicamente para búsquedas autorizadas de solo lectura y que los datos sensibles innecesarios continúan bloqueados;
• una decisión sobre presupuesto de tokens, límites de solicitudes y acciones permitidas; Holidario fija la conservación del contenido del chat en 60 minutos desde la última actividad.

Completa primero el tutorial de cuenta, clave y ZDR de OpenRouter. Aunque las respuestas FAQ se recuperan bajo demanda, sus preguntas forman parte del catálogo que se envía para que el modelo pueda descubrir qué conocimiento existe; revísalas para que no contengan datos personales.

Configurar el proveedor BYOK#

1. Cambia al equipo correcto.
2. Abre Integraciones > Proveedor de IA, entra en Editar, introduce la clave OpenRouter del equipo, acepta la declaración obligatoria sobre titularidad, DPA, transferencias y ajustes de privacidad, y guarda. Si la clave ya estaba guardada, puedes aceptar sin volver a introducirla.
3. Vuelve a Agentes de IA y abre Agente de soporte interno.
4. En Modelo para este agente, elige uno de los modelos compatibles con herramientas y razonamiento.
5. En Proveedor de inferencia ZDR, compara proveedor, cuantización, contexto, salida máxima, disponibilidad, ubicaciones declaradas y precios; elige un endpoint seleccionable.
6. Usa Guardar modelo y proveedor.
7. Configura las fuentes, límites y acciones del agente y usa Guardar configuración.
8. Usa Validar conexión antes de activarlo.

La validación envía una solicitud mínima con una llamada de herramienta real. Comprueba conjuntamente la clave OpenRouter, la pareja exacta de modelo/proveedor y la capacidad necesaria; puede generar un pequeño cargo en la cuenta del tenant. Configurado solo significa que la clave y la ruta están guardadas.

La clave OpenRouter se comparte con los demás agentes del equipo. La ruta pertenece únicamente al agente de soporte interno: cambiarla no modifica el modelo o proveedor guardado para Análisis de Conversaciones, Contenido SEO, Auto Blog u otro agente.

El primer selector se carga dinámicamente con los modelos que la clave del tenant puede usar y que cumplen el protocolo de herramientas y razonamiento de este agente. El segundo se carga con los endpoints que aparecen en el registro ZDR vigente y sus precios por endpoint. Todos los endpoints técnicamente compatibles de ese registro ZDR en vivo son seleccionables.

La selección guarda el modelo y el tag exacto del endpoint. Cada solicitud envía ambos mediante una ruta order + only, exige zdr=true, deniega recopilación de datos y desactiva fallbacks. Si el endpoint desaparece o deja de cumplir la política, Holidario no elige otro por su cuenta: la ruta falla cerrada y un administrador debe revisar y guardar otra pareja ZDR compatible.

Los precios se muestran en USD por millón de tokens cuando OpenRouter publica esa unidad. Pueden cambiar después de cargar el catálogo y no incluyen comisiones de recarga, impuestos ni otros cargos de la cuenta; confirma el coste definitivo en OpenRouter.

La clave del equipo se cifra en reposo y nunca se devuelve al navegador. Si ya existe, el campo de edición aparece vacío; déjalo vacío para conservarla. Sustituir la clave o cambiar el modelo invalida la validación anterior.

El servidor aplica la misma política que la interfaz: una petición manipulada o un modelo incompatible se rechazan antes de la inferencia. Las credenciales directas y los perfiles dedicados anteriores permanecen almacenados únicamente como compatibilidad legacy y no aparecen como alternativas en la configuración principal.

Elegir fuentes, límites y acciones#

Antes de activar el agente:

1. habilita o deshabilita FAQ privadas activas y Documentación pública;
2. revisa el aviso de borrado automático: el contenido del chat caduca 60 minutos después de su última actividad;
3. fija solicitudes por usuario y minuto y por equipo y día;
4. establece un presupuesto mensual de tokens o déjalo sin límite interno;
5. habilita únicamente las acciones que el equipo haya aprobado;
6. guarda los controles y activa el agente.

El presupuesto es un límite de tokens de Holidario, no una cantidad monetaria ni un sustituto de las alertas del proveedor. La comprobación ocurre antes de cada solicitud y una última solicitud acotada puede superar ligeramente el umbral. Holidario suma el uso de todos los pasos de herramientas y, cuando el proveedor los separa, los tokens de caché o pensamiento que corresponden a su facturación; el panel del proveedor sigue siendo la referencia monetaria.

La búsqueda de conocimiento y la generación de enlaces a recursos son de solo lectura. Solicitar bloqueos del propietario, crear tickets, enviar correo a soporte y actualizar la descripción de una operación están desactivados de forma predeterminada y requieren confirmación cuando un administrador los habilita. Al activar Solicitar un bloqueo de calendario del propietario también se habilita su comprobación de disponibilidad de solo lectura; ambas herramientas permanecen dentro del mismo límite de acción.

Acceso de los usuarios del equipo#

Cuando el equipo activa el agente, cualquier usuario autenticado que tenga ese equipo como equipo actual puede abrir el menú y el botón flotante. No existe un permiso adicional del chat que haya que crear, sembrar o asignar por tipo de usuario.

Esto no amplía el acceso a datos ni acciones. Consultar una FAQ sigue requiriendo read-faq-item y autorización vigente sobre esa FAQ; un usuario sin ese acceso todavía puede consultar la documentación pública habilitada. Cada buscador de recursos exige su permiso normal read-*, la función del plan cuando corresponde, el equipo actual y la autorización individual del registro. Los tickets conservan además las categorías visibles para el tipo de usuario. Cada acción conserva sus permisos normales: por ejemplo, confirmar una propuesta no concede permiso para crear tickets ni actualizar una operación. Si se desactiva el agente, una acción o un permiso de negocio después de preparar una propuesta, la confirmación queda bloqueada.

Documentación según el tipo de usuario#

El chat usa la misma clasificación canónica que el sitio de documentación. Una agencia distingue las audiencias de administración de agencia, manager, recepción, propietario de inmueble, empleado de limpieza, proveedor externo de limpieza y proveedor externo de mantenimiento. Un propietario individual usa su propia audiencia. Las páginas pueden pertenecer a una o varias audiencias, pero el catálogo del chat solo contiene las que declaran la audiencia efectiva del usuario.

Por ejemplo, un usuario con rol propietario de inmueble recibe las páginas destinadas a property-owner; no recibe en el catálogo, no puede recuperar por slug y no puede obtener mediante el agente un enlace a una guía exclusiva de agency-admin. La clasificación limita lo que el agente puede enseñar; los permisos y autorizaciones de los recursos siguen siendo una barrera independiente para cualquier dato o acción.

Las FAQ privadas todavía no tienen metadatos de audiencia. Se aíslan por equipo y por la autorización normal de cada FAQ, no por la clasificación de la documentación pública. Un administrador debe revisar a quién autoriza cada FAQ si contiene procedimientos exclusivos de un rol.

Abrir el chat#

Después de guardar y validar un proveedor compatible y activar el agente, el botón flotante de Pregúntale a Holidario aparece para todos los usuarios del equipo actual en la esquina inferior derecha de las pantallas del panel. Se mantiene como un círculo con el icono del asistente y, en escritorio, muestra el nombre completo al pasar el puntero o recibir el foco del teclado. En escritorio abre la ventana flotante alineada a la derecha. En móvil abre el modal de pantalla completa de Holidario: la cabecera y el campo de mensaje permanecen fijos y solo se desplaza la conversación central. El icono de ampliar abre la página completa del Agente de soporte interno únicamente en escritorio; en móvil no aparece porque el modal ya ocupa toda la pantalla. Cada vez que abres el panel, Holidario desplaza la conversación hasta el mensaje más reciente.

En iPhone, iPad y otros móviles puedes tocar y escribir en el campo de mensaje mientras Holidario termina de crear o recuperar la sesión; Enviar se habilita cuando la sesión autorizada está lista. Si ocultas el teclado o cambias el foco, puedes volver a tocar el campo tantas veces como necesites: cada toque vuelve a activar el campo de forma normal. También puedes preparar el texto siguiente mientras el agente responde, pero no enviarlo hasta que termine la respuesta actual. Si la sesión no puede abrirse, conserva el texto y usa Reintentar después de comprobar la conexión.

El panel del chat solo se muestra cuando el usuario tiene un equipo actual activo y ese equipo dispone del plan, la activación del agente y un proveedor listo. Cambiar de equipo vuelve a comprobar todas esas condiciones y mantiene una sesión distinta por usuario y equipo en ese navegador. El chat también vincula cada conversación a la audiencia efectiva del momento.

Un chat vacío muestra botones de acciones rápidas calculados en el servidor para ese usuario. Holidario cruza las acciones activadas en los ajustes del equipo con las funciones del plan y los permisos de negocio normales. Por ejemplo, Solicitar un bloqueo de propietario solo se ofrece a un propietario apto que no tenga acceso directo para gestionar el calendario, mientras que Actualizar la descripción de una operación exige un permiso de actualización de operaciones. Las herramientas auxiliares internas, como la comprobación de disponibilidad, no aparecen como botones independientes.

Impuestos e ingresos aparece únicamente cuando el usuario puede consultar liquidaciones y el equipo tiene activa esa función. Abre un segundo paso con un selector buscable de Alojamiento, Desde y Hasta; ambas fechas forman parte del periodo. El selector carga desde Holidario solo las operaciones de alquiler vacacional que el usuario puede consultar. Por defecto mantiene Todos los alojamientos, por lo que no añade ningún filtro; elegir uno limita la misma búsqueda simultáneamente por ese alojamiento autorizado y por el intervalo. La interfaz exige las dos fechas, comprueba que sean válidas y evita que la fecha final sea anterior a la inicial. Al pulsar Buscar liquidaciones, construye un único mensaje natural con el intervalo y, si se ha elegido, el nombre del alojamiento. Presidio comprueba ese mensaje nuevo antes del envío y tokeniza un valor de búsqueda detectado cuando sea necesario; una detección sensible sin uso de búsqueda bloquea la solicitud. El modelo interpreta únicamente el mensaje seguro para el proveedor; Holidario valida después los argumentos de la herramienta y vuelve a comprobar configuración, plan, equipo, permisos, alcance del token y autorización de cada registro antes de devolver las tarjetas verificadas. Este turno consume tokens.

Cuando coincide al menos una liquidación, la misma respuesta muestra ¿Qué quieres hacer con esta lista? y todas las acciones de colección disponibles para ese usuario. Todavía no crea ninguna propuesta. Al elegir Descargar documentos para impuestos e ingresos, prepara una única tarjeta de confirmación solo si el conjunto completo no supera el límite de lote. Se trata únicamente de una exportación documental: no presenta impuestos, no calcula una declaración ni crea un informe de ganancias. La tarjeta resultante indica que abarca todas las liquidaciones de la búsqueda autorizada, incluidas las páginas posteriores.

Buscar algo abre un segundo paso en lenguaje sencillo que muestra solo los tipos habilitados para este chat y que el usuario actual puede consultar: Alojamiento, Reserva, Liquidación, Ticket, Tarea de limpieza y Gasto de alojamiento. Alojamiento sustituye las opciones anteriores «Operación» y «Alojamiento»: siempre busca la operación de alquiler vacacional autorizada, no el registro técnico de inmueble. Al elegir una opción se envía inmediatamente un mensaje en lenguaje natural definido por el código, y el asistente pide después el nombre, la fecha, la referencia u otro dato de búsqueda que falte. Todos los tipos disponibles, incluida Reserva, mantienen una conversación normal con el proveedor: el modelo interpreta el texto del usuario y llama a la herramienta de búsqueda correspondiente definida en código. Ninguna acción rápida envía una clave interna de acción, concede permisos ni ejecuta por sí sola una modificación; la búsqueda o acción seleccionada vuelve a comprobar el tipo de recurso, el equipo, el registro, los argumentos, la autorización y la confirmación.

Para un usuario con rol Empleado de limpieza o Proveedor externo de limpieza, Buscar algo > Tarea de limpieza abre un tercer paso. Asignadas a mí hoy (DD/MM/AAAA) envía una petición en lenguaje natural con la fecha operativa actual; el servidor obtiene la identidad de empleado o proveedor vinculada a la cuenta, busca únicamente sus asignaciones autorizadas para ese día y devuelve enlaces a la vista de trabajo de limpieza. El modelo no recibe ni elige un usuario, empleado, proveedor, equipo o asignado. Si el usuario pide después otra fecha, se conserva el alcance de asignación y solo se envía la fecha normalizada a la misma búsqueda del servidor filtrada por asignado. Buscar otra tarea de limpieza abre la búsqueda general independiente; una búsqueda general por fecha exacta puede devolver cualquier tarea que el usuario esté autorizado a consultar, y esos resultados no demuestran que estén asignados ni que no estén asignados a ese usuario. Decir «mis tareas», «asignadas a mí» o «las que tengo asignadas» selecciona la búsqueda personal; decir «todas las tareas» o «todas las tareas asignadas» sin «a mí» selecciona la lista general. Cada tarea devuelta tiene una tarjeta con Abrir verificada por el servidor e independiente del Markdown del modelo. Su etiqueta para el navegador autenticado es el nombre completo de la operación relacionada, no un título de tarea de limpieza generado automáticamente. Tanto el acceso rápido de «asignadas a mí» como su herramienta del proveedor se omiten para otros roles o cuentas sin una identidad activa de limpiador vinculada, aunque puedan consultar tareas de limpieza por otros motivos.

El agente no continúa búsquedas en segundo plano después de terminar una respuesta. Cuando ya tiene la fecha y el alcance —por ejemplo, todas las tareas autorizadas del 05/08/2025— debe ejecutar la búsqueda en ese mismo mensaje y devolver la primera página de tarjetas, indicar que no hay coincidencias autorizadas o pedir un único dato que realmente falte. Si el modelo responde solo que está buscando, comprobando o procesando y no llama a ninguna herramienta, Holidario descarta ese texto y repite el turno una vez con la obligación de completar la consulta. Si vuelve a omitirla, el chat muestra un error final recuperable en lugar de dejar una búsqueda aparentemente pendiente.

Cuando una búsqueda devuelve exactamente un recurso, Holidario muestra Opciones para este recurso cuando existe al menos una capacidad permitida. Las recuperaciones de solo lectura aparecen bajo Consultas —por ejemplo, obtener el enlace de check-in o ver el importe, la fecha, los gastos o el desglose por canal de una liquidación— y las operaciones con efectos aparecen por separado bajo Acciones. Una consulta no se presenta ni se acepta como acción. Para las colecciones se reutiliza la misma tarjeta con ¿Qué quieres hacer con esta lista?, limitada a sus acciones sobre el conjunto completo. Si una sección no tiene opciones, no se muestra vacía. El modelo no construye la tarjeta, no enumera sus opciones en una tabla Markdown y no decide qué botón existe.

La referencia reciente, su índice de selección, el tipo, el identificador real y la etiqueta completa se guardan cifrados dentro de la sesión de Holidario. Cada índice es único durante esa sesión y no se reutiliza aunque caduque una referencia anterior. El agente puede reutilizar la referencia opaca durante un máximo de 60 minutos; después la omite y el registro cifrado del chat se elimina mediante el mismo proceso de conservación breve. Borrar el chat o cambiar de audiencia vuelve inaccesible la sesión anterior. El proveedor recibe solo la referencia opaca, el tipo, el índice y argumentos ligados que también contienen esa referencia, nunca el ID, la etiqueta ni el enlace. Antes de mostrar el selector y de nuevo al pulsar una acción, Holidario vuelve a comprobar la configuración del equipo, el plan, los permisos, la referencia y la autorización del registro o de la colección.

Al pulsar una acción de un recurso, el endpoint autenticado vuelve a enfocar exactamente esa referencia, incluso si la tarjeta pertenece a una respuesta anterior. Si la acción todavía necesita datos humanos —por ejemplo, el motivo de un ticket, las fechas y la razón de un bloqueo o una descripción nueva—, el chat envía el texto guiado definido por el código y el agente pide solo esos datos. Si la acción sobre una colección ya tiene todos sus argumentos, el botón prepara directamente su tarjeta de confirmación. Elegir un botón nunca ejecuta una mutación sin la confirmación explícita posterior.

Una búsqueda con una sola coincidencia la deja enfocada de forma inequívoca y muestra sus consultas o acciones disponibles automáticamente. Cuando aparecen varias, ninguna sustituye una elección anterior hasta que el usuario escoge una. Cada tarjeta indexada incluye Seleccionar. Al pulsarlo, el navegador envía el mismo índice como dato estructurado; Holidario comprueba que pertenezca a esa sesión cifrada, que continúe vigente y que el usuario todavía pueda consultar exactamente ese registro. La respuesta y la tarjeta de opciones se generan directamente en Holidario, sin una llamada al modelo ni consumo de tokens. El proveedor recibe selected_resource solo en el siguiente turno que realmente lo necesite. Una búsqueda posterior reemplaza o borra ese enfoque para no reutilizar una elección antigua por error.

Escribir en el chat el nombre, la posición o el número de una tarjeta no sustituye esa selección: el modelo no ve las etiquetas de las tarjetas. Un nombre escrito inicia una búsqueda autorizada nueva; para elegir entre varios resultados ya mostrados, usa Seleccionar. Si la tarjeta ha caducado, repite la búsqueda.

La carga normal del panel no crea una sesión ni llama al proveedor. Holidario restaura o crea el chat únicamente al pulsar el botón flotante. Cerrar la ventana no borra la conversación de inmediato; vuelve a abrirla dentro de los 60 minutos posteriores a la última actividad para continuarla.

Para eliminar el historial visible, pulsa Borrar conversación y confirma Borrar y empezar de nuevo. Esta opción continúa disponible mientras se está procesando una respuesta, también si una recarga del navegador dejó el chat aparentemente bloqueado. Holidario interrumpe esa respuesta, elimina los mensajes, cancela las propuestas pendientes y archiva la sesión anterior antes de crear otra vacía; una respuesta tardía del proveedor no puede reaparecer en la conversación nueva. Conserva los registros de seguridad de acciones y la contabilidad de uso según sus plazos independientes. Cerrar el aviso con Conservar conversación no modifica nada.

Si cambia el rol de un usuario de forma que cambia su audiencia documental, Holidario no restaura ni reutiliza la conversación anterior: inicia un chat nuevo y nunca vuelve a enviar al modelo las respuestas del rol anterior. La conversación antigua se conserva hasta que venza su periodo normal, pero no queda accesible desde la audiencia nueva. Esta misma regla de cierre seguro se aplica a las sesiones creadas antes de que existiera la clasificación por audiencia.

Consultar y comprobar una respuesta#

1. Pulsa Pregúntale a Holidario o abre Agente de soporte interno desde el menú.
2. Formula una pregunta concreta o elige una de las acciones rápidas disponibles para ti. Para obtener un enlace, pulsa Buscar algo y selecciona después el tipo que reconozcas. Para revisar liquidaciones de un intervalo exacto, usa Impuestos e ingresos, deja Todos los alojamientos o elige uno autorizado, selecciona la primera y la última fecha incluidas y pulsa Buscar liquidaciones.
3. Revisa los enlaces de Fuentes que aparecen con la respuesta.
4. Abre la FAQ o página pública cuando la respuesta afecte una decisión importante.
5. Si faltan pruebas, reformula la pregunta o trabaja desde la pantalla original.

Los enlaces y títulos de fuente los genera el servidor desde identificadores recuperados; el modelo no puede inventar una URL válida. Aun así, el modelo puede resumir mal, omitir condiciones o no encontrar la fuente adecuada.

Las respuestas del asistente admiten Markdown para mostrar párrafos, títulos, listas, énfasis, citas, código y tablas de forma legible. Holidario convierte y depura ese contenido en el servidor: elimina HTML e imágenes enviados por el modelo y solo deja como enlaces pulsables las rutas de la aplicación actual y la documentación pública de Holidario. Los destinos externos o inseguros se muestran como texto. Tus propios mensajes se mantienen siempre como texto sin formato.

También puedes pedir un enlace a un alojamiento por nombre, parte del nombre o identificador. Aunque la interfaz diga Alojamiento, Holidario siempre busca la operación de alquiler vacacional autorizada. Realiza una búsqueda acotada dentro del equipo actual y aplica el permiso normal de lectura y la autorización de recurso antes de generar cada enlace. Si hay varias coincidencias, el agente debe mostrarlas para que concretes cuál necesitas; una búsqueda sin resultados no revela si existe una operación en otro equipo o sin autorización.

La búsqueda de reservas admite el nombre completo del huésped o una referencia exacta de Booking.com, Airbnb o Holidario mediante la ruta de tokens privados. Presidio sustituye el valor detectado antes de que el mensaje llegue al proveedor; la herramienta de reservas recibe solo el token opaco, vuelve a comprobar el acceso normal del usuario autenticado a las reservas y resuelve el valor únicamente para esa búsqueda acotada. No incluyas datos de pago, documentos de identidad, credenciales ni información personal no relacionada: el turno se bloquea cuando esas detecciones no tienen un uso de búsqueda autorizado.

También puedes preguntar qué reserva está alojada en un alojamiento hoy o en otra fecha. Holidario busca primero la operación autorizada por su nombre y después usa su referencia opaca para localizar una reserva no cancelada cuyo intervalo incluya la fecha (entrada ≤ fecha < salida); la salida es exclusiva. Para «ahora» u «hoy» usa la fecha operativa del servidor. No necesitas conocer el huésped ni el código de confirmación. Esta capacidad solo aparece y se ejecuta cuando el usuario conserva read-reservation, read-event, acceso a la operación y autorización tanto sobre la reserva encontrada como sobre su evento. Si existe un solapamiento anómalo, el navegador muestra todas las coincidencias autorizadas para que el usuario elija; el modelo no recibe sus nombres, IDs ni enlaces.

Continuar desde un recurso encontrado#

Los siguientes pasos se declaran en código por tipo de recurso. Pueden ser consultas de solo lectura o acciones con efectos; no son una herramienta CRUD genérica y el modelo no puede inventar otra operación. Las consultas aparecen en su propia sección y también se pueden pedir en lenguaje normal. Por ejemplo, sobre una operación de alojamiento puedes consultar la reserva alojada hoy o en otra fecha o la liquidación más reciente. Sobre una reserva puedes consultar el enlace privado de check-in, la liquidación asociada o la tarea de limpieza relacionada. Si el usuario también puede crear tickets y el equipo lo ha habilitado, Crear un ticket sobre este recurso aparece por separado bajo Acciones. Cada capacidad solo está disponible si la función del equipo está activa y el usuario conserva el permiso normal de lectura o escritura y la autorización sobre el recurso y sus relaciones. Al usarla, Holidario vuelve a comprobarlo todo, resuelve la relación en el servidor y devuelve la tarjeta o propuesta exacta; el modelo no busca ni deduce el registro relacionado. Si no existe o no está autorizado, la capacidad no está disponible. Una operación puede ofrecer la actualización de sus notas o una solicitud de bloqueo como acciones solo cuando se cumplen sus permisos y reglas específicas.

Cuando pides «la última liquidación de Almería 11», el agente busca primero esa operación y utiliza únicamente su referencia opaca. Holidario resuelve la operación en el servidor, limita la consulta a sus liquidaciones, ordena por la fecha de creación más reciente y devuelve como máximo una tarjeta. No necesita que indiques mes y año y nunca sustituye esta consulta por la última liquidación general del equipo. Si no existe una liquidación autorizada para esa operación, devuelve un resultado vacío sin mostrar una liquidación de otro alojamiento.

Después de encontrar una liquidación, puedes preguntar con lenguaje normal cuándo se registró, cuánto se pagó, qué gastos se descontaron o cuánto corresponde a Airbnb, Booking y los demás canales. El agente solo selecciona una de esas cuatro capacidades y devuelve la referencia opaca de la liquidación; los valores exactos se calculan otra vez en Holidario y aparecen únicamente en una tarjeta financiera del navegador autenticado. La fecha, importes, conceptos, nombres de canales, ID y enlace administrativo no se envían al modelo ni se reconstruyen desde su texto. Si el modelo responde que el detalle está en una tarjeta sin haber ejecutado la consulta correspondiente, Holidario descarta esa respuesta y le exige una vez que use la capacidad exacta; si vuelve a omitirla, el chat muestra un error honesto y no inventa una tarjeta.

Las cuatro respuestas tienen un significado deliberadamente limitado:

• Fecha registrada: muestra created_at en fecha europea y hora operativa. Indica cuándo Holidario creó el registro de la liquidación; no acredita cuándo el banco abonó el dinero.
• Importe neto final: muestra el ingreso neto de reservas incluido en el abono manual, los gastos descontados y el resultado final. Los importes que un canal pagó directamente mediante reparto automático no se suman a ese abono manual.
• Gastos descontados: usa la instantánea inmutable guardada al crear la liquidación. Muestra los totales de comisiones de canales, honorarios de agencia, cargos de limpieza y otros gastos. Con read-property-expense, detalla además los conceptos del alojamiento que el usuario todavía puede consultar y los cargos de limpieza por bloqueos de propietario incluidos; sin ese permiso conserva los totales, pero no expone esas descripciones. La instantánea no guarda una relación histórica fiable entre cada cargo de limpieza y una tarea concreta, por lo que la tarjeta no inventa una lista de tareas.
• Ingreso por canal: agrupa por Airbnb, Booking, reserva directa u otro canal el ingreso neto de las reservas de la liquidación. La tarjeta diferencia lo incluido en el abono manual de lo pagado directamente por un canal. No reparte los gastos del alojamiento entre canales porque la liquidación no contiene esa asignación.

Las cuatro capacidades requieren read-p-m-s-payout, la función de liquidaciones del plan, el equipo actual y autorización sobre esa liquidación. Holidario vuelve a comprobar esas condiciones al mostrar las opciones y al construir cada tarjeta. Abrir liquidación completa permite revisar después el registro original; no es necesario abrirlo para ver la respuesta solicitada.

Para obtener el check-in desde una reserva encontrada:

1. pide «Dame el enlace privado de check-in de esta reserva»;
2. comprueba que aparece la tarjeta con el nombre claro de la capacidad;
3. pulsa Preparar enlace privado para que el servidor revalide la reserva y genere la URL firmada;
4. usa Abrir enlace privado para revisarlo o Copiar enlace privado para compartirlo por un canal aprobado. En una estancia pasada, la capacidad ofrecida dice Obtener el enlace de la reserva (vista anonimizada; el check-in ya no está disponible) y la tarjeta muestra Reserva pasada: check-in no disponible.

Antes de la salida programada, este enlace es una credencial de acceso sin contraseña. No lo publiques ni lo pegues de nuevo en el chat. En la salida caduca el acceso privado. Para una reserva pasada, autorizada, no cancelada y con fecha de salida, Holidario todavía puede generar la ruta correctamente firmada, pero el middleware de firmas caducadas muestra solo una vista histórica anonimizada: oculta la referencia y los campos privados y desactiva el check-in y el área del huésped. Siguen sin estar disponibles las reservas canceladas, los registros sin fecha de salida y las reservas o eventos a los que el usuario no tenga acceso. La tarjeta no requiere confirmación porque generar el enlace no modifica la reserva; cualquier capacidad con efecto conserva su vista previa y confirmación explícita normales.

Buscar otros recursos autorizados#

El mismo buscador de solo lectura admite un conjunto cerrado de tipos e identificadores. El modelo no puede indicar una tabla, clase, campo o URL; Holidario define en código cada consulta y cada dato que puede volver al chat.

Recurso	Identificadores admitidos
Alojamiento	Nombre, parte del nombre o ID de la operación de alquiler vacacional.
Liquidación	ID, texto descriptivo o nombre de operación; también un intervalo exacto con primera y última fecha incluidas, un año natural completo o un mes y año de creación, con operación opcional. Para «la más reciente» de un alojamiento, usa la capacidad ligada a la operación, sin periodo.
Ticket	Asunto o ID; también mes y año de creación y estado exacto. No busca el cuerpo ni la conversación.
Tarea de limpieza	ID, referencia de reserva o nombre de operación; también mes y año programados y estado exacto.
Gasto de alojamiento	Descripción, inmueble o ID; también un año natural completo o un mes y año del gasto, con operación opcional.

La búsqueda por chat de facturas emitidas, facturas de proveedor, documentos compartidos, gastos fiscales recibidos, empresas, contratos, pagos de reserva directa, envíos a VeriFACTU, planes de tarifas y cupones de descuento está deshabilitada. Aunque el usuario pueda consultar alguno de esos recursos en su pantalla normal de Holidario, el agente no lo ofrece ni acepta ese tipo en su herramienta; utiliza la sección correspondiente del panel.

Las liquidaciones admiten un intervalo exacto con ambos extremos incluidos, un año natural completo o una consulta de mes y año. Los gastos de alojamiento admiten el año completo o mes y año. En liquidaciones, el periodo se aplica a la fecha de creación que ya muestra y filtra el listado (created_at) en la zona horaria operativa; en gastos, se aplica a la fecha propia del gasto (date). Por tanto, no hace falta añadir ni rellenar columnas de periodo. Si pides «todas las liquidaciones de 2025» o «todos los gastos de alojamiento de 2025», el agente ejecuta directamente una búsqueda anual y devuelve la primera página con el total exacto; los controles numerados permiten recorrer las páginas restantes. No pregunta por un mes ni ejecuta doce búsquedas. Para tickets y tareas de limpieza, una búsqueda por periodo continúa necesitando mes y año y cubre un solo mes natural.

El buscador devuelve páginas acotadas de hasta diez opciones —cinco de forma predeterminada— y muestra el total exacto de coincidencias autorizadas junto con la página actual. Cada resultado se presenta en una tarjeta independiente y verificada por el servidor con Seleccionar y Abrir; el panel flotante mantiene una columna y la página completa distribuye las tarjetas en una cuadrícula compacta según el ancho disponible. El proveedor solo conoce el índice de sesión y referencias opacas de recursos: no puede ver la etiqueta de un resultado ni escribir el destino administrativo en Markdown. Bajo las tarjetas aparecen controles numerados como en los listados normales de Holidario, con página anterior, página siguiente y puntos suspensivos cuando hay muchas páginas; la ventana compacta mantiene visible la página inmediatamente adyacente antes de los puntos suspensivos. Al pulsar un número se envía únicamente el mensaje visible en lenguaje natural, por ejemplo «Muéstrame la página 7 de esta búsqueda»; escribir el mismo mensaje sigue exactamente la misma ruta de conversación. Es un turno normal del proveedor y, por tanto, puede consumir tokens. El prompt expone únicamente el tipo de recurso, la página actual, el total exacto y la última página. Siempre que existe ese estado, el modelo recibe una herramienta específica de página y solo lectura cuyo único argumento es el número de página solicitado; la continuación cifrada, los filtros originales y las etiquetas permanecen por completo en el servidor. La herramienta de búsqueda general no admite argumentos de paginación. Así, cualquier redacción resulta inequívoca sin reconocer una frase concreta y no se obliga al proveedor a reproducir un valor cifrado. Una comprobación de evidencia del servidor rechaza y reintenta cualquier respuesta del proveedor que afirme haber cargado otra página sin el resultado autenticado correspondiente. La continuación conservada por el servidor sigue disponible en la última página, por lo que una petición posterior puede retroceder sin repetir la búsqueda. Está vinculada al usuario, equipo, audiencia documental, sesión y caducidad actuales, y no permite ampliar los filtros originales. El servidor vuelve a aplicar el permiso de lectura específico, la función contratada, el equipo, la autorización de cada registro y cualquier regla adicional del recurso. Cuando termina de renderizar una página elegida con los controles, el chat compartido mantiene el mensaje generado de cambio de página al principio del área visible para que los resultados nuevos aparezcan a continuación. Si los datos cambiaron, el total y el número de páginas se calculan de nuevo; si la página o el estado del servidor ya no son válidos, repite la búsqueda original. Un resultado vacío no confirma que el registro no exista.

La referencia opaca de la consulta completa es independiente del estado de paginación conservado por el servidor y de las tarjetas individuales. Conserva únicamente la búsqueda base sin desplazamiento y permite que cada acción de colección declarada vuelva a resolver todos los registros autorizados, aunque ocupen varias páginas. La tarjeta autenticada de resultados enumera esas acciones dinámicamente; si hay dos habilitadas, muestra dos opciones y prepara únicamente la elegida. Para Descargar documentos para impuestos e ingresos, la vista previa de confirmación queda ligada a los miembros exactos de la colección de liquidaciones en ese momento. Si antes de confirmar se añade o retira una liquidación coincidente, o deja de estar autorizada, Holidario rechaza la propuesta obsoleta y obliga a repetir la búsqueda. El modelo no debe ofrecer presentar impuestos, calcular una declaración, crear un informe de ganancias ni ejecutar una acción no declarada sobre esa referencia.

El catálogo autorizado completo —incluidas solo las páginas de la audiencia efectiva— se incluye de nuevo en las solicitudes para que el modelo conozca todas las opciones. El almacenamiento en caché de instrucciones del proveedor puede reducir parte del coste repetido cuando está disponible, pero depende de su política y facturación. Solo las respuestas FAQ y secciones elegidas entran como contenido recuperado.

Preparar y confirmar una acción#

Describe el resultado con tus propias palabras. El agente infiere el asunto, la descripción y los valores técnicos razonables; no debe empezar mostrando campos internos, enumeraciones ni un cuestionario. Si falta un dato obligatorio que no puede deducir de forma segura, pregunta solo por ese dato.

El agente distingue entre una petición que este chat no puede realizar y una acción compatible a la que solo le falta información:

• si la petición exacta no está disponible, lo indica de forma directa —«esto no se puede hacer desde este chat»— y puede sugerir como máximo dos alternativas que estén habilitadas y autorizadas para el usuario actual;
• si la acción sí está disponible, pero falta un dato o el indicado no se puede usar con seguridad, explica el límite con palabras normales y hace una sola pregunta concreta. Conserva los datos válidos que ya has dado y no te pide nombres de campos, tipos de búsqueda ni otros términos técnicos.

El agente nunca debe ampliar, limitar, dividir o sustituir silenciosamente una petición rechazada. Por ejemplo, una búsqueda anual de liquidaciones o gastos de alojamiento se ejecuta como una sola consulta paginada; no se convierte en doce consultas mensuales. Para un recurso cuyo periodo solo admite un mes, como «todos los tickets de 2025», debe conservar el año y preguntar «¿qué mes de 2025 quieres consultar primero?» en lugar de elegir un mes o devolver un periodo distinto.

El acceso rápido Impuestos e ingresos prepara únicamente la búsqueda del periodo. Cuando existen resultados, elige Descargar documentos para impuestos e ingresos bajo ¿Qué quieres hacer con esta lista? Holidario prepara entonces esa propuesta, nunca todas las acciones disponibles de la colección automáticamente. Revisa la cantidad de liquidaciones, el periodo y el alcance de todas las páginas y pulsa Confirmar acción solo cuando el conjunto sea correcto. La confirmación pone en cola el mismo ZIP documental que Descargar documentos fiscales en el listado de liquidaciones; el chat no espera a que se genere el fichero.

Tras confirmar correctamente, la tarjeta muestra el UUID del trabajo en lote y un enlace a la lista de procesos de liquidaciones. Abre esa pantalla, localiza el UUID correspondiente, espera a que termine y después abre su menú de tres puntos verticales y elige Descargar. No repitas la acción solo porque el ZIP continúe en cola. El chat no presenta impuestos, no calcula una declaración ni genera un informe contable de ganancias; esas peticiones deben seguir rechazándose sin inventar otra propuesta.

Para un ticket que no sea de sistemas o integraciones hace falta una operación o reserva autorizada. Puedes indicar el nombre habitual del apartamento, alojamiento o anuncio: el agente lo busca primero como operación y usa el identificador devuelto por Holidario. No necesitas conocer un ID interno. Si hay varias coincidencias, el agente debe mostrarlas para que elijas; si no encuentra ninguna, pide un nombre más distintivo o una referencia de reserva.

Cuando ya dispone del contexto obligatorio, el proveedor debe llamar inmediatamente a la herramienta, que crea una propuesta, no el efecto. No hace falta confirmar antes que deseas preparar la vista previa. Si el proveedor describe una propuesta o tarjeta que en realidad no ha solicitado a Holidario, el servidor descarta ese texto y repite una vez el turno con una instrucción explícita para usar la herramienta. Solo una tarjeta emitida por el servidor demuestra que la propuesta existe:

1. revisa tipo de acción, recurso, destinatario o diferencias entre antes y después;
2. corrige la petición mediante otro mensaje si la vista previa no es correcta;
3. confirma solo la propuesta exacta con Confirmar acción en la tarjeta; si solo hay una propuesta pendiente, también puedes escribir «lo confirmo»;
4. comprueba el resultado enlazado.

Un «ok» o «sí» ordinario no ejecuta una acción. La tarjeta es la autoridad: antes de confirmar indica que la acción todavía no se ha ejecutado y solo cambia a completada después de una respuesta correcta del servidor. Si el texto del asistente contradice ese estado, confía en la tarjeta y en el resultado enlazado. Holidario reutiliza una propuesta idéntica que siga pendiente en vez de crear duplicados cuando continúa la conversación.

Las propuestas caducan. Al confirmar, Holidario recarga el recurso y vuelve a comprobar usuario, equipo, permiso, regla de negocio y cambios concurrentes. La confirmación expresa consentimiento, pero nunca amplía permisos. Una propuesta ya ejecutada tiene una clave de idempotencia y no vuelve a ejecutar el efecto al repetir la confirmación.

Las primeras acciones con efecto son:

• Solicitar un bloqueo de calendario del propietario: solo está disponible para un usuario que pueda consultar y esté autorizado sobre la operación gestionada, pero no pueda editar directamente su calendario de alquiler. El agente resuelve el alojamiento, pregunta la primera noche bloqueada y la fecha de salida o desbloqueo, comprueba el calendario y después pide un motivo obligatorio. La fecha final es exclusiva: una solicitud del 20 al 23 de julio cubre las noches del 20, 21 y 22, y libera el día 23. El servidor comprueba la disponibilidad al preparar la tarjeta y de nuevo al confirmarla. La confirmación crea únicamente una BlockedDatesRequest pendiente de revisión por la agencia; nunca crea una reserva, evento, bloqueo de canal ni bloqueo confirmado del calendario. La aprobación posterior de la agencia sigue siendo un flujo separado y vuelve a comprobar la disponibilidad.
• Crear un ticket: usa al usuario autenticado como creador, infiere categoría y prioridad a partir de la petición y exige una operación o reserva relacionada salvo para sistemas e integraciones. Como Holidario requiere responsable, la tarjeta incorpora un selector obligatorio con búsqueda. Al abrirlo carga desde Holidario las primeras opciones autorizadas; al escribir un nombre realiza otra búsqueda en el servidor, por lo que la tarjeta no descarga la lista completa de personal del equipo. Los resultados contienen solo personas que el usuario actual puede elegir para esa categoría del ticket. Elige el responsable en la tarjeta antes de confirmar. El proveedor no recibe la búsqueda, los nombres, la lista, los IDs ni el valor elegido. El navegador autenticado recibe cada etiqueta visible junto con un token opaco y de corta duración, ligado a la propuesta, chat, equipo, usuario, versión de la acción, campo y caducidad. Al confirmar, Holidario descifra el token, resuelve el ID real únicamente en su servidor y comprueba de nuevo que el responsable siga permitido. Por tanto, el agente no elige una persona ni asigna automáticamente a la primera disponible. Una propuesta creada con un formato de confirmación anterior no puede confirmarse: pide otra nueva.
• Enviar correo a soporte: el destinatario es siempre [email protected]; el modelo no puede indicar remitente ni destinatario.
• Actualizar la descripción interna de una operación: solo reemplaza las notas privadas de una operación de alquiler vacacional autorizada. No cambia el nombre ni notas visibles para huéspedes y falla si el contenido cambió después de la vista previa.

Errores y recuperación#

• No aparece el botón del agente: comprueba que exista un equipo actual, el plan, la activación, la clave OpenRouter y un modelo compatible guardado para este agente. No hay que asignar un permiso propio del chat.
• OpenRouter rechaza la clave API: abre Editar, sustituye la clave inválida, caducada o revocada por una clave OpenRouter activa, vuelve a aceptar la declaración y guarda. La clave nunca se muestra en el navegador ni debe enviarse a soporte.
• Proveedor no disponible: valida la clave OpenRouter, el modelo, los créditos, los límites y la cuota desde la configuración.
• No carga el selector de alojamientos de Impuestos e ingresos: puedes reintentar sin cerrar el paso. Si no se recupera, deja Todos los alojamientos para construir la petición del intervalo sin ese filtro; comprueba además read-operation, read-short-term-rental-operation, el equipo activo y la autorización de las operaciones. Si el mensaje aparece en la conversación pero no llega un resultado, revisa también la traza normal del proveedor y de las herramientas, además de la validación, permisos y búsqueda de Holidario.
• No encuentra una FAQ: comprueba que esté activa, traducida y autorizada para el usuario.
• No encuentra documentación: usa términos del título o categoría, comprueba que la fuente pública esté habilitada y confirma que la página pertenezca a la audiencia documental del usuario. Una página destinada a otro rol se comporta como inexistente para el agente.
• No encuentra un alojamiento: usa una parte distintiva del nombre o el identificador de su operación de alquiler vacacional y comprueba que conservas permiso de lectura y autorización sobre ese recurso.
• No encuentra una reserva: usa el nombre completo del huésped o pega la referencia completa de Booking.com, Airbnb u Holidario; comprueba el equipo actual, read-reservation, tu autorización sobre la reserva y los filtros normales de visibilidad.
• No aparece una capacidad después de encontrar un recurso: comprueba que exista una sola coincidencia y que la acción siga habilitada para el equipo, plan, rol, permisos y registro actuales. Las referencias recientes caducan a los 60 minutos; vuelve a buscar el recurso cuando caduque.
• No se puede preparar el enlace de la reserva: vuelve a buscarla y comprueba que no esté cancelada, que tenga fecha de salida y que conserves acceso tanto a la reserva como al evento. Una salida pasada debe producir la tarjeta de vista histórica anonimizada, no un error de autorización. No intentes reconstruir una URL anterior.
• No encuentra otro recurso: usa su ID o uno de los identificadores de la tabla anterior y comprueba permiso de lectura, función del plan, equipo y autorización del registro. Para liquidaciones indica un intervalo exacto, un año completo o un mes y año; para gastos de alojamiento indica un año completo o un mes y año; para los demás periodos indica mes y año. En liquidaciones se usa la fecha de creación que muestra el listado y en gastos la fecha propia del gasto.
• La petición exacta no se puede realizar desde el chat: el agente debe indicarlo sin atribuirlo a un permiso, plan o configuración que no haya comprobado. Elige una de las alternativas mostradas solo si corresponde a lo que necesitas; las sugerencias proceden de las acciones y capacidades disponibles para el usuario actual.
• La búsqueda pide otro dato: responde únicamente al dato concreto solicitado. Una consulta anual de liquidaciones o gastos de alojamiento que ya incluya el año no necesita otro dato y debe ejecutarse directamente. Para tickets o tareas de limpieza con solo el año, indica el mes; el agente debe conservar el año y buscar un solo mes natural.
• El intervalo de liquidaciones no se envía: completa Desde y Hasta con fechas válidas. Las dos están incluidas en la búsqueda y Hasta no puede ser anterior a Desde.
• La respuesta dice que está buscando y no muestra un resultado: no hay una tarea en segundo plano. Holidario descarta automáticamente ese texto y vuelve a pedir una vez al proveedor que ejecute la consulta. Si aparece el mensaje final de búsqueda no ejecutada, repite la petición completa; si vuelve a ocurrir, pide a un administrador que revise los registros de la aplicación sin enviar datos del cliente ni la clave API.
• Una pregunta de liquidación no muestra la tarjeta financiera: Holidario descarta una respuesta que hable de una tarjeta sin haber ejecutado la consulta y pide una vez al modelo que use la capacidad correcta. Si el mensaje final indica que la consulta no se ejecutó, vuelve a pedir ese detalle sobre la liquidación actual o busca de nuevo la liquidación si hay varias referencias recientes. Comprueba read-p-m-s-payout, la función de liquidaciones y la autorización del registro. Si los totales aparecen pero no se detallan los conceptos de gastos del alojamiento, comprueba read-property-expense y la autorización sobre esos gastos. No uses como dato un importe escrito anteriormente por el asistente.
• Las fechas del bloqueo del propietario no están disponibles: elige otro intervalo. La herramienta solo devuelve disponible o no disponible y nunca revela la reserva o evento en conflicto.
• La propuesta de bloqueo se rechaza al confirmar: el calendario, la operación, la autorización o la configuración de la acción cambió después de la vista previa. No se creó ninguna solicitud, reserva ni evento; comprueba las fechas actuales y prepara otra propuesta.
• La solicitud de bloqueo está pendiente: no trates todavía las fechas como bloqueadas. Espera a que la agencia la revise; solo el flujo posterior de aprobación puede crear el bloqueo real del calendario.
• No se pudo preparar la propuesta y no aparece una tarjeta: Holidario ya descartó un texto no respaldado y pidió una vez al proveedor que utilizara la herramienta correcta. Si el mensaje indica que sigue sin existir propuesta, vuelve a solicitar la acción. Reabrir el chat solo restaura propuestas que el servidor creó de verdad; sin tarjeta no existe nada que confirmar.
• El texto afirma que la acción terminó, pero la tarjeta sigue pendiente: la acción no se ha ejecutado. Confirma mediante la tarjeta o escribe «lo confirmo» cuando haya una sola propuesta pendiente y comprueba después el estado completado y el enlace de resultado.
• Ya hay una respuesta en curso: espera a que termine antes de enviar otro mensaje en ese chat; las pestañas simultáneas no pueden iniciar ejecuciones solapadas del proveedor en la misma sesión.
• La pestaña se cerró durante una respuesta: vuelve a abrir el chat. Si la ejecución superó el tiempo de seguridad sin terminar, Holidario la mostrará como fallida y permitirá un mensaje nuevo; no reanuda una solicitud abandonada ni ejecuta una acción automáticamente.
• Presupuesto o límite alcanzado: espera al periodo indicado o pide al administrador revisar los límites; no repitas solicitudes.
• Propuesta caducada: solicita una nueva para obtener una vista previa actual.
• Permiso retirado o recurso modificado: no fuerces la ejecución; revisa acceso y vuelve a preparar la acción desde el estado actual.
• Error del proveedor: el chat no interpreta el fallo como una acción completada. Revisa antes de repetir una operación que pudiera tener efecto.
• Error interno del agente: reintenta una vez. Si se repite, no cambies ni rotes la clave solo por este mensaje; pide a un administrador de Holidario que revise los registros de la aplicación.

No envíes claves API, contraseñas, documentos personales ni secretos en el chat. Para un error repetido, escribe a [email protected] con equipo, proveedor, modelo, hora, zona horaria, acción intentada y mensaje visible, pero nunca con la clave API.