Documentation Index
Fetch the complete documentation index at: /llms.txt
Use this file to discover all available pages before exploring further.
Widget-facing endpoints for messages, conversation history, and escalation.
https://platform.watermelonn.app/api/v1/chat
/message{
"conversationId": "optional-uuid",
"message": "Where is my order #1234?"
}
conversationId (optional): if omitted, backend creates a new conversation.message (required): 1–2000 characters.{
"conversationId": "uuid",
"message": {
"id": "uuid",
"content": "Your order #1234 is in transit.",
"role": "assistant",
"createdAt": "2026-04-27T10:30:00.000Z"
},
"metadata": {
"intentDetected": "track_order",
"confidence": 0.93,
"entitiesExtracted": {
"orderId": "1234"
}
}
}
/conversations/:id{
"conversation": {
"id": "uuid",
"tenantId": "uuid",
"status": "active"
},
"messages": [
{
"id": "uuid",
"role": "user",
"content": "Where is my order #1234?"
}
]
}
/escalate{
"conversationId": "uuid",
"reason": "Customer asked for human support"
}
{
"success": true,
"ticketId": "tkt_xxx",
"message": "I've created support ticket #tkt_xxx."
}