Amazon Lex V2 を使用している場合は、代わりに Amazon Lex V2 ガイドを参照してください。
Amazon Lex V1 を使用している場合は、ボットを Amazon Lex V2 にアップグレードすることをお勧めします。V1 には新機能を追加されませんので、すべての新しいボットには V2 を使用することを強くお勧めします。
翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
メッセージングプラットフォームで Amazon Lex ボットをデプロイする
このセクションでは、Facebook、Slack、および Twilio の各メッセージングプラットフォームで Amazon Lex ボットをデプロイする方法について説明します。
注記
Facebook、Slack、Twilio の各設定を保存する際に、Amazon Lex は AWS Key Management Service カスタマーマスターキー (CMK) を使用して情報を暗号化します。これらのメッセージングプラットフォームのいずれかに対するチャンネルを初めて作成するときに、Amazon Lex はデフォルトの CMK (aws/lex) を作成します。独自のカスタマー管理キー (CMK) を AWS KMS で作成できます。これにより、キーの作成、更新、無効化ができるなど、より高い柔軟性が得られます。アクセスコントロールを定義し、データの保護に使用される暗号化キーを監査することもできます。詳細については、AWS Key Management Service デベロッパーガイドを参照してください。
メッセージングプラットフォームから Amazon Lex に送信されるリクエストには、プラットフォーム固有の情報が Lambda 関数へのリクエスト属性として含まれています。これらの属性を使用してボットの動作をカスタマイズします。詳細については、「リクエスト属性の設定」を参照してください。
すべての属性は、名前空間 x-amz-lex: をプレフィックスとして使用します。例えば、user-id 属性は x-amz-lex:user-id と呼ばれます。プラットフォーム別の固有の属性に加えて、すべてのメッセージングプラットフォームから送信される一般的な属性があります。以下の表は、メッセージングプラットフォームからボットの Lambda 関数に送信されるリクエスト属性の一覧です。
| 属性 | 説明 |
|---|---|
channel-id |
Amazon Lex のチャンネルエンドポイント識別子。 |
channel-name |
Amazon Lex のチャンネル名。 |
channel-type |
次のいずれかの値になります。
|
webhook-endpoint-url |
チャンネルの Amazon Lex エンドポイント。 |
| 属性 | 説明 |
|---|---|
user-id |
送信者の Facebook 識別子。参照: https://developers.facebook.com/docs/messenger-platform/webhook-reference/message-received |
facebook-page-id |
受信者の Facebook ページ識別子。参照: https://developers.facebook.com/docs/messenger-platform/webhook-reference/message-received |
| 属性 | 説明 |
|---|---|
kik-chat-id |
ボットが関与する会話の識別子。詳細については、https://dev.kik.com/#/docs/messaging#message-formats |
kik-chat-type |
メッセージが発信された会話のタイプ。詳細については、https://dev.kik.com/#/docs/messaging#message-formats |
kik-message-id |
メッセージを識別する UUID。詳細については、https://dev.kik.com/#/docs/messaging#message-formats |
kik-message-type |
メッセージのタイプ。詳細については、https://dev.kik.com/#/docs/messaging#message-types |
| 属性 | 説明 |
|---|---|
user-id |
送信者の電話番号 ("From")。参照: https://www.twilio.com/docs/api/rest/message |
twilio-target-phone-number |
受信者の電話番号 (「To」)。参照: https://www.twilio.com/docs/api/rest/message |
| 属性 | 説明 |
|---|---|
user-id |
Slack ユーザー識別子。参照: https://api.slack.com/types/user |
slack-team-id |
メッセージを送信したチームの識別子。参照: https://api.slack.com/methods/team.info |
slack-bot-token |
Slack API へのアクセス権限をボットに付与する開発者トークン。参照: https://api.slack.com/docs/token-types |
