Configure Facebook channel

Omnichannel for Customer Service offers a suite of capabilities that extend the power of Dynamics 365 Customer Service Enterprise to enable organizations to instantly connect and engage with their customers across digital messaging channels. An additional license is required to access Omnichannel for Customer Service. For more information, see the Dynamics 365 Customer Service pricing overview and Dynamics 365 Customer Service pricing plan pages.

Many customers use social messaging channels like Facebook for their personal communication needs. Many also prefer using messaging channels to engage with businesses. The asynchronous nature of these channels gives customers the convenience of getting their issues resolved as and when they find time. This ability contrasts with real-time channels like Chat for Dynamics 365 Customer Service, where the session ends when the chat window closes.


If you use access tokens in Facebook, refresh them on a 60-day schedule or as required because the tokens might randomly expire. More information: Facebook access tokens


Make sure that the following prerequisites are met:

  • Create a Facebook page. More information: Create and Manage a Page
  • Enable Messenger. More information: Messaging
  • Create a Facebook application. More information: App Development
  • Sign in to the developer site on Facebook or create an account, and then complete the following steps:
    1. Select My Apps, and then select Create app.
    2. On the What do you want your app to do? page, select Other, and then select Next.
    3. On the Select an app type page, select Business, and then type your app's name and contact email address.
    4. On the Add products to your app page, select Messenger, and then select Set up.
    5. On the Messenger settings page, select Add or remove Pages, and then add the Facebook page you created. After you add the page, you see the Page ID and the option to generate a token.
  • If you're using a test environment, set up test accounts in Facebook so that agents can send and receive messages in Omnichannel for Customer Service: Go to App Roles > Roles > Testers (Add Testers).
  • Values for application ID and application secret from the App ID and App Secret fields in the Facebook application > Settings > Basic.

Roles and permissions

The following Facebook roles and permissions are required for integrating your Facebook app with Omnichannel for Customer Service.

  • Facebook users who don’t have a role in the Facebook app must have the pages_messaging permission to send messages to a Facebook page from Omnichannel for Customer Service. The app owner must provide the pages_messaging permission for users to be able to send messages. More information: pages_messaging

  • If the Facebook app that you’re using is in development mode, only those Facebook users who have roles within the app can send messages to the Facebook page. The messages can be received by or forwarded to Omnichannel for Customer Service. More information: App roles

  • For Omnichannel for Customer Service to be able to retrieve the customer’s username from Facebook, the customer must request for Business Asset User Profile Access in their Facebook app. More information: Business Asset User Profile Access

Configure a Facebook channel

To configure a Facebook channel, the following steps are required:

  1. Create a Facebook channel account.

  2. Configure a Facebook workstream and work distribution settings.

Create the Facebook channel account

  1. In the site map of Customer Service admin center, in Customer support, select Channels.

  2. In Accounts, for Messaging accounts, select Manage.

  3. On the Accounts and channels page, select New account.

  4. Enter the following details:

    1. On the Channel details page, enter a name and select Facebook in Channels.

    2. On the Add account page, in the Application ID and Application secret fields, specify the Facebook App ID and App secret that you copied from the Facebook application.

    3. On Add Facebook Pages to this account, do the following steps:

    4. Select Add, and in the Add Facebook Page pane, enter the following details:

      • Page name: Name of the Facebook page.
      • Page ID: ID of the Facebook page. To get the page ID, go to your Facebook page, select About, and copy the value in the Page ID field.
      • Page access token: Specify the Page access token of the Facebook application. To get the page access token, go to your Facebook application and then go to Messenger > Settings. In the Access Tokens section, select the page, and copy the value in the Page Access Token field.
      • On the Callback information page, the Callback URL and Verify token fields are populated automatically when you save the settings. Use the information to configure webhooks in the Facebook application. The values for the fields aren't generated if the Facebook page is reused across multiple instances of the channel.
  5. Navigate back to the Facebook Application Messenger settings page, and then add the callback URL.

  6. Select Add subscriptions for the page, and then on the Edit page subscriptions page, select messages.

  7. Save your changes.

  8. Open Customer Service admin center, and then go to Channels > Messaging Accounts > Your FB Account.

  9. On the Account settings page, select the Facebook Pages tab, and then verify that the Provisioning state shows as Running.

Create a Facebook workstream

  1. To configure routing and work distribution, perform the steps outlined in create a workstream.

  2. Select the workstream you created for the Facebook channel and on the workstream page, select Set up Facebook, and do the following steps:

    1. In the Facebook Page area, select a page from the list.

    2. On the Language page, select the language to use.

    3. On the Behaviors page, configure the following options:

    4. On the User features page, configure the following options:

      • File attachments: When set to yes for both customer and agent, customers and agents can send and receive file attachments. More information: Enable file attachments. The availability and support of media is dependent on the Facebook application settings. More information: Facebook updates
      • Facebook message tag: Set to Yes to enable your agents to message customers after 24 hours pass. When set to No, agents are unable to respond to customers after 24 hours unless the customer sends another message.

      If you enable the Facebook human agent message tag during an active conversation between the agent and customer, the agent must close the conversation and reopen it to communicate with customers after 24 hours of inactivity. Agents can start conversations with customers for up to seven days.

      To use the Facebook human agent message tag, you must also turn it on in the Facebook app. More information: Facebook Developer Tools.

    5. Review the Summary page, and select Create. The channel instance is configured.

  3. Configure routing rules. More information: Configure work classification

  4. Configure work distribution. More information: Work distribution settings

  5. Optionally, you can add a bot. Skip this step if only human agents handle your conversations. More information: Configure a bot

  6. In Advanced settings, configure the following options based on your business needs:

Customer experience

A customer can start a conversation in any of the following ways:

  • Messenger on the Facebook page
  • Messenger app on a mobile device
  • Messenger widget on a custom website

If a customer starts a conversation from the Facebook page and then later switches to the mobile device, the previous conversation persists, and the customer can continue the conversation.

The agent receives the notification of the incoming conversation request. More information: Use Facebook channel

After the Facebook social profile is linked to a customer or contact record by the agent, subsequent Facebook conversations are linked to the customer records, and the customer summary is populated.

If the customer isn't identified based on name, a new contact record can be created.

The customer can send attachments only if you enable them. When the option isn't enabled for the customers, they can still attempt to send the file. However, agents don't receive the file and see an error.

Customer sending file.

Privacy notice

If you enable this feature, your data is shared with Facebook and flows outside of your organization's compliance and geo boundaries (even if your organization is in a Government Community Cloud region). More information: Connect a bot to Facebook.

Customers are solely responsible for using Dynamics 365, this feature, and any associated feature or service in compliance with all applicable laws, such as laws that relate to monitoring, recording, and storing communications with their end users. This responsibility includes adequately notifying end users that their communications with agents might be monitored, recorded, or stored and, as required by applicable laws, obtaining consent from end users before using the feature with them. Customers are also encouraged to have a mechanism in place to inform their agents that their communications with end users may be monitored, recorded, or stored.

See also

Facebook channel setup FAQ
Understand and create workstreams

Configure automated messages
Configure a prechat survey
Configure a post conversation survey
Delete a configured channel
Support for live chat and asynchronous channels