本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
Slack 整合
使用 Slack 動作連接器，您可以透過自然語言直接在 Amazon Quick 中存取 Slack 平台。您可以傳送訊息、管理頻道、搜尋內容，以及與使用者和使用者群組互動，而無需離開 Amazon Quick。
Amazon Quick 支援 Slack 的多種身分驗證方法。選擇最適合您組織安全需求的方法。
-
預設 OAuth 應用程式 – 使用 AWS受管 OAuth 應用程式。不需要額外的登入資料。您使用 Slack 工作區直接進行身分驗證。
-
自訂 OAuth 應用程式 – 使用客戶管理的 Slack 應用程式。此選項可讓您的組織完全控制 OAuth 組態。
-
承載字符 – 使用 Slack 機器人字符進行身分驗證。此方法適用於機器人層級存取工作區。
如需 Amazon Quick 支援的身分驗證方法的詳細資訊，請參閱 身分驗證方法。
開始之前
在設定整合之前，請確定您有下列項目。
-
可存取您要使用的頻道和資料的 Slack 工作區。
-
對於自訂 OAuth 應用程式：存取 Slack 網站上的 Slack API 儀表板
以建立應用程式。 -
對於承載字符：來自 Slack 應用程式的機器人字符 （以 開頭
xoxb-)。如需詳細資訊，請參閱 Slack 網站上的 Quickstart 應用程式設定。 -
如需 Amazon Quick 訂閱需求，請參閱 在主控台中設定整合。
設定 Slack
如果您使用的是預設 OAuth 應用程式身分驗證，請略過本節並前往 在 Amazon Quick 中設定連接器。
對於自訂 OAuth 應用程式或承載字符身分驗證，請在設定 Amazon Quick 之前完成 Slack 中的適用步驟。
為自訂 OAuth 應用程式或承載字符建立 Slack 應用程式
建立 Slack 應用程式，以取得 Amazon Quick 所需的用戶端憑證或機器人字符。
-
前往 Slack 網站上的 Slack API 儀表板
，然後選擇建立新應用程式。 -
選擇從頭開始。
-
輸入應用程式名稱，然後選取您的 Slack 工作區。選擇 Create App (建立應用程式)。
-
在左側邊欄中，選擇 OAuth & Permissions。
-
在重新導向 URLs下，選擇新增重新導向 URL，然後輸入 Amazon Quick 回呼 URL：
https://{region}.quicksight.aws.amazon.com/sn/oauthcallback選擇新增，然後選擇儲存 URLs。
-
在範圍下，新增整合所需的機器人字符範圍。如需建議的範圍，請參閱 建議範圍。
-
在左側邊欄中，選擇基本資訊。在應用程式登入資料下，記錄下列值：
-
用戶端 ID
-
Client secret (用戶端密碼)
-
-
對於承載字符：從 OAuth & Permissions 頁面將應用程式安裝到您的工作區。安裝之後，複製機器人使用者 OAuth 權杖 （以 開頭
xoxb-)。
建議範圍
當您連線到 Slack 時，會請求以下範圍。當您建立自訂 Slack 應用程式時，請在 OAuth & Permissions 頁面上新增這些範圍。對於自訂 OAuth 應用程式，將其新增為使用者字符範圍。對於承載字符，將其新增為機器人字符範圍。
| Scope (範圍) | Description |
|---|---|
calls:read |
讀取通話資訊。 |
calls:write |
建立和管理呼叫。 |
channels:history |
在公有頻道中讀取訊息歷史記錄。 |
channels:read |
讀取公有頻道的相關資訊。 |
channels:write |
管理公有頻道。 |
chat:write |
傳送訊息至管道和對話。 |
dnd:read |
讀取請勿打擾設定。 |
dnd:write |
更新請勿干擾設定。 |
emoji:read |
讀取自訂表情符號。 |
files:read |
讀取頻道中共用的檔案。 |
files:write |
上傳和管理檔案。 |
groups:history |
讀取私有頻道中的訊息歷史記錄。 |
groups:read |
讀取私有頻道的相關資訊。 |
groups:write |
管理私有頻道。 |
im:history |
讀取直接訊息中的訊息歷史記錄。 |
im:read |
讀取有關直接訊息的資訊。 |
im:write |
啟動直接訊息。 |
links:read |
讀取連結預覽。 |
links:write |
管理連結預覽。 |
mpim:history |
讀取群組直接訊息中的訊息歷史記錄。 |
mpim:read |
讀取群組直接訊息的相關資訊。 |
mpim:write |
啟動群組直接訊息。 |
pins:read |
讀取固定訊息。 |
pins:write |
釘選和取消釘選訊息。 |
reactions:read |
讀取訊息上的表情符號反應。 |
reactions:write |
新增和移除表情符號反應。 |
reminders:read |
讀取提醒。 |
reminders:write |
建立提醒。 |
remote_files:read |
讀取遠端檔案。 |
remote_files:share |
共用遠端檔案。 |
search:read |
搜尋訊息和檔案。 |
stars:read |
讀取星號項目。 |
stars:write |
Stars 和 unstars 項目。 |
team:read |
讀取工作區資訊。 |
usergroups:read |
讀取使用者群組資訊。 |
usergroups:write |
管理使用者群組。 |
users:read |
讀取使用者資訊。 |
users:read.email |
讀取使用者電子郵件地址。 |
users:write |
更新使用者資訊。 |
users.profile:read |
讀取使用者設定檔資訊。 |
users.profile:write |
更新使用者設定檔資訊。 |
注意
並非所有範圍都適用於使用者字符範圍和機器人字符範圍。有些範圍，例如 search:read和 stars:read，僅適用於使用者字符範圍。當您設定承載字符身分驗證的範圍時，請在 Slack 網站上的 Slack API 範圍參考
在 Amazon Quick 中設定連接器
從可用索引標籤連線
如果您想要使用預設 OAuth 應用程式身分驗證，您可以直接從可用索引標籤連線，而不需要其他組態。
-
在 Amazon Quick 主控台中，選擇連接器。
-
在可用索引標籤上，尋找 Slack 並選擇連線。
-
完成 Slack 登入流程並授予請求的許可。
若要改為使用自訂 OAuth 應用程式或承載權杖設定連接器，請使用為您的團隊建立索引標籤，如下所述。
從為您的團隊建立索引標籤建立
完成任何必要的 Slack 組態後，請在 Amazon Quick 中建立連接器。
-
在 Amazon Quick 主控台中，選擇連接器。
-
選擇為您的團隊建立索引標籤。
-
尋找並選擇 Slack。
注意
如果 Slack 連接器已存在，則會顯示一個對話方塊，其中包含您現有的連接器。若要使用現有的連接器，請選擇它。若要建立新的，請選擇否，建立新的。
-
輸入連接器的名稱。或者，選擇 + 新增描述以新增描述。
-
針對連線類型，選擇公有網路。
-
針對 OAuth 組態，選擇下列其中一種身分驗證方法，並設定必要欄位。
-
對於預設 OAuth 應用程式：
不需要額外的登入資料。選擇 Next (下一步) 繼續。
-
對於自訂 OAuth 應用程式，請設定下列欄位：
-
基本 URL （選用） – Slack API 基本 URL。範例：
https://slack.com/api -
用戶端 ID – 來自 Slack 應用程式的用戶端 ID。
-
用戶端秘密 – 來自 Slack 應用程式的用戶端秘密。
-
權杖 URL – 權杖端點。範例：
https://slack.com/api/oauth.v2.access -
授權 URL – 授權端點。範例：
https://slack.com/oauth/v2/authorize -
重新導向 URL – 預先填入 Amazon Quick 回呼 URL。
-
-
對於承載字符，請設定下列欄位：
-
基本 URL （選用） – Slack API 基本 URL。範例：
https://slack.com/api -
機器人字符 – 您的 Slack 機器人字符 （以 開頭
xoxb-)。
-
-
-
選擇下一步。
-
如果您選擇預設 OAuth 應用程式或自訂 OAuth 應用程式，會開啟 Slack 授權視窗。檢閱請求的許可，選取您的工作區，然後選擇允許。
-
在檢閱頁面上，檢閱連接器的可用動作。選擇下一步。
-
在發佈頁面上，選擇誰可以存取連接器。您可以為組織中的每個人啟用存取權，或搜尋特定的團隊或群組。
-
選擇發布。
可用動作
設定連接器之後，可以使用下列動作。
| Category | Action | Description |
|---|---|---|
| 訊息 | 聊天貼文訊息 | 將訊息發佈至頻道、直接訊息或私有群組。 |
| 訊息 | 傳送訊息給我 | 傳送第三方動作訊息到頻道。 |
| 訊息 | 取得訊息 Permalink | 擷取特定訊息的 permalink URL。 |
| 頻道 | 對話建立 | 建立公有或私有頻道。 |
| 頻道 | 對話歷史記錄 | 從頻道擷取訊息歷史記錄。僅傳回主要時間軸訊息，而非執行緒回應。 |
| 頻道 | 對話回應 | 擷取特定父訊息的執行緒回應。 |
| 頻道 | 對話邀請 | 邀請使用者加入現有的頻道。 |
| 頻道 | 對話加入 | 加入現有的頻道。 |
| 頻道 | 對話 Kick | 從頻道移除使用者。 |
| 頻道 | 對話離開 | 離開頻道。 |
| 頻道 | 對話成員 | 列出頻道的成員 IDs。 |
| 頻道 | 開啟的對話 | 開啟或繼續直接訊息或多人直接訊息。 |
| 頻道 | 對話集主題 | 設定或更新頻道的主題。 |
| 頻道 | 取得對話 | 依 ID 擷取頻道的中繼資料。 |
| 頻道 | 列出頻道 | 列出使用者可用的頻道。 |
| 頻道 | 列出使用者的對話 | 列出使用者可存取的頻道和直接訊息。 |
| 反應 | 建立反應 | 將表情符號反應新增至訊息。 |
| 反應 | 刪除反應 | 從訊息中移除表情符號反應。 |
| 反應 | 列出反應 | 列出訊息、檔案或檔案註解上的反應。 |
| 檔案 | 上傳或建立檔案 | 將檔案或媒體上傳至頻道或執行緒。 |
| 檔案 | 上傳至外部 URL | 將參考新增至外部檔案以在 Slack 中共用。 |
| 檔案 | 下載檔案 | 下載在 Slack 中共用的檔案。 |
| 檔案 | 檔案資訊 | 擷取檔案的中繼資料和註解。 |
| 檔案 | 檔案清單 | 使用選用的篩選條件列出工作區中的檔案。 |
| 搜尋 | 全部搜尋 | 搜尋工作區中的訊息和檔案。 |
| 搜尋 | 搜尋訊息 | 使用日期範圍和篩選條件搜尋訊息。 |
| 搜尋 | 搜尋頻道 | 依名稱、主題或用途搜尋頻道。 |
| 搜尋 | 搜尋使用者 | 透過電子郵件、名稱或顯示名稱搜尋使用者。 |
| 搜尋 | 搜尋內容 | 搜尋訊息、檔案、頻道和使用者。支援使用 Slack AI 在工作區進行語意搜尋。 |
| 搜尋 | 取得搜尋組態 | 檢查工作區上是否提供語意搜尋。 |
| 使用者 | 取得使用者詳細資訊 | 依 ID 擷取使用者的資訊。 |
| 使用者 | 取得使用者設定檔 | 擷取使用者的設定檔資訊。 |
| 使用者 | 使用者設定檔集 | 更新使用者的設定檔欄位。 |
| 使用者 | 使用者清單 | 列出工作區中的所有使用者。 |
| 使用者群組 | 建立使用者群組 | 建立新的使用者群組。 |
| 使用者群組 | 使用者群組清單 | 列出工作區中的使用者群組。 |
| 使用者群組 | 使用者群組使用者更新 | 取代使用者群組的所有成員。 |
| 提醒 | 提醒 新增 | 建立具有指定文字和時間的提醒。 |
| 工作區 | 取得團隊 | 擷取有關 Slack 工作區的中繼資料。 |
注意
您可以使用的動作取決於為 Slack 應用程式設定的範圍，以及已驗證使用者可存取的頻道。
管理和疑難排解
若要編輯、共用或刪除連接器，請參閱 管理現有的整合。
驗證問題
-
登入失敗 （預設 OAuth 應用程式或自訂 OAuth 應用程式） – 確認您的 Slack 工作區處於作用中狀態，而且您可以直接登入 Slack 網站
。對於自訂 OAuth 應用程式，請確認 Slack 應用程式中的重新導向 URL 符合 Amazon Quick 回呼 URL。 -
無效用戶端登入資料 （自訂 OAuth 應用程式） – 驗證用戶端 ID 和用戶端秘密是否符合 Slack 應用程式的基本資訊區段中的值。
-
承載權杖遭拒 – 確認您的機器人權杖處於作用中狀態並以 開頭
xoxb-。權杖可以從 Slack API 儀表板撤銷。 -
許可不足 – 驗證為 Slack 應用程式設定的範圍是否包含您要使用的動作所需的許可。請參閱 建議範圍。
-
找不到頻道或頻道中沒有 - 確認機器人已新增至頻道。在嘗試張貼訊息或讀取歷史記錄之前，邀請機器人到頻道。
