API Introduction - Conversales ai

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

The API uses API Key authentication for all requests.

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

X-API-Key: your_generated_api_key_here
Content-Type: application/json

Generate API Key

Visit the Dashboard to generate your API key

Configure Headers

Add the X-API-Key header to all your API requests

Start Sending Messages

Use the Chat Operations endpoints to send messages

All API responses follow a consistent structure:

{
  "statusCode": 200,
  "message": "Success message",
  "data": {
    // Response data
  }
}

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

Need help? Contact our support team at support@conversales.in

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

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