Commencez par générer la clé secrète d'application et le jeton d'accès à la page dans Facebook Messenger.

1. Connectez-vous au compte de développeur Facebook.

2. Créez une page Facebook qui héberge votre bot. La description, les images et la page de garde que vous ajoutez à cette page permettront aux utilisateurs d'identifier votre bot.

3. Créez ensuite l'application Facebook à lier à cette page. Comme il s'agit d'une application Messenger, choisissez Applications pour Messenger, puis cliquez sur Créer un ID d'application.
   
   Description de l'illustration setup-fbapp.png
   

   Si vous n'avez pas sélectionné l'option Applications pour Messenger dans cette boîte de dialogue (par exemple, si vous créez une application de test), cliquez sur Ajouter un produit dans la barre de navigation de gauche, choisissez Messenger sur la page Configuration de produit, puis cliquez sur Mise en route.
   
   Description de l'illustration add-product.png
   

4. Sur la page Tableau de bord de l'application Facebook, copiez la clé secrète de l'application et collez-la dans un emplacement approprié de votre système.
   
   Description de l'image facebook-dashboard.png
   

   Vous aurez besoin de la clé secrète pour terminer la configuration de votre canal Facebook.

5. Dans le tableau de bord de votre 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 dans un emplacement approprié.

   Vous utiliserez ce jeton, qui autorise l'application Facebook à accéder à l'API de messagerie de Facebook, pour terminer la définition de votre canal dans Digital Assistant.

Une fois la configuration terminée, vous êtes prêt à activer le canal Facebook.

• Dans Digital Assistant, sélectionnez le canal et activez l'option Canal activé.
• Cliquez sur et sélectionnez l'assistant numérique ou la brique à associer au canal.

Vous pouvez maintenant tester le bot via le canal.

Une fois la configuration du canal Facebook et de la messagerie terminée, vous pouvez tester votre bot à 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 bot dans la recherche, vous êtes prêt à discuter. Vous pouvez voir les modifications apportées au flux de dialogue en temps réel.

Description de l'illustration test-bot.png

Facebook Messenger vous permet de créer un menu fixe à côté de son champ Message. Reportez-vous à https://developers.facebook.com/docs/messenger-platform/send-messages/persistent-menu/ pour plus d'informations sur cette fonctionnalité.

L'exemple ci-dessous illustre les éléments de menu fixe "Order Pizza" et "Order Pasta" :

Description de l'image persist-menu.jpg

Les canaux Facebook Messenger de Digital Assistant prennent en charge les fonctionnalités suivantes :

• texte (envoi et réception),
• images (envoi et réception),
• fichiers (envoi et réception),
• emojis (envoi et réception),
• localisation, mais en phase d'abandon (envoi et réception),
• liens,
• postbacks,
• demandes de localisation,
• propriétés personnalisées,
• composants de carrousel,
• composants de liste.

Si vous ciblez votre brique sur plusieurs canaux avec des fonctionnalités et une syntaxe de formatage différentes, vous pouvez utiliser le 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. Cela est particulièrement utile si vous ciblez vos compétences sur d'autres canaux en plus de Facebook Messenger. Reportez-vous à Formatage de texte enrichi dans les canaux.

Les canaux Facebook Messenger de Digital Assistant présentent les contraintes de message suivantes :

• Messages texte
  • Longueur maximale du message texte : 640 caractères. Si la longueur est supérieure à 640, le texte est divisé en plusieurs messages.
  • Longueur maximale du libellé d'action de texte : 20 caractères
  • Types d'action de texte autorisés : postback, appel, URL
  • Nombre maximal d'actions de texte : 3. S'il existe davantage d'actions de texte, le message est converti en plusieurs cartes horizontales, le même texte étant utilisé en tant que titre sur chacune d'elles. Chaque carte contient jusqu'à 3 actions.
• Cartes horizontales
  • Longueur maximale du titre : 80 caractères
  • Longueur maximale de la description : 80 caractères
  • Longueur maximale du libellé 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 de carte restantes.
  • Nombre minimal d'actions de carte : 0
  • Nombre maximal d'actions de liste de cartes : 0
  • Au moins une description, une image ou une action requise ? : oui
  • Types d'action de carte autorisés : postback, appel, URL, partage.
  • Types d'action de liste de cartes autorisés : N/A
• Cartes verticales
  • Non pris en charge
• Messages de pièce jointe
  • Pris en charge ? : oui
  • Actions de pièce jointe autorisées ? : non
• Boutons d'action
  • Longueur maximale du libellé d'action globale : 20 caractères
  • Nombre maximal d'actions globales : 11
  • Types d'action globale autorisés : postback

Pour les canaux Facebook Messenger, vous pouvez étendre les fonctionnalités des composants de réponse commune avec des fonctions propres à Facebook.

Pour accéder aux extensions, utilisez l'élément channelCustomProperties des métadonnées du composant Common Response et définissez les propriétés appropriées. Le format du code est le suivant :

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

Les propriétés personnalisées disponibles pour les canaux Facebook Messenger sont les suivantes :

Voici un exemple des propriétés personnalisées définies au niveau de l'élément de réponse (top_element_style) et au niveau 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 des informations plus générales sur channelCustomProperties, reportez-vous à Extensions propres à un canal.