Cómo gestionar tus anuncios de villas con un agente de IA
Conecta Claude Code, Codex, OpenClaw o Hermes a VillaSlot para consultar tus villas, comprobar la disponibilidad y gestionar reservas con una clave API de tu organización.
Un cliente busca una villa para una sesión de fotos de dos horas. Antes de responder, debes consultar la disponibilidad, comprobar el precio y asegurarte de que queda tiempo suficiente para preparar el espacio. Esa información ya está en VillaSlot. Un agente de IA puede consultarla por ti y preparar los siguientes pasos a partir de tu petición.
Para empezar necesitas dos cosas: el skill VillaSlot y una clave API de tu organización. El skill explica al agente cómo utilizar la aplicación. La clave le da acceso a tus datos con tus permisos.
Qué puede hacer el agente
El agente trabaja con las fichas de villas y las reservas de VillaSlot. No publica automáticamente tus anuncios en Airbnb ni en otras plataformas.
| Tu petición | Qué puede hacer el agente en VillaSlot |
|---|---|
| «Muéstrame mis villas» | Listar los espacios y consultar su información |
| «Actualiza este anuncio» | Cambiar el nombre de una villa o añadir una foto |
| «¿Qué horarios están libres?» | Consultar horarios de apertura, duraciones con tarifa y disponibilidad |
| «Prepara esta reserva» | Buscar al cliente y crear una reserva por horas según tus instrucciones |
| «El cliente quiere cambiar la hora» | Comprobar otro horario y mover la reserva |
| «Aquí está mi archivo de clientes» | Preparar e importar las fichas que autorices |
Crear o modificar villas y tarifas requiere el rol de propietario o administrador. Los miembros conservan las operaciones de clientes y reservas que permiten sus permisos.
1. Instalar el skill VillaSlot
En el terminal del entorno donde trabaja tu agente, ejecuta:
npx skills add https://github.com/mikecodeur/skills --skill villaslotElige tu agente en el instalador. Hay guías detalladas para Claude Code, Codex, OpenClaw y Hermes. La documentación de agentes está en inglés.
Si tu agente se ejecuta en un servidor, instala el skill allí. Instalarlo en tu ordenador no configura automáticamente un entorno remoto.
2. Generar una clave API
Inicia sesión en VillaSlot y abre Cuenta → Claves API. Crea una clave para la organización cuyas villas quieres gestionar.
Haz que la clave esté disponible en el entorno del agente como VILLASLOT_API_KEY. Configura también la dirección del servicio:
export VILLASLOT_BASE_URL="https://www.villaslot.io"3. Empezar con una consulta
Antes de solicitar un cambio, comprueba que el agente accede a la organización correcta:
Utiliza el skill villaslot y la clave API de tu entorno.
Indica el nombre y la zona horaria de mi organización y después lista
mis villas activas con sus duraciones y tarifas. No modifiques nada.Esta primera petición permite comprobar el contexto. El agente debe usar la zona horaria de la organización para los horarios, aunque tu ordenador esté en otro país.
4. Convertir una petición de un cliente en una reserva
Indica una fecha concreta, una duración y el espacio deseado:
Busca un horario de dos horas en Garden Villa el 20 de octubre de 2026,
a partir de las 10:00 en la zona horaria de la organización. Muestra
la disponibilidad y el precio. Espera mi elección antes de crear la reserva.Cuando elijas un horario, pide al agente que busque al cliente o cree su ficha e indica si la reserva debe ser provisional o confirmada. Una reserva provisional ya puede bloquear el horario: no es solo un borrador de conversación.
El servidor vuelve a comprobar la disponibilidad al crear la reserva. Si alguien ha reservado mientras tanto, el agente debe proponer otra opción en lugar de repetir el mismo intento.
Cambiar tarifas sin perder el resto de la tabla
Cuando cambies un precio, especifica lo que se debe conservar:
Lee la tabla completa de tarifas de Garden Villa. Prepara la tarifa
de dos horas a 1 500 000 IDR, conserva las demás duraciones y muéstrame
la tabla antes de guardarla.La API sustituye la tabla completa. Los horarios de apertura funcionan igual: omitir un día lo deja cerrado. Una instrucción precisa evita que un pequeño cambio elimine datos útiles.
Qué sigue en la aplicación
La API actual no permite registrar pagos manuales, cobrar mediante Stripe, realizar reembolsos ni crear reservas de noches. Confirmar una reserva no significa que esté pagada. Estas operaciones siguen en los flujos correspondientes de la aplicación.
Para una importación, solicita un informe de coincidencias y filas rechazadas. El agente debe guardar los identificadores creados para evitar duplicados tras una interrupción. No existe un parámetro API para desactivar los correos: si la importación debe ser silenciosa, configura primero los ajustes de envío en la aplicación.
Un primer uso sencillo
Empieza con una tarea que conozcas bien: consultar las reservas de mañana o comprobar la disponibilidad de una villa. Compara el resultado con tu calendario y amplía poco a poco las operaciones que delegas al agente.
La guía de Agentes reúne la instalación y los ejemplos de conexión. Mantienes las mismas villas, clientes y reglas; el agente es otra forma de trabajar con tu organización.