Zalo Auto
Danh mục thao tác

Tạo bình chọn

groups.poll.createMCP:groups_poll_createBộ công cụ: Tài khoản & quan hệ

Create a poll in a group: multiple choice, expiry, and (agent 1.4.0) members adding options, results hidden until one votes, anonymous voters.

Cần Idempotency-Key
Xếp hàng theo hạn mức của tài khoản
Quyền: Thao tác Zalo

Gọi bằng REST v2

curl -X POST https://zl.builera.app/api/public/v2/ops/groups.poll.create \
  -H "Authorization: Bearer za_live_…" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"groupRowId":"3f2b8c1e-5d4a-4e6b-9c7d-1a2b3c4d5e6f","question":"Chào anh, em gửi thông tin ạ","options":["x","x"]}'

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": "groups_poll_create",
    "arguments": {
      "groupRowId": "3f2b8c1e-5d4a-4e6b-9c7d-1a2b3c4d5e6f",
      "question": "Chào anh, em gửi thông tin ạ",
      "options": [
        "x",
        "x"
      ]
    }
  }
}

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 202
{ "status": "accepted", "operationId": "…", "jobId": "…", "data": { … } }

→ operations.wait (tối đa 20 giây) hoặc webhook để biết kết quả trên Zalo

Ví dụ đầu vào

{
  "groupRowId": "3f2b8c1e-5d4a-4e6b-9c7d-1a2b3c4d5e6f",
  "question": "Chào anh, em gửi thông tin ạ",
  "options": [
    "x",
    "x"
  ]
}

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": {
    "groupRowId": {
      "type": "string",
      "format": "uuid",
      "description": "Group id from groups_list (our row id, not the Zalo group id)."
    },
    "question": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    },
    "options": {
      "type": "array",
      "items": {
        "type": "string",
        "maxLength": 100
      },
      "minItems": 2,
      "maxItems": 20
    },
    "allowMultiple": {
      "type": "boolean",
      "default": false
    },
    "expiresAt": {
      "type": "integer",
      "nullable": true,
      "default": null
    },
    "allowAddNewOption": {
      "type": "boolean",
      "default": false,
      "description": "Members may add options (agent 1.4.0)."
    },
    "hideVotePreview": {
      "type": "boolean",
      "default": false,
      "description": "Results hidden until the member votes (agent 1.4.0)."
    },
    "isAnonymous": {
      "type": "boolean",
      "default": false,
      "description": "Voters are hidden (agent 1.4.0)."
    }
  },
  "required": [
    "groupRowId",
    "question",
    "options"
  ],
  "additionalProperties": false
}

Cùng bộ công cụ

Thêm tài khoản ZaloBắt đầu đăng nhập QRTrạng thái đăng nhập QRHuỷ đăng nhập QRTạm dừng tài khoảnTiếp tục tài khoảnSửa cài đặt tài khoảnĐồng bộ lại từ Zalo