Generieren Sie zunächst das App Secret und das Seitenzugriffstoken in Facebook Messenger.

1. Melden Sie sich beim Facebook-Account für Entwickler an.

2. Erstellen Sie eine Facebook-Seite, auf der Ihr Bot gehostet wird. Die Beschreibung, Bilder und die Startseite, die Sie zu der Seite hinzufügen, identifiziert den Bot für die Benutzer.

3. Erstellen Sie als Nächstes die Facebook-App, die Sie mit dieser Seite verknüpfen möchten. Da es sich um eine Messenger-App handelt, wählen Sie Apps für Messenger aus, und klicken Sie dann auf App-ID erstellen.
   
   Beschreibung des Illustrationssetups: fbapp.png
   

   Wenn Sie in diesem Dialogfeld die Option Apps for Messenger nicht ausgewählt haben (z.B. wenn Sie eine Test-App erstellen), klicken Sie in der linken Navigationsleiste auf Add Product, wählen Sie auf der Seite "Produktsetup" die Option Messenger aus, und klicken Sie dann auf Get Started.
   
   Beschreibung der Abbildung add-product.png
   

4. Kopieren Sie auf der Dashboard-Seite der Facebook-App das App Secret, und fügen Sie es an einer beliebigen Stelle in Ihrem System ein.
   
   Beschreibung der Abbildung facebook-dashboard.png
   

   Sie benötigen das App Secret, um die Facebook-Kanalkonfiguration abzuschließen.

5. Generieren Sie im Dashboard für Ihre App das Page Access Token, indem Sie Ihre Facebook-Seite auswählen.
   
   Beschreibung der Abbildung page-access-token.png
   

6. Kopieren Sie das Zugriffstoken, und fügen Sie es an einer beliebigen Stelle ein.

   Mit diesem Token erhält Ihre Facebook-App Zugriff auf die Messaging-API von Facebook, mit der Sie Ihre Kanaldefinition in Digital Assistant abschließen können.

Wenn die Konfiguration abgeschlossen ist, können Sie den Facebook-Kanal aktivieren.

• Wählen Sie in Digital Assistant den Kanal aus, und aktivieren Sie die Option Kanal aktiviert.
• Klicken Sie auf , und wählen Sie den digitalen Assistenten oder Skill aus, den Sie mit dem Kanal verknüpfen möchten.

Sie können den Bot nun über den Kanal testen.

Wenn Sie die den Facebook-Kanal und das Messaging konfiguriert haben, können Sie Ihren Bot mit Ihrer Facebook-Seite, mit Facebook Messenger (https://www.messenger.com/) und mit der Facebook Messenger-App auf Ihrem Mobiltelefon testen (). Sobald Sie Ihren Bot in der Suche gefunden haben, können Sie mit dem Chat beginnen. Die Änderungen, die Sie am Dialogfeld vornehmen, werden in Echtzeit angezeigt.

Beschreibung der Abbildung test-bot.png

In Facebook Messenger können Sie neben dem Nachrichtenfeld ein persistentes Menü erstellen. Weitere Informationen zu diesem Feature finden Sie unter https://developers.facebook.com/docs/messenger-platform/send-messages/persistent-menu/.

Im Folgenden finden Sie ein Beispiel mit den persistenten Menüoptionen "Pizza bestellen" und "Pasta bestellen":

Beschreibung der Abbildung persistent-menu.jpg

Die Facebook Messenger-Kanäle in Digital Assistant unterstützen die folgenden Funktionen:

• Text (Senden und Empfangen)
• Bilder (Senden und Empfangen)
• Dateien (Senden und Empfangen)
• Emojis (Senden und Empfangen)
• Standort, aber veraltet (Senden und Empfang)
• Links
• Postbacks
• Standortanforderungen
• Benutzerdefinierte Eigenschaften
• Karussellkomponenten
• Listenkomponenten

Wenn Sie Ihren Skill auf mehrere Kanäle mit unterschiedlichen Formatierungsfunktionen und Syntax ausrichten, können Sie grundlegende HTML-Markups in Ihren Nachrichten verwenden. Wenn Sie dies tun, wird dieses Markup automatisch in das Preisabschriftformat von Facebook Messenger konvertiert, wenn die Nachricht an den Kanal übertragen wird. Dies ist besonders nützlich, wenn Sie Ihre Fähigkeiten zusätzlich zu Facebook Messenger auf andere Kanäle ausrichten. Siehe Rich-Text-Formatierung in Kanälen.

Für Facebook Messenger-Kanäle in Digital Assistant gelten die folgenden Nachrichten-Constraints:

• Textnachrichten
  • Maximale Länge der Textnachricht: 640 Zeichen. Wenn die Länge 640 überschreitet, wird der Text auf mehrere Nachrichten aufgeteilt.
  • Maximale Länge des Textaktionslabels: 20 Zeichen
  • Zulässige Textaktionen: Postback, Aufruf, URL
  • Maximale Anzahl der Textaktionen: 3. Wenn weitere Textaktionen vorhanden sind, wird die Nachricht in mehrere horizontale Karten konvertiert. Dabei wird auf jeder Karte derselbe Text als Titel verwendet, und jede Karte enthält bis zu 3 Aktionen.
• Horizontale Karten
  • Maximale Länge des Titels: 80 Zeichen
  • Maximale Länge der Beschreibung: 80 Zeichen
  • Maximale Länge des Kartenaktionslabels: 20 Zeichen
  • Maximale Anzahl der Karten: 10
  • Maximale Anzahl der Kartenaktionen: 3. Wenn die Anzahl der Kartenaktionen 3 überschreitet, wird die Karte dupliziert, um die verbleibenden Kartenaktionen anzuzeigen.
  • Mindestanzahl der Kartenaktionen: 0
  • Maximale Anzahl der Kartenlistenaktionen: 0
  • Ist mindestens eine Beschreibung, ein Bild oder eine Aktion erforderlich?: Ja
  • Zulässige Arten von Kartenaktionen: Postback, Aufruf, URL, Teilen
  • Zulässige Arten von Kartenlistenaktionen: Nicht zutreffend
• Vertikale Karten
  • Nicht unterstützt
• Anhangsnachrichten
  • Unterstützt? Ja
  • Anhangsaktionen zulässig?: Nein
• Aktionsschaltflächen
  • Maximale Länge des globalen Aktionslabels: 20 Zeichen
  • Maximale Anzahl globaler Aktionen: 11
  • Zulässige globale Aktionen: Postback

Für Facebook Messenger-Kanäle können Sie die Funktionalität der Common Response-Komponenten mit speziellen Facebook-Funktionen erweitern.

Sie können auf die Erweiterungen zugreifen, indem Sie das Element channelCustomProperties in den Metadaten der Common Response-Komponente und die entsprechenden Eigenschaften festlegen. Der Code hat das folgende Format:

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

Nachfolgend finden Sie die verfügbaren benutzerdefinierten Eigenschaften für Facebook Messenger-Kanäle:

Nachfolgend finden Sie ein Beispiel für benutzerdefinierte Eigenschaften, die auf Antwortelementebene (top_element_style) und auf Kartenebene (webview_height_ratio und fallback_url) definiert sind:

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

Allgemeine Informationen zu channelCustomProperties finden Sie unter Kanalspezifische Erweiterungen.