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

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-Plattform aus. Dadurch wird Folgendes möglich:

    • Fügen Sie Ihrer Meta-App die Messenger Platform hinzu.
    • Ihre App für eine Meta-Seite abonnieren. 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 Konsole für Conversational Agents (Dialogflow CX) zu konfigurieren.
    • Warten Sie aber mit dem Konfigurieren des Webhooks und dem Testen Ihrer Integration.

  3. Konfigurieren Sie die Integration über die Konsole für konversationelle Agents (Dialogflow CX):

    1. Rufen Sie die Dialogflow CX Console auf.
    2. Klicken Sie im linken Bereich auf den Tab Verwalten.
    3. Klicken Sie im linken Seitenleistenmenü auf Integrations.
    4. Klicken Sie auf die Schaltfläche Verbinden in der Kachel Meta Messenger.

    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. Damit wird der Meta Messenger-Webhook konfiguriert.

      • Page access token (Seitenzugriffstoken): Geben Sie das Zugriffstoken ein, das Sie während der obigen 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 die Messenger-Plattform aus, um Folgendes zu tun:

    • 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 die Schaltfläche 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.).

Schaltfläche „Jetzt starten“

So richten Sie die Meta 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 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).

    • Die Schaltfläche 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 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. 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 Kundenservicemitarbeiter auf Meta Messenger-Nachrichten antwortet.