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

Si vous utilisez Amazon Lex V2, consultez plutôt le guide Amazon Lex V2.

 

Si vous utilisez Amazon Lex V1, nous vous recommandons de mettre à niveau vos robots vers Amazon Lex V2. Nous n'ajoutons plus de nouvelles fonctionnalités à la V1 et recommandons vivement d'utiliser la V2 pour tous les nouveaux robots.

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

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.