Messenger von Meta

Mithilfe der Meta Messenger-Integration können Sie Messenger-Bot zur Interaktion mit Endnutzern

Funktionsweise

So funktioniert die Integration:

  • Sie erstellen eine Meta-App, die die Meta Messenger Platform verwendet.
  • Sie konfigurieren die Integration für Konversations-Agents (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 Integration der Conversational Agents (Dialogflow CX) empfängt Nachrichten vom Endnutzer, indem sie als die Meta-Webhooks 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-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 Conversational Agents (Dialogflow CX)-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 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. Hiermit wird der Meta Messenger konfiguriert Webhook.

      • 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.

      • 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“

Zum Einrichten Meta Messenger-Schaltfläche „Jetzt starten“:

  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 gegebenenfalls die vorherige Unterhaltung mit Ihrer Metaseite.

    • 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 anrufen Messenger Profile API 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. Weitere Informationen finden Sie unter Nachrichtenobjekt für API-Parameter senden für das Nachrichtenformat.

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.