WhatsApp API Platform
Chatbots

Activate chatbot flow

POST
/api/v1/chatbots/{id}/activate

Compile and activate the chatbot's current flow. Returns the newly activated flow version.

Authorization

ApiKeyAuth
X-API-Key<token>

API key from your dashboard (Settings > API Keys)

In: header

Path Parameters

id*string

Chatbot ID (cuid2)

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://loading/api/v1/chatbots/cbt_abc123/activate"
{
  "success": true,
  "data": {
    "id": "string",
    "chatbot_id": "string",
    "version_number": 0,
    "status": "string",
    "start_node_id": "string",
    "activated_at": "2019-08-24T14:15:22Z",
    "superseded_at": "2019-08-24T14:15:22Z"
  }
}
{
  "success": false,
  "message": "to field is required"
}
{
  "success": false,
  "message": "user not authenticated"
}
{
  "success": false,
  "message": "Chatbot not found"
}
{
  "success": false,
  "message": "internal server error"
}

Unassign specific agents from a customer PATCH

Removes the listed agents from a customer's assignments. Agents not currently assigned are silently ignored — the response reports only the agents actually removed.

Create chatbot POST

Create a new chatbot. A successful create returns the chatbot in `DRAFT` status; build its flow from the dashboard, then activate it.