本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# Slack 整合
<a name="slack-integration"></a>

使用 Slack 動作連接器，您可以透過自然語言直接在 Amazon Quick 中存取 Slack 平台。您可以傳送訊息、管理頻道、搜尋內容，以及與使用者和使用者群組互動，而無需離開 Amazon Quick。

Amazon Quick 支援 Slack 的多種身分驗證方法。選擇最適合您組織安全需求的方法。
+ **預設 OAuth 應用程式** – 使用 AWS受管 OAuth 應用程式。不需要額外的登入資料。您使用 Slack 工作區直接進行身分驗證。
+ **自訂 OAuth 應用程式** – 使用客戶管理的 Slack 應用程式。此選項可讓您的組織完全控制 OAuth 組態。
+ **承載字符** – 使用 Slack 機器人字符進行身分驗證。此方法適用於機器人層級存取工作區。

如需 Amazon Quick 支援的身分驗證方法的詳細資訊，請參閱 [身分驗證方法](quick-action-auth.md)。

## 開始之前
<a name="slack-integration-prerequisites"></a>

在設定整合之前，請確定您有下列項目。
+ 可存取您要使用的頻道和資料的 Slack 工作區。
+ 對於**自訂 OAuth 應用程式**：存取 [Slack 網站上的 Slack API 儀表板](https://api.slack.com/apps)以建立應用程式。
+ 對於**承載字符**：來自 Slack 應用程式的機器人字符 （以 開頭`xoxb-`)。如需詳細資訊，請參閱 Slack 網站上的 [Quickstart 應用程式設定](https://docs.slack.dev/app-management/quickstart-app-settings)。
+ 如需 Amazon Quick 訂閱需求，請參閱 [在主控台中設定整合](integration-console-setup-process.md)。

## 設定 Slack
<a name="slack-source-setup"></a>

如果您使用的是**預設 OAuth 應用程式**身分驗證，請略過本節並前往 [在 Amazon Quick 中設定連接器](#slack-quicksuite-setup)。

對於自訂 OAuth 應用程式或承載字符身分驗證，請在設定 Amazon Quick 之前完成 Slack 中的適用步驟。

### 為自訂 OAuth 應用程式或承載字符建立 Slack 應用程式
<a name="slack-register-oauth"></a>

建立 Slack 應用程式，以取得 Amazon Quick 所需的用戶端憑證或機器人字符。

1. 前往 [Slack 網站上的 Slack API 儀表板](https://api.slack.com/apps)，然後選擇**建立新應用程式**。

1. 選擇**從頭**開始。

1. 輸入**應用程式名稱**，然後選取您的 Slack 工作區。選擇 **Create App (建立應用程式)**。

1. 在左側邊欄中，選擇 **OAuth & Permissions**。

1. 在**重新導向 URLs**下，選擇**新增重新導向 URL**，然後輸入 Amazon Quick 回呼 URL： `https://{{{region}}}.quicksight.aws.amazon.com/sn/oauthcallback`

   選擇**新增**，然後選擇**儲存 URLs**。

1. 在**範圍**下，新增整合所需的機器人字符範圍。如需建議的範圍，請參閱 [建議範圍](#slack-oauth-scopes)。

1. 在左側邊欄中，選擇**基本資訊**。在**應用程式登入**資料下，記錄下列值：
   + **用戶端 ID**
   + **Client secret** (用戶端密碼)

1. 對於**承載字符**：從 **OAuth & Permissions **頁面將應用程式安裝到您的工作區。安裝之後，複製**機器人使用者 OAuth 權杖** （以 開頭`xoxb-`)。

### 建議範圍
<a name="slack-oauth-scopes"></a>

當您連線到 Slack 時，會請求以下範圍。當您建立自訂 Slack 應用程式時，請在 **OAuth & Permissions **頁面上新增這些範圍。對於自訂 OAuth 應用程式，將其新增為**使用者字符範圍**。對於承載字符，將其新增為**機器人字符範圍**。


**Slack 建議範圍**  

| 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 範圍參考](https://api.slack.com/scopes)中驗證範圍可用性。

## 在 Amazon Quick 中設定連接器
<a name="slack-quicksuite-setup"></a>

### 從可用索引標籤連線
<a name="slack-quick-connect"></a>

如果您想要使用預設 OAuth 應用程式身分驗證，您可以直接從**可用**索引標籤連線，而不需要其他組態。

1. 在 Amazon Quick 主控台中，選擇**連接器**。

1. 在**可用**索引標籤上，尋找 **Slack** 並選擇**連線**。

1. 完成 Slack 登入流程並授予請求的許可。

若要改為使用自訂 OAuth 應用程式或承載權杖設定連接器，請使用**為您的團隊建立**索引標籤，如下所述。

### 從為您的團隊建立索引標籤建立
<a name="slack-full-setup"></a>

完成任何必要的 Slack 組態後，請在 Amazon Quick 中建立連接器。

1. 在 Amazon Quick 主控台中，選擇**連接器**。

1. 選擇**為您的團隊建立**索引標籤。

1. 尋找並選擇 **Slack**。
**注意**  
如果 Slack 連接器已存在，則會顯示一個對話方塊，其中包含您現有的連接器。若要使用現有的連接器，請選擇它。若要建立新的，請選擇**否，建立新的**。

1. 輸入連接器**的名稱**。或者，選擇 **\+ 新增描述**以新增描述。

1. 針對**連線類型**，選擇**公有網路**。

1. 針對 **OAuth 組態**，選擇下列其中一種身分驗證方法，並設定必要欄位。

   1. 對於**預設 OAuth 應用程式**：

      不需要額外的登入資料。選擇 **Next** (下一步) 繼續。

   1. 對於**自訂 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。

   1. 對於**承載字符**，請設定下列欄位：
      + **基本 URL** （選用） – Slack API 基本 URL。範例：`https://slack.com/api`
      + **機器人字符** – 您的 Slack 機器人字符 （以 開頭`xoxb-`)。

1. 選擇**下一步**。

1. 如果您選擇**預設 OAuth 應用程式**或**自訂 OAuth 應用程式**，會開啟 Slack 授權視窗。檢閱請求的許可，選取您的工作區，然後選擇**允許**。

1. 在**檢閱**頁面上，檢閱連接器的可用動作。選擇**下一步**。

1. 在**發佈**頁面上，選擇誰可以存取連接器。您可以為組織中的每個人啟用存取權，或搜尋特定的團隊或群組。

1. 選擇**發布**。

## 可用動作
<a name="slack-integration-actions"></a>

設定連接器之後，可以使用下列動作。


**Slack 可用的動作**  

| Category | Action | Description | 
| --- | --- | --- | 
| 訊息 | 聊天貼文訊息 | 將訊息發佈至頻道、直接訊息或私有群組。 | 
| 訊息 | 傳送訊息給我 | 傳送第三方動作訊息到頻道。 | 
| 訊息 | 取得訊息 Permalink | 擷取特定訊息的 permalink URL。 | 
| 頻道 | 對話建立 | 建立公有或私有頻道。 | 
| 頻道 | 對話歷史記錄 | 從頻道擷取訊息歷史記錄。僅傳回主要時間軸訊息，而非執行緒回應。 | 
| 頻道 | 對話回應 | 擷取特定父訊息的執行緒回應。 | 
| 頻道 | 對話邀請 | 邀請使用者加入現有的頻道。 | 
| 頻道 | 對話加入 | 加入現有的頻道。 | 
| 頻道 | 對話 Kick | 從頻道移除使用者。 | 
| 頻道 | 對話離開 | 離開頻道。 | 
| 頻道 | 對話成員 | 列出頻道的成員 IDs。 | 
| 頻道 | 開啟的對話 | 開啟或繼續直接訊息或多人直接訊息。 | 
| 頻道 | 對話集主題 | 設定或更新頻道的主題。 | 
| 頻道 | 取得對話 | 依 ID 擷取頻道的中繼資料。 | 
| 頻道 | 列出頻道 | 列出使用者可用的頻道。 | 
| 頻道 | 列出使用者的對話 | 列出使用者可存取的頻道和直接訊息。 | 
| 反應 | 建立反應 | 將表情符號反應新增至訊息。 | 
| 反應 | 刪除反應 | 從訊息中移除表情符號反應。 | 
| 反應 | 列出反應 | 列出訊息、檔案或檔案註解上的反應。 | 
| 檔案 | 上傳或建立檔案 | 將檔案或媒體上傳至頻道或執行緒。 | 
| 檔案 | 上傳至外部 URL | 將參考新增至外部檔案以在 Slack 中共用。 | 
| 檔案 | 下載檔案 | 下載在 Slack 中共用的檔案。 | 
| 檔案 | 檔案資訊 | 擷取檔案的中繼資料和註解。 | 
| 檔案 | 檔案清單 | 使用選用的篩選條件列出工作區中的檔案。 | 
| 搜尋 | 全部搜尋 | 搜尋工作區中的訊息和檔案。 | 
| 搜尋 | 搜尋訊息 | 使用日期範圍和篩選條件搜尋訊息。 | 
| 搜尋 | 搜尋頻道 | 依名稱、主題或用途搜尋頻道。 | 
| 搜尋 | 搜尋使用者 | 透過電子郵件、名稱或顯示名稱搜尋使用者。 | 
| 搜尋 | 搜尋內容 | 搜尋訊息、檔案、頻道和使用者。支援使用 Slack AI 在工作區進行語意搜尋。 | 
| 搜尋 | 取得搜尋組態 | 檢查工作區上是否提供語意搜尋。 | 
| 使用者 | 取得使用者詳細資訊 | 依 ID 擷取使用者的資訊。 | 
| 使用者 | 取得使用者設定檔 | 擷取使用者的設定檔資訊。 | 
| 使用者 | 使用者設定檔集 | 更新使用者的設定檔欄位。 | 
| 使用者 | 使用者清單 | 列出工作區中的所有使用者。 | 
| 使用者群組 | 建立使用者群組 | 建立新的使用者群組。 | 
| 使用者群組 | 使用者群組清單 | 列出工作區中的使用者群組。 | 
| 使用者群組 | 使用者群組使用者更新 | 取代使用者群組的所有成員。 | 
| 提醒 | 提醒 新增 | 建立具有指定文字和時間的提醒。 | 
| 工作區 | 取得團隊 | 擷取有關 Slack 工作區的中繼資料。 | 

**注意**  
您可以使用的動作取決於為 Slack 應用程式設定的範圍，以及已驗證使用者可存取的頻道。

## 管理和疑難排解
<a name="slack-integration-troubleshooting"></a>

若要編輯、共用或刪除連接器，請參閱 [管理現有的整合](integration-workflows.md#managing-existing-integrations)。

### 驗證問題
<a name="slack-troubleshooting-auth"></a>
+ **登入失敗 （預設 OAuth 應用程式或自訂 OAuth 應用程式）** – 確認您的 Slack 工作區處於作用中狀態，而且您可以直接登入 [Slack 網站](https://slack.com)。對於自訂 OAuth 應用程式，請確認 Slack 應用程式中的重新導向 URL 符合 Amazon Quick 回呼 URL。
+ **無效用戶端登入資料 （自訂 OAuth 應用程式）** – 驗證用戶端 ID 和用戶端秘密是否符合 Slack 應用程式的基本資訊區段中的值。
+ **承載權杖遭拒** – 確認您的機器人權杖處於作用中狀態並以 開頭`xoxb-`。權杖可以從 Slack API 儀表板撤銷。
+ **許可不足** – 驗證為 Slack 應用程式設定的範圍是否包含您要使用的動作所需的許可。請參閱 [建議範圍](#slack-oauth-scopes)。
+ **找不到頻道或頻道中沒有** - 確認機器人已新增至頻道。在嘗試張貼訊息或讀取歷史記錄之前，邀請機器人到頻道。