Klicken Sie im linken Seitenleistenmenü auf Integrations.
Klicken Sie auf Workplace from Facebook.
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.
Anwendung testen
Gehen Sie zu Workspace und melden Sie sich bei Ihrem Konto an.
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:
Klicken Sie im linken Seitenleistenmenü auf Integrations.
Klicken Sie auf Facebook Workplace.
Klicken Sie auf STOP. Sie werden zu Workplace 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 deinstallieren.
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.
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:
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.
Ein Dialogflow-Agent kann nur auf einer Workplace-Instanz installiert werden, aber Sie können mehrere Dialogflow-Agents auf einer Workplace-Instanz installieren.
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:
Beenden Sie die Messenger-Integration.
Um die callback_url aus der Facebook-App zu entfernen kehren Sie die Schritte unter Facebook-App einrichten um.
Starten Sie die Workspace-Integration wie oben beschrieben.
[[["Leicht verständlich","easyToUnderstand","thumb-up"],["Mein Problem wurde gelöst","solvedMyProblem","thumb-up"],["Sonstiges","otherUp","thumb-up"]],[["Schwer verständlich","hardToUnderstand","thumb-down"],["Informationen oder Beispielcode falsch","incorrectInformationOrSampleCode","thumb-down"],["Benötigte Informationen/Beispiele nicht gefunden","missingTheInformationSamplesINeed","thumb-down"],["Problem mit der Übersetzung","translationIssue","thumb-down"],["Sonstiges","otherDown","thumb-down"]],["Zuletzt aktualisiert: 2025-08-18 (UTC)."],[[["\u003cp\u003eThis integration allows you to create a Workplace from Facebook bot that interacts with end-users via the Dialogflow platform.\u003c/p\u003e\n"],["\u003cp\u003ePre-GA products and features, like this integration, are subject to the "Pre-GA Offerings Terms", are available "as is", and may have limited support.\u003c/p\u003e\n"],["\u003cp\u003eTo start this integration you must be a System Admin of a Workplace instance and use the Dialogflow ES console to begin the setup.\u003c/p\u003e\n"],["\u003cp\u003eThis integration uses Facebook's Messenger API and Workplace Webhook to send and receive messages, and all messages sent have to comply to the respective terms of service of both Google and the third-party.\u003c/p\u003e\n"],["\u003cp\u003eRich response messages such as images, cards, quick replies, and custom payloads, are supported and converted to the appropriate Facebook Messenger format.\u003c/p\u003e\n"]]],[],null,["# Workplace from Facebook\n\n| **Preview**\n|\n|\n| This product or feature is subject to the \"Pre-GA Offerings Terms\" in the General Service Terms section\n| of the [Service Specific Terms](/terms/service-terms#1).\n|\n| Pre-GA products and features are available \"as is\" and might have limited support.\n|\n| For more information, see the\n| [launch stage descriptions](/products#product-launch-stages).\n\nUsing the Dialogflow Facebook Workplace integration,\nyou can create a Workplace from Facebook bot to interact with your end-users.\n\n\n| **Note:** When using a third party integration, requests and end-user data are sent to both Google and the third party. The terms of service, SLA, pricing, and quotas [for your agent edition](/dialogflow/docs/editions) are applicable for Google's handling of these requests. The third party's terms of service, SLA, pricing, and quotas are applicable for the third party's handling of these requests.\n\n\u003cbr /\u003e\n\nLimitations\n-----------\n\nOnly the\n[default agent language](/dialogflow/es/docs/agents-settings#lang)\nis supported by this integration.\n\nHow it works\n------------\n\nThis is how the integration works:\n\n- You configure the Dialogflow integration and Workplace instance, so that they communicate with each other.\n- The Dialogflow integration sends messages to the end-user by using the [Messenger API from Facebook](https://developers.facebook.com/docs/messenger-platform/reference/send-api/).\n- The Dialogflow integration receives messages from the end-user by acting as the [Workplace Webhook from Facebook](https://developers.facebook.com/docs/workplace/reference/webhooks).\n\nStart\n-----\n\nTo start the integration:\n\n1. Register a [Workplace](https://www.workplace.com/) instance if you don't have one, and make sure you are the **System Admin** of the group.\n\n2. Enable the integration from the Dialogflow Console:\n\n 1. Go to the [Dialogflow ES console](https://dialogflow.cloud.google.com).\n 2. Click **Integrations** in the left sidebar menu.\n 3. Click **Workplace from Facebook**.\n 4. Click **START** and you will be redirected to Workplace to finish the installation:\n - Log into your Workplace account. The account needs to be a **System Admin** on Workplace to install integrations.\n - Click **Add to Workplace** in the pop-up window that asks you to install Dialogflow integration. You also have the option to customize the name for the bot.\n3. Test your app:\n\n 1. Go to [Workplace](https://www.workplace.com/) and log into the account.\n 2. Find **Dialogflow** (or the customized name of your bot) in **Bots** from the **Home** section of the sidebar and start chatting with the bot.\n\nCancel\n------\n\nIf you clicked the **START** button but do not want to finish the installation on Workplace:\n\n1. Go to the [Dialogflow ES console](https://dialogflow.cloud.google.com).\n\n2. Click **Integrations** in the left sidebar menu.\n\n3. Click **Facebook Workplace**:\n\n 1. If you see a **CANCEL** button: Click **CANCEL** to cancel the installation.\n 2. If you see a **STOP** button: Follow instructions below to uninstall the integration.\n\nStop\n----\n\nTo stop a successfully installed integration:\n\n1. Go to the [Dialogflow ES console](https://dialogflow.cloud.google.com).\n\n2. Click **Integrations** in the left sidebar menu.\n\n3. Click **Facebook Workplace**.\n\n4. Click **STOP** and you will be redirected to Workplace to finish the installation:\n\n 1. Log into your Workplace account. The account needs to be a **System Admin** on [Workplace](https://www.workplace.com/) to uninstall integrations.\n 2. Find and select the Dialogflow integration from the installed integrations on Workplace, click **Uninstall** to finish the uninstallation.\n5. Dialogflow integration will be uninstalled.\n\nRich response messages\n----------------------\n\nThis integration translates some\n[rich response messages](/dialogflow/docs/intents-rich-messages)\nmessages to\n[Facebook Messenger Platform message types](https://developers.facebook.com/docs/messenger-platform/send-messages).\n\n### Image responses\n\n[Image responses](/dialogflow/docs/intents-rich-messages#image)\nare sent to Facebook Messenger as\n[Facebook Messenger file attachment messages](https://developers.facebook.com/docs/messenger-platform/reference/attachment-upload-api#attachment).\nThe `message.attachment.type` value is set to `image`.\nThe following formats are supported:\n\n- jpg\n- png\n- static gif\n- animated gif\n\n### Card responses\n\n[Card responses](https://cloud.google.com/dialogflow/docs/intents-rich-messages#card)\nare sent to Facebook Messenger as\n[Facebook Messenger generic templates](https://developers.facebook.com/docs/messenger-platform/reference/templates/generic).\n\n### Quick reply responses\n\n[Quick reply responses](https://cloud.google.com/dialogflow/docs/intents-rich-messages#quick)\nare sent to Facebook Messenger as\n[Facebook Messenger quick replies](https://developers.facebook.com/docs/messenger-platform/reference/buttons/quick-replies).\n\n### Custom payload responses\n\nTo send other types of Facebook Messenger messages,\nyou can use a\n[custom payload](https://cloud.google.com/dialogflow/docs/intents-rich-messages#custom).\n\nThe general format of the custom payload looks like: \n\n```\n{\n \"facebook\": {\n message\n }\n}\n```\n\nIn place of `message`, provide the Facebook Messenger `message` object.\nFor details of the `message` object, see the\n[Facebook Messenger API reference](https://developers.facebook.com/docs/messenger-platform/reference/send-api/).\n\nFor example:\n\n- Send an audio link: \n\n ```\n {\n \"facebook\": {\n \"attachment\": {\n \"type\": \"audio\",\n \"payload\": {\n \"url\": \"https://example.com/audio/test.mp3\"\n }\n }\n }\n }\n \n ```\n- Send a playable video: \n\n ```\n {\n \"facebook\": {\n \"attachment\": {\n \"type\": \"video\",\n \"payload\": {\n \"url\": \"https://example.com/video.mp4\"\n }\n }\n }\n }\n \n ```\n- Send a file: \n\n ```\n {\n \"facebook\": {\n \"attachment\": {\n \"type\": \"file\",\n \"payload\": {\n \"url\": \"https://example.com/file.pdf\"\n }\n }\n }\n }\n \n ```\n\nLimitations\n-----------\n\n1. A Dialogflow agent can only be installed on one Workplace instance, but you can install multiple Dialogflow agents on one Workplace instance.\n\n2. To remove a failed installation, you need to both cancel the installation on Dialogflow and remove the installation on Workplace.\n\nMigration\n---------\n\nIf you are using Messenger integration and you are going to migrate it to Workplace integration, you'll need to:\n\n1. Stop the Messenger integration.\n\n2. Remove the callback_url on the Facebook app by reversing steps in [Setting Up Your Facebook App](https://developers.facebook.com/docs/messenger-platform/getting-started/app-setup).\n\n3. Start the Workplace integration following steps above."]]
