Codex

Conecta Codex a VillaSlot para revisar los anuncios de villas, trabajar con las fichas de clientes y gestionar reservas por horas desde el espacio de trabajo de tu agente. El skill aporta el contrato de la API y las reglas de funcionamiento, incluidas las zonas horarias, los precios y los límites de la organización.

Instalar el skill para Codex

Ejecuta el instalador desde el espacio de trabajo que usas con Codex:

bash
npx skills add https://github.com/mikecodeur/skills --skill villaslot

Elige Codex cuando el instalador lo pida. Para seleccionarlo explícitamente:

bash
npx skills add https://github.com/mikecodeur/skills --skill villaslot --agent codex

Abre una nueva sesión de Codex en ese espacio de trabajo y pídele que use el skill villaslot. El skill describe la integración; tu entorno de ejecución sigue necesitando acceso a la red y una clave API de VillaSlot.

Crear tu clave API de VillaSlot

Abre VillaSlot → Cuenta → Claves API y genera una clave para la organización que quieres gestionar. Entrégala de forma segura al entorno de ejecución de Codex como VILLASLOT_API_KEY y luego define:

bash
export VILLASLOT_BASE_URL="https://www.villaslot.io"

La clave es de VillaSlot, no una clave API de OpenAI. Mantenla fuera de los archivos versionados. Un entorno de agente alojado debe recibir su propia configuración de secretos; no hereda automáticamente las variables de tu shell local.

Revisar primero tus anuncios

Use the villaslot skill. Read the organization context with the API key
in my environment. List my active villas, their opening hours and
priced durations. Identify missing rate grids without changing data.

Codex puede comparar los resultados y decirte qué villas están listas para reservas por horas. Una villa necesita tanto su horario de apertura como una tarifa para la duración solicitada.

Preparar una importación de clientes

Review this customer file for a VillaSlot import. Match existing
customers by email, list duplicates and invalid rows, and show me
what you would create before making any changes.

Cuando autorices la importación, los lotes de clientes pueden contener hasta 200 filas. Algunas filas pueden tener éxito mientras otras fallan. Pide a Codex que guarde los identificadores devueltos e informe por separado de las filas fallidas, para que un reintento no vuelva a crear las fichas ya creadas.

Importar un cliente o una reserva es una escritura. La API v1 no tiene ningún indicador para suprimir los emails ni ningún endpoint de importación de pagos. Si una importación debe ser silenciosa, configura los ajustes de envío en la aplicación antes de empezarla.

Gestionar las reservas

Find the booking for Garden Villa on 2026-10-15 at 10:00 local time.
Check whether it can move to 14:00 on the same day. Preserve its
current price and show me the proposed change before applying it.

Una vez autorizado, Codex puede usar el UUID de la reserva para reprogramarla. El servidor vuelve a comprobar la disponibilidad, los permisos y el estado de la reserva. Confirmar o completar una reserva no registra ningún pago; usa la aplicación para las operaciones de pago en efectivo, por transferencia o con Stripe.

Resolver una operación rechazada

Pide a Codex que informe del estado HTTP y del motivo, sin mostrar el secreto. Un 401 apunta al acceso de la clave; un 409 puede indicar un conflicto de franja o un límite del plan. Tras un tiempo de espera de red durante una creación, vuelve a leer y concilia el resultado antes de reintentar: la API v1 no tiene un contrato público de clave de idempotencia.

Continúa con Agentes, la referencia de la API o la documentación de los skills de OpenAI.