Messenger by Facebook

Mit der Dialogflow-Integration für Facebook Messenger können Sie einen Facebook Messenger-Bot erstellen, der mit Ihren Endnutzern interagiert.

Beschränkungen

Diese Integration unterstützt nur die Standardsprache des Agents.

Funktionsweise

Die Integration funktioniert so:

  1. Erstellen Sie eine Facebook-App, die die Facebook Messenger Platform verwendet.
  2. Konfigurieren Sie die Dialogflow-Integration und die Facebook-App so, dass sie miteinander kommunizieren.
  3. Die Dialogflow-Integration sendet Nachrichten mithilfe der Facebook Messenger API an den Endnutzer.
  4. Die Dialogflow-Integration empfängt Nachrichten vom Endnutzer und fungiert so als Facebook Messenger-Webhook.

Einrichtung

So richten Sie die Integration ein:

  1. Führen Sie die Schritte zum Erstellen einer Facebook-App im Artikel zur Facebook-App-Entwicklung aus: Facebook app development.

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

    • Hinzufügen der Messenger Platform zu Ihrer Facebook-App
    • Anmelden Ihrer App für eine Facebook-Seite. 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. Rufen Sie die Dialogflow ES-Konsole auf.
    2. Klicken Sie im Seitenleistenmenü auf Integrations.
    3. Klicken Sie auf Facebook Messenger.
    4. Ein Konfigurationsdialogfeld wird geöffnet:
      • Show old callback URL (Alte Callback-URL anzeigen): Dieser Umschalter ist standardmäßig deaktiviert. Er wird vorübergehend aktiviert, um eine kürzlich erfolgte Änderung der Facebook Messenger API zu ermöglichen. Ändern Sie diesen Umschalter nur, wenn Sie vom Dialogflow-Support dazu aufgefordert werden. Nachdem alle Agents aktualisiert wurden, wird diese Option entfernt.
      • Callback URL (Callback-URL): Kopieren Sie diesen Wert. Damit wird der Facebook Messenger-Webhook konfiguriert.
      • Verify Token (Bestätigungstoken): Sie können jedes beliebige private Token eingeben. Kopieren Sie diesen Wert. Damit wird der Facebook Messenger-Webhook konfiguriert.
      • Page Access Token (Seitenzugriffstoken): Geben Sie das Zugriffstoken ein, das Sie beim Erstellen der Facebook-Seite kopiert haben.
      • Start (Starten): Klicken Sie auf diese Option, um den Integrationsdienst für Ihren Agent zu starten.

  4. Schließen Sie die Einrichtung der Facebook-App ab und testen Sie sie. Führen Sie die Schritte in der Dokumentation zum Einrichten einer Facebook-App aus. Dadurch wird Folgendes möglich:

    • Konfigurieren Sie den Facebook-Webhook für Ihre App. Verwenden Sie die Werte für Callback URL (Callback-URL) und Verify Token (Bestätigungstoken), die Sie zuvor kopiert haben. Achten Sie darauf, die Optionen messages (Nachrichten) und messaging_postbacks (Messaging-Postbacks) zu aktivieren.
    • Testen der Anwendung

Ereignisse

Die folgenden Ereignisse werden durch diese Integration aufgerufen:

  • FACEBOOK_WELCOME: Wird ausgelöst, wenn ein Endnutzer eine Unterhaltung mit dem Bot beginnt.

Rich-Media-Antworten

Diese Integration übersetzt einige Rich-Media-Nachrichten Nachrichten in Nachrichtentypen für die Facebook Messenger Platform.

Bildantworten

Bildantworten werden als Facebook Messenger-Dateianhänge an Facebook Messenger gesendet. Der Wert message.attachment.type wird auf image gesetzt.

Die folgenden Formate werden unterstützt:

  • JPG
  • PNG
  • Statisches GIF
  • Animiertes GIF

Kartenantworten

Kartenantworten werden als allgemeine Facebook Messenger-Vorlagen an Facebook Messenger gesendet.

Kurzantwort-Antworten

Kurzantworten werden als Facebook Messenger-Kurzantworten an Facebook Messenger gesendet.

Benutzerdefinierte Nutzlastantworten

Wenn Sie andere Arten von Facebook Messenger-Nachrichten senden möchten, können Sie eine benutzerdefinierte Nutzlast verwenden.

Das allgemeine Format der benutzerdefinierten Nutzlast sieht so aus:

{
  "facebook": {
    message
  }
}

Geben Sie anstelle von message das Facebook Messenger-Objekt message an. Weitere Informationen zum message Objekt finden Sie in der Referenz zur Facebook Messenger API.

Beispiel:

  • So senden Sie einen Link zu einer Audiodatei: 
    {
  "facebook": {
    "attachment": {
      "type": "audio",
      "payload": {
        "url": "https://example.com/audio/test.mp3"
      }
    }
  }
}
  • So senden Sie ein abspielbares Video: 
    {
  "facebook": {
    "attachment": {
      "type": "video",
      "payload": {
        "url": "https://example.com/video.mp4"
      }
    }
  }
}
  • So senden Sie eine Datei: 
    {
  "facebook": {
    "attachment": {
      "type": "file",
      "payload": {
        "url": "https://example.com/file.pdf"
      }
    }
  }
}