Danh mục thao tác

Tổng quan

dashboard.getMCP:dashboard_getBộ công cụ: Quan sát

Dashboard KPIs for today/this week/this month: messages, replies, new contacts, campaign progress, unanswered.

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

Gọi bằng REST v2

curl -X POST https://zl.builera.app/api/public/v2/ops/dashboard.get \
  -H "Authorization: Bearer za_live_…" \
  -H "Content-Type: application/json" \
  -d '{"today":{"from":"2026-11-01T09:00:00+07:00","to":"2026-11-01T09:00:00+07:00"},"week":{"from":"2026-11-01T09:00:00+07:00","to":"2026-11-01T09:00:00+07:00"},"month":{"from":"2026-11-01T09:00:00+07:00","to":"2026-11-01T09:00:00+07:00"}}'

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": "dashboard_get",
    "arguments": {
      "today": {
        "from": "2026-11-01T09:00:00+07:00",
        "to": "2026-11-01T09:00:00+07:00"
      },
      "week": {
        "from": "2026-11-01T09:00:00+07:00",
        "to": "2026-11-01T09:00:00+07:00"
      },
      "month": {
        "from": "2026-11-01T09:00:00+07:00",
        "to": "2026-11-01T09:00:00+07:00"
      }
    }
  }
}

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

{
  "today": {
    "from": "2026-11-01T09:00:00+07:00",
    "to": "2026-11-01T09:00:00+07:00"
  },
  "week": {
    "from": "2026-11-01T09:00:00+07:00",
    "to": "2026-11-01T09:00:00+07:00"
  },
  "month": {
    "from": "2026-11-01T09:00:00+07:00",
    "to": "2026-11-01T09:00:00+07:00"
  }
}

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": {
    "today": {
      "type": "object",
      "properties": {
        "from": {
          "type": "string",
          "format": "date-time"
        },
        "to": {
          "type": "string",
          "format": "date-time"
        }
      },
      "required": [
        "from",
        "to"
      ],
      "additionalProperties": false
    },
    "week": {
      "type": "object",
      "properties": {
        "from": {
          "type": "string",
          "format": "date-time"
        },
        "to": {
          "type": "string",
          "format": "date-time"
        }
      },
      "required": [
        "from",
        "to"
      ],
      "additionalProperties": false
    },
    "month": {
      "type": "object",
      "properties": {
        "from": {
          "type": "string",
          "format": "date-time"
        },
        "to": {
          "type": "string",
          "format": "date-time"
        }
      },
      "required": [
        "from",
        "to"
      ],
      "additionalProperties": false
    }
  },
  "required": [
    "today",
    "week",
    "month"
  ],
  "additionalProperties": false
}

Cùng bộ công cụ