Développeurs

Implémentez une seule API et votre système de réservation vend sur tous les canaux conversationnels.

Vous hébergez une API de dix endpoints et Bota l’appelle en direct à chaque conversation : disponibilités, tarifs, options et réservation. Pas de synchronisation d’inventaire, pas de files d’attente, rien à installer. Implémentez-la vous-même, le contrat et le validateur sous les yeux, ou confiez-la à votre agent IA.

Pas un chatbot de plus

Si votre agence de location a son propre système, ne construisez pas le chatbot : connectez-le.

Un chatbot construit de zéro discute. Bota vend : il connaît la location de voitures, établit des devis avec vos vrais tarifs, applique vos règles et confirme la réservation dans votre système, sur n’importe quel canal conversationnel et dans la langue de chaque client.

Comment fonctionne l’API standard

  1. 1

    Enregistrez une sandbox

    Un seul appel, sans compte : vous obtenez la clé de la sandbox, le jeton que Bota enverra à votre endpoint et le lien de revendication. Elle expire au bout de 30 jours.

    curl -sS -X POST https://www.bota-chat.com/api/public/developers/sandbox \
      -H 'Content-Type: application/json' \
      -d '{"email":"owner@your-rentacar.com","company":"Your Rent a Car","baseUrl":"https://api.your-rentacar.com/bota"}'
  2. 2

    Implémentez les endpoints

    Huit obligatoires et deux facultatifs. Authentification Bearer, montants en centimes, devise ISO-4217, heures dans le fuseau horaire de chaque agence. Des exemples prêts à copier pour chacun.

  3. 3

    Vérifiez depuis Bota

    Bota appelle votre URL et valide chaque réponse avec le même contrat qu’en production. Le rapport indique le champ en échec. Recommencez jusqu’à ce que tout passe ; vous pouvez aussi tester le cycle de vie de la réservation.

    curl -sS -X POST https://www.bota-chat.com/api/public/developers/sandbox/{id}/verify \
      -H 'Authorization: Bearer bota_sbx_…' \
      -H 'Content-Type: application/json' \
      -d '{"includeBookings": false}'
  4. 4

    Passez en production

    Le responsable ouvre le lien de revendication et crée le compte avec le même e-mail : l’endpoint vérifié est connecté. L’agent peut ensuite créer le chat web ; WhatsApp et le téléphone se connectent depuis le tableau de bord.

Les dix endpoints

Contrat v1.5.0

Les identifiants s’enchaînent : l’agence issue de /offices va dans /availability ; l’offre choisie transmet groupId, tariffId et rateRef à /bookings ; tariffId sert de clé à /extras, /concepts et /rate-rules.

MéthodeCheminRôleObligatoire
GET/healthHealth checkOui
GET/officesList officesOui
POST/availabilitySearch availabilityOui
GET/extrasList available extrasOui
GET/conceptsList rate concepts (schema v2, optional)Facultatif
POST/rate-rulesBulk rate rules (preferred)Facultatif
POST/bookingsCreate bookingOui
GET/bookings/{bookingId}Get booking detailOui
POST/bookings/{bookingId}/cancelCancel bookingOui
POST/bookings/{bookingId}/modifyModify booking datesOui

Pour les agents IA

Demandez à votre agent et laissez-le travailler

Le guide est écrit pour les machines : étapes ordonnées, URL absolues, exemples prêts à copier et un seul moment où une personne est nécessaire. Claude Code, Codex, Antigravity, Cursor ou l’environnement que vous utilisez peut mener l’intégration à bien tout seul.

  • Enregistre la sandbox et conserve les deux clés.
  • Implémente et vérifie jusqu’à ce que tous les contrôles passent.
  • Vous remet un lien et vous créez le compte avec votre e-mail.
  • Crée le chat web avec la clé et le snippet pour votre site.

Collez cette phrase dans votre agent.

Lis https://www.bota-chat.com/api/public/provider-api-guide et suis ses étapes pour intégrer mon système de réservation à Bota.
https://www.bota-chat.com/api/public/provider-api-guide

Serveur MCP

Pour les agents qui vendent, pas qui intègrent

Model Context Protocol sur HTTP, sans état. Découvrez les entreprises qui vendent avec Bota, listez leurs agences, recherchez les disponibilités au même prix que dans leur chat web et, si l’entreprise l’autorise, finalisez la réservation : options, coordonnées du conducteur et confirmation dans son système.

Endpoint
https://mcp.bota-chat.com/mcp
Outils
list_rental_companieslist_officessearch_availabilityask_companyselect_offerselect_extrasprovide_customer_detailsconfirm_bookingget_booking_statuscancel_booking
Configuration du client
{
  "mcpServers": {
    "bota": { "url": "https://mcp.bota-chat.com/mcp" }
  }
}

Essayer

curl -sS -X POST https://mcp.bota-chat.com/mcp \
  -H 'Content-Type: application/json' -H 'Accept: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

L’entreprise de démo est toujours disponible et ses réservations sont fictives. Les vraies entreprises décident si elles acceptent les réservations d’agents ; sinon, l’agent présente le devis et leurs coordonnées.

https://www.bota-chat.com/en/developers/mcp

Points d’entrée pour les machines

Tout ce dont votre agent a besoin, sur des URL stables

Aucune ne nécessite de compte ni de clé pour être lue. Si vous ne donnez qu’une seule URL à votre agent, que ce soit le guide : il trouvera le reste à partir de là.

Quel que soit votre agent, Claude Code, Codex, Antigravity ou Cursor lisent ces mêmes URL. Elles sont conçues pour ne pas changer : vous pouvez les laisser écrites dans vos prompts ou votre documentation interne.

Garde-fous

  • Trafic HTTPS vers des adresses publiques uniquement : l’URL de votre sandbox passe par un filtre anti-SSRF et Bota ne suit jamais les redirections.
  • Les secrets sont affichés une seule fois et stockés hachés ou chiffrés. Le lien de revendication ne fonctionne qu’avec l’e-mail utilisé lors de l’enregistrement.
  • Quotas par IP, par sandbox et par entreprise sur la sandbox et le MCP : chaque requête coûte un appel à un système de réservation et un tour d’IA.
  • Un chat web créé par un agent ne fonctionne que depuis les origines de votre site ; les réservations d’agents sont attribuées à leur propre canal et suivent les règles de l’entreprise.

Questions fréquentes

Ai-je besoin d’un compte Bota pour commencer l’intégration ?

Non. La sandbox s’enregistre avec un e-mail et renvoie les clés immédiatement. Le compte est créé à la fin, une fois l’intégration vérifiée, via le lien de revendication.

Un agent IA peut-il le faire sans personne ?

Tout sauf une étape : la création du compte et l’acceptation des conditions commerciales sont faites par une personne, avec le lien que lui remet l’agent. Ensuite, l’agent peut créer le chat web. WhatsApp et le téléphone nécessitent le titulaire du compte dans le tableau de bord (Meta et Telnyx).

Et si mon système figure déjà dans la liste des intégrations ?

Rien à coder : créez le compte, connectez vos accès et Bota est opérationnel en quelques minutes. Le guide pour agents le vérifie avant d’écrire la moindre ligne de code.

Le prix donné par le serveur MCP est-il le même que celui du chat web ?

Oui. Chaque recherche MCP est un tour du même moteur que celui du chat web de l’entreprise, avec ses frais obligatoires, ses règles horaires et sa gestion des allers simples.

Combien cela coûte-t-il ?

L’intégration est gratuite. Bota se paie par réservation confirmée, sans frais de mise en place ni engagement. Les conditions sont acceptées lors de la création du compte.

Votre agence de location peut tourner avec Bota dès cette semaine.

Avec votre système de réservation déjà intégré, ou avec celui que vous avez développé.