Facebook Messenger

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 die Facebook-App, die Sie für den Kanal verwenden:
   1. Gehen Sie in Ihrem Browser zu https://developers.facebook.com/apps/.
   2. Wählen Sie die Registerkarte Meine Apps aus, und klicken Sie auf App erstellen.
   3. Geben Sie auf der Seite App-Details des Assistenten "App erstellen" den Namen, den Sie für die App verwenden möchten, und die E-Mail-Adresse ein, die Sie als Kontakt für die App verwenden möchten. Klicken Sie anschließend auf Weiter.
   4. Wählen Sie auf der Seite Anwendungsfälle unter Filtern nach die Option Business Messaging aus. Wählen Sie dann Mit Kunden in Messenger über Meta interagieren aus, und klicken Sie auf Weiter.
   5. Klicken Sie durch die restlichen Seiten im Assistenten, und klicken Sie dann auf der Seite Überblick auf App erstellen.
3. Nachdem die App erstellt wurde, wählen Sie die App (links auf der Seite "Meine Apps") aus, und wählen Sie im Abschnitt App-Einstellungen die Option Einfach aus.
4. Kopieren Sie den Wert des Feldes App Secret, und fügen Sie ihn an einer geeigneten Stelle in Ihrem System ein.

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

5. Klicken Sie im Abschnitt App-Seite auf Neue Seite erstellen.
6. Füllen Sie auf der Seite Seite erstellen die erforderlichen Felder aus, und klicken Sie auf Seite erstellen.
   Hinweis
   
   Der Seitenname muss den Anwendungsnamen enthalten.
7. Generieren Sie ein Zugriffstoken:
   1. Wählen Sie Extras > Graph API Explorer aus.
   2. Wählen Sie im Abschnitt Zugriffstoken der Seite unter Meta-App den Namen Ihrer App aus.
   3. Wählen Sie im Feld Benutzer oder Seite die Option Token abrufen aus.
   4. Klicken Sie im Abschnitt Berechtigungen auf Berechtigung hinzufügen, und wählen Sie die folgenden Berechtigungen aus:
      • business_management
      • pages_manage_metadata
      • pages_messaging
      • pages_show_list
   5. Klicken Sie auf Zugriffstoken generieren.
8. 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.

Definieren Sie in Facebook Messenger die Callback-URL mit der Webhook-URL, die im vorherigen Schritt in Digital Assistant generiert wurde.

1. Gehen Sie in der Facebook Messenger-Konsole zu dem Projekt, das Sie ursprünglich für den Webhook erstellt haben.
2. Wählen Sie Messenger-API-Einstellungen aus, um die Seite "Messenger-API-Setup" zu öffnen.
3. Fügen Sie im Feld CallBack-URL die Webhook-URL ein, die Sie von der Seite "Digital Assistant-Kanäle" erhalten haben.
4. Fügen Sie in der Messenger-Konsole im Feld Token verifizieren das Token auf der Seite "Kanäle des digitalen Assistenten" ein.
5. Wählen Sie im Abschnitt Webhook-Felder die Callback-Ereignisse Nachrichten und messaging_postbacks aus.
6. Klicken Sie auf Verify and Save.
7. Abonnieren Sie die Seite:
   1. Wählen Sie auf der Seite "Messenger-API-Setup" im Abschnitt Zugriffstoken generieren die Facebook-Seite für Ihren Kanal aus.
   2. Klicken Sie auf Abonnement hinzufügen.
   3. Prüfen Sie im Dialogfeld "Seitenabonnements bearbeiten", ob Nachrichten und messaging_postbacks ausgewählt sind, und klicken Sie auf Bestätigen.

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 die Konfiguration des Facebook-Kanals und des Messaging abgeschlossen ist, können Sie Ihren Bot mit Ihrer Facebook-Seite, Facebook Messenger (https://www.messenger.com/) und der Facebook Messenger-App auf Ihrem Gerät testen.

1. Gehen Sie zu https://www.messenger.com/.
2. Geben Sie in der Messenger-Oberfläche den Namen Ihrer Seite ein, um nach der Seite zu suchen.
3. Beginnen Sie mit dem Chatten mit Ihrem digitalen Assistenten (oder Standalone-Skill).

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