Facebook Messenger

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 l'application Facebook que vous utiliserez pour le canal :
   1. Dans votre navigateur, allez à https://developers.facebook.com/apps/.
   2. Sélectionnez l'onglet Mes applications et cliquez sur Créer une application.
   3. Dans la page Détails de l'application de l'Assistant Créer une application, entrez le nom à utiliser pour l'application et l'adresse de courriel à utiliser comme contact pour l'application. Cliquez ensuite sur Suivant.
   4. Dans la page Cas d'utilisation, sous Filtrer par, sélectionnez Messagerie d'affaires. Sélectionnez ensuite Engager avec les clients sur Messenger à partir de Meta et cliquez sur Suivant.
   5. Cliquez sur le reste des pages de l'assistant, puis, dans la page Aperçu, cliquez sur Créer une application.
3. Une fois l'application créée, sélectionnez-la (dans la partie gauche de la page Mes applications), puis, dans la section Paramètres de l'application, sélectionnez De base.
4. Copiez la valeur du champ Clé secrète de l'application et collez-la à un endroit pratique sur votre système.

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

5. Dans la section Page d'application, cliquez sur Créer une page.
6. Dans la page Create a Page (Créer une page), remplissez les champs obligatoires, puis cliquez sur Create Page (Créer une page).
   Note
   
   Le nom de la page doit contenir le nom de l'application.
7. Générer un jeton d'accès :
   1. Sélectionnez Outils > Explorateur d'API Graph.
   2. Dans la section Jeton d'accès de la page, pour Meta App, sélectionnez le nom de votre application.
   3. Pour le champ Utilisateur ou page, sélectionnez Obtenir le jeton.
   4. Dans la section Autorisations, cliquez sur Ajouter une autorisation et sélectionnez les autorisations suivantes :
      • business_management
      • pages_manage_metadata
      • pages_messaging
      • pages_show_list
   5. Cliquez sur Generate Access Token (Créer un jeton d'accès).
8. 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.

Dans Facebook Messenger, définissez l'URL de rappel à l'aide de l'URL du webhook générée par Digital Assistant à l'étape précédente.

1. Dans la console Facebook Messenger, accédez au projet que vous avez initialement créé pour le webhook.
2. Sélectionnez Paramètres de l'API Messenger pour ouvrir la page Configuration de l'API Messenger.
3. Dans le champ URL de rappel, collez l'URL du webhook obtenue à partir de la page Canaux de Digital Assistant.
4. Dans le champ Vérifier le jeton de la console Messenger, collez le jeton de vérification dans la page Canaux de l'assistant numérique.
5. Dans la section Champs Webhook, sélectionnez les événements de rappel messages et messaging_postbacks.
6. Cliquez sur Verify and Save (Vérifier et enregistrer).
7. Abonnez-vous à la page :
   1. Dans la section Générer des jetons d'accès de la page Configuration de l'API Messenger, sélectionnez la page Facebook de votre canal.
   2. Cliquez sur Ajouter un abonnement.
   3. Dans la boîte de dialogue Modifier les abonnements à une page, vérifiez que les champs messages et messaging_postbacks sont sélectionnés, puis cliquez sur Confirmer.

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.

With the Facebook Channel and messaging configuration complete, you can test your bot using your Facebook page, Facebook Messenger (https://www.messenger.com/) and the Facebook Messenger app on your device.

1. Allez à https://www.messenger.com/.
2. Dans l'interface Messenger, entrez le nom de la page à rechercher.
3. Commencez à clavarder avec votre assistant numérique (ou compétence autonome).

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-menu1.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.