サポート終了通知: 2025 年 9 月 15 日、 AWS は Amazon Lex V1 のサポートを終了します。 V1 2025 年 9 月 15 日を過ぎると、Amazon Lex V1 コンソールまたは Amazon Lex V1 リソースにはアクセスできなくなります。Amazon Lex V2 を使用している場合は、代わりに [Amazon Lex V2 ガイド](https://docs.aws.amazon.com/lexv2/latest/dg/what-is.html)を参照してください。
翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# Amazon Lex ボットと Slack との統合
この演習では、Amazon Lex ボットと Slack メッセージングアプリケーションを統合する手順を示します。以下のステップを実行します。
1. Amazon Lex ボットを作成します。
1. Slack メッセージングアプリケーションを作成します。
1. Slack アプリケーションとボット Amazon Lex を統合します。
1. Amazon Lex ボットと会話して、統合をテストします。Slack アプリケーションを使用してメッセージを送信し、ブラウザウィンドウでテストします。
**Topics**
+ [ステップ 1: Amazon Lex ボットを作成する](slack-bot-assoc-create-bot.md)
+ [ステップ 2: Slack にサインアップして Slack チームを作成する](slack-bot-assoc-create-team.md)
+ [ステップ 3: Slack アプリケーションを作成する](slack-bot-assoc-create-app.md)
+ [ステップ 4: Slack アプリケーションと Amazon Lex ボットを統合する](slack-bot-assoc-create-assoc.md)
+ [ステップ 5: Slack 統合を完了する](slack-bot-back-in-slack-console.md)
+ [ステップ 6: 統合をテストする](slack-bot-test.md)
# ステップ 1: Amazon Lex ボットを作成する
Amazon Lex ボットをまだ持っていない場合には、作成してデプロイします。このトピックでは、「開始方法」の演習 1 で作成したボットを使用することを想定しています。ただし、このガイドで提供されている他のボット例を使用してもかまいません。「ご利用開始にあたって」の演習 1 については、「[演習 1: 設計図を使用して Amazon Lex ボットを作成する (コンソール)](gs-bp.md)」を参照してください。
1. Amazon Lex ボットを作成します。手順については、「[演習 1: 設計図を使用して Amazon Lex ボットを作成する (コンソール)](gs-bp.md)」を参照してください。
1. ボットをデプロイしてエイリアスを作成します。手順については、「[演習 3: バージョンを発行してエイリアスを作成する](gettingstarted-ex3.md)」を参照してください。
**次のステップ**
[ステップ 2: Slack にサインアップして Slack チームを作成する](slack-bot-assoc-create-team.md)
# ステップ 2: Slack にサインアップして Slack チームを作成する
Slack アカウントにサインアップして Slack チームを作成します。手順については、「[Slack の使用](https://get.slack.help/hc/en-us/articles/212675257-Creating-a-Slack-account)」を参照してください。次のセクションでは、Slack アプリケーションを作成します。このアプリケーションには、すべての Slack チームがインストールできます。
**次のステップ**
[ステップ 3: Slack アプリケーションを作成する](slack-bot-assoc-create-app.md)
# ステップ 3: Slack アプリケーションを作成する
このセクションでは、以下の作業を行います。
1. Slack API コンソールで Slack アプリケーションを作成します。
1. ボットにインタラクティブメッセージングを追加するようアプリケーションを設定します。
このセクションの最後で、アプリケーションの認証情報 (クライアント ID、クライアントシークレット、および検証トークン) が提供されます。次のセクションでは、この情報を使用して Amazon Lex コンソールでボットチャンネル関連付けを設定します。
1. Slack API コンソール ([http://api.slack.com](http://api.slack.com)) にサインインします。
1. アプリケーションを作成します。
アプリケーションの作成が正常に完了すると、Slack にアプリケーションの [**Basic Information**] ページが表示されます。
1. アプリケーションの機能を次のように設定します。
1. 左のメニューで、**[Interactivity & Shortcuts]** (インタラクティブ性とショートカット) を選択します。
+ トグルを選択して、インタラクティブなコンポーネントをオンにします。
+ [**Request URL**] ボックスで、任意の有効な URL を指定します。たとえば、**https://slack.com** を使用できます。
**注記**
ここでは、任意の有効な URL を入力し、次のステップで必要な検証トークンを取得します。この URL は、Amazon Lex コンソールでボットチャンネル関連付けを追加した後に更新します。
+ **[Save changes]** (変更の保存) をクリックします。
1. 左のメニューで、[**Settings**] の [**Basic Information**] を選択します。次のアプリケーション認証情報を記録します。
+ クライアント ID
+ クライアントシークレット
+ 検証トークン
**次のステップ**
[ステップ 4: Slack アプリケーションと Amazon Lex ボットを統合する](slack-bot-assoc-create-assoc.md)
# ステップ 4: Slack アプリケーションと Amazon Lex ボットを統合する
Slack アプリケーションの認証情報を取得したので、アプリケーションと Amazon Lex ボットを統合できます。Slack アプリケーションとボットを関連付けるには、Amazon Lex にボットチャンネル関連付けを追加します。
Amazon Lex コンソールで、ボットチャンネル関連付けを有効化し、ボットと Slack アプリケーションを関連付けます。ボットチャンネル関連付けが有効化されると、Amazon Lex は 2 つの URL (**Postback URL** と **OAuth URL**) を返します。後で必要になるため、これらの URL を記録します。
**Slack アプリケーションと Amazon Lex ボットを統合するには**
1. AWS マネジメントコンソールにサインインし、Amazon Lex コンソール ([https://console.aws.amazon.com/lex/](https://console.aws.amazon.com/lex/)) を開きます。
1. ステップ 1 で作成した Amazon Lex ボットを選択します。
1. [**Channels**] タブを選択します。
1. 左側のメニューで、[**Slack**] を選択します。
1. [**Slack**] ページで、以下を指定します。
+ 名前を入力します。例えば、`BotSlackIntegration`。
+ [**KMS Key**] ドロップダウンから [aws/lex] を選択します。
+ [**Alias**] で、ボットのエイリアスを選択します。
+ 前のステップで記録した [**Client Id**]、[**Client secret**]、[**Verification Token**] を入力します。これらは Slack アプリケーションの認証情報です。
![\[Slack 設定画面。\]](http://docs.aws.amazon.com/ja_jp/lex/latest/dg/images/slack-10a.png)
1. [**アクティブ化**] を選択します。
コンソールでは、ボットチャンネルの関連付けを行い、2 つの URL を返します (Postback URL と OAuth URL)。それを記録します。次のセクションでは、Slack アプリケーションの設定を次のように更新して、これらのエンドポイントを使用します。
+ Postback URL は、Slack イベントを待機する Amazon Lex ボットのエンドポイントです。この URL は以下の目的に使用します。
+ Slack アプリケーションの [**Event Subscriptions**] 機能でリクエスト URL として使用します。
+ Slack アプリケーションの [**Interactive Messages**] 機能で、リクエスト URL のプレースホルダ値を置き換えます。
+ OAuth URL は、Slack との OAuth ハンドシェイクにおいて Amazon Lex ボット側のエンドポイントです。
**次のステップ**
[ステップ 5: Slack 統合を完了する](slack-bot-back-in-slack-console.md)
# ステップ 5: Slack 統合を完了する
このセクションでは、Slack API コンソールを使用して Slack アプリケーションの統合を完了します。
1. Slack API コンソール ([http://api.slack.com](http://api.slack.com)) にサインインします。「[ステップ 3: Slack アプリケーションを作成する](slack-bot-assoc-create-app.md)」で作成したアプリを選択します。
1. [**OAuth & Permissions**] 機能を次のように更新します。
1. 左のメニューで、[**OAuth & Permissions**] を選択します。
1. **[Redirect URLs] (URL のリダイレクト)** セクションで、前のステップで Amazon Lex から提供された OAuth URL を追加します。[**Add a new Redirect URL**]、[**Save URLs**] の順に選択します。
1. **Bot Token Scopes** (ボットトークンスコープ) セクションでは、**Add an OAuth Scope** (OAuth スコープを追加する) ボタンで 2 つのパーミッションを追加します。次のテキストを使用してリストをフィルタリングします。
+ **chat:write**
+ **team:read**
1. **[Request URL]** (リクエスト URL) の値を、前のステップで Amazon Lex から返された Postback URL に更新して、**[Interactive Components]** (インタラクティブコンポーネント) 機能を更新します。ステップ 4 で保存した postback URL を参照し、[**Save Changes**] を選択します。
1. 次のように [**Event Subscriptions**] 機能にサブスクライブします。
+ [**On**] オプションを選択してイベントを有効化します。
+ **[Request URL]** (リクエスト URL) の値として、前のステップで Amazon Lex から返された Postback URL を設定します。
+ [**Subscribe to Bot Events**] セクションで、`message.im` ボットイベントにサブスクライブして、エンドユーザーと Slack ボット間の直接メッセージングを有効にします。
+ 変更を保存します。
1. [メッセージ] タブからのメッセージの送信を次のように有効にします。
+ 左のメニューで、**[App Home]** (アプリケーションホーム) をクリックします。
+ **タブの表示** セクションで、**[メッセージ] タブからユーザーが Slash コマンドとメッセージを送信することを許可する** を選択します。
**次のステップ**
[ステップ 6: 統合をテストする](slack-bot-test.md)
# ステップ 6: 統合をテストする
ここでは、ブラウザウィンドウを使用して、Slack と Amazon Lex ボットとの統合をテストします。
1. [**Settings**] の [**Manage Distribution**] を選択します。[**Add to Slack**] を選択してアプリケーションをインストールします。ボットがメッセージに応答することを承認します。
1. Slack チームにリダイレクトされます。左のメニューの [**Direct Messages**] セクションで、ボットを選択します。ボットが表示されていない場合は、[**Direct Messages**] の横にあるプラスアイコン (\$1) を選択してボットを探します。
1. Amazon Lex ボットにリンクされている Slack アプリケーションとチャットを開始します。ボットがメッセージに応答するようになりました。
「ご利用開始にあたって」の演習 1 でボットを作成した場合は、その演習で提供されている会話例が使用できます。詳細については、「[ステップ 4: Lambda 関数をコードフックとして追加する (コンソール)](gs-bp-create-integrate.md)」を参照してください。