Templates & Bot Flow Endpoints
List, create and check WhatsApp templates through the API, list your chatbot flows, and start a flow for any customer.
Template list#
POST /whatsapp/template/list — phone_number_id required.
Returns each template with its short id (use as template_id), Meta's template_id, name, language, header, body and buttons.
Create a template#
POST /whatsapp/template/create — send as JSON (Content-Type: application/json).
| Parameter | Required | Description |
|---|---|---|
phone_number_id |
Yes | — |
name |
Yes | Lowercase letters and underscores, e.g. diwali_offer_2026 |
category |
Yes | MARKETING or UTILITY |
language |
No | e.g. en_US (default), ml_IN, hi_IN |
body_text |
Yes | Body with dynamic tags such as #LEAD_USER_FIRST_NAME#, #city# or #!order_id!# |
header |
No | {"type":"text","text":"…"} or {"type":"image","media_url":"https://…"} |
footer_text |
No | Small text at the bottom |
buttons |
No | Array of quick_reply, url, phone_number or copy_code buttons |
curl -X POST 'https://app.wably.in/api/v1/whatsapp/template/create' \
-H 'Authorization: Bearer YOUR_API_KEY' -H 'Content-Type: application/json' \
-d '{"phone_number_id":"PHONE_NUMBER_ID","name":"order_ready","category":"UTILITY",
"body_text":"Hi #LEAD_USER_FIRST_NAME#, your order #!order_id!# is ready for pickup."}'
The template is submitted to WhatsApp for review. Most are reviewed within minutes; some take up to 24 hours. See why templates get rejected.
Template status#
POST /whatsapp/template/status
| Parameter | Required | Description |
|---|---|---|
phone_number_id |
Yes | — |
template_id |
Yes | Meta's long template ID, e.g. 129847192847198 |
Returns the live status from WhatsApp (approved, in review, rejected, paused), the quality rating and any rejection reason.
Bot flow list#
POST /whatsapp/get/bot-flow-list — phone_number_id required. Lists your Keyword Replies flows with their unique_id.
Trigger a bot flow#
POST /whatsapp/trigger-bot
| Parameter | Required | Description |
|---|---|---|
phone_number_id, phone_number |
Yes | — |
bot_flow_unique_id |
Yes | From Bot Flow List |
Starts that flow for the customer, as if they'd sent its keyword — useful after a website form or a payment. Outside the 24-hour window, only template steps are delivered.