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 →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.
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!"
}'
# 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"
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?"}'
Base URL: https://your-domain.com/api/v1/platform
/register
Public
Create a developer account. Returns an API key and a brand ID.
Body
{ "email": "string", "name": "string", "company_name": "string" }
Response 200
{ "success": true, "api_key": "pak_...", "brand_id": "platform_...", "message": "..." }
/send-message
X-API-Key
Send a WhatsApp text message to any phone number via the shared Meta API.
Body
{ "to_phone": "+919876543210", "message": "Hello!" }
Response 200
{ "success": true, "message_id": "wamid.xxx", "to": "+919876543210" }
/create-bot
X-API-Key
Create a WhatsApp bot configuration with a welcome message and AI instructions.
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" }
/upload-knowledge
X-API-Key
Upload a document (PDF, TXT, JSON, MD) or scrape a URL to add to your AI knowledge base.
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" }
/query
X-API-Key
Ask a question against your knowledge base. Uses RAG with Groq Llama 3.1.
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
}
/create-flow
X-API-Key
Describe a conversation flow in plain English and AI will generate the nodes and edges.
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": [...] }
/conversations
X-API-Key
List all WhatsApp conversations for your brand. Supports pagination via limit and offset query params.
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", ... }
]
}
/usage
X-API-Key
View your current usage: messages sent, AI queries, documents, and flows.
{
"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 }
}
/health
Public
Public health-check endpoint. Returns service status for DB, WhatsApp, and AI.
{ "status": "operational", "database": "connected", "whatsapp": "shared-number", "ai": "groq-llama-3.1-8b-instant" }
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.
Pre-built AI bots for every industry. Deploy with a single API call — includes knowledge base, conversation flow, and ready-to-use curl commands.
Healthcare
Appointment booking, doctor availability, symptoms FAQ, and prescription queries for clinics and hospitals.
Food & Beverage
Menu browsing, ordering, delivery status tracking, and special offers for restaurants and cloud kitchens.
Education
Doubt solving, exam preparation, syllabus queries, and study plan generation for coaching institutes.
E-Commerce
Product queries, order tracking, return policy, and size guide for direct-to-consumer brands.
Real Estate
Listing search, price ranges, schedule site visits, and EMI calculator for agents and builders.
Beauty & Wellness
Booking appointments, services menu, pricing, and stylist availability for salons and spas.
Health & Fitness
Membership plans, class schedules, trainer booking, and diet tips for gyms and fitness studios.
Hospitality
Room availability, booking, amenities information, and check-in/out details for hotels and resorts.
Legal
Basic legal FAQ, document requirements, and consultation booking for law firms and legal services.
Finance
Plan comparison, premium calculator, claim process, and policy queries for insurance companies.
Education
Course information, eligibility criteria, fee structure, and application status for colleges.
Automotive
Model comparison, test drive booking, finance options, and service booking for dealerships.
Pet Care
Vet booking, pet food recommendations, grooming schedules, and vaccination reminders.
Healthcare
Medicine availability, generic alternatives, dosage info, and order refills for pharmacies.
Events
Event details, ticket booking, venue info, schedule, and speaker lineup for event organizers.
$0/mo
$29/mo
$99/mo
| Code | Meaning | When |
|---|---|---|
| 400 | Bad Request | Missing required fields |
| 401 | Unauthorized | Invalid or missing API key |
| 403 | Forbidden | API key deactivated |
| 429 | Too Many Requests | Monthly usage limit reached |
| 502 | Bad Gateway | WhatsApp or AI upstream error |
| 503 | Service Unavailable | AI service not configured |