ステップ 2: Amazon Chime チャットボットのアウトバウンドエンドポイントを設定する

フォーカスモード

ステップ 2: Amazon Chime チャットボットのアウトバウンドエンドポイントを設定する - Amazon Chime

AWS CLI Amazon Chime API AWS SDK for Java

サポート終了通知: 2026 年 2 月 20 日に、 AWS は Amazon Chime サービスのサポートを終了します。2026 年 2 月 20 日以降、Amazon Chime コンソールまたは Amazon Chime アプリケーションリソースにアクセスできなくなります。詳細については、ブログ記事を参照してください。注：これは Amazon Chime SDK サービスの可用性には影響しません。

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

Amazon Chime エンタープライズアカウントのチャットボット ID を作成したら、Amazon Chime がボットにメッセージを送信するために使用するアウトバウンドエンドポイントを設定します。アウトバウンドエンドポイントは、前提条件の一部として作成した AWS Lambda 関数 ARN または HTTPS エンドポイントにすることができます。Lambda の詳細については、AWS Lambda デベロッパーガイド https://docs.aws.amazon.com/lambda/latest/dg/ を参照してください。

注記

チャットボットのアウトバウンド HTTPS エンドポイントが設定されていない、または空の場合、チャットルーム管理者はチャットルームにチャットボットを追加できません。また、チャットルームのユーザーはこのボットとやり取りできません。

AWS CLI

チャットボットのアウトバウンドエンドポイントを設定するには、 AWS CLIで put-events-configuration コマンドを使用します。Lambda 関数 ARN またはアウトバウンド HTTPS エンドポイントを設定します。

anchor anchor


aws chime put-events-configuration --account-id 12a3456b-7c89-012d-3456-78901e23fg45 --bot-id botId --lambda-function-arn arn:aws:lambda:us-east-1:111122223333:function:function-name

Amazon Chime はボット ID と HTTPS エンドポイントで応答します。



{
    "EventsConfiguration": {
        "BotId": "BotId", 
        "OutboundEventsHTTPSEndpoint": "https://example.com:8000"
    }
}

Amazon Chime API

チャットボットのアウトバウンドエンドポイントを設定するには、「Amazon Chime API リファレンス」の Amazon Chime PutEventsConfiguration API オペレーションを使用します。Lambda 関数 ARN またはアウトバウンド HTTPS エンドポイントを設定します。

Lambda 関数 ARN を設定する場合 – Amazon Chime は Lambda を呼び出して、Amazon Chime 管理者の AWS アカウントが指定された Lambda 関数 ARN を呼び出すことを許可するアクセス許可を追加します。これには、Amazon Chime にこの関数を呼び出すアクセス許可があることを検証するリハーサル呼び出しが続きます。アクセス許可の追加が失敗した、またはリハーサル呼び出しが失敗した場合、PutEventsConfiguration リクエストは HTTP 4xx エラーを介します。

アウトバウンド HTTPS エンドポイントを設定する場合 — Amazon Chime は、Challenge JSON ペイロードを使用した HTTP ポストリクエストを前のステップで提供した発信 HTTPS エンドポイントに送信して、エンドポイントを検証します。発信 HTTPS エンドポイントは、JSON 形式の Challenge パラメータにエコーバックすることで応答します。以下の例では、リクエストと有効な応答を示しています。

anchor anchor



               HTTPS POST 

               JSON Payload:
               {
                  "Challenge":"00000000000000000000",
                  "EventType" : "HTTPSEndpointVerification"
               }

チャレンジハンドシェイクが失敗すると、PutEventsConfiguration リクエストは HTTPS 4xx エラーを返します。

AWS SDK for Java

次のサンプルコードは、 AWS SDK for Java を使用してエンドポイントを設定する方法を示しています。


PutEventsConfigurationRequest putEventsConfigurationRequest = new PutEventsConfigurationRequest()
     .withAccountId("chimeAccountId")
     .withBotId("botId")
     .withOutboundEventsHTTPSEndpoint("https://www.example.com")
     .withLambdaFunctionArn("arn:aws:lambda:region:account-id:function:function-name");

 chime.putEventsConfiguration(putEventsConfigurationRequest):