設定通知與值班權限
標準 v0.39 從「設定 → API 與整合」開始。可以讓接收系統使用唯讀 API，或展開 「進階：將事件轉送到其他系統」設定 Webhook。先驗證一則測試事件送達，再確認實際監控的危急事件。
設定事件轉送
- 由接收系統管理員提供接收網址及簽章設定。在「API 事件轉送（Webhook）」填接收系統名稱和網址。密鑰欄位填管理員提供的密鑰設定名稱，實際密鑰由管理員保管。
- 選擇事件等級與來源。測試按鈕產生的是
sdk.test，因此測試用轉送設定必須包含這個來源，以及你按下的測試等級。 - 「先模擬測試，不實際傳送」預設勾選。要驗證接收端真的收到資料，取消勾選並按「建立事件轉送」。確認清單中出現這個設定，再按對應等級的測試按鈕。
- 核對投遞紀錄和接收端的結果。測試通過後，確認正式設定包含所需的事件來源與等級，並在接收端核對實際監控事件。
請讓接收系統管理員確認桌面轉送的資料格式與簽章。這個入口傳送的格式，與透過開發者 API 建立的事件 Webhook 不同，不能直接套用後者的資料格式驗證範例。
相容性參考：另行開通的聊天與郵件通道
這些選用通道可以接收通知；部分也支援值班人員的查詢與指令。
選用通道一覽
| 通道 | 用途 | 需要填入 | 可雙向？ |
|---|---|---|---|
| Telegram | 接收快照、查詢狀態和傳送指令。 | Bot Token、Chat ID | 是 |
| Slack Commands | 公司 Slack 內查詢與指令。 | Bot Token、App Token、允許的 User IDs | 是 |
| Slack Alerts / Google Chat | 將警報送到群組或聊天室。 | Incoming Webhook URL | 否 |
| LINE / Email / Discord / Teams | 透過聊天或電子郵件接收警報。 | 下方各通道資料 | 否 |
| Webhook | 接 n8n、Make、Zapier、WhatsApp、SMS、PagerDuty 或自己的後端。 | 接收 URL、可選 HMAC secret | 由接收系統處理 |
設定 Telegram
- 在 Telegram 搜尋 @BotFather，輸入
/newbot，依指示完成並複製 Bot Token。 - 搜尋你的新 bot，先傳一則普通訊息，例如
hi。 - 在瀏覽器開啟
https://api.telegram.org/bot<你的Token>/getUpdates，在回傳內容中找chat.id數字。 - 回到 Watch 的 Telegram 卡片，填入 Bot Token 和 Chat ID，按儲存。
- 回 Telegram 對 bot 傳
/status。收到攝影機摘要即代表雙向連線成功。
可用指令：/status、/recent 10、/snapshot 1、/watch 1 注意後門是否有人徘徊。第一個 Chat ID 接收警報。逗號分隔的其他 Chat ID 可依角色使用指令；若要群組收件，請將該群組的 Chat ID 設為第一個。
設定 Slack 警報或指令
Slack Alerts：在 Slack 應用程式建立 Incoming Webhook，選擇接收頻道，再將網址 貼到 Watch 的 Slack alerts 卡片。儲存後它只會接收警報。
Slack Commands 用 Socket Mode，無須對外開放監控電腦。到 Slack API 建立 App，開啟 Socket Mode；建立有 connections:write 的 App-Level Token（xapp-…），再安裝 App 取得 Bot Token（xoxb-…），並填入允許操作的 Slack User IDs。設定後先用 DM 對 bot 傳 /status。列入 User IDs 或角色設定的人，依其角色權限操作。
設定其他單向通道
- Google Chat：在 Google Chat 聊天室建立 Incoming Webhook，再貼上網址。
- LINE：在 LINE Developers 建立 Messaging API channel，填入 Channel Access Token 和接收者的使用者／群組 ID。此版本為文字告警；照片請用 Telegram、Email、Discord 或 Webhook。
- Email：填 SMTP Host、Port（通常 587）、帳號、App Password、From 和一或多個 To。Gmail／Microsoft 等建議使用 App Password，不要使用主帳號密碼。成功時會收到文字與 JPEG 附件。
- Discord：在目標頻道的 Integrations → Webhooks 建立 Webhook，複製 URL；危急快照會以附件送出。
- Microsoft Teams：在目標頻道的 Workflows／Power Automate 建立「收到 Webhook 時發文」流程，複製 Workflow Webhook URL。此版本傳送文字卡片。
選用 Alert Webhook 通道
填入接收網址與 HMAC 密鑰。Watch 會傳送已簽章的 JSON；接收端須用原始請求內容驗證 X-Sentinel-Signature，再解析內容。這個選用通道使用 sha256= 簽章，和上方桌面事件轉送的格式不同。可經由接收系統串接 WhatsApp、SMS、PagerDuty、Trainge 或自家後台。攝影機 RTSP 網址與 Watch 金鑰應留在現場。
設定操作權限
viewer 可查狀態與快照；operator 可使用 /watch；admin 可管理長期備註。只有一位可信任的操作人員時可不設定角色；多人使用時，請設定角色並將預設權限設為 viewer。
SENTINEL_CLAW_ROLES={"8765432":"admin","U0456WXYZ":"operator"}
SENTINEL_CLAW_DEFAULT_ROLE=viewer