Pour commencer, générez la clé secrète d'application et le jeton d'accès à la page dans Facebook Messenger.

1. Connectez-vous à votre compte de développeur Facebook.

2. Créez une page Facebook pour héberger votre robot. La description, les images et la page de couverture que vous ajoutez à la page permettent aux utilisateurs d'identifier votre robot.

3. Ensuite, créez l'application Facebook que vous allez lier à cette page. Comme il s'agit d'une application Messenger, sélectionnez Apps for Messenger, puis cliquez sur Créer un ID application.
   
   Description de l'illustration setup-fbapp.png
   

   If you didn't choose the Apps for Messenger option in this dialog (for example, if you’re creating a test app), then click Add Product in the left navbar, choose Messenger from the Product Setup page, and then click Get Started.
   
   Description of the illustration add-product.png
   

4. Dans la page Tableau de bord de l'application Facebook, copiez la clé secrète de l'application et collez-la dans un endroit pratique de votre système.
   
   Description de l'illustration facebook-dashboard.png
   

   Vous avez besoin de la clé secrète d'application pour achever la configuration de votre canal Facebook.

5. Dans le tableau de bord de l'application, générez le jeton d'accès à la page en sélectionnant votre page Facebook.
   
   Description de l'illustration page-access-token.png
   

6. Copiez le jeton d'accès et collez-le à un endroit pratique.

   Vous utiliserez ce jeton, qui donne à votre application Facebook accès à l'API de messagerie de Facebook, pour compléter la définition du canal dans Digital Assistant.

Une fois la configuration terminée, vous pouvez activer le canal Facebook.

• Dans Digital Assistant, sélectionnez le canal et activez le commutateur Channel Enabled (Canal activé).
• Cliquez sur et sélectionnez l'assistant numérique ou la compétence à associer au canal.

Vous pouvez maintenant tester le robot sur le canal.

Une fois la configuration du canal Facebook et de la messagerie terminée, vous pouvez tester votre robot à l'aide de votre page Facebook, de Facebook Messenger (https://www.messenger.com/) et de l'application Facebook Messenger sur votre téléphone (). Une fois que vous avez localisé votre robot avec une recherche, vous pouvez commencer à clavarder avec lui. Vous pouvez voir les modifications que vous apportez au flux de dialogue en temps réel.

Description de l'illustration test-bot.png

Facebook Messenger vous permet de créer un menu persistant à côté de son champ Message. Voir https://developers.facebook.com/docs/messenger-platform/send-messages/persistent-menu/ pour des informations détaillées sur la fonction.

L'exemple suivant présente les éléments de menu persistant pour "Order Pizza" et "Order Pasta" :

Description de l'illustration persistent-menu.jpg

Les canaux Facebook Messenger dans Digital Assistant prennent en charge les fonctions suivantes :

• texte (envoi et réception)
• images (envoi et réception)
• fichiers (envoi et réception)
• émojis (envoi et réception)
• emplacement, mais obsolète (envoi et réception)
• liens
• republications
• demandes d'emplacement
• propriétés personnalisées
• composants de carrousel
• composants de liste

Si vous ciblez votre compétence sur plusieurs canaux avec des capacités de formatage et une syntaxe différentes, vous pouvez utiliser un balisage HTML de base dans vos messages. Si vous le faites, ce balisage sera automatiquement converti au format de balisage de Facebook Messenger lorsque le message sera transmis au canal. Ceci est particulièrement utile si vous ciblez vos compétences sur d'autres canaux en plus de Facebook Messenger. Voir Formatage de texte enrichi dans les canaux.

Dans Digital Assistant, les canaux Facebook Messenger présentent les contraintes suivantes liées aux messages :

• Messages texte
  • Longueur maximale du message texte : 640 caractères. Si la longueur dépasse 640, le texte est fractionné en plusieurs messages.
  • Longueur maximale de l'étiquette d'action de texte : 20 caractères
  • Types d'action de texte autorisés : Republication, Appel, URL
  • Nombre maximal d'actions de texte : 3. S'il y a plus d'actions de texte, le message est converti en plusieurs cartes horizontales comportant le même texte en titre et contenant jusqu'à 3 actions.
• Cartes horizontales
  • Longueur maximale du titre : 80 caractères
  • Longueur maximale de la description : 80 caractères
  • Longueur maximale de l'étiquette d'action de carte : 20 caractères
  • Nombre maximal de cartes : 10
  • Nombre maximal d'actions de carte : 3. Si le nombre d'actions de carte dépasse 3, la carte est dupliquée pour afficher les actions restantes.
  • Nombre minimal d'actions de carte : 0
  • Nombre maximal d'actions de liste de cartes : 0
  • Au moins une description, image ou action requise? : Oui
  • Types d'action de carte autorisés : Republication, Appel, URL, Partage
  • Types d'action de liste de cartes autorisés : S.O.
• Cartes verticales
  • Non pris en charge
• Messages avec fichier joint
  • Pris en charge? : Oui
  • Actions de fichier joint autorisées? : Non
• Boutons d'action
  • Longueur maximale de l'étiquette d'action globale : 20 caractères
  • Nombre maximal d'actions globales : 11
  • Types d'action globale autorisés : Republication

Pour les canaux Facebook Messenger, vous pouvez étendre la fonctionnalité des composants de réponse commune en ajoutant des capacités propres à Facebook.

Vous accédez aux extensions en utilisant l'élément channelCustomProperties des métadonnées du composant de réponse commune et en définissant les propriétés appropriées. Le code a le format suivant :

...
            channelCustomProperties:
            - channel: "facebook"
              properties:
                PROPERTY_NAME: "PROPERTY_VALUE"
...

Voici les propriétés personnalisées disponibles pour les canaux Facebook Messenger :

Voici un exemple de propriétés personnalisées définies au niveau de l'élément de réponse (top_element_style) et des cartes (webview_height_ratio et fallback_url) :

responseItems:
  - type: "cards"
    cardLayout: "vertical"
    cards:
      - title: "${pizzas.name}"
        description: "${pizzas.description}"
        imageUrl: "${pizzas.image}"
        url: "${pizzas.moreInfo}"
        iteratorVariable: "pizzas"
        channelCustomProperties:
          - channel: "facebook"
            properties:
              webview_height_ratio: "compact"
              fallback_url: "http://www.oracle.com"
    channelCustomProperties:
      - channel: "facebook"
        properties:
          top_element_style: "large"
...

Pour obtenir plus d'informations générales sur channelCustomProperties, voir Extensions propres au canal.