3分鐘閱讀

Slack 整合入門指南

分 7 個步驟引導您將新專案連接到 GIIP 的對話式 Slack 機器人（giipclaude）。依序完成每個步驟後，您就能在 Slack 頻道中提及 @giipclaude 來註冊或查詢 giip issue。

1. 確認專案（csn）

在連接 Slack 機器人之前，需要先有一個此機器人所屬的 GIIP 專案（csn）。如果貴公司已經註冊並完成入門流程，可跳過本步驟，直接進入第 2 步。如果需要先註冊:

➡️ 請先完成註冊指南。

下一步: 2. 建立服務群組

2. 建立服務群組

在 GIIP 中，SK（Secret Key）是按「服務群組」單位核發的。如果您還沒有此 Slack 機器人專用的服務群組，請新建一個。

前往 專案群組清單 頁面。
點擊 [+ 新增群組] 按鈕建立新群組（建議使用能體現用途的名稱，如 slack-bot）。

下一步: 3. 核發 SK（Secret Key）

3. 核發 SK（Secret Key）

在同一個 專案群組清單 頁面上，點擊剛建立（或既有）的群組旁的 [Generate Secret Key] 按鈕。將核發的 SK 字串複製到安全的地方 —— 第 7 步會原封不動地使用它。

下一步: 4. 本機安裝 giip-fde-agent

4. 本機安裝 giip-fde-agent

Slack 機器人在您的電腦（或用於常駐執行機器人的伺服器）上以本機方式執行。複製正本範本儲存庫並安裝。

git clone https://github.com/LowyShin/giip-fde-agent.git
cd giip-fde-agent/slack-bot
npm install

下一步: 5. 建立並連接 Slack App

5. 建立並連接 Slack App

請依照 slack-bot/SLACK_APP_SETUP.md（儲存庫中已內含）的完整步驟操作。重點摘要如下:

api.slack.com/apps → Create New App → From scratch
OAuth & Permissions → 新增 Bot Token Scopes: chat:write, app_mentions:read, channels:history, channels:read, groups:history, groups:read, im:history, im:read, im:write（選用: users:read）
啟用 Socket Mode → 核發 App-Level Token（connections:write 權限範圍） → 複製 xapp-...
啟用 Event Subscriptions → 訂閱 app_mention, message.im, message.channels, message.groups
Install to Workspace → 複製 Bot User OAuth Token（xoxb-...）
將 slack-bot/.env.example 複製為 .env，並填入 SLACK_BOT_TOKEN（xoxb-）、SLACK_APP_TOKEN（xapp-）、WORKSPACE_DIR
執行 node index.js（或 pm2 start index.js --name giipclaude-bot）

如遇問題，請先查看 SLACK_APP_SETUP.md 底部的「Troubleshooting」表。

下一步: 6. 準備 Slack 頻道

6. 準備 Slack 頻道

建立機器人將要回應的 Slack 頻道，或選定一個既有頻道。
在該頻道中使用 /invite @<機器人名稱> 邀請機器人加入。
確認頻道 ID: 在頻道名稱上按右鍵 → 檢視頻道詳細資訊 → 底部的 C0XXXXXXXXX 格式 ID。

下一步: 7. 完成 GIIP 連結

7. 完成 GIIP 連結

確認機器人在 Slack 中正常運作後，現在將該頻道與第 3 步核發的 SK/csn 連結起來。請直接傳送 DM 給機器人（或在要連接的頻道中），依序輸入以下指令。

giip account set <login_id> <SK> <csn>
giip channel set <專案名稱> <頻道ID>
giip project set <專案名稱> <csn>

<login_id>: 用於識別此帳號的電子郵件等（僅用於顯示，例如 you@example.com）
<SK>: 第 3 步核發的值
<csn>: 第 1 步確認的專案編號
<專案名稱>: 您自行決定的小寫識別碼（註冊 giip issue 時會依此名稱路由）

所有指令都成功後，您就能在該頻道中輸入 @<機器人名稱> 註冊 issue <內容> 之類的訊息，立即註冊一筆 giip issue。

⚠️ 若為全新專案: giip project set 會自動嘗試授予機器人的資料庫存取權限（tUserPerCorp），但對於完全全新的 csn，基於安全閘門此自動授予會失敗（這是預期行為）。此時指令回應會顯示警告，並會在 csn 47 下自動註冊一筆後續處理的 giip issue —— GIIP 管理員需要查看該 issue，並在 giipdb/data/seed_tUserPerCorp_botuser.sql 中手動新增一行以授予權限。只有這一步需要管理員介入，其餘全部都是自助完成的。

版本: 2.0（全面改版為基於 giip-fde-agent 的對話式機器人入門流程） 最後更新: 2026-09-10 來源檔案: giipv3/public/help/slack-bot-setup.zh-TW.md