> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bota.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Overview

> Capture, ingest, and process offline conversations via AI wearable devices

## Welcome to Bota

Bota is a multi-tenant hardware + API platform that enables software companies to capture, ingest, and process offline conversations via AI wearable devices. Build voice-powered features into your product without managing hardware or AI infrastructure.

<CardGroup cols={2}>
  <Card title="Quickstart" icon="rocket" href="/quickstart">
    Get up and running with the Bota API in minutes
  </Card>

  <Card title="API Reference" icon="code" href="/api-reference/introduction">
    Complete API documentation with examples
  </Card>

  <Card title="Authentication" icon="key" href="/authentication">
    Learn about API keys and authentication flows
  </Card>

  <Card title="Core Concepts" icon="book" href="/concepts">
    Understand the Bota domain model
  </Card>
</CardGroup>

## Who Uses Bota?

Bota is built for software companies that want to add conversation capture to their products:

<AccordionGroup>
  <Accordion title="Healthcare Technology" icon="heart-pulse">
    Capture patient-provider conversations for clinical documentation. Auto-generate SOAP notes, visit summaries, and follow-up tasks from in-person appointments.

    **Example:** A telehealth platform adds in-person visit support by shipping Bota devices to clinicians.
  </Accordion>

  <Accordion title="Sales Enablement" icon="handshake">
    Record field sales meetings and customer conversations. Generate call summaries, extract action items, and sync insights to your CRM.

    **Example:** A sales coaching platform captures in-person pitches for AI-powered feedback and training.
  </Accordion>

  <Accordion title="Legal Tech" icon="scale-balanced">
    Document client consultations and depositions with accurate transcription. Maintain compliance-ready records with speaker attribution.

    **Example:** A law practice management tool adds secure client meeting transcription.
  </Accordion>

  <Accordion title="Enterprise Productivity" icon="building">
    Enable meeting transcription for field teams, service calls, and customer interactions. Build internal tools for compliance and quality assurance.

    **Example:** An insurance company equips claims adjusters with devices for customer interaction capture.
  </Accordion>
</AccordionGroup>

## How It Works

<Steps>
  <Step title="Set up your project">
    Create a Bota account and get your API keys. Use test keys for development and live keys for production.
  </Step>

  <Step title="Integrate the API">
    Use our REST API or SDKs to manage end users, devices, and recordings in your backend.
  </Step>

  <Step title="Ship devices to users">
    Distribute Bota wearables to your end users. Devices pair with your mobile app via Bluetooth.
  </Step>

  <Step title="Capture conversations">
    End users press a button to record. Audio is stored locally and works completely offline.
  </Step>

  <Step title="Upload and transcribe">
    When devices sync with your app, audio uploads to Bota. Transcription runs automatically or on-demand.
  </Step>

  <Step title="Build features">
    Use transcripts with speaker diarization to power your product — search, summaries, insights, and more.
  </Step>
</Steps>

## Architecture Overview

```mermaid theme={null}
flowchart TB
    subgraph "Your Users"
        EU[End User with Device]
    end

    subgraph "Your Infrastructure"
        MA[Mobile App]
        CB[Customer Backend]
    end

    subgraph "Bota Platform"
        API[Bota API]
        S3[Audio Storage]
        ASR[Transcription Engine]
    end

    EU -->|BLE Pairing & Sync| MA
    MA -->|Auth & Tokens| CB
    CB -->|API Calls| API
    MA -->|Direct Upload| S3
    API -->|Trigger| ASR
    ASR -->|Webhook| CB
```

**Data Flow:**

1. **Device ↔ Mobile App** — Bluetooth pairing and audio sync
2. **Mobile App ↔ Your Backend** — User authentication and request tokens
3. **Your Backend ↔ Bota API** — Device registration, recording management, transcription jobs
4. **Mobile App → Bota S3** — Direct audio upload via pre-signed URLs
5. **Bota → Your Backend** — Webhook notifications when processing completes

## Core Capabilities

<CardGroup cols={2}>
  <Card title="Device Management" icon="microchip">
    Register devices, bind to users, and manage the device lifecycle. Support for bulk provisioning and reassignment.
  </Card>

  <Card title="Offline Recording" icon="wifi-slash">
    Devices record without connectivity. Audio syncs automatically when back online with resumable uploads.
  </Card>

  <Card title="AI Processing" icon="file-lines">
    Convert audio to text with speaker diarization. Timestamps per segment for precise navigation. Generate summaries, video highlights, and more.
  </Card>

  <Card title="Webhooks" icon="bell">
    Real-time notifications when recordings upload or transcription completes. No polling required.
  </Card>
</CardGroup>

## Security & Compliance

<CardGroup cols={2}>
  <Card title="End-to-End Encryption" icon="lock">
    TLS 1.2+ in transit, AES-256 at rest. Secure device provisioning with rotating tokens.
  </Card>

  <Card title="Data Isolation" icon="shield-halved">
    Complete tenant isolation at the database level. Each project has separate data boundaries.
  </Card>

  <Card title="Compliance Ready" icon="certificate">
    SOC 2 Type II, GDPR, and HIPAA compliant infrastructure. Built for regulated industries.
  </Card>

  <Card title="Right to Deletion" icon="trash">
    Full end user deletion API for compliance. Remove all recordings and transcripts on request.
  </Card>
</CardGroup>

## Quick Links

<CardGroup cols={3}>
  <Card title="End Users" icon="users" href="/api-reference/end-users/create">
    Create and manage end users
  </Card>

  <Card title="Devices" icon="microchip" href="/api-reference/devices/create">
    Register and bind devices
  </Card>

  <Card title="Recordings" icon="circle-dot" href="/api-reference/recordings/create">
    Create and upload recordings
  </Card>

  <Card title="Transcriptions" icon="file-lines" href="/api-reference/ai/transcriptions/create">
    Transcribe audio to text
  </Card>

  <Card title="Webhooks" icon="bell" href="/webhooks/overview">
    Set up event notifications
  </Card>

  <Card title="Authentication" icon="key" href="/authentication">
    API keys and security
  </Card>
</CardGroup>

## Get Started

Ready to integrate? Start with the quickstart guide to make your first API call.

<Card title="Quickstart Guide" icon="rocket" href="/quickstart">
  Create an end user, register a device, upload audio, and get a transcript in under 10 minutes.
</Card>