预约功能使用指南
设置可预约时间，查看日历，创建预约，更新状态、改期，并使用 AI Agent 查询或预填操作。
预约功能可以做什么？#
预约功能可按日期和时段为客户保留名额，把客户与服务、负责人关联起来，跟踪确认和完成状态，并避免选择已经不可用的时段。
- 1
在主导航中打开 Lịch hẹn（预约），或访问你的 ChatHub 域名下的 /appointments。
- 2
appointments.read 权限可查看日历、员工和可用时段；appointments.manage 会显示预约与 AI Agent，并且是改状态、改期、取消等所有写入操作的必需权限。
- 3
页面顶部三个摘要卡片分别统计当前日期范围、员工筛选和结束状态筛选下的可见预约、等待确认的新预约及已确认预约。
1. 设置营业时段和提醒#
- 1
拥有系统设置管理权限的账号打开 管理 → 设置 → 工作时间，或访问 /settings?tab=hours。
- 2
在 Giờ làm việc（工作时间）中添加星期、开始和结束时间，再点击 Lưu lịch làm việc。没有配置任何时段时，系统按全天 24 小时开放处理，并非关闭。
- 3
在 Lịch hẹn（预约）区域输入提前提醒分钟数并点击 Lưu。默认 120 分钟；输入 0 可关闭提醒。修改只影响之后新建的预约。
- 4
在 Ngày nghỉ và ngày mở bù（休息日和补开日）中选择日期。保持 Nghỉ cả ngày 开启可全天关闭；关闭开关后可填写特殊开放的开始/结束时间和备注，再点击 Thêm ngày。
2. 查看并筛选正确的日期范围#
- 1
选择 Ngày（日）聚焦一天、Tuần（周）协调七天，或 Tháng（月）查看总览。在月/周视图点击日期可快速切换到日视图。
- 2
用上一周期、今天和下一周期切换，或直接输入日期。当当前范围已包含今天时，Hôm nay 按钮会禁用。
- 3
按员工筛选可只查看其负责的预约。打开 Hiện lịch đã kết thúc 可包含已完成、未到场和已取消预约；点击 Xóa bộ lọc 恢复默认。
- 4
日历会定时刷新，重新切回标签页时也会刷新。预约前仍应再次查看时段，因为其他员工或工作流可能刚刚占用名额。
3. 创建预约#
- 1
点击右上角 Đặt lịch、某一天栏中的预约按钮，或日期旁的 +。后两种方式会自动带入所选日期。
- 2
在 Tìm khách 中输入姓名或手机号至少 2 个字符。结果加载后，在 Khách 字段选择正确客户；仅输入搜索词并不等于已经选中客户。
- 3
如预约与产品/服务有关，请选择 Dịch vụ；也可以留空，创建不关联服务的预约。
- 4
选择负责人或保留 Ai cũng được（任意人员），确认日期，再选择可用时段。更换服务、员工或日期会重新加载时段。
- 5
如有需要可填写内部备注，客户看不到。确认客户、服务、员工、日期和时间后再点击 Đặt lịch。
4. 确认、改期或结束预约#
- 1
点击预约卡片可查看客户、服务、时间、时长、负责人、备注及客户填写内容。只有关联了对应记录时，才会显示打开会话或订单的链接。
- 2
对于新建或已确认预约，可按实际情况选择确认、已完成或客户未到。已结束的预约不能重新打开或改期。
- 3
点击 Dời giờ（改期），选择新日期、负责人和时段，再保存。系统会再次检查空位并重新计算提醒时间。
- 4
点击 Huỷ hẹn（取消预约），阅读提示，并只在确实要取消时确认。取消后停止提醒并释放时段；系统不会彻底删除预约历史。
5. 使用 AI Agent 查询和预填#
- 1
先打开正确的日/周/月日期范围，再点击 Hỏi AI Agent。Agent 只能看到当前打开的日期范围。
- 2
选择空闲时段、预约或改期示例，也可输入自然语言问题并点击 Gửi。每条消息最多 4,000 字符，每次对话最多 20 轮。
- 3
如果 Agent 给出操作建议，点击按钮打开相应表单。保存前必须自行核对客户、日期、时间、服务和负责人。
- 4
切换到不同任务时，使用 Cuộc trò chuyện mới 清除当前对话上下文。
6. 常见问题处理#
- 1
看不到预约入口：请管理员授予 appointments.read。能看日历但没有预约和 AI Agent：还需要 appointments.manage。
- 2
没有可用时段：检查时间是否已过、每周工作时间、特殊日期、服务、负责人和容量。更改日期、服务或员工可重新加载时段。
- 3
找不到客户：至少输入 2 个字符，尝试姓名或手机号的其他片段，并确认该联系人仍处于启用状态。
- 4
看不到旧预约或已取消预约：打开“显示已结束预约”，再检查日期范围和员工筛选。
- 5
保存时提示时段已满：其他用户刚刚预约了该时段；关闭表单或更换日期以刷新列表，再选择其他时段。