Desarrolladores

Implementa una API y tu sistema de reservas vende en cualquier canal conversacional.

Tú alojas una API de diez endpoints y Bota la llama en vivo en cada conversación: disponibilidad, precios, extras y la reserva. Sin sincronizar inventario, sin colas y sin nada que instalar. Impleméntala tú con el contrato y el validador delante, o deja que la implemente tu agente de IA.

No es otro chatbot

Si tu rent-a-car tiene su propio sistema, no construyas el chatbot: conéctalo.

Un chatbot hecho desde cero conversa. Bota vende: conoce el alquiler de vehículos, cotiza con tus tarifas reales, aplica tus reglas y confirma la reserva en tu sistema, en cualquier canal conversacional y en el idioma de cada cliente. Lo que se programa es la conexión, no la inteligencia.

Cómo funciona la API estándar

  1. 1

    Registra un sandbox

    Una llamada, sin cuenta: recibes la clave del sandbox, el token que Bota enviará a tu endpoint y el enlace de conversión. Caduca a los 30 días.

    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

    Implementa los endpoints

    Ocho obligatorios y dos opcionales. Autenticación por Bearer, dinero en céntimos, moneda ISO-4217, horas en la zona de cada oficina. Ejemplos copiables en cada uno.

  3. 3

    Verifica desde Bota

    Bota llama a tu URL y valida cada respuesta con el mismo contrato que aplica en producción. El informe dice qué campo falla. Repite hasta que pase; opcionalmente prueba el 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

    Entra en producción

    La persona responsable abre el enlace de conversión y crea la cuenta con el mismo email: el endpoint verificado queda conectado. Después, el agente puede crear el chat web; WhatsApp y teléfono se conectan desde el panel.

Los diez endpoints

Contrato v1.5.0

Los ids encadenan: la oficina de /offices entra en /availability; la oferta elegida lleva groupId, tariffId y rateRef a /bookings; tariffId abre /extras, /concepts y /rate-rules.

MétodoRutaQué haceObligatorio
GET/healthHealth check
GET/officesList offices
POST/availabilitySearch availability
GET/extrasList available extras
GET/conceptsList rate concepts (schema v2, optional)Opcional
POST/rate-rulesBulk rate rules (preferred)Opcional
POST/bookingsCreate booking
GET/bookings/{bookingId}Get booking detail
POST/bookings/{bookingId}/cancelCancel booking
POST/bookings/{bookingId}/modifyModify booking dates

Para agentes de IA

Pídeselo a tu agente y déjale trabajar

La guía está escrita para máquinas: pasos en orden, URLs absolutas, ejemplos copiables y un único punto en el que hace falta una persona. Claude Code, Codex, Antigravity, Cursor o el harness que uses puede completar la integración solo.

  • Registra el sandbox y guarda las dos claves.
  • Implementa y verifica hasta que todos los checks pasen.
  • Te entrega un enlace y tú creas la cuenta con tu email.
  • Crea el chat web con la clave y el snippet para tu sitio.

Pega esta frase en tu agente.

Lee https://www.bota-chat.com/api/public/provider-api-guide y sigue sus pasos para integrar mi sistema de reservas con Bota.
https://www.bota-chat.com/api/public/provider-api-guide

Servidor MCP

Para agentes que venden, no que integran

Model Context Protocol sobre HTTP, sin estado. Descubre las empresas que venden con Bota, lista sus oficinas, busca disponibilidad con el mismo precio que su chat web y, en las empresas que lo permiten, completa la reserva: extras, datos del conductor y confirmación en su sistema.

Endpoint
https://mcp.bota-chat.com/mcp
Herramientas
list_rental_companieslist_officessearch_availabilitychatselect_offerselect_extrasprovide_customer_detailsconfirm_booking
Configuración del cliente
{
  "mcpServers": {
    "bota": { "url": "https://mcp.bota-chat.com/mcp" }
  }
}

Pruébalo

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

La empresa demo siempre está disponible y sus reservas son ficticias. Las empresas reales deciden si aceptan reservas desde agentes; si no, el agente presenta la cotización y su contacto.

Entradas para máquinas

Todo lo que tu agente necesita, en URLs estables

Ninguna requiere cuenta ni clave para leerse. Si le pasas a tu agente solo una, que sea la guía: las demás las encuentra desde ahí.

Da igual el agente: Claude Code, Codex, Antigravity o Cursor leen estas mismas URLs. Están pensadas para no cambiar, así que puedes dejarlas escritas en tus prompts o en tu documentación interna.

Guardas

  • Solo tráfico HTTPS hacia direcciones públicas: la URL de tu sandbox pasa por un filtro anti-SSRF y Bota no sigue redirecciones.
  • Los secretos se muestran una sola vez y se guardan como hash o cifrados. El enlace de conversión solo funciona con el email del registro.
  • Cuotas por IP, por sandbox y por empresa en el sandbox y en el MCP: cada consulta cuesta una llamada a un sistema de reservas y un turno de IA.
  • El chat web creado por un agente solo funciona desde los orígenes de tu sitio; las reservas de agentes se atribuyen a un canal propio y siguen las reglas de la empresa.

Preguntas frecuentes

¿Necesito una cuenta en Bota para empezar a integrar?

No. El sandbox se registra con un email y devuelve las claves al momento. La cuenta se crea al final, cuando la integración ya está verificada, con el enlace de conversión.

¿Puede hacerlo un agente de IA sin una persona?

Todo menos un paso: crear la cuenta y aceptar las condiciones comerciales lo hace una persona con el enlace que el agente le entrega. Después, el agente puede crear el chat web. WhatsApp y teléfono requieren al titular en el panel (Meta y Telnyx).

¿Qué pasa si mi sistema ya está en la lista de integraciones?

No hace falta programar nada: creas la cuenta, conectas tu acceso y Bota opera en minutos. La guía para agentes lo comprueba antes de escribir código.

¿El precio que da el servidor MCP es el mismo que el del chat web?

Sí. Cada búsqueda del MCP es un turno del mismo motor que usa el chat web de la empresa, con sus cargos obligatorios, reglas de horario y trayectos de ida.

¿Cuánto cuesta?

Integrarse es gratis. Bota se paga por reserva confirmada, sin cuota de alta y sin permanencia. Las condiciones se aceptan al crear la cuenta.

Tu rent-a-car puede estar operando con Bota esta semana.

Con tu sistema de reservas ya integrado o con el que has construido tú.