Si utiliza Amazon Lex V2, consulte la guía de Amazon Lex V2.
Si utiliza Amazon Lex V1, le recomendamos que actualice los bots a Amazon Lex V2. Hemos dejado de agregar nuevas características a V1, por lo que recomendamos encarecidamente utilizar V2 para todos los nuevos bots.
Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
Implementación de un bot de Amazon Lex en una plataforma de mensajería
En esta sección se explica cómo implementar bots de Amazon Lex en las plataformas de mensajería de Facebook, Slack y Twilio.
nota
Al almacenar las configuraciones de Facebook, Slack o Twilio, Amazon Lex utiliza claves administradas por el cliente de AWS Key Management Service para cifrar la información. La primera vez que crea un canal a una de estas plataformas de mensajería, Amazon Lex crea una clave administrada por el cliente predeterminada (aws/lex). También puede crear su propia clave administrada por el cliente con AWS KMS. Esto le da más flexibilidad, incluida la capacidad de crear, rotar y deshabilitar las claves. También puede definir controles de acceso y auditar las claves de cifrado que se utilizan para proteger sus datos. Para obtener más información, consulte AWS Key Management Service Developer Guide.
Cuando una plataforma de mensajería envía una solicitud a Amazon Lex, incluye información específica de la plataforma como atributo de la solicitud para la función de Lambda. Utilice estos atributos para personalizar el comportamiento del bot. Para obtener más información, consulte Definición de los atributos de solicitud.
Todos los atributos toman el espacio de nombres x-amz-lex: como prefijo. Por ejemplo, el atributo user-id se denomina x-amz-lex:user-id. Existen atributos comunes que se envían por todas las plataformas de mensajería, además de atributos específicos para cada plataforma. En las tablas siguientes se muestran los atributos de solicitud que envían las plataformas de mensajería a la función de Lambda del bot.
| Atributo | Descripción |
|---|---|
channel-id |
El identificador del punto de conexión del canal de Amazon Lex. |
channel-name |
El nombre del canal de Amazon Lex. |
channel-type |
Uno de los valores siguientes:
|
webhook-endpoint-url |
El punto de conexión de Amazon Lex para el canal. |
| Atributo | Descripción |
|---|---|
user-id |
El identificador de Facebook del remitente. Consulte https://developers.facebook.com/docs/messenger-platform/webhook-reference/message-received |
facebook-page-id |
El identificador de la página de Facebook del remitente. Consulte https://developers.facebook.com/docs/messenger-platform/webhook-reference/message-received |
| Atributo | Descripción |
|---|---|
kik-chat-id |
Identificador de la conversación en la que está involucrado su bot. Para obtener más información, consulte https://dev.kik.com/#/docs/messaging#message-formats |
kik-chat-type |
Tipo de conversación desde la que se originó el mensaje. Para obtener más información, consulte https://dev.kik.com/#/docs/messaging#message-formats |
kik-message-id |
El UUID que identifica el mensaje. Para obtener más información, consulte https://dev.kik.com/#/docs/messaging#message-formats |
kik-message-type |
Tipo de mensaje. Para obtener más información, consulte https://dev.kik.com/#/docs/messaging#message-types |
| Atributo | Descripción |
|---|---|
user-id |
El número de teléfono del remitente (propiedad "From"). Consulte https://www.twilio.com/docs/api/rest/message |
twilio-target-phone-number |
El número de teléfono del destinatario (propiedad "To"). Consulte https://www.twilio.com/docs/api/rest/message |
| Atributo | Descripción |
|---|---|
user-id |
El identificador de usuario de Slack. Consulte https://api.slack.com/types/user |
slack-team-id |
El identificador del equipo que envió el mensaje. Consulte https://api.slack.com/methods/team.info |
slack-bot-token |
El token del desarrollador que proporciona al bot acceso a las API de Slack. Consulte https://api.slack.com/docs/token-types |
