Desenvolvedores

Implemente uma API e o seu sistema de reservas vende em qualquer canal conversacional.

Você hospeda uma API de dez endpoints e o Bota a chama ao vivo em cada conversa: disponibilidade, preços, extras e a reserva. Sem sincronizar estoque, sem filas e sem nada para instalar. Implemente você mesmo com o contrato e o validador à frente, ou deixe o seu agente de IA implementar.

Referência da APIGuia para agentes (Markdown)

Não é mais um chatbot

Se a sua locadora tem sistema próprio, não construa o chatbot: conecte-o.

Um chatbot feito do zero conversa. A Bota vende: conhece a locação de veículos, cota com as suas tarifas reais, aplica as suas regras e confirma a reserva no seu sistema, em qualquer canal conversacional e no idioma de cada cliente.

Três formas de integrar

O seu sistema já está integrado

Karve, Wheelsys, Rently, RentHub, Rentsyst e HQ Rental Software. Sem código: cria a conta, conecta o seu acesso e opera em minutos.

Ver integrações

Você tem sistema próprio

Você hospeda a API padrão do Bota (dez endpoints JSON sobre HTTPS) e o Bota a chama. Contrato OpenAPI 3.1, exemplos reais em cada endpoint e validador com o mesmo esquema que usamos em produção.

Ver o contrato OpenAPI

O seu agente de IA integra por você

Cada vez mais locadoras programam o próprio sistema com Claude Code, Codex, Antigravity ou Cursor. O guia foi escrito para que esse mesmo agente conecte o seu sistema ao Bota do início ao fim, e só peça uma coisa a você: criar a conta.

Ver o guia para agentes

Como funciona a API padrão

  1. 1

    Registre um sandbox

    Uma chamada, sem conta: você recebe a chave do sandbox, o token que o Bota enviará ao seu endpoint e o link de conversão. Expira em 30 dias.

    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

    Implemente os endpoints

    Oito obrigatórios e dois opcionais. Autenticação Bearer, dinheiro em centavos, moeda ISO-4217, horários no fuso de cada agência. Exemplos copiáveis em cada um.

  3. 3

    Verifique a partir do Bota

    O Bota chama a sua URL e valida cada resposta com o mesmo contrato que aplica em produção. O relatório diz qual campo falha. Repita até passar; opcionalmente teste o ciclo de reserva.

    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

    Entre em produção

    A pessoa responsável abre o link de conversão e cria a conta com o mesmo email: o endpoint verificado fica conectado. Depois, o agente pode criar o chat web; WhatsApp e telefone se conectam pelo painel.

Os dez endpoints

Contrato v1.5.0

Os ids se encadeiam: a agência de /offices entra em /availability; a oferta escolhida leva groupId, tariffId e rateRef a /bookings; tariffId abre /extras, /concepts e /rate-rules.

MétodoRotaO que fazObrigatório
GET/healthHealth checkSim
GET/officesList officesSim
POST/availabilitySearch availabilitySim
GET/extrasList available extrasSim
GET/conceptsList rate concepts (schema v2, optional)Opcional
POST/rate-rulesBulk rate rules (preferred)Opcional
POST/bookingsCreate bookingSim
GET/bookings/{bookingId}Get booking detailSim
POST/bookings/{bookingId}/cancelCancel bookingSim
POST/bookings/{bookingId}/modifyModify booking datesSim

Para agentes de IA

Peça ao seu agente e deixe-o trabalhar

O guia foi escrito para máquinas: passos em ordem, URLs absolutas, exemplos copiáveis e um único ponto em que é preciso uma pessoa. Claude Code, Codex, Antigravity, Cursor ou o harness que você usar pode concluir a integração sozinho.

  • Registra o sandbox e guarda as duas chaves.
  • Implementa e verifica até todos os checks passarem.
  • Entrega um link a você e você cria a conta com o seu email.
  • Cria o chat web com a chave e o snippet para o seu site.

Cole esta frase no seu agente.

Leia https://www.bota-chat.com/api/public/provider-api-guide e siga os passos para integrar o meu sistema de reservas ao Bota.
https://www.bota-chat.com/api/public/provider-api-guide

Servidor MCP

Para agentes que vendem, não que integram

Model Context Protocol sobre HTTP, sem estado. Descobre as empresas que vendem com o Bota, lista as suas agências, busca disponibilidade com o mesmo preço do chat web delas e, nas empresas que permitem, completa a reserva: extras, dados do condutor e confirmação no sistema delas.

Endpoint
https://mcp.bota-chat.com/mcp
Ferramentas
list_rental_companieslist_officessearch_availabilitychatselect_offerselect_extrasprovide_customer_detailsconfirm_booking
Configuração do cliente
{
  "mcpServers": {
    "bota": { "url": "https://mcp.bota-chat.com/mcp" }
  }
}

Experimente

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

A empresa demo está sempre disponível e as suas reservas são fictícias. As empresas reais decidem se aceitam reservas de agentes; se não, o agente apresenta a cotação e o contato delas.

Entradas para máquinas

Tudo o que o seu agente precisa, em URLs estáveis

Nenhuma exige conta nem chave para ser lida. Se você passar só uma para o seu agente, que seja o guia: as outras ele encontra a partir dali.

Tanto faz o agente: Claude Code, Codex, Antigravity ou Cursor leem estas mesmas URLs. Elas foram feitas para não mudar, então você pode deixá-las escritas nos seus prompts ou na sua documentação interna.

Proteções

  • Somente tráfego HTTPS para endereços públicos: a URL do seu sandbox passa por um filtro anti-SSRF e o Bota nunca segue redirecionamentos.
  • Os segredos são mostrados uma única vez e guardados como hash ou cifrados. O link de conversão só funciona com o email do registro.
  • Cotas por IP, por sandbox e por empresa no sandbox e no MCP: cada consulta custa uma chamada a um sistema de reservas e um turno de IA.
  • O chat web criado por um agente só funciona a partir das origens do seu site; as reservas de agentes são atribuídas a um canal próprio e seguem as regras da empresa.

Perguntas frequentes

Preciso de uma conta no Bota para começar a integrar?

Não. O sandbox é registrado com um email e devolve as chaves na hora. A conta é criada no final, quando a integração já está verificada, com o link de conversão.

Um agente de IA pode fazer isso sem uma pessoa?

Tudo menos um passo: criar a conta e aceitar as condições comerciais é feito por uma pessoa com o link que o agente entrega. Depois, o agente pode criar o chat web. WhatsApp e telefone exigem o titular no painel (Meta e Telnyx).

E se o meu sistema já está na lista de integrações?

Não é preciso programar nada: cria a conta, conecta o seu acesso e o Bota opera em minutos. O guia para agentes verifica isso antes de escrever código.

O preço do servidor MCP é o mesmo do chat web?

Sim. Cada busca do MCP é um turno do mesmo motor que o chat web da empresa usa, com as suas taxas obrigatórias, regras de horário e trajetos só de ida.

Quanto custa?

Integrar é grátis. O Bota é pago por reserva confirmada, sem taxa de adesão e sem fidelidade. As condições são aceitas ao criar a conta.

A sua locadora pode estar operando com o Bota esta semana.

Com o seu sistema de reservas já integrado ou com o que você construiu.

Criar contaFalar conosco