[[["易于理解","easyToUnderstand","thumb-up"],["解决了我的问题","solvedMyProblem","thumb-up"],["其他","otherUp","thumb-up"]],[["很难理解","hardToUnderstand","thumb-down"],["信息或示例代码不正确","incorrectInformationOrSampleCode","thumb-down"],["没有我需要的信息/示例","missingTheInformationSamplesINeed","thumb-down"],["翻译问题","translationIssue","thumb-down"],["其他","otherDown","thumb-down"]],["最后更新时间 (UTC):2025-08-18。"],[[["\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."]]