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

このガイドのステップを完了するには、Amazon Chime システム管理者である必要があります。Amazon Chime デスクトップクライアント、ウェブアプリケーション、またはモバイルアプリに関するヘルプが必要な場合は、「Amazon Chime ユーザーガイド」の「Getting support」を参照してください。

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

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

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

注記

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

AWS CLI

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

Lambda ARN
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
HTTPS endpoint
aws chime put-events-configuration --account-id 12a3456b-7c89-012d-3456-78901e23fg45 --bot-id botId --outbound-events-https-endpoint https://example.com:8000

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 を呼び出し、提供された Lambda 関数 ARN を呼び出すことを Amazon Chime 管理者の AWS アカウントに許可するアクセス権限を追加します。これには、Amazon Chime にこの関数を呼び出すアクセス許可があることを検証するリハーサル呼び出しが続きます。アクセス許可の追加が失敗した、またはリハーサル呼び出しが失敗した場合、PutEventsConfiguration リクエストは HTTP 4xx エラーを介します。

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

    Request
    
               HTTPS POST 

               JSON Payload:
               {
                  "Challenge":"00000000000000000000",
                  "EventType" : "HTTPSEndpointVerification"
               }
    Response
    
               HTTP/1.1 200 OK
               Content-type: application/json

               {
                   "Challenge":"00000000000000000000"
               }

    チャレンジハンドシェイクが失敗すると、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):