Déploiement d'un robot Amazon Lex sur une plateforme de messagerie

Cette section explique comment déployer les robots Amazon Lex sur les plateformes de messagerie Facebook, Slack et Twilio.

Note

Lorsque vous stockez vos configurations Facebook, Slack ou Twilio, Amazon Lex utilise des clés gérées par AWS Key Management Service le client pour chiffrer les informations. La première fois que vous créez un canal vers l'une de ces plateformes de messagerie, Amazon Lex crée une clé gérée par le client par défaut (aws/lex). Vous pouvez également créer votre propre clé gérée par le client avecAWS KMS. Cette option vous donne plus de flexibilité dans la mesure où elle vous permet de créer des clés, de les modifier ou de les désactiver à votre convenance. Vous pouvez également définir des contrôles d'accès et auditer les clés de chiffrement utilisées pour protéger vos données. Pour plus d’informations, consultez le Guide du développeur AWS Key Management Service.

Lorsqu'une plateforme de messagerie envoie une demande à Amazon Lex, elle inclut des informations spécifiques à la plate-forme en tant qu'attribut de demande pour votre fonction Lambda. Utilisez ces attributs pour personnaliser la manière dont votre robot se comporte. Pour de plus amples informations, veuillez consulter Définition des attributs de demandes.

Tous les attributs prennent l'espace de noms, x-amz-lex:, comme préfixe. Par exemple, l'attribut user-id s'appelle x-amz-lex:user-id. Il existe des attributs communs qui sont envoyés par toutes les plateformes de messagerie en plus des attributs spécifiques à une plate-forme particulière. Les tableaux suivants répertorient les attributs de demande que les plateformes de messagerie envoient à la fonction Lambda de votre bot.

Attributs de demande communs
Attribut	Description
channel-id	L'identifiant du point de terminaison du canal fourni par Amazon Lex.
channel-name	Le nom de la chaîne indiqué par Amazon Lex.
channel-type	L'une des valeurs suivantes : Facebook Kik Slack Twilio-SMS
webhook-endpoint-url	Point de terminaison Amazon Lex pour le canal.

Attributs de demande Facebook
Attribut	Description
user-id	Identificateur Facebook de l'expéditeur. Consultez https://developers.facebook.com/docs/messenger-platform/webhook-reference/message-received.
facebook-page-id	Identificateur de page Facebook du destinataire. Consultez https://developers.facebook.com/docs/messenger-platform/webhook-reference/message-received.

Attributs de demande Kik
Attribut	Description
kik-chat-id	Identifiant de la conversation dans laquelle votre bot est impliqué. Pour plus d'informations, consultez https://dev.kik.com/#/docs/messaging#message-formats.
kik-chat-type	Type de conversation d'où provient le message. Pour plus d'informations, consultez https://dev.kik.com/#/docs/messaging#message-formats.
kik-message-id	UUID qui identifie le message. Pour plus d'informations, consultez https://dev.kik.com/#/docs/messaging#message-formats.
kik-message-type	Type du message. Pour plus d'informations, consultez https://dev.kik.com/#/docs/messaging#message-types.

Attributs de demande Twilio
Attribut	Description
user-id	Numéro de téléphone de l'expéditeur (« From »). Consultez https://www.twilio.com/docs/api/rest/message.
twilio-target-phone-number	Numéro de téléphone du destinataire (« To »). Consultez https://www.twilio.com/docs/api/rest/message.

Attributs de demande Slack
Attribut	Description
user-id	Identificateur d'utilisateur Slack. Consultez https://api.slack.com/types/user.
slack-team-id	Identificateur de l'équipe qui a envoyé le message. Consultez https://api.slack.com/methods/team.info.
slack-bot-token	Jeton de développeur qui donne au robot accès aux API Slack. Consultez https://api.slack.com/docs/token-types.