Templates

Create, sync, send, and delete WhatsApp Business message templates.

Template

get

/templates

Retrieve all WhatsApp message templates associated with your business.

Authorizations

api_keystringRequired

Your Cekat API key. Obtain this by calling POST /register or from your Cekat dashboard under Settings → API.

Query parameters

inbox_idstringOptional

UUID of the WhatsApp Business inbox this template belongs to. Obtainable via the GET /inboxes endpoint.

Responses

200

Successful response

No content

400

Bad request — check required fields and formats.

401

Unauthorized — API key is missing or invalid.

404

Resource not found.

get/templates

GET /templates HTTP/1.1
Host: api.cekat.ai
api_key: YOUR_API_KEY
Accept: */*

No content

Create template

post

/templates

Create a new WhatsApp Business message template. Templates must be approved by Meta before they can be sent.

Authorizations

api_keystringRequired

Your Cekat API key. Obtain this by calling POST /register or from your Cekat dashboard under Settings → API.

Body

namestringRequired

Unique snake_case name for the template, e.g. promo_ramadan. Must match Meta's naming rules (lowercase, no spaces).

Example: tanya_kabarnya

categorystringRequired

Template category. Accepted values: AUTHENTICATION, MARKETING, or UTILITY. Most use cases fall under MARKETING.

Example: MARKETING

languagestringRequired

Language code accepted by Meta (e.g. id for Indonesian, en_US for English US). See full list in the description.

Example: id

bodystringRequired

Main text content of the template. Use {{1}}, {{2}}, etc. to define dynamic variables. Example: Halo {{1}}, ada promo spesial untukmu!

Example: Halo {{1}}, kamu apa kabarnya? Semoga baik-baik aja ya

inbox_idstringRequired

UUID of the WhatsApp Business inbox this template belongs to. Obtainable via the GET /inboxes endpoint.

body_placeholderstringOptional

Example values for body variables in JSON array format. Required if body contains {{N}} placeholders. Example: ["Jane", "10"].

Example: ["Jane"]

filestring · binaryOptional

Optional header image file. Accepted formats: jpeg, jpg, png.

Responses

200

Successful response

No content

400

Bad request — check required fields and formats.

401

Unauthorized — API key is missing or invalid.

404

Resource not found.

post/templates

POST /templates HTTP/1.1
Host: api.cekat.ai
api_key: YOUR_API_KEY
Content-Type: multipart/form-data
Accept: */*
Content-Length: 194

{
  "name": "tanya_kabarnya",
  "category": "MARKETING",
  "language": "id",
  "body": "Halo {{1}}, kamu apa kabarnya? Semoga baik-baik aja ya",
  "inbox_id": "text",
  "body_placeholder": "[\"Jane\"]",
  "file": "binary"
}

No content

Delete template by wa_template_id

delete

/templates

Delete a specific WhatsApp template by its wa_template_id.

Authorizations

api_keystringRequired

Your Cekat API key. Obtain this by calling POST /register or from your Cekat dashboard under Settings → API.

Responses

200

Successful response

No content

400

Bad request — check required fields and formats.

401

Unauthorized — API key is missing or invalid.

404

Resource not found.

delete/templates

DELETE /templates HTTP/1.1
Host: api.cekat.ai
api_key: YOUR_API_KEY
Accept: */*

No content

Template Sync

post

/templates/sync

Synchronize WhatsApp templates from the Meta server to Cekat. Use this after creating or modifying templates directly in Meta Business Manager.

Authorizations

api_keystringRequired

Your Cekat API key. Obtain this by calling POST /register or from your Cekat dashboard under Settings → API.

Query parameters

inbox_idstringOptional

UUID of the WhatsApp Business inbox this template belongs to. Obtainable via the GET /inboxes endpoint.

Example: {{inbox_id}}

Responses

200

Successful response

No content

400

Bad request — check required fields and formats.

401

Unauthorized — API key is missing or invalid.

404

Resource not found.

post/templates/sync

POST /templates/sync HTTP/1.1
Host: api.cekat.ai
api_key: YOUR_API_KEY
Accept: */*

No content

Send template

post

/templates/send

Send an approved WhatsApp template message to a contact. Only templates with status APPROVED will be processed.

Authorizations

api_keystringRequired

Your Cekat API key. Obtain this by calling POST /register or from your Cekat dashboard under Settings → API.

Body

wa_template_idstringOptional

The WhatsApp template ID. Obtainable via GET /templates.

inbox_idstringOptional

UUID of the WhatsApp Business inbox this template belongs to. Obtainable via the GET /inboxes endpoint.

phone_numberstringOptional

Business phone number in international format, e.g. 6285695209520.

phone_namestringOptional

Display name of the recipient.

Responses

200

Successful response

No content

400

Bad request — check required fields and formats.

401

Unauthorized — API key is missing or invalid.

404

Resource not found.

post/templates/send

POST /templates/send HTTP/1.1
Host: api.cekat.ai
api_key: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 69

{
  "wa_template_id": "",
  "inbox_id": "",
  "phone_number": "",
  "phone_name": ""
}

No content