Workplace by Facebook

Mit der Facebook Workplace-Integration von Dialogflow können Sie einen "Workplace from Facebook"-Bot erstellen, der mit Ihren Endnutzern interagiert.

Beschränkungen

Nur die Standard-Agent-Sprache wird von dieser Integration unterstützt.

Funktionsweise

So funktioniert die Integration:

  • Konfigurieren Sie die Dialogflow-Integration und die Workspace-Instanz so, dass sie miteinander kommunizieren.
  • Die Dialogflow-Integration sendet Nachrichten mit der Messenger API von Facebook an den Endnutzer.
  • Die Dialogflow-Integration empfängt Nachrichten vom Endnutzer, da sie als Workplace Webhook by Facebook agiert.

Start

So starten Sie die Integration:

  1. Registrieren Sie eine Workplace-Instanz, wenn Sie noch keine haben, und prüfen Sie, ob Sie der Systemadministrator der Gruppe sind.

  2. Aktivieren Sie die Integration über die Dialogflow-Konsole:

    1. Rufen Sie die Dialogflow ES-Konsole auf.
    2. Klicken Sie im linken Seitenleistenmenü auf Integrations.
    3. Klicken Sie auf Workplace from Facebook.
    4. Klicken Sie auf START. Sie werden dann zu Workspace weitergeleitet, um die Installation abzuschließen:
      • Melden Sie sich bei Ihrem Workspace-Konto an. Für das Workspace-Konto muss eine Berechtigung als Systemadministrator vorliegen, um Integrationen zu installieren.
      • Klicken Sie im Pop-up-Fenster auf Add to Workplace, in dem Sie aufgefordert werden, die Dialogflow-Integration zu installieren. Sie haben auch die Möglichkeit, den Namen des Bots anzupassen.
  3. Anwendung testen

    1. Gehen Sie zu Workspace und melden Sie sich bei Ihrem Konto an.
    2. Suchen Sie Dialogflow oder den benutzerdefinierten Namen des Bots in Bots im Bereich Home der Seitenleiste und beginnen Sie mit dem Bot zu chatten.

Abbrechen

Wenn Sie auf die Schaltfläche START geklickt haben, die Installation aber nicht abschließen möchten:

  1. Rufen Sie die Dialogflow ES-Konsole auf.

  2. Klicken Sie im linken Seitenleistenmenü auf Integrations.

  3. Klicken Sie auf Facebook Workspace:

    1. Wenn die Schaltfläche CANCEL angezeigt wird, klicken Sie auf CANCEL, um die Installation abzubrechen.
    2. Wenn die Schaltfläche STOP angezeigt wird, deinstallieren Sie die Integration wie unten beschrieben.

Beenden

So halten Sie eine erfolgreich installierte Integration an:

  1. Rufen Sie die Dialogflow ES-Konsole auf.

  2. Klicken Sie im linken Seitenleistenmenü auf Integrations.

  3. Klicken Sie auf Facebook Workplace.

  4. Klicken Sie auf STOP. Sie werden zu Workplace weitergeleitet, um die Installation abzuschließen:

    1. Melden Sie sich bei Ihrem Workspace-Konto an. Für das Workspace-Konto muss eine Berechtigung als Systemadministrator vorliegen, um Integrationen zu deinstallieren.
    2. Suchen Sie nach der Integration von Dialogflow in Workplace und wählen Sie sie aus. Klicken Sie dann auf Uninstall, um die Deinstallation abzuschließen.
  5. Die Dialogflow-Integration wird deinstalliert.

Rich-Media-Antworten

Diese Integration übersetzt einige Rich-Media-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 festgelegt. 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 Objekt message 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"
          }
        }
      }
    }
        

Beschränkungen

  1. Ein Dialogflow-Agent kann nur auf einer Workplace-Instanz installiert werden, aber Sie können mehrere Dialogflow-Agents auf einer Workplace-Instanz installieren.

  2. Um eine fehlgeschlagene Installation zu entfernen, müssen Sie sowohl die Installation in Dialogflow abbrechen als auch die Installation aus dem Workspace entfernen.

Migration

Wenn Sie die Messenger-Integration nutzen und diese zur Workplace-Integration migrieren möchten, müssen Sie Folgendes tun:

  1. Beenden Sie die Messenger-Integration.

  2. Um die callback_url aus der Facebook-App zu entfernen kehren Sie die Schritte unter Facebook-App einrichten um.

  3. Starten Sie die Workspace-Integration wie oben beschrieben.