wecomcli-schedule

企業微信行程管理技能

wecom-cli 是企業微信提供的命令列程式，所有操作皆透過執行 wecom-cli 命令完成。

透過 wecom-cli schedule <介面名稱> '<json帶入參數>' 與企業微信行程系統互動。

注意事項

• 行程清單查詢僅支援當日前後 30 天，時間格式為 YYYY-MM-DD 或 YYYY-MM-DD HH:mm:ss
• 涉及參與者 userid 時，需先使用 wecomcli-contact 技能取得；若存在同名者則顯示候選名單供使用者選擇（禁止暴露 userid）
• 建立/修改/取消前，請先確認目標行程與參與者資訊
• errcode != 0 時顯示錯誤資訊；回傳的 start_time/end_time 為 Unix 時間戳記（秒），需轉換為易讀格式
• 注意時間格式轉換：介面帶入參數使用字串格式（如 YYYY-MM-DD HH:mm:ss），但回傳值多為 Unix 時間戳記，使用時需進行格式轉換

---

介面列表

get_schedule_list_by_range — 查詢行程 ID 清單

wecom-cli schedule get_schedule_list_by_range '{"start_time": "YYYY-MM-DD HH:mm:ss", "end_time": "YYYY-MM-DD HH:mm:ss"}'

回傳 schedule_id_list 陣列。僅支援當日前後 30 天。

get_schedule_detail — 取得行程詳情

wecom-cli schedule get_schedule_detail '{"schedule_id_list": ["SCHEDULE_ID_1", "SCHEDULE_ID_2"]}'

支援 1~50 個 ID，回傳行程標題、時間、地點、參與者等。參見 API 詳情。

create_schedule — 建立行程

wecom-cli schedule create_schedule '{"schedule": {"start_time": "YYYY-MM-DD HH:mm:ss", "end_time": "YYYY-MM-DD HH:mm:ss", "summary": "行程標題", "attendees": [{"userid": "USER_ID"}], "reminders": {"is_remind": 1, "remind_before_event_secs": 3600, "timezone": 8}}}'

參見 API 詳情 | reminders 欄位。

update_schedule — 修改行程

只需傳入需修改的欄位，未傳入欄位保持不變。

wecom-cli schedule update_schedule '{"schedule": {"schedule_id": "SCHEDULE_ID", "summary": "更新後的標題"}}'

參見 API 詳情。

cancel_schedule — 取消行程

wecom-cli schedule cancel_schedule '{"schedule_id": "SCHEDULE_ID"}'

add_schedule_attendees / del_schedule_attendees — 管理參與人

• 新增參與人：

wecom-cli schedule add_schedule_attendees '{"schedule_id": "SCHEDULE_ID", "attendees": [{"userid": "USER_ID"}]}'

• 移除參與人：

wecom-cli schedule del_schedule_attendees '{"schedule_id": "SCHEDULE_ID", "attendees": [{"userid": "USER_ID"}]}'

check_availability — 查詢忙碌/空閒狀態

wecom-cli schedule check_availability '{"check_user_list": ["USER_ID_1", "USER_ID_2"], "start_time": "YYYY-MM-DD HH:mm:ss", "end_time": "YYYY-MM-DD HH:mm:ss"}'

支援 1~10 個使用者，回傳各使用者的忙碌時段清單。參見 API 詳情。

---

典型工作流程

查詢行程

常見 query 範例：

• 「我今天有哪些行程？」
• 「幫我看看這週三下午有沒有會議」
• 「明天的行程安排是什麼？」
• 「查一下最近有沒有關於專案審查的行程」
• 「我下週一到週五的行程有哪些？」

流程：

1. 根據使用者意圖計算時間範圍（如「今天」→當日 00:00:00 至 23:59:59，「這週」→本週一至週日）
2. 呼叫 get_schedule_list_by_range 取得行程 ID 清單
3. 呼叫 get_schedule_detail 批次取得詳情，將 Unix 時間戳記轉換為易讀時間
4. 若使用者提到關鍵字（如「專案審查」），在 summary 中比對篩選；未找到則逐步擴大範圍至前後 30 天上限
5. 展示行程清單時包含標題、時間、地點、參與者等關鍵資訊，方便使用者快速了解

建立行程

常見 query 範例：

• 「幫我建立一個明天下午 2 點到 3 點的會議，標題叫做需求審查」
• 「安排一個週五全天的 Team Building 活動」
• 「建立行程：後天上午 10 點和張三、李四開產品方案討論會，地點在 3 樓會議室」
• 「幫我建個行程，下週一 14:00-15:00，提前 15 分鐘提醒」
• 「約一個明天上午的行程，邀請王偉參加」

流程：

1. 解析使用者意圖，提取時間、標題、地點、參與人、提醒設定等資訊
2. 若涉及參與人，先透過 wecomcli-contact 查詢 userid；存在同名者時顯示候選名單供使用者選擇
3. 若使用者未指定提醒，預設設定提前 15 分鐘提醒（remind_before_event_secs: 900）
4. 若使用者說「全天」，設定 is_whole_day: 1，時間設定為當天 00:00:00 至 23:59:59
5. 向使用者確認行程資訊（標題、時間、地點、參與人等）後呼叫 create_schedule

修改行程

常見 query 範例：

• 「把明天的需求審查改到後天下午 3 點」
• 「幫我修改一下今天下午的會議標題，改成技術方案審查」
• 「我今天 14 點的行程地點改成線上騰訊會議」
• 「把週五的 Team Building 活動延後一個小時」
• 「幫我給明天的週會加上說明：討論 Q2 規劃」

流程：

1. 先透過查詢工作流程定位目標行程（根據使用者提到的時間、標題等關鍵字比對）
2. 若比對到多個行程，顯示候選清單供使用者確認
3. 向使用者確認要修改的欄位與目標值
4. 呼叫 update_schedule，只傳入需修改的欄位

取消行程

常見 query 範例：

• 「取消明天下午的需求審查」
• 「幫我把週五的 Team Building 行程刪掉」
• 「我不想開今天 15 點的會了，幫我取消」

流程：

1. 先透過查詢工作流程定位目標行程
2. 向使用者確認取消的行程資訊（標題、時間等），避免誤操作
3. 確認後呼叫 cancel_schedule

管理參與人

常見 query 範例：

• 「把張三加到明天的需求審查會議裡」
• 「幫我把李四從週五的行程裡移除」
• 「明天下午的會議再邀請一下王偉和趙敏」
• 「把我後天那個技術分享的參與人裡去掉劉強」

流程：

1. 透過 wecomcli-contact 取得目標人員 userid；存在同名者時顯示候選名單供使用者選擇
2. 透過查詢工作流程定位目標行程
3. 呼叫 add_schedule_attendees 或 del_schedule_attendees 完成新增/移除

查詢忙碌/空閒狀態並安排會議

常見 query 範例：

• 「幫我看看張三和李四明天下午有沒有空」
• 「查一下我和王偉這週的空閒時間，想約個會」
• 「我想跟產品組的小明、小紅開個會，看看大家什麼時候有空」
• 「找一個明天下午大家都有空的時間，安排一個 1 小時的會議」

流程：

1. 透過 wecomcli-contact 取得相關人員 userid
2. 呼叫 check_availability 查詢指定時間範圍內各使用者的忙碌時段
3. 分析所有使用者的忙碌時段，計算出共同空閒時段並推薦給使用者
4. 使用者確認時段後，呼叫 create_schedule 建立會議並自動新增參與人