Danh sách hội thoại
inbox.conversations.listMCP:inbox_conversations_listBộ công cụ: Quan sátList Zalo conversations visible to the caller, newest first, with unread/unanswered state and filters. Use to find who is waiting for a reply.
Chỉ đọc
Quyền: Đọc
Gọi bằng REST v2
curl -X POST https://zl.builera.app/api/public/v2/ops/inbox.conversations.list \
-H "Authorization: Bearer za_live_…" \
-H "Content-Type: application/json" \
-d '{}'Mỗi khoá/kết nối tối đa 300 lệnh đọc và 60 lệnh ghi mỗi phút. Gọi lại cùng Idempotency-Key trả đúng kết quả cũ, không làm lại.
Gọi qua MCP
{
"method": "tools/call",
"params": {
"name": "inbox_conversations_list",
"arguments": {}
}
}Thêm https://zl.builera.app/mcp vào ứng dụng AI rồi cho phép kết nối; AI chỉ thấy công cụ trong bộ bạn chọn.
Kết quả
HTTP 200
{ "status": "succeeded", "operationId": "…", "data": { … } }Ví dụ đầu vào
{}Thay mã (id) mẫu bằng mã thật lấy từ các thao tác liệt kê/tìm kiếm.
Lược đồ đầu vào (JSON Schema)
{
"type": "object",
"properties": {
"accountId": {
"type": "string",
"format": "uuid"
},
"contactId": {
"type": "string",
"format": "uuid"
},
"search": {
"type": "string",
"maxLength": 100
},
"unanswered": {
"type": "boolean"
},
"unread": {
"type": "boolean"
},
"assigned": {
"anyOf": [
{
"type": "string",
"enum": [
"me",
"none"
]
},
{
"type": "string",
"format": "uuid"
}
]
},
"type": {
"type": "string",
"enum": [
"user",
"group"
]
},
"labelId": {
"type": "string",
"format": "uuid"
},
"pinned": {
"type": "boolean"
},
"hidden": {
"type": "boolean",
"default": false
},
"cursor": {
"type": "string",
"maxLength": 200,
"nullable": true,
"default": null
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 100,
"default": 50
}
},
"additionalProperties": false
}