Configure Azure integration with Dynamics 365 Customer Engagement (on-premises)

You can post the message request data for the current core operation to cloud hosted applications listening on the Azure Service Bus. To enable this capability in Dynamics 365 Customer Engagement (on-premises), perform the tasks detailed in this topic.


These instructions apply to Online deployments only. For on-premises deployments, see documentation for the most recent on-premises release at Dynamics CRM 2016 SDK: Configure Azure integration with Microsoft Dynamics 365 Customer Engagement apps

Configure Azure For Dynamics 365 Customer Engagement (on-premises) integration

When you use SAS for authorization, you need to configure the rules and issuers of your Azure solution to allow a listener application to read the Dynamics 365 Customer Engagement (on-premises) message posted to the Azure Service Bus. In addition, you must configure the service bus rules to accept the Dynamics 365 Customer Engagement (on-premises) issuer claim. The recommended method to configure Azure is to use the Plug-in Registration Tool.

For instructions on configuring authorization see Walkthrough: Configure Microsoft Azure (SAS) for integration with Dynamics 365 Customer Engagement (on-premises).

Test Configuration

After configuring Azure integration, you will need to perform these additional tasks.

  1. Write and register a listener application with a Azure Service Bus solution endpoint. For more information, see the Azure Service Bus documentation.

  2. Register a Azure aware plug-in or a Azure aware custom workflow activity with Dynamics 365 Customer Engagement (on-premises). More information: Walkthrough: Register an Azure-aware Plug-in with Plug-in Registration Tool

  3. Perform the necessary Dynamics 365 Customer Engagement (on-premises) operation that triggers the plug-in or custom workflow activity to run.

If all of the preceding steps were performed correctly, a message containing the Dynamics 365 Customer Engagement (on-premises) data context should be sent to a Azure queue or topic and ultimately received by the listener application. You can navigate to the System Jobs grid in the Dynamics 365 Customer Engagement (on-premises) web application and check the status of the related System Job to see if the post to the Azure Service Bus succeeded. In case of errors, the message section of the System Job displays the error details.

See also

Azure Extensions for Dynamics 365 Customer Engagement (on-premises)
Write a plug-in
Using the Provided Azure Plug-in
Writing a Listener for a Azure Solution
Azure Platform – Getting Started


Can you tell us about your documentation language preferences? Take a short survey.

The survey will take about seven minutes. No personal data is collected (privacy statement).