Skip to main content
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: 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:
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:
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.
Propuesta de la acción de precios de Lana con los controles Approve y Reject.

Revisa la acción de precios antes de elegir Approve (Aprobar) o Reject (Rechazar). La conversación del ejemplo está en español y los controles del dashboard, en inglés.

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:
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.
Lana informa cuatro departamentos disponibles y dos totales de estancia, con cargos de alojamiento y limpieza.

Pruebas directas completadas por Lana: disponibilidad y dos cotizaciones de estancia, con ambas acciones limitadas a Playground.

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:
El agente debe pedir llegada, salida y número de huéspedes antes de consultar Hostaway. Después envía:
Revisa los recibos de disponibilidad y precios y compáralos con la respuesta. Este es un ejemplo de cotización para dos noches:
Playground muestra los primeros dos departamentos disponibles con totales de MXN 7,436 y MXN 11,273.

Respuesta de Playground con las acciones creadas por Lana, totales de estancia y desglose de cargos.

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:
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.
Playground confirma disponibilidad para la estancia modificada y muestra totales nuevos de MXN 6,700 y MXN 9,451.

Las nuevas fechas y número de huéspedes producen totales nuevos del proveedor para los mismos departamentos.

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

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:
Usa la tarea del cliente para decidir qué acciones pedirle a Lana que investigue: 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.

Guía de Lana

Revisa acceso, aprobaciones, progreso, descargas y créditos.

Prueba tu agente

Aprende a inspeccionar la conversación del huésped y sus resultados registrados en Playground.