Messenger von Meta

Mithilfe der Einbindung von Dialogflow Meta Messenger können Sie einen Meta Messenger-Bot zur Interaktion mit Ihren Endnutzern erstellen.

Funktionsweise

So funktioniert die Integration:

Einrichtung

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 Meta Messenger-Plattform ein. Führen Sie die Schritte in der Dokumentation zu Meta-Webhooks für Messenger-Plattform aus, um Folgendes zu erreichen:

    • Fügen Sie der Meta-App die Messenger-Plattform hinzu.
    • Abonnieren Sie Ihre App bei einer Metaseite. 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 Integrations.
    4. Klicken Sie auf der Kachel Meta Messenger auf die Schaltfläche Verbinden.

    5. Ein Konfigurationsdialogfeld wird geöffnet:

      • App-Secret: Geben Sie das App-Secret aus den grundlegenden Einstellungen des App-Dashboards ein.

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

      • Page access token (Seitenzugriffstoken): Geben Sie das Zugriffstoken ein, das Sie oben bei der Einrichtung der Meta-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 Meta-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 Meta-App ab und testen Sie sie. Führen Sie die Schritte in der Dokumentation zu Meta-Webhooks für Messenger Platform aus, um Folgendes zu erreichen:

    • Konfigurieren Sie den Meta-Webhook für Ihre App. Verwenden Sie dazu die oben kopierten Werte für Webhook-URL und Token überprüfen. 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 Meta Messenger-Schaltfläche „Jetzt starten“ 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 Meta Messenger-Schaltfläche „Jetzt starten“ ein:

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

    • Dieser Integrationsdienst aktiviert die Schaltfläche durch Aufrufen der 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 gegebenenfalls die vorherige Konversation mit Ihrer Metaseite.

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

  2. Beginnen Sie eine neue Unterhaltung über Ihre Metaseite.

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

Sie können jederzeit die 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 Nachrichtenobjekt für API-Parameter senden.

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

Kanalspezifische Antworten

Nach der Konfiguration werden kanalspezifische Antworten mit dem Kanal DF_CX_FB_MESSENGER automatisch verwendet, wenn der Agent auf Meta Messenger-Nachrichten antwortet.