CekatAI

API Reference

The CekatAI REST API allows you to programmatically manage messages, contacts, and conversations.

Authentication

All API requests require a Bearer token in the Authorization header:

Authorization: Bearer YOUR_API_KEY

Keep your API keys secret. Never expose them in client-side code.

Base URL

https://api.cekat.ai/v1

Send Message

POST/v1/messages
tostring*

Recipient phone number in E.164 format.

messagestring*

Message body. Max 4096 characters.

channelstring

Channel to send through: whatsapp, instagram, livechat. Default: whatsapp.

template_idstring

Template ID for template messages.

undefined Server Error
{
  "id": "msg_abc123",
  "status": "sent",
  "channel": "whatsapp",
  "timestamp": "2025-03-27T10:00:00Z"
}

Get Contacts

GET/v1/contacts
pageinteger

Page number for pagination. Default: 1.

limitinteger

Results per page. Default: 20, max: 100.

searchstring

Search by name, phone, or email.

undefined Server Error
{
  "data": [
    {
      "id": "contact_123",
      "name": "John Doe",
      "phone": "+62812345678",
      "email": "[email protected]",
      "tags": ["vip", "active"]
    }
  ],
  "pagination": {
    "page": 1,
    "total": 150,
    "pages": 8
  }
}