> ## Documentation Index
> Fetch the complete documentation index at: https://docs.visitoai.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Ejemplo: añade una integración personalizada con Lana
> Usa Hostaway como ejemplo y adapta el mismo flujo de investigación, configuración de acciones y pruebas en Playground a tu propio sistema.
Cuéntale a Lana qué necesita hacer tu agente de atención al cliente con otro sistema. Lana puede investigar la documentación pública del proveedor, preparar acciones compatibles en Visito y probar sus respuestas con tu aprobación.
Este ejemplo muestra el flujo con **disponibilidad y precios de estancias en Hostaway**. Sigue los mismos pasos para tu propio caso de uso: describe el resultado, revisa las acciones propuestas, coordina el ingreso privado de credenciales y comprueba la respuesta en Playground. Reemplaza el proveedor, la tarea del cliente y los datos de prueba por los tuyos. No necesitas escribir los esquemas de las acciones.
## Antes de empezar
* Selecciona el negocio correcto e inicia sesión como administrador registrado con acceso a Lana.
* Ten acceso autorizado a la API del sistema externo. Un administrador u operador de soporte tendrá que ingresar sus credenciales de forma privada.
* Empieza con una prueba acotada. El ejemplo de Hostaway consulta disponibilidad y cotizaciones, sin reservas, bloqueos de fechas ni mensajes a clientes.
Una integración suele necesitar varias acciones. En este ejemplo:
| Acción | Qué hace | Qué necesita el agente |
| - | - | - |
| Disponibilidad | Busca departamentos disponibles para una estancia y devuelve sus IDs | Llegada, salida y número de huéspedes |
| Precio de estancia | Obtiene el total y desglose de cargos de un departamento devuelto | ID del departamento y los mismos datos de estancia |
El agente combina los resultados durante la conversación. El precio base de un alojamiento no es una cotización para la estancia solicitada.
## 1. Pide a Lana que conecte tu sistema
Abre **Lana**, inicia un chat y describe el resultado con tus propias palabras. Por ejemplo:
```text theme={null}
Hola Lana. Uso Hostaway para administrar mis departamentos y quiero conectarlo
a Visito. No sé programar. Quiero que el agente diga a los huéspedes qué
departamentos están disponibles y cuánto cuesta una estancia según sus fechas
y número de huéspedes. Ayúdame a configurarlo solo para pruebas. No crees
reservas, no bloquees fechas ni envíes mensajes a clientes.
```
Puedes indicar el sistema sin proporcionar la URL de su documentación. Pide a Lana que use fuentes oficiales y explique lo que no pueda verificar. Si tienes una versión de API o enlace de documentación específico, inclúyelo.
Lana revisa la configuración de tu negocio y la documentación del proveedor para identificar las opciones de conexión. Puedes pedirle que compruebe si una conexión directa es adecuada para tu flujo:
```text theme={null}
Empezamos desde cero y no tenemos un servicio intermediario.
¿Puedes comprobar si las acciones personalizadas actuales de Visito permiten
conectarlo directamente? Explica qué es compatible y qué ayuda necesitas
todavía de nosotros. Mantén todo limitado a pruebas de disponibilidad y precios.
```
Lana puede explicar qué solicitudes corresponden a acciones de Visito y si tu flujo necesita un adaptador o trabajo técnico adicional.
## 2. Revisa las acciones propuestas
Lana prepara las acciones y pide tu aprobación para cada cambio de configuración. Revisa el negocio seleccionado, propósito, destino, datos de entrada y efectos previstos. En este ejemplo, ambas acciones deben ser **de solo lectura** y estar inicialmente **Desactivadas** mientras falte la autenticación.
El ejemplo usa los nombres `hostaway_disponibilidad_prueba` y `hostaway_precio_prueba`. Los tuyos pueden ser distintos. Confirma que la acción de disponibilidad pase a precios los IDs reales de los departamentos devueltos y que ambas usen las mismas fechas y número de huéspedes.
Selecciona **Rechazar** si hay que cambiar la propuesta. Aprobar una acción no aprueba la siguiente ni una prueba posterior con el proveedor. Una configuración guardada todavía no demuestra que la conexión funcione.
## 3. Añade las credenciales en los ajustes privados
No pongas contraseñas, claves API ni tokens de acceso en el chat de Lana, las instrucciones de la acción o su esquema de entradas.
Un administrador autorizado u operador de soporte debe obtener el token de acceso adecuado del proveedor y guardarlo en los ajustes privados de **Autenticación** de la acción. Sigue el proceso de acceso del proveedor: una clave API y un token de acceso no siempre son intercambiables. Para autenticación Bearer en el editor de acciones HTTP, ingresa el token sin el prefijo `Bearer `.
Guarda el token de acceso en los ajustes privados de autenticación de ambas acciones. Si necesitas ayuda para obtenerlo o configurar la autenticación, contacta a tu administrador o a Soporte de Visito.
Después de guardar la autenticación, vuelve al mismo chat:
```text theme={null}
El token de acceso a Hostaway ya está guardado en los ajustes privados de
autenticación de ambas acciones. Habilítalas solo para Playground y prueba
del 1 al 3 de noviembre de 2026 para 2 huéspedes. Busca los primeros dos
departamentos disponibles y consulta el total de cada estancia.
No crees reservas ni envíes mensajes a clientes.
```
Usa fechas futuras adecuadas para tu propia prueba. Lana puede verificar si la autenticación está configurada sin recibir el token en el chat.
## 4. Aprueba las pruebas con el proveedor
Lana propone habilitar el modo **Solo área de pruebas** y solicita por separado cada prueba de acción externa. Revisa la acción, fechas, huéspedes e ID del departamento antes de aprobar.
Las acciones limitadas a Playground también contactan al proveedor real. En esta guía, las solicitudes aprobadas consultan disponibilidad y calculan cotizaciones. No reservan un departamento.
Pide a Lana que resuma la respuesta de disponibilidad, identifique los IDs de los departamentos devueltos y los use para consultar precios. Si una respuesta está incompleta o recortada, pídele que inspeccione la ejecución y el diagnóstico guardados antes de proponer otra solicitud.
Revisa los resultados de disponibilidad y precios, incluidos los datos faltantes o errores. Cuando las acciones devuelvan los resultados esperados, comprueba la conversación completa del huésped en Playground.
## 5. Prueba la conversación del huésped en Playground
Abre **Playground** para el mismo negocio y comprueba cómo usa las acciones tu agente durante una conversación.
Empieza sin indicar los datos de estancia:
```text theme={null}
Hola, ¿qué departamentos tienen disponibles y cuánto cuesta una estancia?
```
El agente debe pedir llegada, salida y número de huéspedes antes de consultar Hostaway. Después envía:
```text theme={null}
Del 1 al 3 de noviembre de 2026, para 2 huéspedes. Muéstrame los primeros
dos departamentos disponibles y el total de cada estancia, incluidos
los cargos devueltos.
```
Revisa los recibos de disponibilidad y precios y compáralos con la respuesta. Este es un ejemplo de cotización para dos noches:
| Departamento | Alojamiento | Limpieza | Total de estancia |
| - | -: | -: | -: |
| De Lujo Moderno Narvarte Planta Baja | MXN 7,036 | MXN 400 | **MXN 7,436** |
| Minimalista En Planta Baja Narvarte | MXN 10,873 | MXN 400 | **MXN 11,273** |
Estos precios de ejemplo ilustran la respuesta. La disponibilidad y los precios dependen de las fechas, huéspedes y tarifas actuales de Hostaway. Las consultas de disponibilidad y precios no crean una reserva.
## 6. Cambia los datos de estancia
Comprueba que el agente obtenga resultados nuevos en lugar de repetir la cotización anterior:
```text theme={null}
Mejor del 10 al 13 de noviembre de 2026 para 3 huéspedes. ¿Esos mismos
dos departamentos siguen disponibles y cuál sería el nuevo total
de cada estancia?
```
El agente debe volver a consultar disponibilidad y solicitar precios nuevos para los mismos IDs de departamentos. En este ejemplo, los totales actualizados son **MXN 6,700** y **MXN 9,451**, incluidos los cargos devueltos por huésped adicional y limpieza.
Compara la nueva respuesta con los resultados más recientes de las acciones. Confirma que cada total mostrado use el departamento, fechas, huéspedes, moneda y cargos incluidos correctos.
## Si algo no funciona
| Qué ves | Qué hacer |
| - | - |
| La autenticación falta o se rechaza | Revisa los ajustes privados de autenticación y el token con un administrador autorizado u operador de soporte. No pegues credenciales en el chat. |
| La acción está guardada pero nunca se llama | Revisa el modo, alcance del negocio, propósito y entradas obligatorias. Pide a Lana que inspeccione su configuración actual. |
| Aparece un precio base fijo en lugar del total de estancia | Pide a Lana que inspeccione las llamadas guardadas de disponibilidad y precios y verifique que la respuesta use la cotización del mismo departamento, fechas y huéspedes. |
| Una respuesta se recorta o una solicitud falla | Pide a Lana que inspeccione la ejecución y diagnóstico guardados, indique lo que falta y proponga el siguiente paso. Un error de API no significa que no haya disponibilidad. |
Mantén las acciones en **Solo área de pruebas** mientras revisas las respuestas. Cuando estés listo, confirma el alcance del negocio y cámbialas a **Activa** para usarlas en conversaciones con clientes. Elige **Inactiva** para pausar nuevas llamadas.
## Adapta el ejemplo a tu propio flujo
Empieza con este mensaje y reemplaza los datos entre corchetes:
```text theme={null}
Uso [sistema] y quiero que nuestro agente de Visito [tarea del cliente].
Investiga la documentación oficial y revisa nuestra configuración actual en Visito.
Explica qué acciones necesitamos, cómo se combinan y qué credenciales debemos
ingresar de forma privada. Prepáralas para pruebas en Playground y pide aprobación
antes de cada cambio de configuración o prueba externa.
Usa [datos de ejemplo] y compara la respuesta con los resultados de las acciones.
No hagas reservas ni compras, ni envíes mensajes a clientes durante esta prueba.
```
Usa la tarea del cliente para decidir qué acciones pedirle a Lana que investigue:
| Caso de uso | Acciones que investigar | Qué variar en Playground |
| - | - | - |
| Citas | Buscar tipos de cita y horarios disponibles | Servicio, fecha, zona horaria y duración |
| Inventario y precios | Buscar el producto, consultar existencias y obtener su precio | Variante del producto, cantidad y ubicación |
| Estado de un pedido | Buscar el pedido del cliente autorizado y consultar su estado | Referencia del pedido y datos del cliente |
Como en el ejemplo de Hostaway, pasa los IDs devueltos por una acción a la siguiente y mantén los datos compartidos consistentes. Prueba primero una solicitud con información faltante, luego una completa y después datos modificados. Compara cada respuesta con los resultados más recientes antes de activar el flujo.
El proveedor necesita una API y un método de acceso compatibles con Visito. Cada flujo tiene sus propias acciones y requisitos de acceso; las dos acciones de Hostaway corresponden a este ejemplo. Pide a Lana que explique la conexión propuesta y si necesita acciones adicionales, un adaptador o ayuda técnica.
Revisa acceso, aprobaciones, progreso, descargas y créditos.
Aprende a inspeccionar la conversación del huésped y sus resultados registrados en Playground.
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.