使用手冊

新增訊息三步驟

在「訊息」按「新增訊息」進入三步精靈（/messages/new/1 → /2 → /3）。每一步都可儲存草稿；重新開始（/messages/new/reset）會清掉精靈狀態。

① 內容

1. 選 分類（categoryId）。分類決定同意範圍、管道計畫、彙整方式與審核規則；只有本單位被允許的分類會出現。
2. 可選 模板（templateId）。選了已核准的模板，系統事件類的訊息才能自動核准。
3. 選 訊息形式（kind：text / card / buttons / quickReply…）。多數通知用 card。
4. 填 標題（中文）與 Title（English）（titleZh / titleEn）。英文未填時英文使用者看到中文，從不機器翻譯。
5. 填 一句話（body，≤ 40 字）或純文字 text。
6. 設 主要動作：primaryKind 為開連結（primaryUri，需在白名單）或啟動 pattern（primaryPatternId）；primaryLabel 是按鈕文字。勾 不再提醒此類（mute）會加第二顆按鈕；固定層分類沒有這個選項。
7. 右側即時預覽切換 LINE / Email / Web push / 純文字降級。內容政策與連結白名單即時檢查：出現成績、金額、諮商關鍵字或白名單外連結會標紅，無法進下一步。
8. 按 下一步：受眾，或 儲存草稿。

② 受眾

1. 可從 常用受眾（savedId）載入先前儲存的條件，或勾 儲存目前條件（saveAs）存成新的常用受眾。
2. 勾 身分別（roles：學生／教師／職員）、填 部門／系所（orgUnits）與 班級（classIds）。只有本單位被授權的維度可用；越權會被拒收，不是靜默忽略。
3. 選 群組／子群組（groups）與 標籤（tags）。
4. 互動歷程（historyKind）：報名了／未報名（historyPatternId）、已填／未填、已讀／未讀、已確認／未確認（historyMessageId）。
5. 排除（excludeGroup）：例如「− 已報名子群組」。
6. 右側 dry-run 即時顯示：預計收件人、各管道人數、排除原因（無同意／無地址／已關閉此類／封鎖）、LINE 配額影響與門檻。

③ 排程與送審

1. 選 送出時間（mode）：立即（仍受分類的彙整時段影響）、指定時間（填 date / time，時區固定 Asia/Taipei）、加入彙整時段（分類為 slot 模式時才可選，顯示時段）、週期（填 5 欄 cron，例如 30 8 * * 1 每週一 08:30；每次執行產生新意圖各自走審核）。
2. 設 過期時間（expiresDate / expiresTime）：過了仍未送出的訊息作廢並釋放預留，未送的人記 expired。
3. 管道計畫只能拿掉管道，不能加上分類沒允許的管道。
4. 免打擾與審核為唯讀說明：依收件人設定延後（固定層與緊急除外）；審核規則由分類決定。
5. 檢視右側 送審摘要，按 送審（action=submit）。狀態變為 submitted，dry-run 快照存檔，進入審核佇列；若有內容違規會以 content_violation 拒絕。

之後

訊息列表

/messages 以狀態 chip 篩選：draft / submitted / approved / scheduled / sending / sent / rejected / cancelled / expired。

單筆詳情

/messages/{id}：內容、受眾、dry-run 快照、審核紀錄、投遞統計（sent / skipped 依原因 / failed）。

重新 dry-run

draft 與 submitted 狀態可按 重新 dry-run；名單在送出時才最終解析。

取消

draft / submitted / approved / scheduled 可按 取消（作者或 approver）；釋放預留。

狀態機

draft → submitted（dry-run 快照）→ approved（預留配額）→ scheduled → sending → sent
      ↘ cancelled          ↘ rejected / cancelled     ↘ cancelled / expired   ↘ expired