Walkthrough: Get started with building a simple communication widget
In this tutorial, we demonstrate how to build a simple Hello World! communication widget that can be hosted on Dynamics 365 Channel Integration Framework.
- Visual Studio 2017.
- A valid Microsoft Azure subscription is required to publish the sample app to Azure.
If you don't have an Azure subscription, create a free account.
Create a simple Hello World! application
Open Visual Studio 2017, and select File > New > Project to create a new project.
Select the ASP.NET Web Application (.NET Framework) template for your project, and add any name to it.
Select the MVC template for your application, and make sure that authentication is set to No Authentication.
You can choose any other template for your ASP.NET application.
Now view the files in Solution Explorer. Expand Views > Home, and open the Index.cshtml file.
Replace the HTML code in the Index.cshtml file with the following code:
<!DOCTYPE html> <html> <body> <br /><br /> <p>Hello World!</p> </body> </html>
Run this HTML file using Microsoft Edge or Google Chrome to test and debug.
The webpage should look like this when you run it in your browser:
Publish and configure the widget
To publish the sample widget you just created, follow the steps in Publish sample app to Azure. You might also want to read this Azure tutorial on how to create and publish an ASP.NET web app in Azure: Create an ASP.NET Framework web app in Azure. Once the wizard has published the app on Azure, it provides a site URL that you can use to access your hosted web app.
When you select the site URL, it opens the same web app that we saw earlier while debugging our web app in Visual Studio.
To configure the widget in your Dynamics 365 instance, follow the steps mentioned here: Configure sample app in Dynamics 365.
Once the preceding steps are completed, open one of the Unified Interface apps that you selected while configuring the widget in Dynamics 365 Channel Integration Framework, and you will see the communication widget in the right-side panel. To open one of your selected Unified Interface apps, go to
The published widget should look like this.
Now, proceed to the next section of this walkthrough that shows how you can search and open a record in Dynamics 365 on an incoming call.
How to check if Channel Integration Framework 1.0 is ready for communication
You can check if Channel Integration Framework 1.0 is ready by invoking CIFInitDone event. CIFInitDone event is raised by Channel Integration Framework library after the Channel Integration Framework is loaded. This event determines if the Channel Integration Framework APIs are ready for communication. More information: Events