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

# 設定通知與 AWS Chatbot 之間的整合
<a name="notifications-chatbot"></a>

AWS Chatbot 是一種 AWS 服務，可讓 DevOps 和軟體開發團隊使用 Amazon Chime 聊天室、Slack 頻道和 Microsoft Team 頻道來監控和回應 中的操作事件 AWS 雲端。您可以設定通知規則目標與 AWS Chatbot 之間的整合，讓事件通知出現在您選擇的 Amazon Chime 會議室、Slack 頻道或 Microsoft Teams 頻道中。如需詳細資訊，請參閱 [AWS Chatbot 文件](https://docs.aws.amazon.com/chatbot/latest/adminguide/what-is.html)。

設定與 AWS Chatbot 的整合之前，您必須設定通知規則和規則目標。如需詳細資訊，請參閱[設定](setting-up.md)及[建立通知規則](notification-rule-create.md)。您也必須在 AWS Chatbot 中設定 Slack 頻道、Microsoft Teams 頻道或 Amazon Chime 聊天室。如需詳細資訊，請參閱這些服務的文件。

**Topics**
+ [設定 Slack 頻道的 AWS Chatbot 用戶端](#notifications-chatbot-configure-client)
+ [為 Microsoft Teams 頻道設定 AWS Chatbot 用戶端](#notifications-chatbot-configure-client-ts)
+ [為 Slack 或 Amazon Chime 手動設定用戶端](#notifications-chatbot-configure-manual-client)

## 設定 Slack 頻道的 AWS Chatbot 用戶端
<a name="notifications-chatbot-configure-client"></a>

您可以建立使用 AWS Chatbot 用戶端做為目標的通知規則。如果您為 Slack 頻道建立用戶端，則可以直接使用此用戶端，做為建立通知規則之工作流程中的目標。這是設定出現在 Slack 頻道中的通知最簡單的方法。

## 使用 Slack 建立 AWS Chatbot 用戶端以用作目標


1. 請依照 *AWS Chatbot 管理員指南*中的[在 Slack 中設定 AWS Chatbot](https://docs.aws.amazon.com/chatbot/latest/adminguide/slack-setup.html#slack-client-setup) 的指示操作。當您執行這項操作時，請考慮下列選項，以便與通知進行最佳整合：
   + 建立 IAM 角色時，請考慮選擇一個容易識別該角色的角色名稱 (例如 **AWSCodeStarNotifications-Chatbot-Slack-Role**)。這有助於識別未來角色的用途。
   + 在 **SNS 主題**中，您不需要選擇主題或 AWS 區域。當您選擇 AWS Chatbot 用戶端做為[目標](concepts.md#targets)時，系統會為 AWS Chatbot 用戶端建立和設定具有所有必要許可的 Amazon SNS 主題，做為通知規則建立程序的一部分。

1. 完成用戶端建立程序。然後，您可以在建立通知規則時選擇此用戶端做為目標。如需詳細資訊，請參閱[建立通知規則](notification-rule-create.md)。
**注意**  
設定 Amazon SNS 主題之後，請勿將其從 AWS Chatbot 用戶端中移除。這樣做會讓通知無法傳送至 Slack。

## 為 Microsoft Teams 頻道設定 AWS Chatbot 用戶端
<a name="notifications-chatbot-configure-client-ts"></a>

您可以建立使用 AWS Chatbot 用戶端做為目標的通知規則。如果您為 或 Microsoft Team 頻道建立用戶端，則可以直接使用此用戶端，做為建立通知規則之工作流程中的目標。這是設定出現在 Microsoft Teams 頻道中的通知最簡單的方法。

## 使用 Microsoft Teams 建立 AWS Chatbot 用戶端以用作目標


1. 請依照《AWS Chatbot 管理員指南》**中的[在 Microsoft Teams 中設定 AWS Chatbot](https://docs.aws.amazon.com/chatbot/latest/adminguide/teams-setup.html#teams-client-setup) 的指示操作。當您執行這項操作時，請考慮下列選項，以便與通知進行最佳整合：
   + 建立 IAM 角色時，請考慮選擇一個容易識別該角色的角色名稱 (例如 **AWSCodeStarNotifications-Chatbot-Microsoft-Teams-Role**)。這有助於識別未來角色的用途。
   + 在 **SNS 主題**中，您不需要選擇主題或 AWS 區域。當您選擇 AWS Chatbot 用戶端做為[目標](concepts.md#targets)時，系統會為 AWS Chatbot 用戶端建立並設定具有所有必要許可的 Amazon SNS 主題，做為通知規則建立程序的一部分。

1. 完成用戶端建立程序。然後，您可以在建立通知規則時選擇此用戶端做為目標。如需詳細資訊，請參閱[建立通知規則](notification-rule-create.md)。
**注意**  
設定 Amazon SNS 主題之後，請勿將其從 AWS Chatbot 用戶端中移除。這樣做會讓通知無法傳送至 Microsoft Teams。

## 為 Slack 或 Amazon Chime 手動設定用戶端
<a name="notifications-chatbot-configure-manual-client"></a>

您可以選擇在通知和 Slack 或 Amazon Chime 之間直接建立整合。這是為 Amazon Chime 聊天室設定通知的唯一可用方法。當您手動設定此整合時，您可以建立 AWS Chatbot 用戶端，該用戶端使用您先前設定為通知規則目標的 Amazon SNS 主題。<a name="notification-rule-chatbot-console-manual"></a>

## 手動整合通知與 AWS Chatbot 和 slack
<a name="notification-rule-chatbot-console-manual"></a>

1. 開啟位於 https：//[https://console.aws.amazon.com/codesuite/settings/notifications](https://console.aws.amazon.com/codesuite/settings/notifications/) 的 AWS 開發人員工具主控台。

1. 選擇 **Settings (設定)**，然後選擇 **Notification settings (通知設定)**。

1. 在 **Notification rule targets (通知規則目標)** 中，尋找並複製目標。
**注意**  
您可以設定多個通知規則使用與其目標相同的 Amazon SNS 主題。這可協助您整合簡訊，但如果訂閱清單專屬於一個通知規則或資源，則會產生意外後果。

1. 在 https：//[https://console.aws.amazon.com/chatbot/](https://console.aws.amazon.com/chatbot/) 開啟 AWS Chatbot 主控台。

1. 選擇 **Configure new client (設定新用戶端)**，然後選擇 **Slack**。

1. 選擇**設定**。

1. 登入您的 Slack 工作空間。

1. 如果系統提示您確認選擇項目，請選擇 **Allow (允許)**。

1. 選擇 **Configure new channel (設定新頻道)**。

1. 在 **Configuration details (組態詳細資訊)** 中的 **Configuration name (組態名稱)** 中，輸入您的用戶端名稱。此名稱會在您建立通知規則時，顯示在 **AWS Chatbot (Slack)** 目標類型的可用目標清單中。

1. 在 **Configure Slack Channel** (設定 Slack 頻道) 的 **Channel type** (頻道類型) 中，根據您要整合的頻道類型來選擇 **Public** (公有) 或 **Private** (私有)。
   + 在 **Public channel (公有頻道)** 中，從清單中選擇 Slack 頻道的名稱。
   + 在 **Private channel ID (私有頻道 ID)** 中，輸入頻道代碼或 URL。

1. 在 **IAM permissions (IAM 許可)** 中的 **Role (角色)** 裡，選擇 **Create an IAM role using a (使用範本建立 IAM 角色)**。在 **Policy templates (政策範本)** 中，選擇 **Notification permissions (通知許可)**。在 **Role name (角色名稱)** 中，輸入此角色的名稱 (例如 **AWSCodeStarNotifications-Chatbot-Slack-Role**)。在 **Policy templates (政策範本)** 中，選擇 **Notification permissions (通知許可)**。

1. 在 **SNS 主題**的 **SNS 區域中**，選擇您建立通知規則目標 AWS 區域 的 。在 **SNS topics (SNS 主題)** 中，選擇您設定為通知規則目標的 Amazon SNS 主題名稱。
**注意**  
如果您要建立使用此用戶端做為目標的通知規則，則不需要執行此步驟。

1. 選擇**設定**。
**注意**  
如果您已搭配私有頻道設定了整合，則您必須先邀請 AWS Chatbot 加入該頻道後，才能在該頻道中看到通知。如需詳細資訊，請參閱 [AWS Chatbot 文件](https://docs.aws.amazon.com/chatbot/latest/adminguide/what-is.html)。

1. (選用) 若要測試整合，請在資源中進行變更，以符合設定為使用 Amazon SNS 主題做為其目標之通知規則的事件類型。例如，如果您有一個通知規則設定為在對提取請求進行註解時傳送通知，請對提取請求進行註解，然後在瀏覽器中監看 Slack 頻道，以查看通知何時出現。<a name="notifications-chatbot-chime"></a>

## 將通知與 AWS Chatbot 和 Amazon Chime 整合
<a name="notifications-chatbot-chime"></a>

1. 開啟位於 https：//[https://console.aws.amazon.com/codesuite/settings/notifications](https://console.aws.amazon.com/codesuite/settings/notifications/) 的 AWS 開發人員工具主控台。

1. 選擇 **Settings (設定)**，然後選擇 **Notification settings (通知設定)**。

1. 在 **Notification rule targets (通知規則目標)** 中，尋找並複製目標。
**注意**  
您可以設定多個通知規則使用與其目標相同的 Amazon SNS 主題。這可協助您整合簡訊，但如果訂閱清單是針對一個通知規則或資源，也會產生意外後果。

1. 在 Amazon Chime 中，開啟您要設定進行整合的聊天室。

1. 選擇右上角的齒輪圖示，然後選擇 **Manage webhooks (管理 Webhook)**。

1. 在 **Manage webhooks (管理 Webhook)** 對話方塊中，選擇 **New (新增)**，輸入 Webhook 的名稱，然後選擇 **Create (建立)**。

1. 確認 Webhook 出現，然後選擇 **Copy webhook URL (複製 Webhook URL)**。

1. 在 https：//[https://console.aws.amazon.com/chatbot/](https://console.aws.amazon.com/chatbot/) 開啟 AWS Chatbot 主控台。

1. 選擇 **Configure new client (設定新用戶端)**，然後選擇 **Amazon Chime**。

1. 在 **Configuration details (組態詳細資訊)** 中的 **Configuration name (組態名稱)** 中，輸入您的用戶端名稱。

1. 在 **Webhook URL** 中，貼上 URL。在 **Webhook description (Webhook 描述)** 中，提供選用描述。

1. 在 **IAM permissions (IAM 許可)** 中的 **Role (角色)** 裡，選擇 **Create an IAM role using a (使用範本建立 IAM 角色)**。在 **Policy templates (政策範本)** 中，選擇 **Notification permissions (通知許可)**。在 **Role name (角色名稱)** 中，輸入此角色的名稱 (例如 **AWSCodeStarNotifications-Chatbot-Chime-Role**)。

1. 在 **SNS 主題**的 **SNS 區域中**，選擇您建立通知規則目標 AWS 區域 的 。在 **SNS topics (SNS 主題)** 中，選擇您設定為通知規則目標的 Amazon SNS 主題名稱。

1. 選擇**設定**。

1. (選用) 若要測試整合，請在資源中進行變更，以符合設定為使用 Amazon SNS 主題做為其目標之通知規則的事件類型。例如，如果您有一個通知規則設定為在對提取請求進行註解時傳送通知，請對提取請求加上註解，然後在瀏覽器中監看 Amazon Chime 聊天室，查看通知何時出現。