翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# 通知と AWS Chatbot の統合を設定する
<a name="notifications-chatbot"></a>

AWS Chatbot は、DevOps およびソフトウェア開発チームが Amazon Chime チャットルーム、Slack チャネル、Microsoft Team チャネルを使用して、 の運用イベントをモニタリングして対応できるようにする AWS サービスです AWS クラウド。イベントに関する通知が、選択した Amazon Chime ルーム、Slack チャネル、または Microsoft Teams チャネルに表示されるように、通知ルールターゲットと AWS Chatbot の統合を設定できます。詳細については、「[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 管理者ガイド」の「[AWS Chatbot を Slack で設定する](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)として選択すると、通知ルールの作成プロセスの一環として、必要なすべてのアクセス許可を持つ Amazon SNS トピックが AWS Chatbot クライアント用に作成および設定されます。

1. クライアントの作成プロセスを完了します。通知ルールの作成時に、このクライアントをターゲットとして選択できます。詳細については、「[通知ルールの作成](notification-rule-create.md)」を参照してください。
**注記**  
設定後に AWS Chatbot クライアントから Amazon SNS トピックを削除しないでください。削除すると、Slack に通知が送信されなくなります。

## Microsoft Teams チャネルの AWS Chatbot クライアントを設定する
<a name="notifications-chatbot-configure-client-ts"></a>

 AWS Chatbot クライアントをターゲットとして使用する通知ルールを作成できます。Microsoft Teams チャネルのクライアントを作成すると、このクライアントを通知ルールの作成ワークフローでターゲットとして直接使用できます。これは、Microsoft Teams チャネルに表示される通知を設定する最も簡単な方法です。

## ターゲットとして使用する Microsoft Teams で AWS Chatbot クライアントを作成するには


1. 「AWS Chatbot 管理者ガイド」の「[AWS Chatbot を Microsoft Teams で設定する](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)として選択すると、通知ルールの作成プロセスの一環として、必要なすべてのアクセス許可を持つ Amazon SNS トピックが AWS Chatbot クライアント用に作成および設定されます。

1. クライアントの作成プロセスを完了します。通知ルールの作成時に、このクライアントをターゲットとして選択できます。詳細については、「[通知ルールの作成](notification-rule-create.md)」を参照してください。
**注記**  
設定後に AWS Chatbot クライアントから Amazon SNS トピックを削除しないでください。削除すると、Microsoft Teams に通知が送信されなくなります。

## Slack または Amazon Chime のクライアントの手動設定
<a name="notifications-chatbot-configure-manual-client"></a>

Slack や Amazon Chime と通知との統合を直接作成することを選択できます。これは、Amazon Chime チャットルームへの通知を設定するための唯一の方法です。この統合を手動で設定する場合は、通知ルールのターゲットとして以前に設定した Amazon SNS トピックを使用する AWS Chatbot クライアントを作成します。<a name="notification-rule-chatbot-console-manual"></a>

## AWS Chatbot および slack と通知を手動で統合するには
<a name="notification-rule-chatbot-console-manual"></a>

1. [https://console.aws.amazon.com/codesuite/settings/notifications](https://console.aws.amazon.com/codesuite/settings/notifications/) で AWS デベロッパーツールコンソールを開きます。

1. [**Settings (設定)**]、[**Notification rules (通知ルール)**] の順に選択します。

1. [**通知ルールのターゲット**] で、ターゲットを検索してコピーします。
**注記**  
そのターゲットと同じ Amazon SNS トピックを使用する通知ルールを複数設定できます。これはメッセージングを統合するのに役立ちますが、サブスクリプションリストが 1 つの通知ルールまたはリソースを対象としている場合、意図しない結果が生じることがあります。

1. [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 template**] (テンプレートを使用して IAM ロールを作成する) を選択します。[**ポリシーテンプレート**] で、[**通知のアクセス許可**] を選択します。[**ロール名**] に、このロールの名前（**AWSCodeStarNotifications-Chatbot-Slack-Role** など）を入力します。[**ポリシーテンプレート**] で、[**通知のアクセス許可**] を選択します。

1. **SNS トピック**の **SNS リージョン**で、通知ルールターゲットを作成した AWS リージョン を選択します。[**SNS topics**] で、通知ルールのターゲットとして設定した 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>

## Chatbot および Amazon Chime AWS と通知を統合するには
<a name="notifications-chatbot-chime"></a>

1. [https://console.aws.amazon.com/codesuite/settings/notifications](https://console.aws.amazon.com/codesuite/settings/notifications/) で AWS デベロッパーツールコンソールを開きます。

1. [**Settings (設定)**]、[**Notification rules (通知ルール)**] の順に選択します。

1. [**通知ルールのターゲット**] で、ターゲットを検索してコピーします。
**注記**  
そのターゲットと同じ Amazon SNS トピックを使用する通知ルールを複数設定できます。これはメッセージングを統合するのに役立ちますが、サブスクリプションリストが 1 つの通知ルールまたはリソース用である場合、意図しない結果が生じることがあります。

1. Amazon Chime で、統合用に設定するチャットルームを開きます。

1. 右上の歯車アイコンを選択して、[**Manage webhooks**] を選択します。

1. [**Manage webhooks (ウェブフックの管理)**] ダイアログボックスで [**新規**] を選択し、ウェブフックの名前を入力して [**作成**] を選択します。

1. Webhook が表示されることを確認し、[**Copy webhook URL (Webhook URL のコピー)**] を選択します。

1. [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 template**] (テンプレートを使用して IAM ロールを作成する) を選択します。[**ポリシーテンプレート**] で、[**通知のアクセス許可**] を選択します。[**ロール名**] に、このロールの名前（**AWSCodeStarNotifications-Chatbot-Chime-Role** など）を入力します。

1. **SNS トピック**の **SNS リージョン**で、通知ルールターゲットを作成した AWS リージョン を選択します。[**SNS topics (SNS トピック)**] で、通知ルールのターゲットとして設定した Amazon SNS トピックの名前を選択します。

1. [**設定**] を選択します。

1. (オプション) 統合をテストするには、ターゲットとして Amazon SNS トピックを使用するように設定された通知ルールのイベントタイプに対応するリソースを変更します。例えば、プルリクエストに対してコメントが作成されたときに通知を送信するように設定された通知ルールがある場合は、プルリクエストにコメントし、Amazon Chime チャットルームを監視して通知がいつ表示されるかを確認します。