Messenger von Meta

Mit der Meta Messenger-Integration können Sie einen Meta Messenger-Bot erstellen, um mit Ihren Nutzern zu interagieren.

Funktionsweise

So funktioniert die Integration:

  • Sie erstellen eine Meta-App, die die Meta Messenger Platform verwendet.
  • Sie konfigurieren die Dialogflow CX-Integration und die Meta-Anwendung so, dass sie miteinander kommunizieren.
  • Die Dialogflow CX-Integration sendet Nachrichten über die Meta Messenger API an Ihre Nutzer.
  • Die Dialogflow CX-Integration empfängt Nachrichten von Ihren Nutzern, indem sie als Meta-Webhooks für die Messenger-Plattform fungiert.

Einrichtung

Achten Sie darauf, dass die Abrechnung für Ihr Projekt aktiviert ist, bevor Sie die Integration testen.

So richten Sie die Integration ein:

  1. Folgen Sie der Anleitung zum Erstellen einer Meta-App: Meta-App-Entwicklung.
  2. Richten Sie die Meta-App für die Verwendung der Meta Messenger-Plattform ein. Folgen Sie der Anleitung in der Dokumentation zu Meta-Webhooks für die Messenger-Plattform, um Folgendes zu tun:
    • Fügen Sie Ihrer Meta-App die Messenger-Plattform hinzu.
    • Abonnieren Sie mit Ihrer App eine Meta-Seite. Achten Sie darauf, dass messages und messaging_postbacks im Seitenabo aktiviert sind.
    • Kopieren Sie das in diesem Schritt bereitgestellte Zugriffstoken. Dieses Token wird verwendet, um die Integration über die Dialogflow CX-Konsole zu konfigurieren.
    • Konfigurieren Sie den Webhook noch nicht und testen Sie die Integration noch nicht.
  3. Konfigurieren Sie die Integration über die Dialogflow CX-Konsole:
    1. Rufen Sie die Dialogflow CX-Konsole auf.
    2. Wählen Sie im Navigationsmenü den Tab Verwalten aus.
    3. Wählen Sie Integrationen aus.
    4. Klicken Sie auf der Kachel Meta Messenger auf den Button Verbinden.
    5. Füllen Sie die Felder im Konfigurationsdialogfeld aus:
      • App-Secret: Geben Sie das App-Secret aus den Grundeinstellungen des App-Dashboards ein.
      • Bestätigungstoken: Geben Sie ein beliebiges privates Token ein. Kopieren Sie diesen Wert. Damit wird der Meta Messenger-Webhook konfiguriert.
      • Seitenzugriffstoken:Geben Sie das Zugriffstoken ein, das Sie während der Einrichtung der Meta-App kopiert haben.
      • Button „Jetzt starten“ aktivieren:Setzen Sie ein Häkchen, um den Button „Jetzt starten“ zu aktivieren.
      • Webhook-URL:Kopieren Sie diesen Wert. Diese wird zum Konfigurieren des Meta Messenger-Webhooks verwendet.
      • Starten: Klicken Sie dieses Kästchen an, um den Integrationsdienst für Ihren Agenten zu starten.
  4. Schließen Sie die Einrichtung der Meta-App ab und testen Sie sie. Folgen Sie der Anleitung in der Dokumentation zu Meta-Webhooks für die Messenger-Plattform, um Folgendes zu tun:
    • Konfigurieren Sie den Meta-Webhook für Ihre Anwendung. Verwenden Sie die Werte für Webhook-URL und Token bestätigen, die Sie zuvor 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 den Button „Erste Schritte“ mit Meta Messenger klickt.
FACEBOOK_MEDIA Wird ausgelöst, wenn die Nachricht eines Endnutzers Anhänge enthält (z. B. Audio, Bild oder Video).

Button „Los gehts“

Richten Sie die Schaltfläche „Erste Schritte“ für Meta Messenger ein:

  1. Aktivieren Sie den Button Jetzt starten, wenn Sie diesen Integrationsdienst aktivieren.

    • Mit diesem Integrationsdienst können Sie den Button aktivieren, indem Sie die Messenger Profile API aufrufen.

      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 Ereignis FACEBOOK_WELCOME.

So testen Sie sie:

  1. Löschen Sie gegebenenfalls die vorherige Unterhaltung mit Ihrer Meta-Seite.
    • Der Button Jetzt starten wird nur für neue Unterhaltungen angezeigt.
  2. Starten Sie eine neue Unterhaltung mit Ihrer Meta-Seite.
  3. Klicken Sie auf Jetzt starten und prüfen Sie die Antwort des benutzerdefinierten Ereignis-Handlers.

Sie können die Messenger Profile API aufrufen, um den Button Jetzt starten zu verwalten. Das kann beim Testen hilfreich sein.

Verwenden Sie die folgende Anfrage, um den Status des Buttons Get started (Jetzt starten) zu prüfen:

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

Mit der folgenden Anfrage können Sie den Button Jetzt starten deaktivieren:

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-Response-Nachrichten werden mit Benutzerdefinierte Nutzlast in Fulfillment unterstützt. Weitere Informationen zum Nachrichtenformat finden Sie in der Dokumentation zu Send API Parameters Message Object.

Die folgende benutzerdefinierte Nutzlast stellt beispielsweise eine Textnachricht bereit:

{
  "text": "Hello, world"
}

Die folgende benutzerdefinierte Nutzlast stellt eine Bildnachricht bereit:

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

Kanalspezifische Antworten

Nachdem Sie die kanalspezifischen Antworten konfiguriert haben, verwendet der Agent automatisch den Kanal DF_CX_FB_MESSENGER, um auf Meta Messenger-Nachrichten zu antworten.