Developers

Implement one API and your reservation system sells on any conversational channel.

You host a ten-endpoint API and Bota calls it live in every conversation: availability, prices, extras and the booking. No inventory sync, no queues, nothing to install. Implement it yourself with the contract and the validator in front of you, or let your AI agent do it.

Not another chatbot

If your rental company runs its own system, don't build the chatbot: connect it.

A chatbot built from scratch talks. Bota sells: it knows car rental, quotes with your real rates, applies your rules and confirms the booking in your system, on any conversational channel and in each customer’s language.

How the standard API works

  1. 1

    Register a sandbox

    One call, no account: you get the sandbox key, the token Bota will send to your endpoint and the claim link. It expires after 30 days.

    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

    Implement the endpoints

    Eight required and two optional. Bearer auth, money in cents, ISO-4217 currency, times in each office's timezone. Copy-ready examples on each one.

  3. 3

    Verify from Bota

    Bota calls your URL and validates every response with the same contract it applies in production. The report names the failing field. Repeat until it passes; optionally exercise the booking lifecycle.

    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

    Go live

    The person in charge opens the claim link and creates the account with the same email: the verified endpoint is connected. Then the agent can create the web chat; WhatsApp and phone are connected from the dashboard.

The ten endpoints

Contract v1.5.0

Ids chain: the office from /offices goes into /availability; the chosen offer carries groupId, tariffId and rateRef into /bookings; tariffId keys /extras, /concepts and /rate-rules.

MethodPathPurposeRequired
GET/healthHealth checkYes
GET/officesList officesYes
POST/availabilitySearch availabilityYes
GET/extrasList available extrasYes
GET/conceptsList rate concepts (schema v2, optional)Optional
POST/rate-rulesBulk rate rules (preferred)Optional
POST/bookingsCreate bookingYes
GET/bookings/{bookingId}Get booking detailYes
POST/bookings/{bookingId}/cancelCancel bookingYes
POST/bookings/{bookingId}/modifyModify booking datesYes

For AI agents

Ask your agent and let it work

The guide is written for machines: ordered steps, absolute URLs, copy-ready examples and a single point where a person is needed. Claude Code, Codex, Antigravity, Cursor or whichever harness you use can complete the integration on its own.

  • Registers the sandbox and keeps the two keys.
  • Implements and verifies until every check passes.
  • Hands you a link and you create the account with your email.
  • Creates the web chat with the key and the snippet for your site.

Paste this sentence into your agent.

Read https://www.bota-chat.com/api/public/provider-api-guide and follow its steps to integrate my reservation system with Bota.
https://www.bota-chat.com/api/public/provider-api-guide

MCP server

For agents that sell, not integrate

Model Context Protocol over HTTP, stateless. Discover the companies selling with Bota, list their offices, search availability at the same price as their web chat and, where the company allows it, complete the booking: extras, driver details and confirmation in their system.

Endpoint
https://mcp.bota-chat.com/mcp
Tools
list_rental_companieslist_officessearch_availabilitychatselect_offerselect_extrasprovide_customer_detailsconfirm_booking
Client configuration
{
  "mcpServers": {
    "bota": { "url": "https://mcp.bota-chat.com/mcp" }
  }
}

Try it

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"}'

The demo company is always available and its bookings are fictitious. Real companies decide whether they accept bookings from agents; otherwise the agent presents the quote and their contact.

Entry points for machines

Everything your agent needs, on stable URLs

None of them need an account or a key to read. If you only hand your agent one, make it the guide: it finds the rest from there.

Whichever agent you use: Claude Code, Codex, Antigravity or Cursor read these same URLs. They are meant not to change, so you can leave them written in your prompts or your internal docs.

Safeguards

  • HTTPS traffic to public addresses only: your sandbox URL goes through an anti-SSRF filter and Bota never follows redirects.
  • Secrets are shown once and stored hashed or encrypted. The claim link only works with the email used at registration.
  • Quotas per IP, per sandbox and per company on the sandbox and the MCP: every query costs a call to a reservation system and an AI turn.
  • A web chat created by an agent only works from your site's origins; agent bookings are attributed to their own channel and follow the company's rules.

Frequently asked questions

Do I need a Bota account to start integrating?

No. The sandbox is registered with an email and returns the keys immediately. The account is created at the end, once the integration is verified, through the claim link.

Can an AI agent do it without a person?

Everything but one step: creating the account and accepting the commercial terms is done by a person with the link the agent hands over. After that the agent can create the web chat. WhatsApp and phone require the account owner in the dashboard (Meta and Telnyx).

What if my system is already in the integrations list?

Nothing to code: create the account, connect your access and Bota operates in minutes. The guide for agents checks this before writing any code.

Is the price from the MCP server the same as the web chat's?

Yes. Every MCP search is a turn of the same engine the company's web chat uses, with its mandatory charges, time rules and one-way handling.

How much does it cost?

Integrating is free. Bota is paid per confirmed booking, with no setup fee and no lock-in. Terms are accepted when the account is created.

Your rental company can be running on Bota this week.

With your reservation system already integrated, or with the one you built.