---
title: Microsoft Dynamics CRM App Creation and Installation
slug: contact-center/microsoft-dynamics-crm-app-creation-and-installation
docTags: 
createdAt: 2025-10-28T18:33:47.260Z
---

# Overview

This document serves as a guide to configure the MSD CRM App at MSD application's end. Please follow all the steps for the configuration given below.

# Usage Instructions

Create Microsoft Dynamic Account and do following configuration:

## Step 1: Set Up Dynamics Account:

1.First, create an account or do sign up for MSD 365 from the below link :

*https\://signup.microsoft.com/Signup?OfferId=bd569279-37f5-4f5c-99d0-425873bb9a4b\&dl=DYN365\_ENTERPRISE\_PLAN1\&Culture=en-us\&Country=us\&ali=1*

&#x20;Copy the Username and Password.

2.While creating the account select all services provided by&#x20;

*https\://port.crm8.dynamics.com/G/TrialInstances/TrialInstancePicker.aspx*

- now click on create your own trial
- now click on create new
- now select "All of these" checkbox and click on complete setup
- from here you can add the new instance as well and now copy the URL from the browser

![](https://api.archbee.com/api/optimize/SK2urIgCC2ml99YyqWOSl/7TVtRl_tQcAqMenZ8QbVC_.blob)

***

3.The user will do log in with the below URL with credentials, Username, and Password.

*https\://cxfusion.crm8.dynamics.com/*

![](https://api.archbee.com/api/optimize/SK2urIgCC2ml99YyqWOSl/7vtxYFHEdDsfmBxp51Qj0_.blob)

4.Now we will redirect to this page :

![](https://api.archbee.com/api/optimize/SK2urIgCC2ml99YyqWOSl/iwsO01xJkTsziq-NXmOFN_.blob)

##

## Step 2: Register an Application in Azure for SSO:

:::Paragraph{listStyleType="disc" indent="2"}
Log in to the Microsoft Azure portal using your Dynamics credentials. Steps to create APP in Azure
*https\://portal.azure.com/#blade/Microsoft\_AAD\_IAM/ActiveDirectoryMenuBlade/Overview*&#x20;
:::

:::Paragraph{listStyleType="disc" listStart="2" indent="2"}
Navigate to **Azure Active Directory** from the left-hand menu.&#x20;
:::

![](https://api.archbee.com/api/optimize/SK2urIgCC2ml99YyqWOSl/gbZf1X6XqSHC-zq1tYwHH_.blob)

- Click on **App Registration** and **provide a nam**e and now click on add **new app** and provide the details for the app&#x20;

![](https://api.archbee.com/api/optimize/SK2urIgCC2ml99YyqWOSl/4zF7LFSS_cnl7L27EVKzv_.blob)

- Set the **Application type** to "Web app / API". After that enter Web API and MSD CRM URL will be entered. Now provide the details for the app as given below :
- In the **Sign-on URL** field, enter the URL of your app. Click **Create**.&#x20;
- Now click outside this box it will validate all the details and then create button will highlight.

![](https://api.archbee.com/api/optimize/SK2urIgCC2ml99YyqWOSl/1ph9x0pF1IdMCFLreLYM5_.blob)

Now go to th&#x65;**&#x20;app >> settings** and then provides the **Reply URLs** as given below :

![](https://api.archbee.com/api/optimize/SK2urIgCC2ml99YyqWOSl/2VebmIPo3pozwcTEuK5pP_.blob)

- Now to the **app name >> settings >> required permission** as given in below screenshot :

![](https://api.archbee.com/api/optimize/SK2urIgCC2ml99YyqWOSl/8iW_7-5W-bjg6k17UQMUp_.blob)

- Now go to the **app name >> settings >> required permission** and add the API access as given below :

![](https://api.archbee.com/api/optimize/SK2urIgCC2ml99YyqWOSl/5Wl-5iO3Vu6TIAnWBJvNy_.blob)

## Step 3: Grant API Permissions:

- Navigate to **API permissions**. Now go to the **app >> settings >> required permission >> add api access >> select an API** and select the **DYNAMIC CRM ONLINE (Or Common Data Service)**

![](https://api.archbee.com/api/optimize/SK2urIgCC2ml99YyqWOSl/ZP0F7Mvx0FowdPLfSfjCI_.blob)

- Now select the **app >> settings >> required permission >> add API access >> enable access** as provided in the below screen shot:

![](https://api.archbee.com/api/optimize/SK2urIgCC2ml99YyqWOSl/2VKVMEzw3UI5YMDj5Ib1i_.blob)

- Now add the API access as given in the below screen shot :&#x20;

![](https://api.archbee.com/api/optimize/SK2urIgCC2ml99YyqWOSl/qncxebI0FNex2ixwZb9Da_.blob)

- Click the **Grant admin consent** button to apply the permissions. Confirm by clicking "Yes".&#x20;

***

![](https://api.archbee.com/api/optimize/SK2urIgCC2ml99YyqWOSl/f_LBVUaJ0Bo4W4rg-390G_.blob)

***

- Now go to the keys and copy the **client secret** from here and save the same somewhere (important) and provide the details as given in below screen shot:

![](https://api.archbee.com/api/optimize/SK2urIgCC2ml99YyqWOSl/6Z8yq5EWX_nj-VrHkcO7S_.blob)

- Now copy the application ID from the below screenshot:

***

![](https://api.archbee.com/api/optimize/SK2urIgCC2ml99YyqWOSl/ypYMw-aWF-yKxx9iB7hp9_.blob)

***

- Now edit the manifest and provide the oauth2AllowImplicitFlow as TRUE:&#x20;

***

![](https://api.archbee.com/api/optimize/SK2urIgCC2ml99YyqWOSl/G8UcncWpifGvP9GdoTRjJ_.blob)

Now copy the OAUTH 2.0 TOKEN ENDPOINT and OAUTH 2.0 AUTHORIZATION ENDPOINT from the endpoints as given below: - **USE ONLY OAUTH2 V1.0 URLs - https\://login.microsoftonline.com/b699289e-9677-4e1a-a46e-3b7xt4dcefe9/oauth2/authorize**

![](https://api.archbee.com/api/optimize/SK2urIgCC2ml99YyqWOSl/WhMFBKYh87cqkjzXLXjuU_.blob)

***

# Configuration To Enable Channel Specific Framework in Microsoft Dynamics

***

1. open your app page in microsoft crm dynamics. eg. **https\://\<orgURL>.dynamics.com/apps**

![](https://api.archbee.com/api/optimize/SK2urIgCC2ml99YyqWOSl/hT_nP_z_Wfl4kXFjOD6XU_.blob)

2. Click on Channel Specific option.&#x20;
3. (or) go to https\://appsource.microsoft.com/en-us/product/dynamics-365/mscrm.d365ciframework and click on **GET IT NOW.**

![](https://api.archbee.com/api/optimize/SK2urIgCC2ml99YyqWOSl/G1mMQNMFvwlxIZx8NqsNQ_.blob)

***

![](https://api.archbee.com/api/optimize/SK2urIgCC2ml99YyqWOSl/MpGxswSHI7gnko7BoPp5g_.blob)

4. Now you have enabled CIF.
5. Now go to you dynamic home, click on drop down > (in all apps) select Channel specific Framework app > create a new app and fill the details.

***

![](https://api.archbee.com/api/optimize/SK2urIgCC2ml99YyqWOSl/jovXn7TKB9EAMFtRh9WPm_.blob)

***

![](https://api.archbee.com/api/optimize/SK2urIgCC2ml99YyqWOSl/Kdwj75-AvNtIDsE5Lov0u_.blob)

![](https://api.archbee.com/api/optimize/SK2urIgCC2ml99YyqWOSl/LLKD-k43ucWsnvDjnR-Md_.blob)

![](https://api.archbee.com/api/optimize/SK2urIgCC2ml99YyqWOSl/hEtP0Qt4B1vg5Vkq0AyVz_.blob)

**In Select Unified Interface Apps for the Channel -- Ameyo Toolbar Supports In Sales Hub Tab And Customer Service Hub. Except These Two Other Tab May Not Support Ameyo Toolbar.**

![](https://api.archbee.com/api/optimize/SK2urIgCC2ml99YyqWOSl/peM0hIf9pgUc463H3GElR_.blob)

- Enter all fields, channel URL will be:

https\://\<your server domain>/ameyowebaccess/toolbar/toolbar-crm.htm?ucilib=https\://\<msd domain>/webresources/Widget/msdyn\_ciLibrary.js

eg. https\://abhay.ameyo.com:8443/ameyowebaccess/toolbar/toolbar-crm.htm?ucilib=https\://ddeveloper.crm8.dynamics.com/webresources/Widget/msdyn\_ciLibrary.js
And than Click on SAVE AND CLOSE

# Data Fields Configuration (Phone Call Activity)

To start Ameyo service on Microsoft Dynamics Account, configure data fields to the App so that the Ameyo user can use these data fields during the work. These data fields help the user to fill the customer's information about the phone call.

Perform the following steps to configure and store the Phone Call activities in the CIF account.

1. Go back to the home of Microsoft Dynamics account.
2. Select "Dynamics 365 Custom" App from the main menu.

::Image[]{src="https://api.archbee.com/api/optimize/SK2urIgCC2ml99YyqWOSl/dtZISZw7TY8HpXsGF0XxT-20260729-055918.png" size="42" width="246" height="175" position="center" caption="Figure: Dynamics Custom App" showCaption="true"}

3. Click "Settings" icon, followed by "Advanced Settings" option from the list of settings located in the top right corner of the page.

![](https://api.archbee.com/api/optimize/SK2urIgCC2ml99YyqWOSl/zdUR3fi0eW1ONm87nrqEz-20260729-055929.png "Figure: Custom Settings icon")

4. It shows the following page of settings.

![](https://api.archbee.com/api/optimize/SK2urIgCC2ml99YyqWOSl/SMcTVyi6tJvkofxshWrjI-20260729-055921.png "Figure: Customizations Settings")

5. Click "Settings" icon located with "Customizations". It shows the following page.

![](https://api.archbee.com/api/optimize/SK2urIgCC2ml99YyqWOSl/Kv7D3_WQ3EejfH4sInF04-20260729-055928.png "Figure: Customize the System Settings tab")

6. Click "Customize the System" tab located on the top of the page. It shows the following page of PowerApps, which makes you allow and integrate all fields to your Ameyo account.

![](https://api.archbee.com/api/optimize/SK2urIgCC2ml99YyqWOSl/QOMKS4EkuFY-60-Oa9G_1-20260729-055920.png "Figure: Entities option of Customization tab")

7. Select the "Entities" link to expand its tree. It shows the list of all features.

![](https://api.archbee.com/api/optimize/SK2urIgCC2ml99YyqWOSl/PlLVTI2xE28uhfSLRIGRD-20260729-055925.png "Figure: Phone Call List")

8. Scroll down to find "Phone Call". Click it to expand it further.
9. Click "Fields" option to access the following page.

![](https://api.archbee.com/api/optimize/SK2urIgCC2ml99YyqWOSl/mErD6ncWFBjBqIHZi4vTo-20260729-055923.png "Figure: Fields option")

10. Now, select "New" button located on the top.

![](https://api.archbee.com/api/optimize/SK2urIgCC2ml99YyqWOSl/jbxHXyQjaOurzASwdvfRg-20260729-055926.png "Figure: Phone Call Fields")

11. Create the new Phone Call Fields that helps CIF to create the compatible fields for Ameyo. You have to provide the inputs in the following fields.
    - Display Name
    - Name
    - Format
    - Maximum Length
12. Create the following fields with their columns.
    - **Recording Link Field:** It allows the Ameyo to record the calls and store them in the Ameyo Server.
      - **Display Name:** Recording Link
      - **Name:** recordinglink
      - **Maximum Length:** 500
      - **Format:** URL

![](https://api.archbee.com/api/optimize/SK2urIgCC2ml99YyqWOSl/Bu7AgYdYMAR9xMhXJhu-v-20260729-055927.png "Figure: Recording Link Field")

2. **Disposition Field:** It allows you to provide the Dispositions in the CIF as well.
   - **Display Name:&#x20;**&#x44;isposition
   - **Name:&#x20;**&#x64;isposition
   - **Length:&#x20;**&#x31;00
   - **Format:** Text

![](https://api.archbee.com/api/optimize/SK2urIgCC2ml99YyqWOSl/pNoZKvGZApKnAlgOmY6Wl-20260729-055925.png "Figure: Disposition Field")

3. **Sub Disposition Field:&#x20;**&#x49;t allows you to provide the sub dispositions to the call.
   - **Display Name:&#x20;**&#x53;ub Disposition
   - **Name:&#x20;**&#x73;ubdisposition
   - **Length:&#x20;**&#x31;00
   - **Format:** Text

![](https://api.archbee.com/api/optimize/SK2urIgCC2ml99YyqWOSl/co5ffock4PblfR6msLOMn-20260729-055928.png "Figure: Sub Disposition Field")

***

4. **Association Field:**
   - **Display Name:&#x20;**&#x41;ssociation
   - **Name:&#x20;**&#x61;ssociation
   - **Length:&#x20;**&#x31;00
   - **Format:** Text

![](https://api.archbee.com/api/optimize/SK2urIgCC2ml99YyqWOSl/aLtDUgWTeQnkpDMcRs4i5-20260729-055923.png "Figure: Association Field")

5. **Agent Field:&#x20;**&#x49;t allows the CIF to recognize the agent with the help of ameyo.
   - **Display Name:&#x20;**&#x41;gent
   - **Name:&#x20;**&#x61;gent
   - **Length:&#x20;**&#x31;00
   - **Format:** Text

![](https://api.archbee.com/api/optimize/SK2urIgCC2ml99YyqWOSl/R3r9v-cyw2FG_WK1H6nSM-20260729-055922.png "Figure: Agent Field")

:::hint{type="info"}
If you want to add more fields that are not present in the above steps, then contact the Services Team of Ameyo.
:::

13. After creating all above fields, close the page and return to the previous page. Now, there is a need to assign these fields to the phone call entity.
14. Click "Forms" option and click "Fields".
15. All options of "Forms" options are displayed.

![](https://api.archbee.com/api/optimize/SK2urIgCC2ml99YyqWOSl/0g6xZU6gEM99u6yfc-G0G-20260729-055924.png "Figure: Forms option in Entity")

16. Click "Phone Call" option in the right panel. It shows the options in a navigation pane located on the right side., which contains the fields created in the previous step. It helps CIF to use all required services offered by Ameyo to inherit.

![](https://api.archbee.com/api/optimize/SK2urIgCC2ml99YyqWOSl/TJ5HwdbNXk6xxtBmcVJkQ-20260729-055918.png "Figure: Phone Call Entity Page")

17. All created fields are located in this right panel. Drag them to the section named "Phone Call".

![](https://api.archbee.com/api/optimize/SK2urIgCC2ml99YyqWOSl/bRAgMAAXFjtFyMlwWBjjT-20260729-055920.png "Figure: Fields dragged to Main Menu")

18. Click "Publish" button located on the top to save and publish the changes. It shows a confirmation message. Click "OK" to save the changes.

![](https://api.archbee.com/api/optimize/SK2urIgCC2ml99YyqWOSl/K7JUzN2FIpd14ty7gQpSA-20260729-055919.png "Figure: Save and Publish the Controls")

19. Now, go back to the entities page and open **"Phone Call for Interactive experience"**. It shows the following page.

![](https://api.archbee.com/api/optimize/SK2urIgCC2ml99YyqWOSl/0g6xZU6gEM99u6yfc-G0G-20260729-055924.png "Figure: Phone Call for Interactive Experience")

20. Perform the same steps, which you have performed earlier in the Phone call menu. Drag the fields to the Phone call menu and assign the control options as done in previous steps.

![](https://api.archbee.com/api/optimize/SK2urIgCC2ml99YyqWOSl/g9JoUn7hNASk0D5IQR0j4-20260729-055927.png "Figure: Phone call for an interactive experience")

21. After completing all changes, click **Publish** button to save the changes.

With the above steps, all configurations for Microsoft Dynamics account have been completed.
