Danh sách lệnh`operations_list`

List operations

Chỉ đọcHồ sơ: Lõi (luôn có)Quyền: Lệnh · đọc

Recent commands with their state, newest first; filter by number, state, gate (rest/mcp/schedule) or only your own. Cursor paging.

Không thay đổi gì.

REST

GET

/api/public/v2/operations

MCP

operations_list

Cùng tên trên cổng đăng nhập /mcp và cổng khoá /api/public/mcp.

Tham số

Tên	Ở đâu	Kiểu	Bắt buộc	Mô tả
`numberId`	query	`uuid`	Không	—
`status`	query	`"queued" \| "waiting" \| "running" \| "succeeded" \| "partial" \| "failed" \| "cancelled" \| "unverified" \| "expired"`	Không	—
`via`	query	`"rest" \| "mcp" \| "schedule"`	Không	—
`mine`	query	`boolean`	Không	Mặc định false.
`cursor`	query	`string`	Không	Tối đa 200 ký tự.
`limit`	query	`integer`	Không	Mặc định 25. Từ 1 tới 100.

Không gửi workspaceId: luôn lấy từ khoá hoặc kết nối AI.

curl -X GET "https://<ten-mien-cua-ban>/api/public/v2/operations?numberId=3f2c1e9b-6a4d-4c0f-b2e8-3d7a9f1c2e44&status=queued&via=rest" \
  -H "Authorization: Bearer $WA_AUTO_KEY"

Phản hồi (200)

{
  "…": "dữ liệu của thao tác"
}

Lỗi có thể gặp

HTTP	code	Ý nghĩa
401	`unauthorized`	Thiếu khoá/đăng nhập, hoặc khoá không đúng.
403	`permission_denied`	Khoá/kết nối không có quyền này, hoặc vai trò của người tạo không đủ.
403	`number_not_allowed`	Khoá/kết nối không được dùng số WhatsApp này (hoặc thao tác cần quyền “mọi số”).
422	`validation_failed`	Dữ liệu gửi lên sai kiểu hoặc thiếu trường — xem `violations`.
429	`rate_limited`	Quá 60 yêu cầu/phút cho một khoá hoặc kết nối — đợi theo Retry-After.
503	`paused`	API/MCP đang tạm dừng (nút ngắt khẩn của workspace hoặc đội vận hành).

Lỗi theo RFC 9457 (application/problem+json). Xem mọi mã lỗi.

# MCP (JSON-RPC) — tools/call
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "operations_list",
    "arguments": {
      "numberId": "3f2c1e9b-6a4d-4c0f-b2e8-3d7a9f1c2e44",
      "status": "queued",
      "via": "rest"
    }
  }
}