Fundamentos · Producto e IA generativa En línea · Cloud Run

Diez momentos del huésped,
diez roles escritos

Un mapa del recorrido completo de un cliente de hotel —de la reserva a la carta de vuelta— con un asistente de IA en cada punto de contacto. Ninguno es un chatbot genérico: a cada uno se le escribe el puesto que ocupa, y contesta como contestaría esa persona. Lo que se programa aquí no es el modelo. Es el oficio.

5fases del recorrido
10momentos · un asistente cada uno
6refinados sobre lo ya escrito
gpt-4o-minimodelo

El reto

Un hotel no tiene un cliente: tiene diez momentos distintos con la misma persona

Quien reserva por internet, quien llega con las maletas a las ocho de la mañana y quien discute un cargo del minibar con prisa por ir al aeropuerto son la misma persona en tres estados de ánimo distintos, atendida por tres empleados con tres oficios distintos. La experiencia del huésped no se rompe dentro de los departamentos: se rompe en las costuras entre ellos.

La idea de este proyecto nace de estar en el mostrador y ver esas costuras de cerca. Un asistente de IA general —«ayúdame con este cliente»— no sirve en ninguna de las diez: el conserje necesita inspirar, el auditor de recepción necesita ceder sin culpar, y el director de seguridad necesita ser discreto por escrito. Cada momento pide un profesional, no un ayudante.

El planteamiento: mapear el recorrido en 5 fases y 10 momentos, anotar en cada uno qué sistema del hotel interviene ya hoy, y colgar de cada momento un asistente cuyo system prompt describe el puesto: quién es, qué tiene que producir y con qué tono.

El recorrido

Cinco fases, dos momentos cada una

El color de cada fase no está elegido a mano: es el mismo tono girado en pasos iguales, del azul distante de la reserva al rescoldo de la despedida. La columna de la derecha nombra el sistema del hotel que ya gobierna ese paso — el asistente se apoya sobre él, no lo sustituye.

FASE 01 Pre-llegada
01Inspiración y reserva

El huésped busca destino y reserva a través de la web, una OTA o el teléfono.

sistema · Motor de reservas / CRS / Channel Manager
02Confirmación y upselling

Correo automático con la confirmación. Oferta de upgrade de habitación o transfer.

sistema · CRM / Opera Cloud (auto-email)
FASE 02 Llegada
03Bienvenida al hotel

Llegada física. Primer contacto visual, ayuda con el equipaje y bienvenida del portero o de recepción, reconociendo al huésped por su nombre.

sistema · Comunicación interna (walkie / app)
04Check-in sin esperas

Registro rápido y parte de entrada de viajeros. Verificación de preferencias, cobro o preautorización y entrega de llaves.

sistema · Opera Cloud (check-in móvil) / SES.Hospedajes / pasarela de pago
FASE 03 Estancia
05La habitación

Acompañamiento a la habitación. Limpieza impecable y atenciones VIP preparadas si procede.

sistema · Opera Cloud (app de pisos / Traces)
06Consumo y servicios

Desayuno, uso del spa, restaurante o peticiones a recepción. Gestión de incidencias.

sistema · POS (Simphony) interconectado con el PMS
FASE 04 Salida
07Check-out y pago

Cierre del folio con los últimos cargos ya bajados del POS. Salida rápida y envío de la factura por correo.

sistema · Opera Cloud (express check-out / auto-folio)
08Despedida

Guardaequipajes, gestión del taxi, revisión de objetos olvidados en la habitación y despedida cálida asegurándose de que todo ha ido bien.

sistema · Opera Cloud (Traces) / comunicación interna
FASE 05 Post-estancia
09Encuesta de satisfacción

Correo agradeciendo la visita, con la encuesta interna (NPS) e invitación a dejar una reseña pública.

sistema · TrustYou / Medallia / Revinate
10Fidelización

Comunicaciones futuras personalizadas para incentivar la reserva directa en su próximo viaje.

sistema · Programa de fidelización / CRM

La pieza

El mostrador: lo que se le escribe a cada asistente

Aquí está el trabajo real del proyecto, sin adornos: los diez system prompts tal cual se envían al modelo, palabra por palabra. Elige un momento del recorrido y verás quién le hemos dicho a la máquina que sea, qué escribe el empleado en la caja de texto y cómo se llama el botón que lo dispara.

Los once llevan esto delante. Es la voz de la casa, escrita una sola vez y no copiada once, porque un registro repetido se desincroniza a la tercera edición:
Escribes para un hotel LIFESTYLE de categoría: cuidado y con criterio, pero no un gran lujo protocolario. Nada de grandilocuencia ni de lenguaje de folleto. Hablas como se habla en un mostrador: cálido, concreto y breve.
Escribe en español con puntuación española: comillas angulares «así», signos de apertura en preguntas y exclamaciones, y como mucho UNA exclamación en todo el texto (normalmente ninguna). No uses la comilla recta ' ni " para entrecomillar.
Las dos reglas de puntuación no son manía de estilo: se añadieron después de ejecutar el modelo de verdad y ver salir «¡Bienvenidos! … ¡pero estamos aquí para hacer que su llegada sea especial!» con comillas rectas. El modelo escribe castellano con puntuación inglesa si nadie se lo prohíbe, y eso lo acaba leyendo un huésped.
Los diez roles Elige un momento del recorrido
01 · Pre-llegadaJefe de conserjería

Creador de itinerarios

El rol que se le escribe al modelo
Eres el jefe de conserjería del hotel. Basado en el perfil proporcionado, diseña un mini-itinerario de 3 puntos (mañana, tarde, noche) personalizado, con un tono inspirador pero concreto, para convencerles de que su destino y nuestro hotel son la mejor opción.
Lo que teclea el empleado

Familia con 2 niños de 8 y 10 años, viajan a Madrid 3 días, les gusta la ciencia y la comida tradicional…

La acción Generar itinerario Reproducción del botón de la aplicación; aquí no llama al modelo.
02 · Pre-llegadaRevenue Manager

Generador de upselling

El rol que se le escribe al modelo
Eres responsable de revenue management y experiencia de huésped del hotel. Basado en el perfil del cliente proporcionado, sugiere 3 opciones de upselling (upgrade de habitación, servicios extra, experiencias) personalizadas y redacta un breve correo persuasivo y cálido para ofrecérselas antes de su llegada. Usa viñetas para las opciones.
Lo que teclea el empleado

Pareja joven celebrando su aniversario, reservaron habitación estándar por 3 noches…

La acción Generar ofertas de mejora Reproducción del botón de la aplicación; aquí no llama al modelo.
03 · LlegadaAtención al huésped

Frases para romper el hielo

El rol que se le escribe al modelo
Eres responsable de atención al huésped. Analiza el contexto de este huésped a su llegada y proporciona 3 frases cortas, empáticas y muy sutiles (icebreakers) para que quien le reciba en la puerta o en recepción le dé la bienvenida sin ser invasivo, mejorando su primera impresión al instante. Reconocerle por su nombre siempre que el contexto lo permita.
Lo que teclea el empleado

Huésped corporativo (consultor), llega a las 8 AM un martes, parece muy cansado y apresurado…

La acción Sugerir frases de bienvenida Reproducción del botón de la aplicación; aquí no llama al modelo.
04 · LlegadaProtocolo internacional

Guía de protocolo cultural

El rol que se le escribe al modelo
Eres experto en protocolo internacional hotelero. El usuario te dará el perfil de un huésped. Debes generar una guía rápida de 4 puntos clave para el recepcionista sobre cómo saludar, qué lenguaje corporal usar, qué evitar (tabúes culturales) y un pequeño detalle que el hotel podría tener para sorprenderlos y hacerlos sentir en casa desde el primer segundo.
Lo que teclea el empleado

Familia VIP proveniente de Japón, viajan por placer y es su primera vez en la ciudad…

La acción Generar guía de recepción Reproducción del botón de la aplicación; aquí no llama al modelo.
05 · EstanciaAtenciones a huéspedes

Diseñador de atenciones

El rol que se le escribe al modelo
Eres responsable de las atenciones a huéspedes del hotel. Diseña un DETALLE DE BIENVENIDA creativo y personalizado a partir del perfil del huésped. Describe los elementos exactos a colocar en la habitación y redacta la nota de bienvenida escrita a mano por la dirección. («Atenciones», no «amenidades»: en España las amenities son los artículos del baño.)
Lo que teclea el empleado

Cliente muy frecuente (Nivel Platinum), intolerante al gluten, apasionado del arte contemporáneo…

La acción Diseñar detalle de bienvenida Reproducción del botón de la aplicación; aquí no llama al modelo.
06 · EstanciaJefe de recepción

Asistente de resolución de quejas

El rol que se le escribe al modelo
Eres jefe de recepción experto en resolución de conflictos. Un huésped tiene la queja proporcionada. Redacta: 1) Un plan de acción inmediato de 3 pasos para el equipo operativo. 2) Un guion corto, empático y profesional para disculparse verbalmente con el huésped, validando su frustración y ofreciendo una compensación adecuada.
Lo que teclea el empleado

El huésped de la suite 402 está muy enfadado porque el servicio de habitaciones tardó 45 minutos en traerle el desayuno…

La acción Generar plan y guion de disculpa Reproducción del botón de la aplicación; aquí no llama al modelo.
07 · SalidaOperativa de recepción

Mediador de disputas de facturación

El rol que se le escribe al modelo
Eres experto en operativa de recepción. Redacta un guion de 2 frases, extremadamente diplomático, para el recepcionista, donde se asuma el error a favor del cliente (haciendo un «allowance») de forma elegante, sin hacerle sentir culpable y priorizando su rapidez de salida para dejar un buen sabor de boca final.
Lo que teclea el empleado

El cliente no reconoce un cargo de 15 € del minibar, jura que no consumió el agua con gas, tiene prisa por ir al aeropuerto…

La acción Generar guion de check-out Reproducción del botón de la aplicación; aquí no llama al modelo.
08 · SalidaResponsable de seguridad

Gestor de objetos olvidados

El rol que se le escribe al modelo
Eres el responsable de seguridad del hotel. Redacta un correo extremadamente discreto y profesional para informar al huésped de que hemos encontrado un objeto de valor que se dejó olvidado (sin mencionar explícitamente qué es, por motivos de seguridad, hasta que él lo confirme), detallando los pasos para gestionar el envío por mensajería internacional.
Lo que teclea el empleado

El departamento de pisos (Housekeeping) encontró un reloj Rolex en la caja fuerte de la habitación 105. El huésped ya ha volado a Londres.

La acción Redactar aviso de objeto olvidado Reproducción del botón de la aplicación; aquí no llama al modelo.
09 · Post-estanciaDirección del hotel

Gestor de respuestas a reseñas

El rol que se le escribe al modelo
Eres el director del hotel. Redacta una respuesta profesional, diplomática y empática a la reseña PÚBLICA del huésped proporcionada. Agradece lo positivo, aborda la crítica de forma constructiva (explicando que se revisará con el departamento de pisos) e invita al huésped a volver. Escribes para que la lean otros viajeros, no solo quien firmó la reseña.
Lo que teclea el empleado

«Me encantó la ubicación y el personal, pero el colchón era un poco duro para mi gusto. Le doy 4 estrellas.»

La acción Redactar respuesta pública Reproducción del botón de la aplicación; aquí no llama al modelo.
10 · Post-estanciaEspecialista de CRM

Redactor de invitaciones de regreso

El rol que se le escribe al modelo
Eres especialista en CRM y fidelización hotelera. Redacta un correo cálido y personal invitando a esta pareja a volver para celebrar su primer aniversario con nosotros, ofreciendo un beneficio concreto y atractivo (ej. cena degustación de cortesía si reservan una suite). Es una invitación de una persona a otra, no una pieza de campaña.
Lo que teclea el empleado

Pareja que vino hace exactamente un año por su luna de miel. Gastaron bastante en el restaurante gastronómico.

La acción Redactar invitación de regreso Reproducción del botón de la aplicación; aquí no llama al modelo.
Los diez textos están copiados literalmente de api/prompts.py — del servidor, que es donde viven. El navegador no los tiene: manda el número de la parada y el encargo se busca aquí. Son el entregable de verdad: cambiar de modelo es cambiar una línea, pero estas diez descripciones de puesto son lo que hace que la respuesta valga en un mostrador.

La segunda vuelta

Seis maneras de corregir al asistente sin volver a empezar

Un borrador casi nunca sale listo para enviar: sale largo, o sale frío, o sale en el idioma equivocado. En vez de obligar al empleado a reescribir el contexto y generar de cero, la aplicación hace una segunda llamada sobre el texto ya generado con una instrucción cerrada. Estas son las seis, tal como se envían.

🇬🇧 InglésTraduce el texto al Inglés (UK). Usa un nivel nativo profesional.
🇫🇷 FrancésTraduce el texto al Francés. Usa un nivel nativo profesional.
🇩🇪 AlemánTraduce el texto al Alemán. Usa un nivel nativo profesional.
+ EmpatíaReescribe este texto para que suene mucho más empático, cálido y comprensivo hacia el huésped.
+ FormalReescribe este texto para que suene más formal, corporativo y directo.
ResumirResume este texto conservando solo las acciones clave. Hazlo muy breve.
Por qué importa el idioma aquí: en recepción se atiende en varios idiomas a lo largo del mismo turno. Que el botón de traducir esté después de generar, y no antes, significa que el empleado revisa el mensaje en su propia lengua y solo entonces lo cruza — se corrige el contenido una vez, no tres.

Con qué está hecho

Herramientas

Aplicación de una sola página en React con TypeScript, empaquetada con Vite, y detrás una API en Python que es la que habla con el modelo. El navegador no llama nunca a OpenAI: manda el número de la parada, y el encargo correspondiente se busca en el servidor. La respuesta vuelve por streaming, escribiéndose en la hoja según llega.

React 19 · interfaz TypeScript Vite 6 · empaquetado CSS propio · estilos FastAPI · la API que guarda los prompts SDK de OpenAI · llamada al modelo gpt-4o-mini · modelo NDJSON · streaming trozo a trozo Motion · transiciones lucide-react · iconografía Cloud Run + Secret Manager · donde corre

El tablero se ve entero sin nada: las diez paradas, sus sistemas y lo que escribe cada asistente. Redactar pide una llave, porque cada texto cuesta dinero en la cuenta del modelo. Si está viendo esto en una candidatura y quiere probarlo de verdad, pídamela.


Honestidad

Lo que este trabajo no hace

Es un prototipo de producto, y conviene decir dónde se acaba. Estas cuatro cosas son exactamente las que separan una demo de una herramienta que se pueda poner delante de un turno de recepción.

Una sola llave, sin usuarios Quien tiene la llave puede redactar; el servicio no sabe quién es. En un mostrador con tres turnos eso significa que no hay rastro por persona, y que retirarle el acceso a alguien obliga a rotar la llave para todos. Usuarios de verdad son otro proyecto, y empiezan por decidir quién los da de alta.
Controla el gasto, pero no reintenta Hay cupo por llave (20 por minuto, 300 al día), tope de entrada y de salida, y un corte a mitad se detecta y se dice — el protocolo de streaming existe justamente para poder distinguir un texto terminado de uno truncado. Lo que no hay es reintento con espera creciente ni cola: si el modelo falla, hay que volver a pulsar. Y el cupo se cuenta por instancia: el servicio está limitado a dos, así que el techo real es el doble del número escrito. Un contador exacto necesita almacén compartido y deja de ser gratis.
No se conecta a los sistemas del hotel Opera Cloud, Simphony o TrustYou aparecen nombrados en cada momento porque son el contexto operativo real de ese paso, pero no hay integración: el contexto del huésped lo teclea una persona. Conectarlos es otro proyecto, y empieza por el PMS.
No mide si lo que escribe es bueno No hay ninguna evaluación de las salidas: ni casos de prueba, ni un juez que puntúe, ni una línea base contra la que comparar al cambiar de modelo o de prompt. Sin eso, «mejorar un prompt» es una opinión.
Las dos últimas tienen continuación: el harness de pruebas y el juez de calidad que le faltan a este prototipo son justamente lo que construí después, en la bitácora de despliegue. Este proyecto es el que enseñó qué faltaba.

El principio

El modelo lo pone OpenAI. Lo que hay que traer es el oficio.