Developer Hub

API Documentation

Integrate Ai Auto Soft with your applications. Build powerful WhatsApp automation workflows with our comprehensive API.

Get API KeyView on GitHub
Contents

Quick Start

Get started with the Ai Auto Soft API in just a few minutes. Follow these steps to make your first API call:

1

Create an Account

Sign up for an Ai Auto Soft account and verify your email.

2

Generate API Key

Navigate to Settings → API Keys and create a new key.

3

Make Your First Call

Use your API key to authenticate and start making requests.

bash
curl -X GET "https://api.aiautosoft.com/v1/contacts" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"

Authentication

Ai Auto Soft uses OAuth 2.0 for secure API authentication. All API requests must include a valid access token in the Authorization header.

OAuth 2.0 Flow

Use the authorization code flow for applications that need to access user data.

javascript
// Step 1: Redirect user to authorization URL
const authUrl = "https://auth.aiautosoft.com/authorize?" +
  "response_type=code&" +
  "client_id=YOUR_CLIENT_ID&" +
  "redirect_uri=https://your-app.com/callback&" +
  "scope=read write";

// Step 2: Exchange code for access token
const response = await fetch("https://auth.aiautosoft.com/token", {
  method: "POST",
  headers: { "Content-Type": "application/x-www-form-urlencoded" },
  body: new URLSearchParams({
    grant_type: "authorization_code",
    code: "AUTHORIZATION_CODE",
    client_id: "YOUR_CLIENT_ID",
    client_secret: "YOUR_CLIENT_SECRET",
    redirect_uri: "https://your-app.com/callback"
  })
});

const { access_token, refresh_token } = await response.json();

Endpoints Reference

Our RESTful API provides comprehensive endpoints for managing contacts, messages, templates, and more.

GET
/api/v1/contacts

Retrieve all contacts from your Busy ERP database

POST
/api/v1/messages

Send a WhatsApp message to one or more contacts

GET
/api/v1/templates

List all approved WhatsApp message templates

POST
/api/v1/reminders

Create a new payment reminder campaign

GET
/api/v1/invoices

Retrieve invoices from Busy ERP

POST
/api/v1/webhooks

Configure webhooks for real-time event notifications

POST/api/v1/messages

Send a WhatsApp message to one or more contacts.

Request Body

json
{
  "to": ["+919876543210", "+919123456789"],
  "template_id": "payment_reminder_001",
  "parameters": {
    "customer_name": "John Doe",
    "invoice_number": "INV-2024-001",
    "amount": "₹15,000",
    "due_date": "2024-02-15"
  },
  "callback_url": "https://your-app.com/webhook/delivery"
}

Response

json
{
  "success": true,
  "message_id": "msg_abc123xyz",
  "status": "queued",
  "created_at": "2024-01-15T10:30:00Z",
  "recipients": [
    { "phone": "+919876543210", "status": "queued" },
    { "phone": "+919123456789", "status": "queued" }
  ]
}

SDKs & Client Libraries

Node.js SDK

Official Node.js library for server-side integration

npm install @aiautosoft/sdk
View Documentation

Python SDK

Python library for AI and data science workflows

pip install aiautosoft
View Documentation

REST API

Direct REST API access for any programming language

curl https://api.aiautosoft.com/v1
View Documentation

Error Handling

Our API returns standard HTTP status codes along with detailed error messages to help you debug issues.

400

Bad Request

Invalid request parameters or malformed JSON.

401

Unauthorized

Missing or invalid authentication credentials.

403

Forbidden

You don't have permission to access this resource.

404

Not Found

The requested resource was not found.

429

Rate Limited

Too many requests. Please retry after some time.

500

Server Error

An unexpected error occurred on our servers.

Error Response Format

json
{
  "error": {
    "code": "INVALID_PARAMETER",
    "message": "The 'phone' field must be a valid phone number",
    "details": [
      {
        "field": "phone",
        "issue": "Invalid format",
        "value": "invalid-phone"
      }
    ],
    "request_id": "req_xyz789"
  }
}

Rate Limits

Our API has rate limits to ensure fair usage and platform stability. Rate limits vary by plan:

PlanRequests/minMessages/day
Starter601,000
Professional30010,000
Enterprise1,000Unlimited

Ready to Build Something Amazing?

Get your API key and start integrating Ai Auto Soft with your applications today.

Get API KeyView Examples