Sviluppatori

Implementa un'API e il tuo sistema di prenotazione vende su qualsiasi canale conversazionale.

Tu ospiti un'API di dieci endpoint e Bota la chiama in tempo reale in ogni conversazione: disponibilità, prezzi, extra e prenotazione. Nessuna sincronizzazione dell'inventario, nessuna coda e niente da installare. Implementala tu con il contratto e il validatore davanti, oppure lascia che la implementi il tuo agente IA.

Riferimento dell'APIGuida per agenti (Markdown)

Non è l'ennesimo chatbot

Se il tuo autonoleggio ha un sistema proprio, non costruire il chatbot: collegalo.

Un chatbot fatto da zero conversa. Bota vende: conosce il noleggio di veicoli, fa preventivi con le tue tariffe reali, applica le tue regole e conferma la prenotazione nel tuo sistema, su qualsiasi canale conversazionale e nella lingua di ogni cliente. Quello che si programma è il collegamento, non l'intelligenza.

Tre modi per integrarsi

Il tuo sistema è già integrato

Karve, Wheelsys, Rently, RentHub, Rentsyst e HQ Rental Software. Senza codice: crei l'account, colleghi il tuo accesso e sei operativo in pochi minuti.

Vedi le integrazioni

Hai un sistema proprio

Ospiti l'API standard di Bota (dieci endpoint JSON su HTTPS) e Bota la chiama. Contratto OpenAPI 3.1, esempi reali per ogni endpoint e un validatore con lo stesso schema che usiamo in produzione.

Vedi il contratto OpenAPI

Il tuo agente IA fa l'integrazione per te

Sempre più autonoleggi programmano il proprio sistema con Claude Code, Codex, Antigravity o Cursor. La guida è scritta perché quello stesso agente colleghi il tuo sistema a Bota dall'inizio alla fine, chiedendoti una cosa sola: creare l'account.

Vedi la guida per agenti

Come funziona l'API standard

  1. 1

    Registra una sandbox

    Una chiamata, senza account: ricevi la chiave della sandbox, il token che Bota invierà al tuo endpoint e il link di conversione. Scade dopo 30 giorni.

    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 gli endpoint

    Otto obbligatori e due facoltativi. Autenticazione Bearer, importi in centesimi, valuta ISO-4217, orari nel fuso di ogni ufficio. Esempi pronti da copiare per ciascuno.

  3. 3

    Verifica da Bota

    Bota chiama il tuo URL e valida ogni risposta con lo stesso contratto che applica in produzione. Il report indica quale campo non va. Ripeti finché non passa; facoltativamente prova il ciclo di prenotazione.

    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

    Vai in produzione

    Il responsabile apre il link di conversione e crea l'account con la stessa email: l'endpoint verificato resta collegato. Poi l'agente può creare la chat web; WhatsApp e telefono si collegano dal pannello.

I dieci endpoint

Contratto v1.5.0

Gli id si concatenano: l'ufficio di /offices entra in /availability; l'offerta scelta porta groupId, tariffId e rateRef a /bookings; tariffId apre /extras, /concepts e /rate-rules.

MetodoPercorsoCosa faObbligatorio
GET/healthHealth checkSì
GET/officesList officesSì
POST/availabilitySearch availabilitySì
GET/extrasList available extrasSì
GET/conceptsList rate concepts (schema v2, optional)Facoltativo
POST/rate-rulesBulk rate rules (preferred)Facoltativo
POST/bookingsCreate bookingSì
GET/bookings/{bookingId}Get booking detailSì
POST/bookings/{bookingId}/cancelCancel bookingSì
POST/bookings/{bookingId}/modifyModify booking datesSì

Per agenti IA

Chiedilo al tuo agente e lascialo lavorare

La guida è scritta per le macchine: passi in ordine, URL assoluti, esempi pronti da copiare e un solo punto in cui serve una persona. Claude Code, Codex, Antigravity, Cursor o l'harness che usi possono completare l'integrazione da soli.

  • Registra la sandbox e salva le due chiavi.
  • Implementa e verifica finché tutti i check non passano.
  • Ti consegna un link e tu crei l'account con la tua email.
  • Crea la chat web con la chiave e lo snippet per il tuo sito.

Incolla questa frase nel tuo agente.

Leggi https://www.bota-chat.com/api/public/provider-api-guide e segui i passi per integrare il mio sistema di prenotazione con Bota.
https://www.bota-chat.com/api/public/provider-api-guide

Server MCP

Per agenti che vendono, non che integrano

Model Context Protocol su HTTP, senza stato. Scopre le aziende che vendono con Bota, elenca i loro uffici, cerca la disponibilità con lo stesso prezzo della loro chat web e, nelle aziende che lo consentono, completa la prenotazione: extra, dati del conducente e conferma nel loro sistema.

Endpoint
https://mcp.bota-chat.com/mcp
Strumenti
list_rental_companieslist_officessearch_availabilityask_companyselect_offerselect_extrasprovide_customer_detailsconfirm_bookingget_booking_statuscancel_booking
Configurazione del client
{
  "mcpServers": {
    "bota": { "url": "https://mcp.bota-chat.com/mcp" }
  }
}

Provalo

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'azienda demo è sempre disponibile e le sue prenotazioni sono fittizie. Le aziende reali decidono se accettare prenotazioni dagli agenti; in caso contrario, l'agente presenta il preventivo e i loro contatti.

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

Punti di accesso per le macchine

Tutto ciò che serve al tuo agente, su URL stabili

Nessuno richiede account o chiave per essere letto. Se al tuo agente ne passi solo uno, che sia la guida: gli altri li trova da lì.

Non importa quale agente usi: Claude Code, Codex, Antigravity o Cursor leggono questi stessi URL. Sono pensati per non cambiare, quindi puoi lasciarli scritti nei tuoi prompt o nella tua documentazione interna.

Protezioni

  • Solo traffico HTTPS verso indirizzi pubblici: l'URL della tua sandbox passa da un filtro anti-SSRF e Bota non segue i redirect.
  • I segreti vengono mostrati una sola volta e salvati come hash o cifrati. Il link di conversione funziona solo con l'email della registrazione.
  • Limiti per IP, per sandbox e per azienda nella sandbox e nel MCP: ogni richiesta costa una chiamata a un sistema di prenotazione e un turno di IA.
  • La chat web creata da un agente funziona solo dalle origini del tuo sito; le prenotazioni degli agenti vengono attribuite a un canale dedicato e seguono le regole dell'azienda.

Domande frequenti

Mi serve un account Bota per iniziare l'integrazione?

No. La sandbox si registra con un'email e restituisce subito le chiavi. L'account si crea alla fine, quando l'integrazione è già verificata, con il link di conversione.

Può farlo un agente IA senza una persona?

Tutto tranne un passaggio: creare l'account e accettare le condizioni commerciali spetta a una persona, con il link che le consegna l'agente. Dopo, l'agente può creare la chat web. WhatsApp e telefono richiedono il titolare nel pannello (Meta e Telnyx).

Cosa succede se il mio sistema è già nell'elenco delle integrazioni?

Non serve programmare nulla: crei l'account, colleghi il tuo accesso e Bota è operativo in pochi minuti. La guida per agenti lo verifica prima di scrivere codice.

Il prezzo del server MCP è lo stesso della chat web?

Sì. Ogni ricerca del MCP è un turno dello stesso motore che usa la chat web dell'azienda, con i suoi costi obbligatori, le regole sugli orari e le tratte di sola andata.

Quanto costa?

L'integrazione è gratuita. Bota si paga per prenotazione confermata, senza costi di attivazione e senza vincoli. Le condizioni si accettano alla creazione dell'account.

Il tuo autonoleggio può essere operativo con Bota già questa settimana.

Con il tuo sistema di prenotazione già integrato o con quello che hai costruito tu.

Crea un accountParla con noi