Connect Dynamics 365 and Social Engagement

Set up the connection between Dynamics 365 and Social Engagement so you can link social posts to Dynamics 365. Linking posts to Dynamics 365 lets you create Dynamics 365 records from social posts that were found in Social Engagement by using the Automatic Record Creation and Update Rules feature in Dynamics 365.

Prerequisites to establish a connection with Dynamics 365

The following prerequisites apply to both Dynamics 365 (online) and Dynamics 365 (on-premises). Prerequisites specific to Dynamics 365 (online) or Microsoft Dynamics 365 are listed later in this topic.

  • You have a license assigned for both Dynamics 365 and Microsoft Social Engagement.

  • You have a System Administrator security role in Dynamics 365. Contact your system administrator if you need an upgrade to your licensed products or an update to your permissions.

  • You have an Administrator user role in Social Engagement. To find out your user role in Social Engagement, go to Settings > Personal Settings > Your Preferences.

  • Your browser is likely to block any pop-up windows opened by Social Engagement when authenticating to Dynamics 365, Twitter, or Facebook. Learn more about the recommended browser settings to manage authentication pop-up windows.

Additional prerequisites to connect with Dynamics 365 (online)

  • Your Dynamics 365 (online) instance is upgraded to Dynamics CRM Online 2015 Update 1 or a later release.

  • Your Dynamics 365 instance is ready to receive social data. More information: TechNet: Control social data

Additional prerequisites to connect with Dynamics 365 (on-premises) (IFD-enabled)

  • You have upgraded to at least Microsoft Dynamics 365 (on-premises) and the deployment is IFD-enabled.

  • Your Dynamics 365 (on-premises) instance is an Internet-facing deployment (IFD) with a public IP address.
    More information: TechNet: Configure IFD for Microsoft Dynamics CRM

  • Enable OAuth support by following the post-installation and configuration guidelines for Microsoft Dynamics CRM.

  • Register your Social Engagement solution so that it can connect to and authenticate with the Dynamics 365 server, and access the web services. Each solution that you want to connect with Dynamics 365 (on-premises) (IFD-enabled) should be registered as a RedirectUri. Use the following command to register with the desktop client:

    Add-AdfsClient -Name MSE -ClientId e8ab36af-d4be-4833-a38b-4d6cf1cfd525 -RedirectUri @("https://listening-prod.dynamics.com/api/connect/version/1.0/solutions/<solution id>/crm/oauthRedirect ", "https://listening-prod.dynamics.com/api/connect/version/1.0/solutions/<solutionid>/crm/oauthRedirect") -Description "OAuth 2.0 client for MSE".

    More information: TechNet: Walkthrough: Register a CRM app with Active Directory

Establish a connection between Social Engagement and Dynamics 365

To connect Dynamics 365 (online) and Social Engagement, both services must be part of the same organization's Office 365 subscription. If you have licenses assigned to both Dynamics 365 (online) and Social Engagement, you'll find both products in the Office 365 app launcher. More information: Meet the Office 365 app launcher

Connect Social Engagement and Dynamics 365

  1. In Social Engagement, go to Settings > Connections > Microsoft Dynamics 365.

  2. Click Add connection Add button.

  3. Select the Connection type from the drop-down list.
    Add connection drop-down list in Social Engagement

  4. Provide the connection information for your Dynamics 365 (online) instance.

    • Dynamics 365 (online)
    • Select Dynamics 365 (online) and then click Check Instances to automatically discover all available Dynamics 365 (online) instances in your Office 365 tenant.
      Add connection dialog box in Social Engagement

    • Select the Dynamics 365 (online) instance you want to connect to from the list of discovered Dynamics 365 (online) instances for the selected location. For more information about the discovery process, see Discover the URL for your organization using the Web API.

    • Based on the selected Dynamics 365 (online) instance, the value in the Name field changes. You can update the Dynamics 365 (online) name if required.

    • For Dynamics 365 (on-premises)

    • Select Dynamics 365 (On-Premises) and add the details of your Dynamics 365 instance and enter a unique name for the connection.
      Add connection to Dynamics 365 (on-premises)
  5. Click Next Next button.

  6. If the connection was successful, the Dynamics 365 Instance pane opens and shows you the details about the connected instance.

  7. You can set the Set as default control to ON to have this instance selected by default when creating new links to Dynamics 365 records from social posts.

  8. If you changed a value in the Dynamics 365 Instance pane, click Save Save button to apply your changes.
    The connected Dynamics 365 (online) instance is now listed in the main pane when you go to Settings > Connections > Microsoft Dymanics Dynamics 365.

Next steps

Now that you've connected Dynamics 365 and Social Engagement, you can define entity details in Social Engagement to specify information for the Social Activity entity that is created when you link a post to Dynamics 365.

When you are satisfied with the configuration of the entities, configure the Record Creation Rules in Dynamics 365 to automatically create Dynamics 365 records from Social Activity entities.

Privacy notice

By enabling Microsoft Social Engagement to connect to Dynamics 365, you will allow data to be sent to Dynamics 365 using an individual action on a post or automation rules.

Dynamics 365 stores the data from Microsoft Social Engagement as a SocialActivity and a SocialProfile entity, and subsequently may convert the SocialActivity into a different record type based on predefined rules. Any Dynamics 365 user with the required permission to access Dynamics 365 records will be able to access and/or process this data.

Note that the data sent from Microsoft Social Engagement includes both Social Content and customer data. Specifically, the data includes Social Content information about the social post (author and text) as well as customer data in the form of enriched information, such as sentiment and tags. For complete information about the content of the data sent to Dynamics 365, please see the payload properties topic.

See also

Link posts from Social Engagement to Dynamics 365
Create a Dynamics 365 record from a social post
Manage the connection between Dynamics 365 and Social Engagement
Administer Microsoft Social Engagement