本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
# Microsoft Teams 整合
使用 Microsoft Teams 動作連接器，透過自然語言直接在 Amazon Quick 中傳送訊息、管理頻道、排程會議和管理團隊協作。
設定此整合包含兩個步驟。首先，在 Microsoft Entra 中註冊應用程式並設定其許可。然後，您可以在 Amazon Quick 中建立整合，並將其連接到您的 Entra 應用程式。如需有關 Amazon Quick 支援的身分驗證方法的資訊，請參閱 [身分驗證方法](quick-action-auth.md)。
## 開始之前
在設定整合之前，請確定您有下列項目。
+ 具有 Teams 存取權的 Microsoft 365 帳戶。
+ 存取至少具有應用程式開發人員許可的 [Microsoft Entra 管理中心](https://entra.microsoft.com/)。
+ 如需訂閱需求，請參閱 [在 主控台中設定整合](integration-console-setup-process.md)。
## 設定 Microsoft Entra
設定 Amazon Quick 之前，請在 Microsoft Entra 中建立應用程式註冊。在移至 Amazon Quick 主控台之前，請先完成 Entra 中的所有以下步驟。
如需應用程式註冊的詳細資訊，請參閱 [Microsoft 文件中的使用 Microsoft 身分平台註冊應用程式](https://learn.microsoft.com/en-us/entra/identity-platform/quickstart-register-app)。
### 註冊應用程式
1. 開啟 [Microsoft Entra 管理中心](https://entra.microsoft.com/)。
1. 在左側導覽中，選擇 **Entra ID**，然後選擇**應用程式註冊**。
1. 選擇**新增註冊**。
1. 在**名稱**中，輸入整合的描述性名稱。
1. 對於**支援的 帳戶類型**，**僅選擇此組織目錄中的帳戶**。
1. 針對**重新導向 URI**，選取 **Web** 並輸入 `https://{region}.quicksight.aws.amazon.com/sn/oauthcallback`。將 *\$1region\$1* 取代為部署 Amazon Quick 執行個體 AWS 的區域。
1. 選擇**註冊**。
1. 在概觀頁面上，複製**應用程式 （用戶端） ID** 和**目錄 （租戶） ID**。您需要這些值才能進行 Amazon Quick 組態。
### 建立用戶端秘密
Amazon Quick 需要用戶端秘密才能向 Microsoft Entra 進行身分驗證。此秘密可做為應用程式註冊的密碼。
1. 從您的應用程式註冊中，選擇**憑證和秘密**。
1. 選擇**新增用戶端秘密**。
1. 輸入描述並選擇過期期間。
1. 選擇**新增**。
1. 立即複製 **值**。此值只會顯示一次。
**重要**
複製秘密**值**，而不是秘密 ID。值是用於身分驗證的較長字串。
### 設定 API 許可
Microsoft Graph 支援此整合的兩種許可類型。委派許可允許應用程式代表登入的使用者採取行動。應用程式許可允許應用程式在沒有登入使用者的情況下採取行動。如需詳細資訊，請參閱 [Microsoft 文件中的 Microsoft Graph 許可概觀](https://learn.microsoft.com/en-us/graph/permissions-overview)。
1. 從您的應用程式註冊中選擇 **API 許可**。
1. 選擇**新增許可**，然後選擇 **Microsoft Graph**。
1. 根據您的身分驗證方法選擇**委派許可**或**應用程式許可**，然後從下方適當的資料表新增許可。
1. 選擇**授予 【您的租戶名稱】 管理員同意**以核准許可。
**對於使用者身分驗證 （委派許可）：**
在 Entra 應用程式註冊中將以下內容新增為委派許可。如需完整許可參考，請參閱 [Microsoft 文件中的 Microsoft Graph 許可參考](https://learn.microsoft.com/en-us/graph/permissions-reference)。
**團隊動作整合 – 委派許可**
| 權限 | Description |
| --- | --- |
| Chat.ReadWrite | 允許應用程式讀取和寫入登入使用者的聊天訊息。 |
| ChatMessage.Send | 允許應用程式代表登入的使用者傳送聊天訊息。 |
| Team.ReadBasic.All | 允許應用程式代表登入使用者讀取團隊的名稱和描述。 |
| Channel.ReadBasic.All | 允許應用程式代表登入的使用者讀取頻道名稱和描述。 |
| Channel.Create | 允許應用程式代表登入使用者在任何團隊中建立頻道。 |
| ChannelMessage.Read.All | 允許應用程式代表登入的使用者讀取所有頻道訊息。 |
| ChannelMessage.Send | 允許應用程式代表登入使用者在頻道中傳送訊息。 |
| ChannelMember.ReadWrite.All | 允許應用程式代表登入使用者從頻道新增和移除成員。 |
| TeamMember.ReadWrite.All | 允許應用程式代表登入使用者從所有團隊新增和移除成員。 |
| User.Read.All | 允許應用程式代表登入使用者讀取所有使用者的完整設定檔屬性集。 |
| OnlineMeetings.ReadWrite | 允許應用程式代表登入的使用者讀取和建立線上會議。 |
| OnlineMeetingTranscript.Read.All | 允許應用程式代表登入的使用者讀取線上會議的所有文字記錄。 |
| Calendars.ReadWrite | 允許應用程式代表登入使用者在使用者行事曆中讀取和寫入事件。 |
| offline\$1access | 允許應用程式重新整理存取權杖，而不需要使用者再次登入。這可減少使用者需要重新驗證身分的頻率。 |
**對於服務身分驗證 （應用程式許可）：**
在 Entra 應用程式註冊中將以下內容新增為應用程式許可。
**團隊動作整合 – 應用程式許可**
| 權限 | Description |
| --- | --- |
| Chat.Read.All | 允許應用程式在沒有登入使用者的情況下讀取組織中的所有聊天訊息。 |
| Chat.Send | 允許應用程式在沒有登入使用者的情況下傳送聊天訊息。 |
| Team.ReadBasic.All | 允許應用程式在沒有登入使用者的情況下讀取所有團隊的名稱和描述。 |
| Channel.ReadBasic.All | 允許應用程式在沒有登入使用者的情況下讀取所有頻道名稱和描述。 |
| ChannelMessage.Read.All | 允許應用程式在沒有登入使用者的情況下讀取所有頻道訊息。 |
| ChannelMessage.Send | 允許應用程式在沒有登入使用者的情況下傳送訊息到任何頻道。 |
| ChannelMember.ReadWrite.All | 允許應用程式從所有頻道新增和移除成員，而無需登入使用者。 |
| TeamMember.ReadWrite.All | 允許應用程式在沒有登入使用者的情況下，從所有團隊新增和移除成員。 |
| User.Read.All | 允許應用程式在沒有登入使用者的情況下，讀取所有使用者的完整設定檔屬性集。 |
| OnlineMeetingTranscript.Read.All | 允許應用程式在沒有登入使用者的情況下讀取線上會議的所有文字記錄。 |
**重要**
透過服務身分驗證，所有動作都會以服務帳戶身分執行。任何有權存取此整合的使用者都可以跨服務帳戶可存取的所有團隊和管道執行動作。根據您的組織安全需求，適當地範圍應用程式許可。
### 記錄您的登入資料
離開 Microsoft Entra 管理中心之前，請確認您有下列值。您需要它們才能進行 Amazon Quick 組態。
**Microsoft Entra 的必要登入資料**
| Value | 在哪裡找到它 |
| --- | --- |
| 應用程式 (用戶端) ID | 應用程式註冊概觀頁面 |
| 目錄 （租戶） ID | 應用程式註冊概觀頁面 |
| 用戶端秘密值 | 憑證與秘密頁面 |
## 在 Amazon Quick 中設定整合
完成 Entra 組態後，請在 Amazon Quick 中建立整合。
1. 在 Amazon Quick 主控台中，選擇**整合**。
1. 選擇**動作**索引標籤。
1. 選擇 **Microsoft Teams**，然後選擇新增 （加 "\$1") 按鈕。
1. 填寫整合詳細資訊：
+ **名稱** – Teams 整合的描述性名稱。
+ **描述** （選用） – 整合的目的。
1. 選擇您的連線類型並填入連線設定：
1. 對於**使用者身分驗證 (OAuth)**，請設定下列欄位：
+ **基本 URL** – `https://graph.microsoft.com/v1.0`
+ **用戶端 ID** – 來自您 Entra 應用程式註冊的應用程式 （用戶端） ID。
+ **用戶端秘密** – 來自您 Entra 應用程式註冊的用戶端秘密值。
+ **字符 URL** – `https://login.microsoftonline.com/{tenant-id}/oauth2/v2.0/token`
+ **驗證 URL** – `https://login.microsoftonline.com/{tenant-id}/oauth2/v2.0/authorize`
+ **重新導向 URL** – `https://{region}.quicksight.aws.amazon.com/sn/oauthcallback`
1. 針對**服務身分驗證**，請設定下列欄位：
+ **用戶端 ID** – 來自您 Entra 應用程式註冊的應用程式 （用戶端） ID。
+ **用戶端秘密** – 來自您 Entra 應用程式註冊的用戶端秘密值。
+ **字符 URL** – `https://login.microsoftonline.com/{tenant-id}/oauth2/v2.0/token`
+ **範圍** – `.default`
1. 選擇**建立並繼續**。
1. 選擇要與之共用整合的使用者。
1. 選擇**下一步**。
## 可用動作
設定整合之後，可以使用下列動作。
**Microsoft Teams 可用的動作**
| Category | Action | Description |
| --- | --- | --- |
| 聊天 | 列出聊天 | 檢視您的聊天對話。 |
| 聊天 | 建立聊天 | 開始新的聊天對話。 |
| 聊天 | 傳送聊天訊息 | 在聊天中傳送訊息。 |
| 團隊 | 列出團隊 | 檢視您所屬的團隊。 |
| 團隊 | 列出團隊成員 | 檢視團隊成員。 |
| 團隊 | 新增團隊成員 | 將成員新增至團隊。 |
| 頻道 | 列出頻道 | 檢視團隊中的頻道。 |
| 頻道 | 建立頻道 | 在團隊中建立新的頻道。 |
| 頻道 | 列出頻道訊息 | 檢視頻道中的訊息。 |
| 頻道 | 傳送頻道訊息 | 將訊息發佈至頻道。 |
| 頻道 | 列出頻道成員 | 檢視頻道的成員。 |
| 頻道 | 新增頻道成員 | 將成員新增至頻道。 |
| 使用者 | 列出 使用者 | 檢視組織中的使用者。 |
| 會議 | 列出線上會議 | 檢視排定的線上會議。 |
| 會議 | 建立線上會議 | 安排新的線上會議。 |
| 會議 | 列出會議文字記錄 | 檢視會議的文字記錄。 |
| 行事暦 | 列出行事曆事件 | 檢視行事曆上的事件。 |
| 行事暦 | 建立行事曆事件 | 建立新的行事曆事件。 |
## 管理和疑難排解
若要編輯、共用或刪除整合，請參閱 [管理現有的整合](integration-workflows.md#managing-existing-integrations)。
### 驗證問題
+ **不正確的應用程式註冊** – 驗證 Microsoft Entra 中的應用程式註冊包含必要的 API 許可，並且已授予管理員同意。
+ **過期的用戶端秘密** – 檢查用戶端秘密是否已在**憑證和秘密**中過期，並視需要產生新的秘密。
+ **不正確的重新導向 URI** – 驗證 Microsoft Entra 中的重新導向 URI 符合 `https://{region}.quicksight.aws.amazon.com/sn/oauthcallback`。
### 常見錯誤訊息
+ **`Access denied. You do not have permission to perform this action`** – 已驗證的使用者沒有必要的許可。請聯絡您的管理員以驗證並授予適當的許可。
+ **`AADSTS50020: User account from identity provider does not exist in tenant`** – 使用者帳戶未在正確的 Microsoft Entra 租用戶中設定。確認使用者帳戶存在於符合應用程式註冊中目錄 （租用戶） ID 的租用戶中。