Slack 機器人設置指南
引導您如何配置 GIIP 專用 Slack 機器人 (App),以便即時接收基礎設施故障及主要事件的通知。
📋 概述
Slack 機器人可將 GIIP 平台檢測到的關鍵問題或資源短缺情況立即發送到負責人的 Slack 頻道。這樣,即使不一直盯着 Web 儀表板,也能快速做出響應。
🔍 核心設置步驟
1. 創建 Slack App 並獲取令牌
- 在 Slack API 網站上進行「Create New App」。
- Bot Type: 授予
和chat:write
權限。incoming-webhook - Bot User OAuth Token: 複製以
開頭的令牌。xoxb-
2. 在 GIIP 中註冊機器人
- 在 GIIP [通知設置] 菜單中輸入複製的令牌。
- 輸入接收通知的預設頻道 ID(例如:
)。C0123456789
3. 選擇通知過濾器與類型
為了避免過多的通知干擾,請僅選擇需要的類型。
- 關鍵問題 (Critical Issues): 需要立即處理的項目,如伺服器停機、連接中斷等。
- AI 建議 (AI Recommendations): 成本節約或資源優化建議。
- 安全警報 (Security Alerts): 檢測到異常登入嘗試或安全威脅。
🛠️ 設置方法
- 進入 GIIP [系統管理] > [Slack 機器人設置] 菜單。
- 點擊 [Register New Bot] 按鈕,輸入獲取的 Bot Token 和 頻道 ID。
- 點擊 [Send Test Message],確認對應的 Slack 頻道是否收到「GIIP 關聯成功」消息。
- 通過底部的通知複選框決定要接收的事件範圍並保存。
💡 技巧
- 頻道分離: 為「維運」和「研發」分別設置頻道,確保每位負責人只接收到與其相關的通知。
- 利用 Slack 命令: (後續支持)通過向 GIIP 機器人輸入
等命令,可以在 Slack 內即時查詢目前的基础設施摘要資訊。/giip status
疑難排解
| 症狀 | 原因 | 解決方法 |
|---|---|---|
| 點擊 [Send Test Message] 後頻道仍未收到「GIIP 關聯成功」訊息 | 機器人未被邀請進入該頻道,或頻道 ID 有誤 | 將機器人邀請進目標頻道,並重新確認輸入的頻道 ID(例如:)。 |
| 儲存令牌時出現認證錯誤 | 輸入了非 開頭的 Bot User OAuth Token | 複製 Slack 應用的 Bot User OAuth Token()並重新註冊。 |
| 機器人無法發布訊息或顯示權限錯誤 | 未授予 或 權限 | 為 Slack 應用新增相應權限後重新安裝 (Reinstall) 應用。 |
| 已儲存設定但收不到通知 | 未勾選通知類型核取方塊 | 選擇要接收的事件類型(如 Critical Issues)並儲存。 |
版本: 1.0 最後更新: 2026-03-19 源文件:
giipv3/public/help/slack-bot-setup.zh-TW.md