連接 Slack

適用對象

Slack workspace 的管理員。

開始前請準備

• 可管理目標 Slack workspace 的帳號
• 想好 Bot 的顯示名稱（最多 35 個字元），例如 ANIMA

階段 A：建立並安裝 Slack App

1. 登入要安裝 ANIMA 的 Slack workspace。
2. 開啟 api.slack.com/apps → 右上角頭像 → Your Apps → 捲到頁面底部的 App Configuration Tokens。
3. 按 Generate Token，選擇目標 workspace 並完成授權，複製 Access Token。Token 以 xoxe.xoxp- 開頭。
4. 回到 Admin Panel 的 Slack 卡片，輸入「Bot 顯示名稱」，並把 Token 貼進「Slack Configuration Access Token」。
5. 按「建立並開始安裝」，依 Slack 畫面完成授權。

階段 B：設定 App-Level Token

1. 前往 api.slack.com/apps，選擇剛建立的 App，進入左側 Basic Information。
2. 捲到 App-Level Tokens，按 Generate Token and Scopes。Token Name 可自行命名，例如 socket-mode。
3. 加入三個 scope：connections:write、authorizations:read、app_configurations:write，然後按 Generate。
4. 複製產生的 Token（以 xapp- 開頭）。
5. 回到 Admin Panel，貼進「App-Level Token」欄位，按「送出並完成連接」。

完成狀態：Slack 卡片顯示「已連接到 <目標 workspace>」。

將 ANIMA 加入 群組

連接完成後，ANIMA 還不會出現在任何 群組。在每個要使用的群組中：

• 輸入 /invite @<Bot 名稱>，或
• 點 channel details → Integrations → Add apps

目前的限制

• 無法讀取未被邀請的群組。 ANIMA 無法得知這些 群組的存在。
• 無法讀取同仁之間的私訊。 ANIMA 不是參與者的對話一律無法存取。
• 發訊息需要確認。 ANIMA 不會未經同意就代發言。

常見問題

Configuration Token 跟 App-Level Token 有什麼不同？ 前者用於建立與設定 App，後者用於連線。兩者是 Slack 定義的不同類型，都需要。

Bot 名稱可以之後改嗎？ 可以在 Slack 的 App 設定頁修改。

與外部組織共用的 Slack 群組要特別設定嗎？ 不用。ANIMA 會自動把 與外部組織共用的 Slack 群組（與外部組織共用的 Slack 群組） 視為外部，套用外部規則。這是自動的，不需管理員判斷。

可以私訊 ANIMA 嗎？ 可以。Slack 支援與 ANIMA 的一對一私訊，可用的資料範圍由管理員設定。

私人群組可以用嗎？ 可以，將 ANIMA 邀請加入即可。私人群組視為「內部私人」：可使用內部共用資料，但本身的對話不會被其他群組查詢到。