Công cụ AI — Office

37 công cụ. Schema luôn mới nhất ở office_tool_catalog khi đã kết nối.

Thư gần đây của tôi

ĐọcScope: office:read

get_my_recent_mail

Các thư gần đây trong hộp thư cá nhân của chính người dùng: người gửi, tiêu đề, trạng thái đã đọc.

Tham số	Kiểu	Bắt buộc	Mô tả
`limit`	integer	không	Số thư, mặc định 10, tối đa 30

Hoặc gọi REST bằng API key

curl -X POST https://api.nextx.vn/api/v1/ai/tools/office/get_my_recent_mail/read \
  -H "X-Api-Key: $API_KEY" -H "Content-Type: application/json" \
  -d '{"limit":10}'

Ví dụ gọi qua MCP (dành cho trợ lý AI)

Trợ lý AI tự gửi lệnh này khi bạn hỏi bằng lời; bạn chỉ cần xem khi tự gỡ lỗi kết nối MCP.

{
  "name": "get_my_recent_mail",
  "arguments": {
    "args": {
      "limit": 10
    }
  }
}

Bật luật tự động hoá

Write proposalScope: office:write

office_activate_automation

Bật một luật tự động hoá Office để bắt đầu chạy khi có sự kiện; kiểm như nút Bật trên màn. Tạo đề xuất; người dùng bấm Xác nhận trong app mới thực hiện.

Tham số	Kiểu	Bắt buộc	Mô tả
`automationName`	string	không	Tên luật (bỏ trống nếu đang mở luật trên màn)

Ví dụ gọi qua MCP (dành cho trợ lý AI)

Trợ lý AI tự gửi lệnh này khi bạn hỏi bằng lời; bạn chỉ cần xem khi tự gỡ lỗi kết nối MCP.

{
  "name": "office_activate_automation",
  "arguments": {
    "args": {
      "automationName": "Giao việc khi có đơn mới"
    }
  }
}

Thêm mục checklist

Write proposalScope: office:write

office_add_checklist_item

Thêm một mục checklist vào một việc. Tạo đề xuất; người dùng bấm Xác nhận trong app mới thực hiện.

Tham số	Kiểu	Bắt buộc	Mô tả
`taskId`	string	không	Id việc
`title`	string	không	Tiêu đề việc khi không có taskId
`itemTitle`	string	có	Nội dung mục

Ví dụ gọi qua MCP (dành cho trợ lý AI)

Trợ lý AI tự gửi lệnh này khi bạn hỏi bằng lời; bạn chỉ cần xem khi tự gỡ lỗi kết nối MCP.

{
  "name": "office_add_checklist_item",
  "arguments": {
    "args": {
      "title": "Chuẩn bị báo giá",
      "itemTitle": "Gửi bản nháp"
    }
  }
}

Bình luận vào việc

Write proposalScope: office:write

office_add_task_comment

Ghi một bình luận vào một việc Office. Tạo đề xuất; người dùng bấm Xác nhận trong app mới thực hiện.

Tham số	Kiểu	Bắt buộc	Mô tả
`taskId`	string	không	Id việc (lấy từ office_list_tasks)
`title`	string	không	Tiêu đề chính xác của việc, khi không có taskId
`content`	string	không	Nội dung bình luận

Ví dụ gọi qua MCP (dành cho trợ lý AI)

Trợ lý AI tự gửi lệnh này khi bạn hỏi bằng lời; bạn chỉ cần xem khi tự gỡ lỗi kết nối MCP.

{
  "name": "office_add_task_comment",
  "arguments": {
    "args": {
      "title": "Chuẩn bị báo giá",
      "content": "Đã gửi bản nháp"
    }
  }
}

Duyệt bước trong phiếu duyệt

Write proposalScope: office:write

office_approve_approval_task

Duyệt một bước duyệt đang chờ người dùng trong phiếu duyệt. Tạo đề xuất; người dùng bấm Xác nhận trong app mới thực hiện.

Tham số	Kiểu	Bắt buộc	Mô tả
`taskId`	string	có	Id bước duyệt (lấy từ office_get_approval_instance)
`comment`	string	không	Ý kiến khi duyệt

Ví dụ gọi qua MCP (dành cho trợ lý AI)

Trợ lý AI tự gửi lệnh này khi bạn hỏi bằng lời; bạn chỉ cần xem khi tự gỡ lỗi kết nối MCP.

{
  "name": "office_approve_approval_task",
  "arguments": {
    "args": {
      "taskId": "0199a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b",
      "comment": "Đồng ý"
    }
  }
}

Duyệt việc

Write proposalScope: office:write

office_approve_task

Duyệt một việc Office đang chờ duyệt, chuyển sang Xong. Tạo đề xuất; người dùng bấm Xác nhận trong app mới thực hiện.

Tham số	Kiểu	Bắt buộc	Mô tả
`taskId`	string	không	Id việc (lấy từ office_list_tasks)
`title`	string	không	Tiêu đề chính xác của việc, khi không có taskId

Ví dụ gọi qua MCP (dành cho trợ lý AI)

Trợ lý AI tự gửi lệnh này khi bạn hỏi bằng lời; bạn chỉ cần xem khi tự gỡ lỗi kết nối MCP.

{
  "name": "office_approve_task",
  "arguments": {
    "args": {
      "title": "Chuẩn bị báo giá"
    }
  }
}

Danh mục khối tự động hoá

ĐọcScope: office:read

office_automation_catalog

Danh mục khối dựng luật tự động hoá Office: loại sự kiện kích hoạt, loại hành động (giao việc, gửi email nội bộ, cập nhật bản ghi…) kèm trường cấu hình.

Không có tham số.

Hoặc gọi REST bằng API key

curl -X POST https://api.nextx.vn/api/v1/ai/tools/office/office_automation_catalog/read \
  -H "X-Api-Key: $API_KEY" -H "Content-Type: application/json" \
  -d '{}'

Ví dụ gọi qua MCP (dành cho trợ lý AI)

Trợ lý AI tự gửi lệnh này khi bạn hỏi bằng lời; bạn chỉ cần xem khi tự gỡ lỗi kết nối MCP.

{
  "name": "office_automation_catalog",
  "arguments": {
    "args": {}
  }
}

Huỷ cuộc họp

Write proposalScope: office:write

office_cancel_event

Huỷ một cuộc họp do chính người đang chat chủ trì. Tạo đề xuất; người dùng bấm Xác nhận trong app mới thực hiện.

Tham số	Kiểu	Bắt buộc	Mô tả
`eventId`	string	có	Cuộc họp cần huỷ

Ví dụ gọi qua MCP (dành cho trợ lý AI)

Trợ lý AI tự gửi lệnh này khi bạn hỏi bằng lời; bạn chỉ cần xem khi tự gỡ lỗi kết nối MCP.

{
  "name": "office_cancel_event",
  "arguments": {
    "args": {
      "eventId": "0199a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"
    }
  }
}

Kiểm đồ thị luật

ĐọcScope: office:read

office_check_graph

Kiểm một đồ thị luật Office chưa lưu như lúc bấm Bật: các bước, phần kích hoạt, phân hệ nguồn. Không ghi gì.

Tham số	Kiểu	Bắt buộc	Mô tả
`graph`	object	không	Đồ thị gọn của luật

Hoặc gọi REST bằng API key

curl -X POST https://api.nextx.vn/api/v1/ai/tools/office/office_check_graph/read \
  -H "X-Api-Key: $API_KEY" -H "Content-Type: application/json" \
  -d '{"graph":{"trigger":"record_created","triggerConfig":{"tableId":"0199a1b2-0000-7000-8000-00000000a001"},"steps":[{"ref":"S1","kind":"action","actionType":"create_task","config":{"title":"Gọi lại khách đăng ký","assigneeName":"Nguyễn Văn An"}},{"ref":"S2","kind":"action","actionType":"send_notification","config":{"message":"Có đăng ký mới"}}]}}'

Ví dụ gọi qua MCP (dành cho trợ lý AI)

Trợ lý AI tự gửi lệnh này khi bạn hỏi bằng lời; bạn chỉ cần xem khi tự gỡ lỗi kết nối MCP.

{
  "name": "office_check_graph",
  "arguments": {
    "args": {
      "graph": {
        "trigger": "record_created",
        "triggerConfig": {
          "tableId": "0199a1b2-0000-7000-8000-00000000a001"
        },
        "steps": [
          {
            "ref": "S1",
            "kind": "action",
            "actionType": "create_task",
            "config": {
              "title": "Gọi lại khách đăng ký",
              "assigneeName": "Nguyễn Văn An"
            }
          },
          {
            "ref": "S2",
            "kind": "action",
            "actionType": "send_notification",
            "config": {
              "message": "Có đăng ký mới"
            }
          }
        ]
      }
    }
  }
}

Gửi phiếu duyệt

Write proposalScope: office:write

office_create_approval_instance

Gửi một phiếu duyệt mới theo quy trình, kèm nội dung phiếu. Tạo đề xuất; người dùng bấm Xác nhận trong app mới thực hiện.

Tham số	Kiểu	Bắt buộc	Mô tả
`definitionCode`	string	có	Mã quy trình duyệt
`formValue`	object	không	Nội dung phiếu: mã ô → giá trị

Ví dụ gọi qua MCP (dành cho trợ lý AI)

Trợ lý AI tự gửi lệnh này khi bạn hỏi bằng lời; bạn chỉ cần xem khi tự gỡ lỗi kết nối MCP.

{
  "name": "office_create_approval_instance",
  "arguments": {
    "args": {
      "definitionCode": "NGHI_PHEP",
      "formValue": {
        "so_ngay": 1
      }
    }
  }
}

Tạo luật tự động hoá

Write proposalScope: office:write

office_create_automation_from_graph

Tạo một luật tự động hoá Office mới (khi có sự kiện thì giao việc, gửi email nội bộ, cập nhật bản ghi…) từ đồ thị gọn. Tạo đề xuất; người dùng bấm Xác nhận trong app mới thực hiện.

Tham số	Kiểu	Bắt buộc	Mô tả
`name`	string	có	Tên luật
`graph`	object	không	Đồ thị gọn của luật

Ví dụ gọi qua MCP (dành cho trợ lý AI)

Trợ lý AI tự gửi lệnh này khi bạn hỏi bằng lời; bạn chỉ cần xem khi tự gỡ lỗi kết nối MCP.

{
  "name": "office_create_automation_from_graph",
  "arguments": {
    "args": {
      "name": "Giao việc khi có đăng ký mới",
      "graph": {
        "trigger": "record_created",
        "triggerConfig": {
          "tableId": "0199a1b2-0000-7000-8000-00000000a001"
        },
        "steps": [
          {
            "ref": "S1",
            "kind": "action",
            "actionType": "create_task",
            "config": {
              "title": "Gọi lại khách đăng ký",
              "assigneeName": "Nguyễn Văn An"
            }
          },
          {
            "ref": "S2",
            "kind": "action",
            "actionType": "send_notification",
            "config": {
              "message": "Có đăng ký mới"
            }
          }
        ]
      }
    }
  }
}

Tạo cuộc họp

Write proposalScope: office:write

office_create_event

Tạo một cuộc họp trên lịch cá nhân của người dùng, kèm người tham dự, địa điểm và ghi chú. Tạo đề xuất; người dùng bấm Xác nhận trong app mới thực hiện.

Tham số	Kiểu	Bắt buộc	Mô tả
`title`	string	có	Tiêu đề cuộc họp
`startAt`	string	có	Bắt đầu: yyyy-MM-dd (cả ngày), yyyy-MM-ddTHH:mm giờ Việt Nam hoặc ISO có múi giờ
`endAt`	string	không	Kết thúc, cùng kiểu startAt; bỏ trống = 1 giờ
`attendeeNames`	string	không	Họ tên người tham dự trong công ty, cách nhau bằng dấu phẩy
`location`	string	không	Địa điểm

Ví dụ gọi qua MCP (dành cho trợ lý AI)

Trợ lý AI tự gửi lệnh này khi bạn hỏi bằng lời; bạn chỉ cần xem khi tự gỡ lỗi kết nối MCP.

{
  "name": "office_create_event",
  "arguments": {
    "args": {
      "title": "Họp giao ban",
      "startAt": "2026-10-28T09:00",
      "attendeeNames": "Nguyễn Văn An, Trần Thị Bình"
    }
  }
}

Thêm dòng vào bảng dữ liệu

Write proposalScope: office:write

office_create_record

Thêm một dòng vào một bảng dữ liệu Office. Tạo đề xuất; người dùng bấm Xác nhận trong app mới thực hiện.

Tham số	Kiểu	Bắt buộc	Mô tả
`tableId`	string	có	Id bảng
`data`	object	có	Giá trị theo mã cột

Ví dụ gọi qua MCP (dành cho trợ lý AI)

Trợ lý AI tự gửi lệnh này khi bạn hỏi bằng lời; bạn chỉ cần xem khi tự gỡ lỗi kết nối MCP.

{
  "name": "office_create_record",
  "arguments": {
    "args": {
      "tableId": "0199a1b2-0000-7000-8000-00000000a001",
      "data": {
        "ten_khach": "Nguyễn Văn An",
        "so_dien_thoai": "0901234567"
      }
    }
  }
}

Tạo việc

Write proposalScope: office:write

office_create_task

Tạo một việc trên Office: tiêu đề, người nhận, hạn, mức ưu tiên, dự án. Tạo đề xuất; người dùng bấm Xác nhận trong app mới thực hiện.

Tham số	Kiểu	Bắt buộc	Mô tả
`title`	string	có	Tiêu đề việc
`assigneeName`	string	không	Họ tên người nhận trong công ty
`dueAt`	string	không	Hạn: yyyy-MM-dd (17:00 giờ Việt Nam) hoặc ISO có múi giờ
`priority`	string	không	Thấp, Trung bình hoặc Cao
`listName`	string	không	Tên dự án; bỏ trống = chưa xếp

Ví dụ gọi qua MCP (dành cho trợ lý AI)

Trợ lý AI tự gửi lệnh này khi bạn hỏi bằng lời; bạn chỉ cần xem khi tự gỡ lỗi kết nối MCP.

{
  "name": "office_create_task",
  "arguments": {
    "args": {
      "title": "Chuẩn bị báo giá",
      "assigneeName": "Nguyễn Văn An",
      "dueAt": "2026-10-30"
    }
  }
}

Tạo việc từ chat nhóm

Write proposalScope: office:write

office_create_task_from_chat

Tạo một việc cho một chủ đề trong đoạn chat nhóm Office (vấn đề, nguyên nhân, yêu cầu sửa) và đăng thẻ việc vào đúng nhóm. Tạo đề xuất; người dùng bấm Xác nhận trong app mới thực hiện.

Tham số	Kiểu	Bắt buộc	Mô tả
`messageId`	string	có	Id một tin nguồn trong đoạn (lấy từ office_read_group_chat)
`problem`	string	có	Vấn đề
`cause`	string	có	Nguyên nhân
`fixRequest`	string	có	Yêu cầu sửa; cũng là tiêu đề việc
`assigneeName`	string	không	Người nhận
`dueAt`	string	không	Hạn (yyyy-MM-dd)

Ví dụ gọi qua MCP (dành cho trợ lý AI)

Trợ lý AI tự gửi lệnh này khi bạn hỏi bằng lời; bạn chỉ cần xem khi tự gỡ lỗi kết nối MCP.

{
  "name": "office_create_task_from_chat",
  "arguments": {
    "args": {
      "messageId": "0199a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b",
      "problem": "Khách phản hồi giao hàng trễ 2 ngày",
      "cause": "Kho chưa nhận lịch xuất",
      "fixRequest": "Lập lịch xuất kho hằng ngày lúc 8 giờ",
      "assigneeName": "Trần Thị Bình",
      "dueAt": "2026-10-30"
    }
  }
}

Tạo danh sách việc

Write proposalScope: office:write

office_create_task_list

Tạo một danh sách việc, cũng là một dự án trên màn Công việc. Tạo đề xuất; người dùng bấm Xác nhận trong app mới thực hiện.

Tham số	Kiểu	Bắt buộc	Mô tả
`name`	string	có	Tên danh sách

Ví dụ gọi qua MCP (dành cho trợ lý AI)

Trợ lý AI tự gửi lệnh này khi bạn hỏi bằng lời; bạn chỉ cần xem khi tự gỡ lỗi kết nối MCP.

{
  "name": "office_create_task_list",
  "arguments": {
    "args": {
      "name": "Khai trương Quận 7"
    }
  }
}

Xoá dòng của bảng dữ liệu

Write proposalScope: office:write

office_delete_record

Chuyển một dòng của bảng dữ liệu Office vào thùng rác. Tạo đề xuất; người dùng bấm Xác nhận trong app mới thực hiện.

Tham số	Kiểu	Bắt buộc	Mô tả
`tableId`	string	có	Id bảng
`recordId`	string	có	Id dòng (lấy từ office_list_records)

Ví dụ gọi qua MCP (dành cho trợ lý AI)

Trợ lý AI tự gửi lệnh này khi bạn hỏi bằng lời; bạn chỉ cần xem khi tự gỡ lỗi kết nối MCP.

{
  "name": "office_delete_record",
  "arguments": {
    "args": {
      "tableId": "0199a1b2-0000-7000-8000-00000000a001",
      "recordId": "0199a1b2-0000-7000-8000-00000000b001"
    }
  }
}

Xoá việc

Write proposalScope: office:write

office_delete_task

Chuyển một việc Office (kèm việc con) vào thùng rác, giữ 30 ngày. Tạo đề xuất; người dùng bấm Xác nhận trong app mới thực hiện.

Tham số	Kiểu	Bắt buộc	Mô tả
`taskId`	string	không	Id việc (lấy từ office_list_tasks)
`title`	string	không	Tiêu đề chính xác của việc, khi không có taskId

Ví dụ gọi qua MCP (dành cho trợ lý AI)

Trợ lý AI tự gửi lệnh này khi bạn hỏi bằng lời; bạn chỉ cần xem khi tự gỡ lỗi kết nối MCP.

{
  "name": "office_delete_task",
  "arguments": {
    "args": {
      "title": "Chuẩn bị báo giá"
    }
  }
}

Chi tiết phiếu duyệt

ĐọcScope: office:read

office_get_approval_instance

Chi tiết một phiếu duyệt: nội dung, các bước duyệt và dòng thời gian.

Tham số	Kiểu	Bắt buộc	Mô tả
`instanceId`	string	có	Id phiếu (lấy từ office_list_approval_instances)

Hoặc gọi REST bằng API key

curl -X POST https://api.nextx.vn/api/v1/ai/tools/office/office_get_approval_instance/read \
  -H "X-Api-Key: $API_KEY" -H "Content-Type: application/json" \
  -d '{"instanceId":"0199a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}'

Ví dụ gọi qua MCP (dành cho trợ lý AI)

Trợ lý AI tự gửi lệnh này khi bạn hỏi bằng lời; bạn chỉ cần xem khi tự gỡ lỗi kết nối MCP.

{
  "name": "office_get_approval_instance",
  "arguments": {
    "args": {
      "instanceId": "0199a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"
    }
  }
}

Một dòng của bảng dữ liệu

ĐọcScope: office:read

office_get_record

Đọc một dòng của bảng dữ liệu Office; dòng ngoài quyền xem trả về không tìm thấy.

Tham số	Kiểu	Bắt buộc	Mô tả
`tableId`	string	có	Id bảng
`recordId`	string	có	Id dòng (lấy từ office_list_records)

Hoặc gọi REST bằng API key

curl -X POST https://api.nextx.vn/api/v1/ai/tools/office/office_get_record/read \
  -H "X-Api-Key: $API_KEY" -H "Content-Type: application/json" \
  -d '{"tableId":"0199a1b2-0000-7000-8000-00000000a001","recordId":"0199a1b2-0000-7000-8000-00000000b001"}'

Ví dụ gọi qua MCP (dành cho trợ lý AI)

Trợ lý AI tự gửi lệnh này khi bạn hỏi bằng lời; bạn chỉ cần xem khi tự gỡ lỗi kết nối MCP.

{
  "name": "office_get_record",
  "arguments": {
    "args": {
      "tableId": "0199a1b2-0000-7000-8000-00000000a001",
      "recordId": "0199a1b2-0000-7000-8000-00000000b001"
    }
  }
}

Phiếu duyệt

ĐọcScope: office:read

office_list_approval_instances

Danh sách phiếu duyệt của người dùng: phiếu đã gửi, phiếu đang chờ duyệt hoặc phiếu đã xử lý.

Tham số	Kiểu	Bắt buộc	Mô tả
`role`	string	không	mine = phiếu tôi gửi (mặc định), todo = chờ tôi duyệt, acted = tôi đã xử lý
`page`	integer	không	Trang, bắt đầu từ 1
`pageSize`	integer	không	Số phiếu mỗi trang, 1–100, mặc định 20

Hoặc gọi REST bằng API key

curl -X POST https://api.nextx.vn/api/v1/ai/tools/office/office_list_approval_instances/read \
  -H "X-Api-Key: $API_KEY" -H "Content-Type: application/json" \
  -d '{"role":"todo"}'

Ví dụ gọi qua MCP (dành cho trợ lý AI)

Trợ lý AI tự gửi lệnh này khi bạn hỏi bằng lời; bạn chỉ cần xem khi tự gỡ lỗi kết nối MCP.

{
  "name": "office_list_approval_instances",
  "arguments": {
    "args": {
      "role": "todo"
    }
  }
}

Luật tự động hoá

ĐọcScope: office:read

office_list_automations

Danh sách luật tự động hoá Office: tên, trạng thái (nháp, đang chạy, tạm dừng), loại kích hoạt, số bước.

Tham số	Kiểu	Bắt buộc	Mô tả
`search`	string	không	Một phần tên
`status`	string	không	Draft, Active hoặc Paused
`includeGraph`	boolean	không	true = kèm đồ thị khi chỉ còn một kết quả

Hoặc gọi REST bằng API key

curl -X POST https://api.nextx.vn/api/v1/ai/tools/office/office_list_automations/read \
  -H "X-Api-Key: $API_KEY" -H "Content-Type: application/json" \
  -d '{"status":"Active"}'

Ví dụ gọi qua MCP (dành cho trợ lý AI)

Trợ lý AI tự gửi lệnh này khi bạn hỏi bằng lời; bạn chỉ cần xem khi tự gỡ lỗi kết nối MCP.

{
  "name": "office_list_automations",
  "arguments": {
    "args": {
      "status": "Active"
    }
  }
}

Lịch của tôi

ĐọcScope: office:read

office_list_my_calendar

Các cuộc họp của chính người đang chat trong khoảng ngày. Bỏ trống thì 7 ngày tới, tối đa 31 ngày. Không trả người dự hay email.

Tham số	Kiểu	Bắt buộc	Mô tả
`from`	string	không	Từ ngày (yyyy-MM-dd)
`to`	string	không	Đến ngày (yyyy-MM-dd)

Hoặc gọi REST bằng API key

curl -X POST https://api.nextx.vn/api/v1/ai/tools/office/office_list_my_calendar/read \
  -H "X-Api-Key: $API_KEY" -H "Content-Type: application/json" \
  -d '{}'

Ví dụ gọi qua MCP (dành cho trợ lý AI)

Trợ lý AI tự gửi lệnh này khi bạn hỏi bằng lời; bạn chỉ cần xem khi tự gỡ lỗi kết nối MCP.

{
  "name": "office_list_my_calendar",
  "arguments": {
    "args": {}
  }
}

Dòng của bảng dữ liệu

ĐọcScope: office:read

office_list_records

Danh sách dòng của một bảng dữ liệu Office; chỉ thấy dòng và cột người dùng được xem.

Tham số	Kiểu	Bắt buộc	Mô tả
`tableId`	string	có	Id bảng
`page`	integer	không	Trang, bắt đầu từ 1
`pageSize`	integer	không	Số dòng mỗi trang, 1–100, mặc định 20

Hoặc gọi REST bằng API key

curl -X POST https://api.nextx.vn/api/v1/ai/tools/office/office_list_records/read \
  -H "X-Api-Key: $API_KEY" -H "Content-Type: application/json" \
  -d '{"tableId":"0199a1b2-0000-7000-8000-00000000a001","pageSize":20}'

Ví dụ gọi qua MCP (dành cho trợ lý AI)

Trợ lý AI tự gửi lệnh này khi bạn hỏi bằng lời; bạn chỉ cần xem khi tự gỡ lỗi kết nối MCP.

{
  "name": "office_list_records",
  "arguments": {
    "args": {
      "tableId": "0199a1b2-0000-7000-8000-00000000a001",
      "pageSize": 20
    }
  }
}

Việc đang kẹt

ĐọcScope: office:read

office_list_stuck_tasks

Việc đang kẹt của người dùng — quá hạn, chờ duyệt, chưa giao — kèm lý do từng việc.

Không có tham số.

Hoặc gọi REST bằng API key

curl -X POST https://api.nextx.vn/api/v1/ai/tools/office/office_list_stuck_tasks/read \
  -H "X-Api-Key: $API_KEY" -H "Content-Type: application/json" \
  -d '{}'

Ví dụ gọi qua MCP (dành cho trợ lý AI)

Trợ lý AI tự gửi lệnh này khi bạn hỏi bằng lời; bạn chỉ cần xem khi tự gỡ lỗi kết nối MCP.

{
  "name": "office_list_stuck_tasks",
  "arguments": {
    "args": {}
  }
}

Danh sách việc

ĐọcScope: office:read

office_list_tasks

Danh sách việc Office: mặc định việc đang mở của người dùng; lọc theo quá hạn, người nhận, phạm vi, trạng thái, tiêu đề, ưu tiên, chưa giao.

Tham số	Kiểu	Bắt buộc	Mô tả
`overdue`	boolean	không	true = chỉ việc quá hạn
`assigneeName`	string	không	Họ tên người nhận
`scope`	string	không	assigned-to-me, created-by-me, watching…
`status`	string	không	Trạng thái; bỏ trống = đang mở
`search`	string	không	Một phần tiêu đề
`priority`	string	không	Thấp, Trung bình hoặc Cao
`unassigned`	boolean	không	true = chỉ việc chưa có người nhận

Hoặc gọi REST bằng API key

curl -X POST https://api.nextx.vn/api/v1/ai/tools/office/office_list_tasks/read \
  -H "X-Api-Key: $API_KEY" -H "Content-Type: application/json" \
  -d '{"overdue":true}'

Ví dụ gọi qua MCP (dành cho trợ lý AI)

Trợ lý AI tự gửi lệnh này khi bạn hỏi bằng lời; bạn chỉ cần xem khi tự gỡ lỗi kết nối MCP.

{
  "name": "office_list_tasks",
  "arguments": {
    "args": {
      "overdue": true
    }
  }
}

Tạm dừng luật tự động hoá

Write proposalScope: office:write

office_pause_automation

Tạm dừng một luật tự động hoá Office đang bật. Tạo đề xuất; người dùng bấm Xác nhận trong app mới thực hiện.

Tham số	Kiểu	Bắt buộc	Mô tả
`automationName`	string	không	Tên luật (bỏ trống nếu đang mở luật trên màn)

Ví dụ gọi qua MCP (dành cho trợ lý AI)

Trợ lý AI tự gửi lệnh này khi bạn hỏi bằng lời; bạn chỉ cần xem khi tự gỡ lỗi kết nối MCP.

{
  "name": "office_pause_automation",
  "arguments": {
    "args": {
      "automationName": "Giao việc khi có đăng ký mới"
    }
  }
}

Đọc chat nhóm

ĐọcScope: office:read

office_read_group_chat

Đọc tối đa 30 tin gần đây của một nhóm chat Office.

Tham số	Kiểu	Bắt buộc	Mô tả
`channelName`	string	không	Tên nhóm chat
`channelId`	string	không	Id nhóm khi đã xác định đúng một nhóm
`take`	integer	không	Số tin, 1–30, mặc định 20
`fromMessageId`	string	không	Tin đầu của đoạn đã chọn
`toMessageId`	string	không	Tin cuối của đoạn đã chọn

Hoặc gọi REST bằng API key

curl -X POST https://api.nextx.vn/api/v1/ai/tools/office/office_read_group_chat/read \
  -H "X-Api-Key: $API_KEY" -H "Content-Type: application/json" \
  -d '{"channelName":"Kinh doanh","take":20}'

Ví dụ gọi qua MCP (dành cho trợ lý AI)

Trợ lý AI tự gửi lệnh này khi bạn hỏi bằng lời; bạn chỉ cần xem khi tự gỡ lỗi kết nối MCP.

{
  "name": "office_read_group_chat",
  "arguments": {
    "args": {
      "channelName": "Kinh doanh",
      "take": 20
    }
  }
}

Từ chối bước duyệt

Write proposalScope: office:write

office_reject_approval_task

Từ chối một bước duyệt đang chờ người dùng, kèm lý do. Tạo đề xuất; người dùng bấm Xác nhận trong app mới thực hiện.

Tham số	Kiểu	Bắt buộc	Mô tả
`taskId`	string	có	Id bước duyệt (lấy từ office_get_approval_instance)
`comment`	string	không	Lý do từ chối

Ví dụ gọi qua MCP (dành cho trợ lý AI)

Trợ lý AI tự gửi lệnh này khi bạn hỏi bằng lời; bạn chỉ cần xem khi tự gỡ lỗi kết nối MCP.

{
  "name": "office_reject_approval_task",
  "arguments": {
    "args": {
      "taskId": "0199a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b",
      "comment": "Thiếu báo giá đính kèm"
    }
  }
}

Khôi phục việc

Write proposalScope: office:write

office_restore_task

Khôi phục một việc đang trong thùng rác, trong 30 ngày. Tạo đề xuất; người dùng bấm Xác nhận trong app mới thực hiện.

Tham số	Kiểu	Bắt buộc	Mô tả
`taskId`	string	có	Id việc trong thùng rác

Ví dụ gọi qua MCP (dành cho trợ lý AI)

Trợ lý AI tự gửi lệnh này khi bạn hỏi bằng lời; bạn chỉ cần xem khi tự gỡ lỗi kết nối MCP.

{
  "name": "office_restore_task",
  "arguments": {
    "args": {
      "taskId": "0199a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"
    }
  }
}

Trả việc

Write proposalScope: office:write

office_return_task

Trả một việc về, kèm lý do do người dùng nói. Tạo đề xuất; người dùng bấm Xác nhận trong app mới thực hiện.

Tham số	Kiểu	Bắt buộc	Mô tả
`taskId`	string	không	Id việc
`title`	string	không	Tiêu đề việc khi không có taskId
`reason`	string	có	Lý do trả việc

Ví dụ gọi qua MCP (dành cho trợ lý AI)

Trợ lý AI tự gửi lệnh này khi bạn hỏi bằng lời; bạn chỉ cần xem khi tự gỡ lỗi kết nối MCP.

{
  "name": "office_return_task",
  "arguments": {
    "args": {
      "title": "Chuẩn bị báo giá",
      "reason": "Thiếu số liệu"
    }
  }
}

Chạy thử luật tự động hoá

ĐọcScope: office:read

office_simulate_automation

Chạy thử một luật tự động hoá Office đã lưu trên dữ liệu sự kiện mẫu, không ghi gì: trả từng bước đã chạy hoặc bỏ qua và lý do kết thúc.

Tham số	Kiểu	Bắt buộc	Mô tả
`automationName`	string	không	Tên luật (bỏ trống nếu đang mở luật trên màn)
`triggerData`	string	không	Dữ liệu sự kiện mẫu (JSON)

Hoặc gọi REST bằng API key

curl -X POST https://api.nextx.vn/api/v1/ai/tools/office/office_simulate_automation/read \
  -H "X-Api-Key: $API_KEY" -H "Content-Type: application/json" \
  -d '{"automationName":"Giao việc khi có đăng ký mới","triggerData":"{\"ten_khach\":\"Nguyễn Văn An\"}"}'

Ví dụ gọi qua MCP (dành cho trợ lý AI)

Trợ lý AI tự gửi lệnh này khi bạn hỏi bằng lời; bạn chỉ cần xem khi tự gỡ lỗi kết nối MCP.

{
  "name": "office_simulate_automation",
  "arguments": {
    "args": {
      "automationName": "Giao việc khi có đăng ký mới",
      "triggerData": "{\"ten_khach\":\"Nguyễn Văn An\"}"
    }
  }
}

Chuyển bước duyệt cho người khác

Write proposalScope: office:write

office_transfer_approval_task

Chuyển một bước duyệt đang chờ mình cho một người khác trong công ty. Tạo đề xuất; người dùng bấm Xác nhận trong app mới thực hiện.

Tham số	Kiểu	Bắt buộc	Mô tả
`taskId`	string	có	Id bước duyệt (lấy từ office_get_approval_instance)
`receiverName`	string	có	Họ tên người nhận
`comment`	string	không	Ghi chú

Ví dụ gọi qua MCP (dành cho trợ lý AI)

Trợ lý AI tự gửi lệnh này khi bạn hỏi bằng lời; bạn chỉ cần xem khi tự gỡ lỗi kết nối MCP.

{
  "name": "office_transfer_approval_task",
  "arguments": {
    "args": {
      "taskId": "0199a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b",
      "receiverName": "Trần Thị Bình",
      "comment": "Nhờ chị duyệt thay trong tuần nghỉ phép"
    }
  }
}

Sửa luật tự động hoá

Write proposalScope: office:write

office_update_automation_graph

Sửa một luật tự động hoá Office bằng cách gửi toàn bộ đồ thị sau khi sửa, kèm phiên bản đã đọc; luật đang bật phải tạm dừng trước. Tạo đề xuất; người dùng bấm Xác nhận trong app mới thực hiện.

Tham số	Kiểu	Bắt buộc	Mô tả
`automationName`	string	không	Tên luật (bỏ trống nếu đang mở luật trên màn)
`baseVersion`	integer	không	Phiên bản đồ thị đã đọc
`graph`	object	không	Đồ thị gọn sau khi sửa

Ví dụ gọi qua MCP (dành cho trợ lý AI)

Trợ lý AI tự gửi lệnh này khi bạn hỏi bằng lời; bạn chỉ cần xem khi tự gỡ lỗi kết nối MCP.

{
  "name": "office_update_automation_graph",
  "arguments": {
    "args": {
      "automationName": "Giao việc khi có đăng ký mới",
      "baseVersion": 1834512907,
      "graph": {
        "trigger": "record_created",
        "triggerConfig": {
          "tableId": "0199a1b2-0000-7000-8000-00000000a001"
        },
        "steps": [
          {
            "ref": "S1",
            "kind": "action",
            "actionType": "create_task",
            "config": {
              "title": "Gọi lại khách đăng ký",
              "assigneeName": "Nguyễn Văn An"
            }
          },
          {
            "ref": "S2",
            "kind": "action",
            "actionType": "send_notification",
            "config": {
              "message": "Có đăng ký mới"
            }
          }
        ]
      }
    }
  }
}

Sửa cuộc họp

Write proposalScope: office:write

office_update_event

Sửa một cuộc họp do chính người đang chat chủ trì. Chỉ đưa phần muốn đổi. Tạo đề xuất; người dùng bấm Xác nhận trong app mới thực hiện.

Tham số	Kiểu	Bắt buộc	Mô tả
`eventId`	string	có	Cuộc họp cần sửa
`title`	string	không	Tiêu đề mới
`startAt`	string	không	Giờ bắt đầu mới
`endAt`	string	không	Giờ kết thúc mới

Ví dụ gọi qua MCP (dành cho trợ lý AI)

Trợ lý AI tự gửi lệnh này khi bạn hỏi bằng lời; bạn chỉ cần xem khi tự gỡ lỗi kết nối MCP.

{
  "name": "office_update_event",
  "arguments": {
    "args": {
      "eventId": "0199a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b",
      "title": "Họp chốt báo giá"
    }
  }
}

Sửa dòng của bảng dữ liệu

Write proposalScope: office:write

office_update_record

Sửa một dòng của bảng dữ liệu Office: chỉ các cột cần đổi, hoặc ghi đè toàn bộ dòng. Tạo đề xuất; người dùng bấm Xác nhận trong app mới thực hiện.

Tham số	Kiểu	Bắt buộc	Mô tả
`tableId`	string	có	Id bảng
`recordId`	string	có	Id dòng
`data`	object	có	Giá trị theo mã cột
`replace`	boolean	không	true = ghi đè toàn bộ dòng

Ví dụ gọi qua MCP (dành cho trợ lý AI)

Trợ lý AI tự gửi lệnh này khi bạn hỏi bằng lời; bạn chỉ cần xem khi tự gỡ lỗi kết nối MCP.

{
  "name": "office_update_record",
  "arguments": {
    "args": {
      "tableId": "0199a1b2-0000-7000-8000-00000000a001",
      "recordId": "0199a1b2-0000-7000-8000-00000000b001",
      "data": {
        "trang_thai": "Đã liên hệ"
      }
    }
  }
}

Cập nhật việc

Write proposalScope: office:write

office_update_task

Cập nhật một việc Office: trạng thái, người nhận, hạn, ưu tiên, tiêu đề, dự án. Tạo đề xuất; người dùng bấm Xác nhận trong app mới thực hiện.

Tham số	Kiểu	Bắt buộc	Mô tả
`taskId`	string	không	Id việc (lấy từ office_list_tasks)
`title`	string	không	Tiêu đề chính xác của việc, khi không có taskId
`status`	string	không	Cần làm, Đang làm, Xong, Chờ duyệt hoặc Huỷ
`assigneeName`	string	không	Họ tên người nhận mới
`dueAt`	string	không	Hạn mới (yyyy-MM-dd hoặc ISO)
`priority`	string	không	Thấp, Trung bình hoặc Cao
`newTitle`	string	không	Tiêu đề mới
`listName`	string	không	Tên dự án

Ví dụ gọi qua MCP (dành cho trợ lý AI)

Trợ lý AI tự gửi lệnh này khi bạn hỏi bằng lời; bạn chỉ cần xem khi tự gỡ lỗi kết nối MCP.

{
  "name": "office_update_task",
  "arguments": {
    "args": {
      "title": "Chuẩn bị báo giá",
      "status": "Xong"
    }
  }
}