Se você estiver usando o Amazon Lex V2, consulte o Guia do Amazon Lex V2.
Se você estiver usando o Amazon Lex V1, recomendamos atualizar seus bots para o Amazon Lex V2. Não estamos mais adicionando novos atributos à V1 e recomendamos o uso da V2 para todos os novos bots.
As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
Implantação de um bot do Amazon Lex em uma plataforma de sistema de mensagens
Esta seção explica como implantar bots do Amazon Lex nas plataformas de sistema de mensagens Facebook, Slack e Twilio.
nota
Ao armazenar suas configurações do Facebook, do Slack ou do Twilio, o Amazon Lex usa CMK do AWS Key Management Service para criptografar as informações. Na primeira vez que você cria um canal para uma das seguintes plataformas de sistema de mensagens, o Amazon Lex cria uma CMK padrão (aws/lex). É possível criar sua própria chave gerenciada pelo cliente no AWS KMS. Isso lhe dá mais flexibilidade, incluindo a capacidade de criar, girar e desabilitar as chaves. Você também pode definir controles de acesso e auditar as chaves de criptografia usadas para proteger seus dados. Para obter mais informações, consulte o Guia do desenvolvedor do AWS Key Management Service.
Quando uma plataforma de sistema de mensagens envia uma solicitação ao Amazon Lex, informações específicas à plataforma são incluídas como um atributo de solicitação para a função do Lambda. Use esses atributos para personalizar a forma como o seu bot se comporta. Para obter mais informações, consulte Definição de atributos de solicitação.
Todos os atributos levam o namespace x-amz-lex: como prefixo. Por exemplo, o atributo user-id é chamado x-amz-lex:user-id. Existem atributos comuns que são enviados por todas as plataformas de mensagens, além de outros que são específicos de uma determinada plataforma. A tabela a seguir lista os atributos de solicitação que as plataformas de sistema de mensagens enviam à função do Lambda do bot.
Atributos de solicitação comuns | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Atributo | Descrição | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
channel-id |
O identificador do endpoint do canal do Amazon Lex. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
channel-name |
O nome do canal do Amazon Lex. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
channel-type |
Um dos seguintes valores:
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
webhook-endpoint-url |
O endpoint do Amazon Lex para o canal. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Atributos de solicitação do Facebook | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Atributo | Descrição | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
user-id |
O identificador do Facebook do remetente. Consulte https://developers.facebook.com/docs/messenger-platform/webhook-reference/message-received |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
facebook-page-id |
O identificador da página do Facebook do destinatário. Consulte https://developers.facebook.com/docs/messenger-platform/webhook-reference/message-received |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Atributos de solicitação do Kik | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Atributo | Descrição | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
kik-chat-id |
O identificador para a conversa no qual o bot está envolvido. Para obter mais informações, consulte https://dev.kik.com/#/docs/messaging#message-formats |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
kik-chat-type |
O tipo de conversa do qual a mensagem foi originada. Para obter mais informações, consulte https://dev.kik.com/#/docs/messaging#message-formats |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
kik-message-id |
Um UUID que identifica a mensagem. Para obter mais informações, consulte https://dev.kik.com/#/docs/messaging#message-formats |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
kik-message-type |
O tipo de mensagem. Para obter mais informações, consulte https://dev.kik.com/#/docs/messaging#message-types |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Atributos de solicitação do Twilio | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Atributo | Descrição | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
user-id |
O número de telefone do remetente ("De"). Consulte https://www.twilio.com/docs/api/rest/message |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
twilio-target-phone-number |
O número de telefone do destinatário ("Para"). Consulte https://www.twilio.com/docs/api/rest/message |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Atributos de solicitação do Slack | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Atributo | Descrição | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
user-id |
O identificador do usuário do Slack. Consulte https://api.slack.com/types/user |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
slack-team-id |
O identificador da equipe que enviou a mensagem. Consulte https://api.slack.com/methods/team.info |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
slack-bot-token |
O token de desenvolvedor que concede ao bot acesso às APIs do Slack. Consulte https://api.slack.com/docs/token-types |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
