在簡訊平台上部署 Amazon Lex 機器人 - Amazon Lex V1

如果您使用的是 Amazon Lex V2,請改參閱 Amazon Lex V2 指南

 

如果您使用的是 Amazon Lex V1,我們建議您將機器人升級至 Amazon Lex V2。我們不再將新功能新增至 V1,並強烈建議對所有新機器人使用 V2。

本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。

在簡訊平台上部署 Amazon Lex 機器人

本節説明如何將 Amazon Lex 機器人部署在 Facebook、Slack 和 Twilio 簡訊平台上。

注意

當存放 Facebook、Slack 或 Twilio 組態時,Amazon Lex 會使用AWS Key Management Service客户管理的密鑰來加密信息。您第一次建立管道到其中一個簡訊平台時,Amazon Lex 會建立預設的客服管密鑰 (aws/lex。您也可以使用AWS KMS。這可給予您更多彈性,包括能夠建立、輪換和停用金鑰。您也可以定義存取控制並稽核用來保護資料的加密金鑰。如需詳細資訊,請參閱《AWS Key Management Service 開發人員指南》。

當簡訊平台傳送請求給 Amazon Lex 時,會包含平台特定的資訊,做為 Lambda 函數的請求屬性。請使用這些屬性來自訂機器人的行為。如需詳細資訊,請參閱 設定請求屬性

所有屬性都會使用 x-amz-lex: 命名空間做為字首。例如,user-id 屬性稱為 x-amz-lex:user-id。除了特定平台專用的屬性外,還有所有簡訊平台傳送的常見屬性。下表列出簡訊平台傳送到機器人 Lambda 函數的請求屬性。

常見的請求屬性
屬性 Description (描述)
channel-id 來自 Amazon Lex 的管道端點識別符。
channel-name 來自 Amazon Lex 的管道名稱。
channel-type

下列其中一值:

  • Facebook

  • Kik

  • Slack

  • Twilio-SMS

webhook-endpoint-url 管道的 Amazon Lex 端點.
Facebook 請求屬性
屬性 Description (描述)
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 請求屬性
屬性 Description (描述)
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
Twilio 請求屬性
屬性 Description (描述)
user-id 傳送者的電話號碼 (「寄件者」)。請參閱 https://www.twilio.com/docs/api/rest/message
twilio-target-phone-number 接收者的電話號碼 (「收件人」)。請參閱 https://www.twilio.com/docs/api/rest/message
Slack 請求屬性
屬性 Description (描述)
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