Codex

Connectez Codex à VillaSlot pour passer en revue vos annonces de villas, travailler sur vos fiches clients et gérer vos réservations à l’heure depuis l’espace de travail de votre agent. Le skill fournit le contrat de l’API et les règles de fonctionnement, dont les fuseaux horaires, les tarifs et les frontières entre organisations.

Installer le skill pour Codex

Lancez l’installateur depuis l’espace de travail que vous utilisez avec Codex :

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

Choisissez Codex quand l’installateur le demande. Pour le sélectionner explicitement :

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

Ouvrez une nouvelle session Codex dans cet espace de travail et demandez-lui d’utiliser le skill villaslot. Le skill décrit l’intégration ; votre environnement d’exécution a toujours besoin d’un accès réseau et d’une clé API VillaSlot.

Créer votre clé API VillaSlot

Ouvrez VillaSlot → Compte → Clés API et générez une clé pour l’organisation à gérer. Transmettez-la de façon sécurisée à l’environnement d’exécution de Codex sous le nom VILLASLOT_API_KEY, puis définissez :

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

Cette clé est une clé VillaSlot, pas une clé API OpenAI. Gardez-la hors des fichiers versionnés. Un environnement d’agent hébergé doit recevoir sa propre configuration de secrets ; il n’hérite pas automatiquement des variables de votre shell local.

Passer d’abord vos annonces en revue

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 peut comparer les résultats et vous dire quelles villas sont prêtes pour les réservations à l’heure. Une villa a besoin à la fois d’horaires d’ouverture et d’un tarif pour la durée demandée.

Préparer un import de clients

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.

Une fois l’import autorisé, les lots de clients peuvent contenir jusqu’à 200 lignes. Certaines lignes peuvent réussir pendant que d’autres échouent. Demandez à Codex d’enregistrer les identifiants renvoyés et de signaler les lignes en échec à part, pour qu’une nouvelle tentative ne recrée pas les fiches déjà enregistrées.

Importer un client ou une réservation est une écriture. L’API v1 n’a ni option pour supprimer les emails ni endpoint d’import de paiements. Si un import doit rester silencieux, configurez les réglages d’envoi dans l’application avant de le lancer.

Gérer les réservations

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.

Une fois autorisé, Codex peut utiliser l’UUID de la réservation pour la déplacer. Le serveur revérifie la disponibilité, les permissions et l’état de la réservation. Confirmer ou terminer une réservation n’enregistre aucun paiement ; utilisez l’application pour les paiements en espèces, par virement ou via Stripe.

Résoudre une opération refusée

Demandez à Codex de rapporter le statut HTTP et la raison, sans afficher le secret. Un 401 désigne l’accès de la clé ; un 409 peut signaler un conflit de créneau ou une limite de l’offre. Après un délai d’attente réseau pendant une création, relisez et rapprochez le résultat avant de réessayer : l’API v1 n’a pas de contrat public de clé d’idempotence.

Poursuivez avec Agents, la référence de l’API, ou la documentation des skills d’OpenAI.