跳至主要內容

Slack

Slack 接入採用 Socket Mode，需要兩種認證資料：bot_token（通常以 xoxb- 開頭）用於 Web API 和傳送訊息，app_token（xapp-）用於建立 Socket Mode 連線。不要只填寫其中一種。

在 Slack 主控台完成準備​

為目標 Workspace 建立 App，啟用 Socket Mode，簽發有相應權限的 App-level Token，再設定 Bot 的訊息事件訂閱和讀取/傳送/檔案權限。權限變更後按 Slack 要求重新安裝 App；僅改主控台選項不一定更新現有 Token 授權。

在 Anyy 儲存帳號​

開啟 Dashboard 通訊管道 → 新增 → Slack，預設採用 Socket Mode，填寫帳號 ID 和兩個 Token。預設帳號 ID 為 work。也可執行 anyy setup channel 在精靈中選擇 Slack。

Socket Mode 不要求公用網路入站 Webhook，但常駐 Gateway 必須能夠主動連線 Slack。Token 按目前 Profile 管理。

放行傳送者​

私訊預設 pairing，群組對話預設 mention。策略透過 CLI 精靈修改，目前可選值為：

  • 私訊：pairing、open、allowlist、disabled；
  • 群組對話：mention、open、allowlist、disabled。

Dashboard 認證資料表單不提供這些策略輸入；現有公開設定也沒有 Slack 名單條目編輯器。已有名單使用 Slack User/Channel ID，不能靠暱稱猜測。首次使用優先完成配對：

anyy channel pairing list --channel slack
anyy channel pairing approve --request REQUEST_ID

批准後傳送一則新私訊。存取範圍與清單限制見訊息平台。

檢查 Thread 和檔案​

anyy channel reload
anyy channel doctor slack

先測試私訊，再在已安裝 Bot 的頻道提及它。Slack Thread Timestamp 會保留在路由中，回覆進入原 Thread；受支援的入站檔案使用 Bot 認證資料下載，通過大小限制後暫存。

無法連線時檢查 Socket Mode、App Token Scope 和出站網路；有連線但沒訊息時檢查事件訂閱與成員關係；不能傳送訊息或取得檔案時分別檢查 Bot 寫入權限和檔案權限。