Build WhatsApp AI Apps in minutes, not months

One API key gives you WhatsApp messaging, AI-powered knowledge bases, conversation flows, and analytics — all on a shared, managed infrastructure.

Get your API key →

Getting Started

Step 1 — Register

Create a developer account and receive your API key.

curl -X POST https://your-domain.com/api/v1/platform/register \
  -H "Content-Type: application/json" \
  -d '{
    "email": "dev@example.com",
    "name": "Jane Doe",
    "company_name": "Acme Corp"
  }'

Response includes api_key and brand_id. Save the key securely.

Step 2 — Send your first message

curl -X POST https://your-domain.com/api/v1/platform/send-message \
  -H "Content-Type: application/json" \
  -H "X-API-Key: pak_YOUR_KEY_HERE" \
  -d '{
    "to_phone": "+919876543210",
    "message": "Hello from my app!"
  }'

Step 3 — Add a knowledge base

# Upload a file
curl -X POST https://your-domain.com/api/v1/platform/upload-knowledge \
  -H "X-API-Key: pak_YOUR_KEY_HERE" \
  -F "file=@product-catalog.pdf"

# Or scrape a URL
curl -X POST https://your-domain.com/api/v1/platform/upload-knowledge \
  -H "X-API-Key: pak_YOUR_KEY_HERE" \
  -F "url=https://example.com/faq"

Step 4 — Query with AI

curl -X POST https://your-domain.com/api/v1/platform/query \
  -H "Content-Type: application/json" \
  -H "X-API-Key: pak_YOUR_KEY_HERE" \
  -d '{"question": "What is your return policy?"}'

API Reference

Base URL: https://your-domain.com/api/v1/platform

POST /register Public

Create a developer account. Returns an API key and a brand ID.

Request / Response

Body

{ "email": "string", "name": "string", "company_name": "string" }

Response 200

{ "success": true, "api_key": "pak_...", "brand_id": "platform_...", "message": "..." }
POST /send-message X-API-Key

Send a WhatsApp text message to any phone number via the shared Meta API.

Request / Response

Body

{ "to_phone": "+919876543210", "message": "Hello!" }

Response 200

{ "success": true, "message_id": "wamid.xxx", "to": "+919876543210" }
POST /create-bot X-API-Key

Create a WhatsApp bot configuration with a welcome message and AI instructions.

Request / Response

Body

{
  "name": "Support Bot",
  "welcome_message": "Hi! How can I help?",
  "ai_instructions": "You are a friendly support agent."
}

Response 200

{ "success": true, "bot_id": "bot_...", "whatsapp_number": "shared", "status": "active" }
POST /upload-knowledge X-API-Key

Upload a document (PDF, TXT, JSON, MD) or scrape a URL to add to your AI knowledge base.

Request / Response

Multipart form — file upload

curl -F "file=@catalog.pdf" -H "X-API-Key: pak_..." .../upload-knowledge

Multipart form — URL scrape

curl -F "url=https://example.com/faq" -H "X-API-Key: pak_..." .../upload-knowledge

Response 200

{ "success": true, "document_id": "doc_...", "text_length": 4200, "status": "uploaded" }
POST /query X-API-Key

Ask a question against your knowledge base. Uses RAG with Groq Llama 3.1.

Request / Response

Body

{ "question": "What is your return policy?" }

Response 200

{
  "success": true,
  "answer": "Our return policy allows returns within 30 days...",
  "sources_used": 1,
  "model": "groq-llama-3.1-8b-instant",
  "tokens_used": 312
}
POST /create-flow X-API-Key

Describe a conversation flow in plain English and AI will generate the nodes and edges.

Request / Response

Body

{ "prompt": "A product inquiry bot that asks what category, shows options, and collects order" }

Response 200

{ "success": true, "flow_id": "flow_...", "name": "Product Inquiry Bot", "nodes": [...], "edges": [...] }
GET /conversations X-API-Key

List all WhatsApp conversations for your brand. Supports pagination via limit and offset query params.

Request / Response
curl -H "X-API-Key: pak_..." .../conversations?limit=20&offset=0

Response 200

{
  "success": true,
  "total": 42,
  "conversations": [
    { "id": "...", "customer_phone": "+91...", "message_count": 12, "status": "active", ... }
  ]
}
GET /usage X-API-Key

View your current usage: messages sent, AI queries, documents, and flows.

Response example
{
  "success": true,
  "tier": "free",
  "usage": { "messages_sent": 47, "ai_queries": 12, "documents": 3, "flows": 1 },
  "limits": { "messages": 1000, "ai_queries": 500, "documents": 10, "flows": 5 }
}
GET /health Public

Public health-check endpoint. Returns service status for DB, WhatsApp, and AI.

Response example
{ "status": "operational", "database": "connected", "whatsapp": "shared-number", "ai": "groq-llama-3.1-8b-instant" }

Authentication

All authenticated endpoints require the X-API-Key header. Keys are prefixed with pak_ and generated during registration.

curl -H "X-API-Key: pak_abc123..." https://your-domain.com/api/v1/platform/usage

If the key is missing or invalid you will receive a 401 Unauthorized response. Deactivated keys return 403 Forbidden.

Starter Kits

Pre-built AI bots for every industry. Deploy with a single API call — includes knowledge base, conversation flow, and ready-to-use curl commands.

🏥

Clinic Bot

Healthcare

Appointment booking, doctor availability, symptoms FAQ, and prescription queries for clinics and hospitals.

healthcare appointments doctors
🍕

Restaurant Bot

Food & Beverage

Menu browsing, ordering, delivery status tracking, and special offers for restaurants and cloud kitchens.

food ordering delivery
📚

Tutor Bot

Education

Doubt solving, exam preparation, syllabus queries, and study plan generation for coaching institutes.

education tutoring exams
🛒

D2C Support Bot

E-Commerce

Product queries, order tracking, return policy, and size guide for direct-to-consumer brands.

ecommerce d2c orders
🏠

Real Estate Bot

Real Estate

Listing search, price ranges, schedule site visits, and EMI calculator for agents and builders.

realestate property EMI
💇

Salon Bot

Beauty & Wellness

Booking appointments, services menu, pricing, and stylist availability for salons and spas.

salon beauty spa
🏋️

Gym/Fitness Bot

Health & Fitness

Membership plans, class schedules, trainer booking, and diet tips for gyms and fitness studios.

fitness gym training
🏨

Hotel Bot

Hospitality

Room availability, booking, amenities information, and check-in/out details for hotels and resorts.

hotel booking travel
⚖️

Legal Bot

Legal

Basic legal FAQ, document requirements, and consultation booking for law firms and legal services.

legal consultation documents
🏦

Insurance Bot

Finance

Plan comparison, premium calculator, claim process, and policy queries for insurance companies.

insurance finance claims
🎓

Admission Bot

Education

Course information, eligibility criteria, fee structure, and application status for colleges.

admissions college university
🚗

Car Dealer Bot

Automotive

Model comparison, test drive booking, finance options, and service booking for dealerships.

automotive cars testdrive
🐾

Pet Care Bot

Pet Care

Vet booking, pet food recommendations, grooming schedules, and vaccination reminders.

pets veterinary grooming
💊

Pharmacy Bot

Healthcare

Medicine availability, generic alternatives, dosage info, and order refills for pharmacies.

pharmacy medicine prescriptions
🎪

Event Bot

Events

Event details, ticket booking, venue info, schedule, and speaker lineup for event organizers.

events tickets conferences

Pricing

Free

$0/mo

  • 1,000 WhatsApp messages
  • 500 AI queries
  • 10 documents
  • 5 flows
  • Shared number
  • Community support
Get started
Popular

Starter

$29/mo

  • 10,000 WhatsApp messages
  • 5,000 AI queries
  • 100 documents
  • 50 flows
  • Shared number
  • Email support
Get started

Growth

$99/mo

  • 100,000 WhatsApp messages
  • 50,000 AI queries
  • 1,000 documents
  • 500 flows
  • Dedicated number (add-on)
  • Priority support
Get started

Error Codes

CodeMeaningWhen
400Bad RequestMissing required fields
401UnauthorizedInvalid or missing API key
403ForbiddenAPI key deactivated
429Too Many RequestsMonthly usage limit reached
502Bad GatewayWhatsApp or AI upstream error
503Service UnavailableAI service not configured