Intégration d'un robot Amazon Lex à Facebook Messenger - 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.

Intégration d'un robot Amazon Lex à Facebook Messenger

Cet exercice montre comment intégrer Facebook Messenger à votre robot Amazon Lex. Procédez comme suit :

  1. Créer un bot Amazon Lex

  2. Créez une application Facebook.

  3. Intégrez Facebook Messenger à votre robot Amazon Lex

  4. Validez l'intégration.

Étape 1 : créer un robot Amazon Lex

Si vous ne possédez pas encore de bot Amazon Lex, créez-en un et déployez-le. Dans cette rubrique, nous supposons que vous utilisez le bot que vous avez créé dans l'exercice 1 de mise en route. Cependant, vous pouvez utiliser l'un des exemples de bots fournis dans ce guide. Pour accéder à l'exercice 1 de mise en route, consultez Exercice 1 : créer un robot Amazon Lex à l'aide d'un plan (console).

  1. Créez un robot Amazon Lex. Pour obtenir des instructions, veuillez consulter Exercice 1 : créer un robot Amazon Lex à l'aide d'un plan (console).

  2. Déployez le bot et créez un alias. Pour obtenir des instructions, veuillez consulter Exercice 3 : Publication d'une version et création d'un alias.

Etape 2 : Création d'une application Facebook

Sur le portail des développeurs Facebook, créez une application et une page Facebook. Pour plus d'informations, consultez Quick Start dans la documentation de la plateforme Facebook Messenger. Prenez note des éléments suivants :

  • App Secret (clé secrète de l'application Facebook)

  • Page Access Token (jeton d'accès à la page Facebook)

Étape 3 : intégrer Facebook Messenger au bot Amazon Lex

Dans cette section, vous allez intégrer Facebook Messenger à votre robot Amazon Lex.

Une fois que vous avez terminé cette étape, la console fournit une URL de rappel. Notez cette URL.

Pour intégrer Facebook Messenger au bot

    1. Connectez-vous à la console Amazon Lex AWS Management Console et ouvrez-la à l'adresse https://console.aws.amazon.com/lex/.

    2. Choisissez votre robot Amazon Lex.

    3. Choisissez Channels.

    4. Choisissez Facebook sous Chatbots. La console affiche la page d'intégration Facebook.

    5. Sur la page d'intégration Facebook, procédez comme suit :

      • Saisissez le nom suivant : BotFacebookAssociation.

      • Pour Clé KMS, choisissez aws/lex.

      • Pour Alias, choisissez l'alias du bot.

      • Pour Verify token, entrez un jeton. Il peut s'agir d'une chaîne que vous choisissez (par exemple, ExampleToken). Vous utiliserez ce jeton ultérieurement dans le portail des développeurs Facebook dans l'étape de configuration du webhook.

      • Pour Page access token, saisissez le jeton que vous avez obtenu à partir de Facebook à l'étape 2.

      • Pour App secret key, saisissez la clé que vous avez obtenue à partir de Facebook à l'étape 2.

      Formulaire pour intégrer votre bot à Facebook.
    6. Choisissez Activer.

      La console crée l'association de canaux de bot et renvoie une URL de rappel. Notez cette URL.

  1. Sur le portail des développeurs Facebook, choisissez votre application.

  2. Choisissez le produit Messenger, puis Setup webhooks dans la section Webhooks de la page.

    Pour plus d'informations, consultez Quick Start dans la documentation de la plateforme Facebook Messenger.

  3. Dans l'assistant d'abonnement à la page webhook, procédez comme suit :

    • Pour l'URL de rappel, saisissez l'URL de rappel fournie dans la console Amazon Lex plus tôt dans la procédure.

    • Pour Verify Token, saisissez le même jeton que celui que vous avez utilisé dans Amazon Lex.

    • Choisissez Subscription Fields (messages, messaging_postbacks et messaging_optins).

    • Choisissez Verify and Save. Cela déclenche une poignée de main entre Facebook et Amazon Lex.

  4. Activer l'intégration des Webhooks. Choisissez la page que vous venez de créer, puis sélectionnez subscribe.

    Note

    Si vous mettez à jour ou recréez un webhook, vous devez vous désabonner, puis vous réabonner à la page.

Etape 4 : Test de l'intégration

Vous pouvez désormais démarrer une conversation depuis Facebook Messenger avec votre robot Amazon Lex.

  1. Ouvrez votre page Facebook et choisissez Message.

  2. Dans la fenêtre Messenger, utilisez les énoncés de test fournis dans Étape 1 : créer un robot Amazon Lex (console).