> ## 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.

# Support

> Get help with the Bota platform

We're here to help you succeed with Bota. Choose the support channel that best fits your needs.

***

## Contact Support

<CardGroup cols={2}>
  <Card title="Email Support" icon="envelope" href="mailto:support@bota.dev">
    [support@bota.dev](mailto:support@bota.dev)
  </Card>

  <Card title="API Status" icon="signal" href="https://api.bota.dev/health">
    Check system availability
  </Card>
</CardGroup>

***

## Response Times

| Plan         | Initial Response | Severity 1 (Outage) |
| ------------ | ---------------- | ------------------- |
| **Basic**    | 2 business days  | 24 hours            |
| **Standard** | 1 business day   | 8 hours             |
| **Pro**      | 4 hours          | 1 hour              |

<Note>
  Severity 1 issues are defined as complete service outages affecting production workloads.
</Note>

***

## Before Contacting Support

To help us resolve your issue quickly, please include:

1. **Project ID** — Found in your dashboard under Settings
2. **Request ID** — Included in every API response header (`X-Request-Id`)
3. **Timestamp** — When the issue occurred (UTC preferred)
4. **Error message** — Full error response from the API
5. **Steps to reproduce** — What you were doing when the issue occurred

***

## Common Issues

<AccordionGroup>
  <Accordion title="Authentication errors (401)">
    * Verify your API key is correct and not revoked
    * Ensure you're using `Bearer` authentication: `Authorization: Bearer sk_live_...`
    * Check that you're using the correct key type (live vs test)
    * See [Authentication](/authentication) for details
  </Accordion>

  <Accordion title="Rate limiting (429)">
    * Default rate limit is 100 requests per second per project
    * Implement exponential backoff on 429 responses
    * Check `X-RateLimit-Remaining` header to monitor usage
    * See [Rate Limits](/api-reference/rate-limits) for details
  </Accordion>

  <Accordion title="Upload failures">
    * Ensure upload URLs haven't expired (valid for 1 hour)
    * Verify file format is supported (WAV, MP3, M4A, FLAC)
    * For large files, use multipart upload
    * See [Uploads](/api-reference/uploads/create-url) for details
  </Accordion>

  <Accordion title="Webhook not receiving events">
    * Verify your endpoint returns 2xx status codes
    * Check that your endpoint responds within 30 seconds
    * Ensure your endpoint accepts POST requests with JSON body
    * Verify webhook signature validation logic
    * See [Webhooks](/api-reference/webhooks/overview) for details
  </Accordion>

  <Accordion title="Transcription quality issues">
    * Ensure audio quality is sufficient (clear speech, minimal background noise)
    * Check that the correct language is being detected
    * For domain-specific vocabulary, contact support about custom dictionaries
  </Accordion>
</AccordionGroup>

***

## Developer Resources

<CardGroup cols={3}>
  <Card title="API Reference" icon="code" href="/api-reference/introduction">
    Complete endpoint documentation
  </Card>

  <Card title="Quickstart" icon="rocket" href="/quickstart">
    Get started in minutes
  </Card>

  <Card title="Changelog" icon="clock-rotate-left" href="/changelog">
    Latest platform updates
  </Card>
</CardGroup>

***

## Feature Requests

Have an idea for improving Bota? We'd love to hear from you.

Email your feature requests to [feedback@bota.dev](mailto:feedback@bota.dev) with:

* **Use case** — What problem are you trying to solve?
* **Proposed solution** — How would you like it to work?
* **Priority** — How important is this for your integration?

***

## Security Issues

If you discover a security vulnerability, please report it responsibly:

**Email:** [security@bota.dev](mailto:security@bota.dev)

Do not disclose security issues publicly until we've had a chance to address them. We aim to respond to security reports within 24 hours.
