Messenger by Facebook

Mithilfe der Integration von Dialogflow mit dem Facebook Messenger können Sie einen Facebook Messenger-Bot erstellen, der mit Ihren Endnutzern interagiert.

So gehts:

So funktioniert die Integration:

  • Sie erstellen eine Facebook-App, die die Facebook Messenger Platform verwendet.
  • Sie konfigurieren die Dialogflow-Integration und die Facebook-App so, dass sie miteinander kommunizieren.
  • Die Dialogflow-Integration sendet Nachrichten mithilfe der Facebook Messenger API an den Endnutzer.
  • Die Dialogflow-Integration empfängt Nachrichten vom Endnutzer und fungiert so als Facebook Messenger-Webhook.

Einrichtung

So richten Sie die Integration ein:

  1. Führen Sie die Schritte zum Erstellen einer Facebook-App im Artikel zur Facebook-App-Entwicklung aus.

  2. Richten Sie die Facebook-App für die Verwendung der Facebook Messenger Platform ein. Führen Sie die Schritte in der Dokumentation zum Einrichten einer Facebook-App aus. Dadurch wird Folgendes möglich:

    • Hinzufügen der Messenger Platform zu Ihrer Facebook-App
    • Anmelden Ihrer App für eine Facebook-Seite. Achten Sie darauf, dass messages und messaging_postbacks im Seitenabo aktiviert sind.
    • In diesem Schritt erhalten Sie ein Zugriffstoken. Kopieren Sie diesen Wert. Dieses Token wird verwendet, um die Integration über die Dialogflow-Konsole zu konfigurieren.
    • Warten Sie aber mit dem Konfigurieren des Webhooks und dem Testen Ihrer Integration.

  3. Konfigurieren Sie die Integration über die Dialogflow-Konsole:

    1. Zur Dialogflow CX Console
    2. Klicken Sie im linken Bereich auf den Tab Verwalten.
    3. Klicken Sie im linken Seitenleistenmenü auf Integrationen.
    4. Klicken Sie auf der Kachel Facebook Messenger auf die Schaltfläche Verbinden.

    5. Ein Konfigurationsdialogfeld wird geöffnet:

      • App-Secret: Geben Sie das App-Secret aus den grundlegenden Einstellungen für das Facebook App-Dashboard ein.

      • Bestätigungstoken: Sie können jedes beliebige private Token eingeben. Kopieren Sie diesen Wert. Damit wird der Facebook Messenger-Webhook konfiguriert.

      • Page access token (Seitenzugriffstoken): Geben Sie das Zugriffstoken ein, das Sie während der obigen Einrichtung der Facebook-App kopiert haben.

      • Schaltfläche "Jetzt starten" aktivieren: Weitere Informationen finden Sie im Abschnitt Schaltfläche "Jetzt starten".

      • Webhook URL (Webhook-URL): Kopieren Sie diesen Wert. Damit wird der Facebook Messenger-Webhook konfiguriert.

      • Start: Klicken Sie auf diese Option, um den Integrationsdienst für Ihren Agent zu starten.

  4. Schließen Sie die Einrichtung der Facebook-App ab und testen Sie sie. Führen Sie die Schritte in der Dokumentation zum Einrichten einer Facebook-App aus. Dadurch wird Folgendes möglich:

    • Konfigurieren des Facebook-Webhooks für Ihre App. Verwenden Sie die Werte Callback-URL und Bestätigungstoken, die Sie oben kopiert haben. Aktivieren Sie messages und messaging_postbacks im Seitenabo.
    • Testen der Anwendung

Ereignisse

Die folgenden Ereignisse werden durch diese Integration aufgerufen: Sie können benutzerdefinierte Event-Handler erstellen, um festzulegen, was passiert, wenn die Ereignisse ausgelöst werden.

Termin Beschreibung
FACEBOOK_WELCOME Wird ausgelöst, wenn ein Endnutzer auf die Schaltfläche "Erste Schritte" mit Facebook Messenger klickt.
FACEBOOK_MEDIA Wird ausgelöst, wenn die Nachricht eines Endnutzers Anhänge enthält (z. B. Audio, Bild, Video usw.).

Schaltfläche „Jetzt starten“

So richten Sie die Facebook Messenger-Startschaltfläche ein:

  1. Aktivieren Sie die Schaltfläche Jetzt starten, wenn Sie diesen Integrationsdienst aktivieren.

    • Dieser Integrationsdienst aktiviert die Schaltfläche für Sie durch Aufrufen der Facebook Messenger Profile API.

      curl -X POST \
-H "Content-Type: application/json" \
-d '{"get_started": {"payload": "FACEBOOK_WELCOME"}}' \
"https://graph.facebook.com/v10.0/me/messenger_profile?access_token=${PAGE_ACCESS_TOKEN}"

  2. Erstellen Sie einen benutzerdefinierten Event-Handler für das FACEBOOK_WELCOME-Ereignis.

So testen Sie sie:

  1. Löschen Sie die vorherige Unterhaltung mit Ihrer Facebook-Seite (falls zutreffend).

    • Die Schaltfläche Jetzt starten wird nur für neue Unterhaltungen angezeigt.

  2. Starten Sie eine neue Unterhaltung mit Ihrer Facebook-Seite.

  3. Klicken Sie auf Jetzt starten und prüfen Sie die Antwort des benutzerdefinierten Ereignis-Handlers.

Sie können jederzeit die Facebook Messenger Profile API aufrufen, um die Schaltfläche Jetzt starten zu verwalten. Dies kann zum Testen hilfreich sein.

Die folgende Anfrage prüft beispielsweise den Status der Schaltfläche Get started (Jetzt starten):

curl -X GET \
"https://graph.facebook.com/v10.0/me/messenger_profile?fields=get_started&access_token=${PAGE_ACCESS_TOKEN}"

Die folgende Anfrage deaktiviert die Schaltfläche Jetzt starten:

curl -X DELETE \
-H "Content-Type: application/json" \
-d '{"fields": ["get_started"]}' \
"https://graph.facebook.com/v10.0/me/messenger_profile?access_token=${PAGE_ACCESS_TOKEN}"

Rich-Media-Antworten

Rich-Media-Antworten werden unterstützt überBenutzerdefinierte Nutzlast inAuftragsausführung finden Sie weitere Informationen. Das Nachrichtenformat finden Sie unter Facebook Messenger API für Nachrichtennachrichten.

Die folgende benutzerdefinierte Nutzlast stellt beispielsweise eine einfache Textnachricht bereit:

{
  "text": "Hello, world"
}

Die folgende benutzerdefinierte Nutzlast stellt eine Bildnachricht bereit:

{
  "attachment": {
    "type": "image",
    "payload": {
      "url": "https://example.com/test.jpg"
    }
  }
}