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

# API Introduction

> Welcome to the Conversales AI API Documentation

## Overview

The Conversales AI API provides a comprehensive set of endpoints for managing WhatsApp messaging operations, including:

* **Chat Operations**: Send text, images, videos, documents, audio, and location messages
* **Template Operations**: Create, manage, and deploy message templates

**Base URL**: `https://backend.conversales.in/api/v1`

## Authentication

The API uses API Key authentication for all requests.

### API Key Authentication

For all API endpoints, use the `X-API-Key` header:

```bash theme={null}
X-API-Key: your_generated_api_key_here
Content-Type: application/json
```

## Quick Start

<Steps>
  <Step title="Generate API Key">
    Visit the [Dashboard](https://dashboard.conversales.in) to generate your API
    key
  </Step>

  <Step title="Configure Headers">
    Add the `X-API-Key` header to all your API requests
  </Step>

  <Step title="Start Sending Messages">
    Use the Chat Operations endpoints to send messages
  </Step>
</Steps>

## Response Format

All API responses follow a consistent structure:

```json theme={null}
{
  "statusCode": 200,
  "message": "Success message",
  "data": {
    // Response data
  }
}
```

## Error Codes

| Status Code | Description                                                 |
| ----------- | ----------------------------------------------------------- |
| **200**     | Success - Request completed successfully                    |
| **400**     | Bad Request - Invalid parameters or missing required fields |
| **401**     | Unauthorized - Invalid or missing API key/token             |
| **403**     | Forbidden - API key is disabled or insufficient permissions |
| **404**     | Not Found - Resource doesn't exist                          |
| **500**     | Internal Server Error - Server-side error                   |

## Support

Need help? Contact our support team at [support@conversales.in](mailto:support@conversales.in)

## Rate Limiting

The API implements rate limiting to ensure fair usage. If you exceed the rate limit, you'll receive a `429 Too Many Requests` response.

<Note>
  Store your API keys securely and never expose them in client-side code or
  public repositories.
</Note>