Messenger von Meta

Mit der Meta Messenger-Integration können Sie einen Meta Messenger-Bot erstellen, der mit Ihren Endnutzern interagiert.

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-App so, dass sie miteinander kommunizieren.
  • Die Dialogflow CX-Integration sendet Nachrichten mithilfe der Meta Messenger API an den Endnutzer.
  • Die Dialogflow CX-Integration empfängt Nachrichten vom Endnutzer und fungiert so als der Meta-Webhook für die Messenger Platform.

Einrichtung

So richten Sie die Integration ein:

  1. Folgen Sie der Anleitung zum Erstellen einer Meta-App: Meta App Development.

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

    • Fügen Sie Ihrer Meta-App die Messenger Platform hinzu.
    • Abonnieren Sie Ihre App auf einer Meta-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 CX-Konsole zu konfigurieren.
    • Warten Sie aber mit dem Konfigurieren des Webhooks und dem Testen Ihrer Integration.

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

    1. Rufen Sie die Dialogflow CX-Konsole auf.
    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 für das App-Dashboard ein.

      • Bestätigungstoken: Sie können jedes beliebige private Token eingeben. Kopieren Sie diesen Wert. Dieser Wert wird verwendet, um den Meta Messenger-Webhook zu konfigurieren.

      • Seitenzugriffstoken: Geben Sie das Zugriffstoken ein, das Sie während der obigen Einrichtung der Meta-App kopiert haben.

      • Button „Jetzt starten“ aktivieren: Weitere Informationen finden Sie im Abschnitt Button „Jetzt starten“.

      • Webhook URL (Webhook-URL): Kopieren Sie diesen Wert. Dieser Wert wird verwendet, um den Meta Messenger-Webhook zu konfigurieren.

      • 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 die Messenger Platform aus. Dadurch wird Folgendes möglich:

    • Konfigurieren Sie den Meta-Webhook für Ihre App. Verwenden Sie die Werte Webhook 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 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, Video usw.).

Button „Jetzt starten“

So richten Sie den Button „Jetzt starten“ für Meta Messenger ein:

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

    • Dieser Integrationsdienst aktiviert den Button für Sie durch Aufrufen von 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 Meta-Seite (falls zutreffend).

    • 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 jederzeit die Messenger Profile API aufrufen, um den Button Jetzt starten zu verwalten. Dies kann zum Testen hilfreich sein.

Die folgende Anfrage prüft beispielsweise den Status des Buttons 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 den Button 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 über Benutzerdefinierte Nutzlast in Auftragsausführung. Informationen zum Nachrichtenformat finden Sie unter Send API Parameters Message Object.

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

Nachdem Sie die kanalspezifischen Antworten konfiguriert haben, wird der Kanal DF_CX_FB_MESSENGER automatisch verwendet, wenn der Agent auf Meta Messenger-Nachrichten antwortet.