Configurar OpenRouter y el análisis de conversaciones mediante IA

Holidario puede enviar una copia con la información personal detectada redactada de una conversación de reserva al modelo de IA elegido por tu agencia en OpenRouter para generar un resumen, detectar temas, fechas, solicitudes y posibles incidencias. Antes del envío, la instancia local de Presidio sustituye esa información por marcadores no reversibles. El resultado es una ayuda operativa: no sustituye la lectura de la conversación original ni la decisión de una persona.

Esta guía incluye la preparación común de OpenRouter y después se centra en el análisis de conversaciones. El agente de soporte interno es otra función opcional: consulta FAQ privadas y documentación pública y no usa conversaciones como fuente de conocimiento. Todos los agentes usan la misma clave OpenRouter del equipo, pero cada uno conserva su propia pareja exacta de modelo y proveedor de inferencia.

La agencia contrata y controla su cuenta de OpenRouter. Las credenciales, el saldo, el consumo, los límites y los ajustes de privacidad pertenecen a esa cuenta. Holidario no añade un cargo por uso de IA.

Dos niveles de acceso#

La configuración y el uso diario requieren capacidades distintas:

• Administración de IA: permisos read-ai-provider y update-ai-provider, además de autorización sobre la configuración del equipo.
• Trabajo con una reserva: permisos de lectura y actualización de reservas, además de autorización sobre esa reserva.

Pertenecer a un puesto concreto no concede por sí solo ambas capacidades. Los roles predeterminados Gerente y Recepción pueden consultar un análisis ya guardado en una reserva autorizada, pero no incluyen update-reservation: no pueden iniciar un análisis ni una respuesta automática. Entrégales la guía operativa de revisión, nunca la clave API.

Antes de configurar#

Necesitas:

• el plan Agencia con mensajería mediante IA disponible;
• una cuenta propia de OpenRouter con saldo y cuota disponibles;
• una clave API de OpenRouter dedicada al equipo;
• los ajustes de privacidad y ZDR de OpenRouter revisados por un administrador de esa cuenta;
• una decisión sobre el modelo y proveedor de inferencia que usará cada agente;
• una decisión interna sobre qué conversaciones pueden enviarse al proveedor;
• una persona responsable de revisar resultados, costes y respuestas automáticas.

No uses una clave personal de un empleado. Utiliza una credencial de la organización que pueda rotarse cuando cambie el equipo.

Crear la cuenta y la clave de OpenRouter#

1. Abre OpenRouter y registra la cuenta que controlará la organización.
2. Añade saldo desde Credits. OpenRouter describe esos créditos como depósitos que se descuentan con cada inferencia; no son una suscripción de Holidario.
3. Abre API Keys y crea una clave dedicada, por ejemplo Holidario — nombre del equipo.
4. Define un límite de gasto para la clave si la cuenta necesita ese control.
5. Copia la clave completa cuando aparezca. OpenRouter solo muestra el valor secreto al crearlo; después no puede recuperarse desde el listado.
6. Guarda la clave en el gestor de secretos aprobado por la agencia hasta introducirla en Holidario. No la envíes por correo, chat ni a soporte.

La cuenta, el saldo y la clave son responsabilidad del equipo. Si la clave se deshabilita, caduca, pierde saldo o alcanza su límite, los agentes dejarán de completar solicitudes aunque Holidario todavía muestre la configuración guardada.

Activar Zero Data Retention en OpenRouter#

La protección completa depende de la configuración que mantenga el tenant en su propia cuenta de OpenRouter, no solo de Holidario. Un administrador de esa cuenta debe abrir Organization Privacy y conservar estos estados.

En Data Policies > Zero Data Retention, activa los cinco controles:

1. Non-frontier: activado.
2. Anthropic: activado.
3. OpenAI: activado.
4. Google: activado.
5. xAI: activado.

Con esos controles activos, OpenRouter descarta los endpoints sin ZDR de cada grupo. En particular, los endpoints directos de Anthropic dejan paso a opciones ZDR como Bedrock o Vertex; los directos de OpenAI dejan paso a Azure; y Google AI Studio deja paso a Vertex cuando estén disponibles para el modelo.

En Data Training, desactiva los cuatro controles siguientes:

1. Allow paid endpoints that train on request data: desactivado.
2. Allow free endpoints that train on request data: desactivado.
3. Allow free endpoints that publish prompts: desactivado.
4. Allow 1% data discount in workspaces: desactivado.

Abre también Observability y mantén Input & Output Logging desactivado. Ese control es independiente: si se activa, OpenRouter guarda el contenido de prompts y respuestas para que los administradores de la organización puedan consultarlo. Revisa de nuevo estos ajustes tras cambiar de organización o espacio de trabajo.

Holidario no puede cambiar ni certificar los controles de la cuenta externa. El administrador del tenant debe mantenerlos. OpenRouter explica el alcance y las excepciones en su documentación de Zero Data Retention, recogida de datos y registro de proveedores.

Presidio + ZDR#

Holidario ejecuta Microsoft Presidio en su propio servidor antes de estas solicitudes:

• Soporte interno: un valor detectado que admita una búsqueda autorizada de solo lectura se sustituye en la copia para el proveedor por un token privado, cifrado, de corta duración y ligado a la sesión. El resto de información personal o sensible detectada bloquea el turno completo.
• Análisis de Conversaciones: Presidio analiza localmente la transcripción completa en español e inglés. Sustituye de forma irreversible la información personal detectada; no conserva una tabla para reconstruirla. Mantiene fechas y horas porque son necesarias para interpretar la estancia. Los identificadores internos de mensaje se reemplazan por números temporales durante la solicitud y se resuelven de nuevo dentro de Holidario cuando una incidencia necesita citar mensajes.
• Contenido SEO: Presidio anonimiza únicamente el texto no controlado que puede contener datos introducidos por una persona, como reseñas y descripciones libres. Conserva los campos públicos e intencionales de la ficha —nombre comercial, ubicación, geografía, características y datos estructurados— para que el contenido siga siendo específico. Una respuesta que reproduzca un marcador de privacidad no se publica.

Si Presidio o su anonimizador no están disponibles o devuelven una respuesta inválida, Holidario bloquea la solicitud antes de contactar con el proveedor. La detección automática reduce la información personal enviada, pero puede tener falsos positivos o falsos negativos: utiliza una conversación controlada para validar los idiomas y formatos habituales del equipo y continúa revisando el resultado contra el original.

Cuando una ruta de IA envía una solicitud, Holidario exige ZDR, fija el modelo y endpoint ZDR en vivo que guardó el administrador, rechaza endpoints que recopilan datos y desactiva los fallbacks. Son controles distintos:

• Presidio seudonimiza las búsquedas autorizadas de Soporte interno y anonimiza de forma irreversible las entradas no controladas de Análisis de Conversaciones y Contenido SEO.
• ZDR exige que OpenRouter y el endpoint final seleccionado no conserven el contenido transmitido; no lo anonimiza.

ZDR solo cubre el enrutamiento de inferencia. No cubre plugins ni herramientas de terceros que alguien decida activar en OpenRouter. No añadas plugins o herramientas externas a una clave usada por Holidario sin revisar por separado su tratamiento y conservación.

Configurar el proveedor#

1. Cambia al equipo correcto.
2. Abre Integraciones > Proveedor de IA.
3. Entra en Editar.
4. Introduce la clave API completa de OpenRouter.
5. Abre desde el mismo formulario el DPA, Organization Privacy y Observability y comprueba que corresponden a la cuenta propietaria de esa clave.
6. Activa la declaración obligatoria. Con ella confirmas que el tenant controla la cuenta y la clave, ha aceptado los Términos y el DPA vigentes de OpenRouter, autoriza a sus administradores a elegir una pareja exacta de modelo y proveedor dentro del registro ZDR en vivo de OpenRouter, entiende que los proveedores y ubicaciones de tratamiento pueden cambiar, autoriza el envío de datos redactados por las rutas seleccionadas y mantendrá desactivados el registro, entrenamiento, publicación de prompts y descuentos por uso de datos.
7. Guarda y vuelve a la integración.
8. Comprueba que aparece Configurado con OpenRouter.

Holidario registra qué administrador aceptó, la fecha y hora y la versión exacta de la declaración. Si la clave ya estaba guardada antes de existir este control, deja el campo de clave vacío, acepta la declaración y guarda: el secreto conservado no se devuelve al navegador ni hace falta volver a introducirlo. Sustituir la clave exige una nueva aceptación. Una versión futura de la declaración puede exigir que el administrador la acepte de nuevo.

El estado Configurado confirma que la clave está guardada; no garantiza saldo, cuota, límites ni demuestra de forma independiente los ajustes de privacidad de la cuenta externa. La declaración documenta la instrucción y responsabilidad del tenant, pero no permite a Holidario modificar ni supervisar OpenRouter. Cada agente permanece incompleto hasta que guardes su modelo y proveedor. La primera operación real valida la comunicación completa con OpenRouter y puede generar consumo.

Elegir el modelo y el proveedor de inferencia#

Holidario carga en el servidor el catálogo de modelos disponible para la clave del tenant. Después lo cruza con las capacidades que necesita el agente y el registro ZDR vigente de OpenRouter. La clave no se envía al navegador.

1. Elige primero el Modelo para este agente.
2. En Proveedor de inferencia ZDR, compara el proveedor, la cuantización, el contexto, la salida máxima, la disponibilidad reciente, las ubicaciones declaradas y los precios de entrada, salida y caché que comunique OpenRouter.
3. Elige un endpoint seleccionable y usa Guardar modelo y proveedor.

Todos los endpoints técnicamente compatibles del registro ZDR en vivo son seleccionables. Revisa el proveedor, sus ubicaciones declaradas, política de privacidad, términos y precio antes de guardarlo. Tras guardar, cada solicitud fija exactamente esa pareja mediante las opciones order y only; no hay cambio automático de proveedor ni fallback.

Los importes son los publicados por OpenRouter para ese endpoint, normalmente en USD por millón de tokens. Son informativos, pueden variar después de la actualización del catálogo y no incluyen comisiones de recarga, impuestos ni otros cargos de la cuenta. Consulta el panel de OpenRouter para la facturación definitiva.

Habilitar Análisis de Conversaciones#

1. En Agentes de IA, localiza Análisis de Conversaciones.
2. Elige un modelo compatible y después un Proveedor de inferencia ZDR seleccionable.
3. Usa Guardar modelo y proveedor.
4. Habilítalo para el equipo. El control permanece indisponible mientras falte cualquiera de los dos valores, existan cambios sin guardar o la ruta guardada ya no aparezca apta en el catálogo en vivo.
5. Mantén inicialmente sin plantilla cualquier categoría de respuesta automática.
6. Elige una reserva futura controlada con una conversación real de OTA o WhatsApp.
7. Ejecuta el análisis y revisa el resultado antes de ampliar el uso.

Cambiar esta pareja de modelo y proveedor solo afecta a Análisis de Conversaciones. No cambia las rutas de Contenido SEO, Auto Blog ni la ruta propia del agente de soporte interno.

Las reservas pasadas no admiten un nuevo análisis manual. Si la reserva no tiene una conversación compatible, la acción informa que no encontró contenido para analizar.

Utilizar el análisis en una reserva#

1. Abre la reserva autorizada desde el calendario.
2. Lee los últimos mensajes y confirma que pertenecen al huésped correcto.
3. Usa Analizar conversación.
4. Espera al procesamiento; el resultado puede no aparecer de inmediato.
5. Actualiza la reserva y revisa resumen, categorías, evidencias, fechas, acciones y preocupaciones.
6. Contrasta cualquier dato importante con el texto original.

Si llegan mensajes nuevos durante el análisis, Holidario puede marcar la conversación para una revisión posterior. No interpretes un resultado anterior como cobertura de mensajes que llegaron después.

Comportamiento actual durante una estancia en curso#

Holidario guarda el resultado de una estancia en curso como análisis de incidencias, pero la tarjeta visible consulta actualmente el análisis general. Por eso puede aparecer la hora de Último análisis sin que el contenido nuevo aparezca en la tarjeta.

Comprueba que las fechas de la reserva incluyen el día actual, que la conversación OTA o WhatsApp está vinculada y que la hora del último análisis es posterior al mensaje que querías revisar. Trabaja mientras tanto desde la conversación original. Si todo coincide y el resultado continúa ausente, escribe a [email protected] con el equipo, la reserva, la zona horaria y las horas del mensaje y del análisis. No repitas el análisis de forma continua para intentar que aparezca.

Respuestas automáticas: límite crítico#

En la configuración del agente puedes asociar plantillas a categorías y activar su envío. Al habilitar Envío automático, un análisis posterior puede generar un mensaje real al huésped sin que una persona pulse de nuevo el botón de envío.

Antes de habilitarlo:

1. revisa la categoría y sus condiciones en varias conversaciones representativas;
2. comprueba las plantillas de aceptación y rechazo en todos sus idiomas;
3. verifica datos de propiedad, horarios, tarifas y excepciones;
4. confirma por qué canal se enviará;
5. prueba con una reserva controlada;
6. asigna a alguien para revisar las primeras ejecuciones.

Si el análisis no determina claramente una respuesta, la automatización puede usar una plantilla configurada como alternativa. Por eso, deja el envío automático desactivado en categorías donde una respuesta incorrecta pueda comprometer precio, disponibilidad, acceso, seguridad o condiciones contractuales.

Cuándo está listo#

El análisis está preparado para uso asistido cuando:

• el agente muestra el modelo y proveedor exactos esperados;
• los cinco controles ZDR están activados, los cuatro controles de Data Training están desactivados y Input & Output Logging continúa desactivado en OpenRouter;
• el agente está habilitado;
• el servicio local de Presidio supera una prueba controlada y bloquea el envío si no está disponible;
• una conversación controlada termina sin error;
• el resultado corresponde al texto original;
• el equipo sabe que siempre debe verificarlo;
• los envíos automáticos permanecen desactivados o han pasado una aceptación específica.

Errores y recuperación#

• OpenRouter no configurado: guarda la clave del equipo.
• OpenRouter rechaza la clave API: la clave guardada es inválida, ha caducado o ha sido revocada. Abre Editar, sustitúyela por una clave OpenRouter activa, vuelve a aceptar la declaración y guarda. Holidario no utiliza un catálogo público como sustituto porque ignoraría las preferencias y restricciones de la cuenta.
• Ruta del agente sin configurar: elige y guarda modelo y proveedor dentro de Análisis de Conversaciones; después habilita el agente.
• La declaración vigente está pendiente: abre Editar, revisa y acepta la versión actual antes de consultar o cambiar el catálogo dinámico.
• Proveedor incompatible con el agente: el endpoint es ZDR, pero no expone los parámetros o la modalidad que necesita este agente; elige otro endpoint seleccionable.
• Agente no habilitado: habilita Análisis de Conversaciones.
• No hay conversación: confirma que la reserva tiene mensajes de OTA o WhatsApp vinculados.
• Reserva pasada: usa la información ya registrada; no fuerces un análisis nuevo.
• Error de autenticación, saldo o cuota: revisa la clave, los créditos, los límites y la disponibilidad del modelo en OpenRouter.
• La ruta guardada deja de estar disponible: no se cambia de proveedor. Comprueba los ajustes ZDR y preferencias de proveedor de la cuenta, vuelve a cargar el catálogo, revisa el proveedor sustituto y guarda otra ruta ZDR compatible.
• Tarjeta casi vacía con el botón Respuesta automática: el intento puede haber guardado solo un error. No pulses el botón ni consideres que existe un análisis válido. Revisa proveedor, modelo, cuota y facturación, prueba con una reserva futura controlada y contacta con soporte si se repite.
• Estancia en curso con Último análisis pero sin contenido: verifica fechas, conversación vinculada y horas. Es una limitación actual de visualización; trabaja desde el hilo original y contacta con soporte si las comprobaciones son correctas.
• Resultado incompleto o incorrecto: no lo corrijas enviando automáticamente; trabaja desde la conversación original y registra el caso.
• Mensaje automático inesperado: desactiva el envío automático de esa categoría antes de continuar y revisa plantillas y asociación.

No repitas análisis de forma continua ante un error de cuota: puede aumentar costes o agravar el límite del proveedor.

Privacidad, seguridad y calidad#

• Holidario aplica Presidio a cada mensaje nuevo del usuario en Soporte interno, tokeniza los valores detectados únicamente para campos de búsqueda autorizados de solo lectura y bloquea el resto de información personal o sensible detectada.
• Análisis de Conversaciones sustituye los identificadores personales detectados por marcadores no reversibles antes de construir la solicitud a OpenRouter y bloquea el envío si el servicio local de Presidio no está disponible.
• Holidario exige un endpoint ZDR sin fallback, pero la conservación dentro de OpenRouter también depende de que el tenant mantenga desactivado Input & Output Logging y los cuatro controles de Data Training indicados arriba.
• Revisa contrato, región, conservación, uso para entrenamiento y acuerdo de tratamiento de OpenRouter y del endpoint final.
• No incluyas contraseñas, códigos de acceso ni documentos personales en conversaciones usadas solo para probar.
• La clave se guarda cifrada, pero debe rotarse si una persona no autorizada pudo verla.
• Los modelos pueden inventar, omitir o clasificar mal información, incluso cuando el texto parece claro.
• Revisa el consumo en OpenRouter; Holidario no sustituye sus límites ni alertas de presupuesto.

Qué enviar a soporte#

Escribe a [email protected] e incluye equipo, reserva, modelo, hora y zona horaria, acción realizada y error visible. Si falta un análisis de estancia en curso, añade también las fechas de estancia y las horas del último mensaje y del último análisis. Puedes aportar un fragmento anonimizado que conserve el problema. No envíes la clave API ni toda la conversación si no es imprescindible.