[[["容易理解","easyToUnderstand","thumb-up"],["確實解決了我的問題","solvedMyProblem","thumb-up"],["其他","otherUp","thumb-up"]],[["難以理解","hardToUnderstand","thumb-down"],["資訊或程式碼範例有誤","incorrectInformationOrSampleCode","thumb-down"],["缺少我需要的資訊/範例","missingTheInformationSamplesINeed","thumb-down"],["翻譯問題","translationIssue","thumb-down"],["其他","otherDown","thumb-down"]],["上次更新時間:2025-09-08 (世界標準時間)。"],[[["\u003cp\u003eThis integration allows you to create a Meta Workplace bot that interacts with end-users via Dialogflow CX.\u003c/p\u003e\n"],["\u003cp\u003eSetting up the integration involves creating a Meta Workplace Custom Integration and configuring both the Conversational Agents (Dialogflow CX) integration and Workplace instance to communicate with each other.\u003c/p\u003e\n"],["\u003cp\u003eWhen using this third-party integration, end-user data is sent to both Google and Meta, with each party's terms of service, SLA, pricing, and quotas applicable to their respective handling of requests.\u003c/p\u003e\n"],["\u003cp\u003eThe integration uses the Meta Send API to send messages to end-users and the Workplace Webhook to receive messages.\u003c/p\u003e\n"],["\u003cp\u003eRich response messages are supported using Custom Payload in Fulfillment, and channel-specific responses can be configured for Meta Messenger messages.\u003c/p\u003e\n"]]],[],null,["# Workplace from Meta\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 Meta Workplace integration, you can create a Meta\nWorkplace 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\nHow it works\n------------\n\nThis is how the integration works:\n\n- You create a Customer Integration that uses the [Meta Workplace](https://developers.facebook.com/docs/workplace/).\n- You configure the Conversational Agents (Dialogflow CX) integration and Workplace instance, so that they communicate with each other.\n- The Conversational Agents (Dialogflow CX) integration sends messages to the end-user by using the [Send API from Meta](https://developers.facebook.com/docs/messenger-platform/reference/send-api/).\n- The Conversational Agents (Dialogflow CX) integration receives messages from the end-user by acting as the [Workplace Webhook from Meta](https://developers.facebook.com/docs/workplace/reference/webhooks/).\n\nSetup\n-----\n\n| **Note:** Make sure [billing is enabled](/dialogflow/cx/docs/quick/setup#billing) on your project before testing the integration.\n\nTo set up the integration:\n\n1. Follow the steps to create a Meta Workplace Custom Integration :\n [Creating an Meta Workplace custom integration](https://www.workplace.com/resources/tech/integrations/chat-bot).\n\n - Create a Meta Workplace Custom Integration.\n - You are provided with an App Secret at this step. Copy this value. This token will be used to configure the integration from the Conversational Agents (Dialogflow CX) console.\n - Create or reset the Access token of your integration. Copy this value. This token will be used to configure the integration from the Conversational Agents (Dialogflow CX) console.\n - Set up the Custom Integration Permissions. Make sure `Message any member` is enabled in Permissions.\n2. Configure the integration from the Conversational Agents (Dialogflow CX) console:\n\n 1. Go to the [Dialogflow CX console](https://dialogflow.cloud.google.com/cx/projects).\n 2. Click the **Manage** tab on the left panel.\n 3. Click **Integrations** in the left sidebar menu.\n 4. Click the **Connect** button on the **Meta Workplace** tile.\n 5. A configuration dialog opens:\n\n - **App secret** : Enter the app secret from\n [App Dashboard Basic Settings](https://developers.facebook.com/docs/development/create-an-app/app-dashboard/basic-settings/).\n\n - **Access token**: Enter the access token you copied during the\n Meta app setup above.\n\n - **Verify token**: You can enter any private token you desire. Copy\n this value. This will be used to configure the Meta Workplace\n Webhook.\n\n - **Webhook URL**: Copy this value. This will be used to configure the\n Meta Workplace Webhook.\n\n - **Start**: Click to start this integration service for your agent.\n\n3. Finish setup of the Meta Workplace Custom Integration and test it. Follow steps in the\n [Webhook for Meta Workplace](https://developers.facebook.com/docs/workplace/integrations/custom-integrations/webhooks/)\n documentation to accomplish the following:\n\n - Configure the Meta webhook for your app. Use the **Webhook URL** and **Verify token** values you copied above.\n - Subscribe your Integration to Webhook Topics. Be sure to enable `messages` and `messaging_postbacks` in the page subscription.\n - Test your app.\n\nRich response messages\n----------------------\n\nThe rich response messages are supported using **Custom Payload** in\n[Fulfillment](/dialogflow/cx/docs/concept/fulfillment). See\n[Send API Parameters Message Object](https://developers.facebook.com/docs/messenger-platform/reference/send-api#parameters)\nfor the message format.\n\nFor example, the following custom payload provides a simple text message: \n\n```json\n{\n \"text\": \"Hello, world\"\n}\n```\n\nThe following custom payload provides an image message: \n\n```json\n{\n \"attachment\": {\n \"type\": \"image\",\n \"payload\": {\n \"url\": \"https://example.com/test.jpg\"\n }\n }\n}\n```\n\nChannel specific responses\n--------------------------\n\nWhen configured, [channel specific responses](/dialogflow/cx/docs/concept/fulfillment#channel-specific) with channel `DF_CX_FB_MESSENGER` are automatically used when the agent responds to Meta Messenger messages."]]