Developer Docs

Chatloka API Reference

Integrate Chatloka into your applications. Manage conversations, contacts, messages, and more using our RESTful API.

Base URL
https://chatloka.net/api/v1
Response Format
JSON

Authentication

All API requests require authentication via an API key. Include your key in the Authorization header.

Rate Limiting

API requests are rate-limited based on your API key tier.

MCP (Model Context Protocol)

Connect AI agents directly to your Chatloka workspace via the Model Context Protocol. Let your AI assistant manage conversations, contacts, campaigns, and more.

Conversations

Manage conversations and send messages across multiple channels (WhatsApp, Facebook, Instagram, Telegram, WebChat).

Contacts

Create, update, and manage contacts. Organize with labels, tags, and custom fields.

Traffic Sources

Manage traffic sources that track where contacts come from.

Messages

Read and search messages across every conversation.

Channels

List and manage connected channels (WhatsApp, Facebook, Instagram, Telegram, WebChat).

Labels

Create and manage contact labels.

Tags

Tag contacts and conversations.

Webhooks

Subscribe to events and manage webhook endpoints.

API Keys

Create, rotate, and revoke API keys.

Custom Fields

Define and manage custom field schemas for contacts.

Analytics

Get aggregate analytics data for contacts, conversations, and messages.

Bot Flows

List bot flow automations and toggle them.

Campaigns

Read broadcast and drip campaigns.

Canned Responses

Read reusable message snippets.

Files

Read your media library and storage usage.

Organization

Read organization profile, team members, teams, roles, settings, and usage.

AI

Read AI providers and knowledge bases.

WhatsApp Cloud Interactive

Interactive messages for WhatsApp Cloud API: buttons (reply-only), list, and CTA URL. Buttons and lists require an optional image header for best UX.

WhatsApp QR Interactive

Interactive messages for WhatsApp QR (Baileys): buttons with full type support (reply, url, call, copy), list, and carousel. Images are recommended for better rendering.

Facebook Interactive

Interactive messages for Facebook Messenger: button template (postback/web_url/phone_number), quick replies (disappear after tap), and generic template carousel.

Instagram Interactive

Interactive messages for Instagram DM: button template (postback/web_url only, max 3), quick replies (max 13), and generic template carousel. List is auto-converted to carousel.

Telegram Interactive

Interactive messages for Telegram: inline keyboard (buttons attached to message, max 13) and reply keyboard (persistent keyboard, max 13). Lists are auto-converted to inline buttons.

WebChat Interactive

Interactive messages for WebChat widget: buttons (reply, url, call, postback, web_url β€” max 13), quick replies (max 13), and carousel (max 10 cards). The widget renders these client-side via polling.

Rate Limits

120
Standard
600
High
3,000
Enterprise

Headers: X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset

Start Today

Stop Losing Customers
to Slow Responses

Every minute you wait is revenue walking out the door. Join hundreds of businesses who transformed their customer communication with ChatOn.

50%
Faster Response
24/7
AI Support
40%
Higher Conversion
No credit card required
Setup in 5 minutes
Cancel anytime

βœ“ 30-day money-back guarantee

πŸͺ We use cookies

We use cookies and similar technologies to improve your experience, analyze traffic, and personalize content. By clicking "Accept All", you consent to our use of cookies. Privacy Policy & Cookie Policy.

Cookie Preferences

Choose which cookies you want to allow. Essential cookies are always required for the website to function.

Essential Cookies

Required for the website to function. Cannot be disabled.

Always On

Analytics Cookies

Help us understand how visitors interact with our website by collecting anonymous data.

Marketing Cookies

Used to track visitors across websites to display relevant advertisements.

βœ… Preferences saved!