Microsoft Dynamics Integration

Before integrating your Microsoft Dynamics CRM with Outplay, you must gather your Dynamics credentials. If you have completed the "Create an OAuth Application", Obtain the Client ID, Client Secret, and URL. These would be the credentials required!

Create an OAuth Application:

To begin Dynamics and Outplay integration setup, you must create an OAuth Application or use an already existing OAuth Application within your Dynamics instance.

Dynamics asks for other applications to integrate with them securely. They specifically use OAuth to securely give the appropriate authorization level to the application you are trying to integrate.

Steps to setup OAuth application:

1. Log in to the Microsoft account, and in the Main Dashboard, click the 3x3 dot icon to see the different Microsoft Apps and select the admin app.
   
   

   

2. From the menu on the left side of your screen, select Show All.

3. Click Azure Active Directory.

4. From the Main Dashboard for Azure Active Directory, click the Azure Active Directory from the left-hand side menu.

5. In the Overview, click App Registrations on the menu on the left side within the Dashboard.

6. From the App Registrations, Click New Registration.
Note: If you are using a previously created OAuth Application, click the title of the Application to open the OAuth Application to obtain a Client ID.

7. Give the OAuth Application a name. The name will be user-facing, so give it something appropriate that you can easily remember. For example, keep Supported Account Types to the default setting of single-tenant and click on Register.

How to get the Client ID and Client Secret

1. Once you've completed the Oauth Application registration, you will be taken to an Overview Page for the OAuth Application that you just created. Copy the application (client) ID.

   

2. On the Overview Page for the OAuth Application, click Certificates & Secrets on the left-hand menu under the Manage section.

3. Select New client secret under the Client secrets section.

4. Enter a Description for Client Secret, such as "Outplay client secret," and click on Add button.

Note: Select a time frame for your Outplay Client Secret to expire as far into the future as you can. Upon expiration, you will need to create a new secret in Dynamics and update it in Outplay integration to continue syncing.

Navigate to Dynamics Integration Settings and change the client secret.

5. Now you will see a value associated with the new Client Secret you created. You can click the document icon to copy to your clipboard and paste this into the word document you've been using to capture your credentials and add this under the header Secret:

Note: This is the only time the Secret will be visible. If you do not immediately copy the Secret, you must create a new one to copy the credential.

Integrating Client ID with Dynamics account

1. Navigate to Dynamics ➡️ Settings ➡️ Advanced settings

   

2. Click on Security

3. Click on Users

4. Select Application User

5. In the application, users form click on New. Then, enter the Application ID (Client ID) created in the Azure portal and click on "Save and close" in the User: Application user form.

6. Select the Application user-created to click on Manage roles and assign the "System administrator" role to the application user created.

Integrating Dynamics with Outplay

1. Navigate to Integrations & API in Outplay and enable Microsoft dynamics integration.

2. Verify URI, Client ID & Client Secret popup opened.

3. While in Dynamics 365, click My Apps on the left-hand side.

4. Click Sales app.

5. From the Main Dashboard, look at the URL in the Browser and Highlight the "https://xxxxxxxxxxxxxxxxxxx.com" including both the "HTTPS://" and ".com" part.

6. Enter Client ID and Client Secret. Click on connect.