產品文件

# 設定通知與值班權限

標準 v0.39 從「設定 → API 與整合」開始。可以讓接收系統使用唯讀 API，或展開 「進階：將事件轉送到其他系統」設定 Webhook。先驗證一則測試事件送達，再確認實際監控的危急事件。

## 設定事件轉送

1.  由接收系統管理員提供接收網址及簽章設定。在「API 事件轉送（Webhook）」填接收系統名稱和網址。密鑰欄位填管理員提供的密鑰設定名稱，實際密鑰由管理員保管。
2.  選擇事件等級與來源。測試按鈕產生的是 `sdk.test`，因此測試用轉送設定必須包含這個來源，以及你按下的測試等級。
3.  「先模擬測試，不實際傳送」預設勾選。要驗證接收端真的收到資料，取消勾選並按「建立事件轉送」。確認清單中出現這個設定，再按對應等級的測試按鈕。
4.  核對投遞紀錄和接收端的結果。測試通過後，確認正式設定包含所需的事件來源與等級，並在接收端核對實際監控事件。

請讓接收系統管理員確認桌面轉送的資料格式與簽章。這個入口傳送的格式，與透過開發者 API 建立的事件 Webhook 不同，不能直接套用後者的資料格式驗證範例。

[唯讀 API 快速開始](https://watch.tensordynamics.org/developers/quickstart?lang=zh) · [事件轉送與簽章說明](https://watch.tensordynamics.org/developers/webhooks?lang=zh)

相容性參考：另行開通的聊天與郵件通道

標準 v0.39 沒有 **Agent → Channels** 入口。以下聊天與郵件設定，僅適用於支援團隊另行開通、且介面已有該入口的版本。 一般安裝請使用上方的 API／事件轉送；需要選用通道時先聯絡支援。 通道金鑰只在本機輸入，儲存後介面僅顯示是否已設定。

這些選用通道可以接收通知；部分也支援值班人員的查詢與指令。

## 選用通道一覽

| 通道 | 用途 | 需要填入 | 可雙向？ |
| --- | --- | --- | --- |
| 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

1.  在 Telegram 搜尋 **@BotFather**，輸入 `/newbot`，依指示完成並複製 **Bot Token**。
2.  搜尋你的新 bot，先傳一則普通訊息，例如 `hi`。
3.  在瀏覽器開啟 `https://api.telegram.org/bot<你的Token>/getUpdates`，在回傳內容中找 `chat.id` 數字。
4.  回到 Watch 的 Telegram 卡片，填入 Bot Token 和 Chat ID，按儲存。
5.  回 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 金鑰應留在現場。

**Webhook 會從 Watch 傳送事件到接收系統。** 此網址無法接收控制指令。桌面區網 API 只提供讀取；修改監控設定請在 Watch 內操作。 其他自動操作須先確認該版本支援的整合方式與權限。

## 設定操作權限

`viewer` 可查狀態與快照；`operator` 可使用 `/watch`；`admin` 可管理長期備註。只有一位可信任的操作人員時可不設定角色；多人使用時，請設定角色並將預設權限設為 viewer。

```
SENTINEL_CLAW_ROLES={"8765432":"admin","U0456WXYZ":"operator"}
SENTINEL_CLAW_DEFAULT_ROLE=viewer
```

**確認通知送達** 介面顯示「已填設定，未驗證送達」後，從該通道確認收到測試回覆或警報。不要將 Bot Token、Slack 權杖、SMTP 密碼或 Webhook 網址放入攝影機設定檔、螢幕截圖、群組聊天或公開文件。

[

下一節

硬體容量與分析效能

](https://watch.tensordynamics.org/docs/inference?lang=zh)

---
Source: https://watch.tensordynamics.org/docs/notifications?lang=zh
More Watch guides: https://watch.tensordynamics.org/llms.txt