Danh mục thao tác

Sự kiện

events.listMCP:events_listBộ công cụ: Theo dõi & sự kiện

Everything that happened in the workspace since a cursor, in order, kept 7 days: messages (received, sent, status, reactions, recalls), command/job results, account/policy/Zalo-wait changes, friends and groups, customers, campaigns and journeys, rule runs, assignments, tasks, connections. Filter by types (e.g. message.received) or one account. Keep the returned cursor for the next call: events come in the order they were committed, as soon as they are committed, and a cursor never skips one (seq is the position, eventId the stable id to de-duplicate). Webhooks push the same events.

Chỉ đọc
Quyền: Đọc

Gọi bằng REST v2

curl -X POST https://zl.builera.app/api/public/v2/ops/events.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": "events_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": {
    "after": {
      "type": "integer",
      "minimum": 0,
      "default": 0
    },
    "types": {
      "type": "array",
      "items": {
        "type": "string",
        "maxLength": 60
      },
      "maxItems": 30
    },
    "accountId": {
      "type": "string",
      "format": "uuid"
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 200,
      "default": 100
    }
  },
  "additionalProperties": false
}

Cùng bộ công cụ