Microsoft Dynamics

Overview

The Dynamics Integration connects IFS Loops to your Microsoft Dynamics environment to pull tickets, customer details, and knowledge articles. It uses OAuth authentication via an Azure app registration, with credentials generated in the Azure Portal and entered during setup in IFS Loops.

Prerequisites

• Before adding the Dynamics integration in IFS Loops, you must create an OAuth application in the Microsoft Azure Portal.

  • The Client ID and Client Secret generated from this step will be required while adding the integration.

Setup instructions

Create OAuth App in Azure

1

Go to the Microsoft Azure Portal and sign in using a tenant admin account.

2

From the home page, click App registrations, then click New registration.

3

Fill in the following details:

1. Name — Enter an application name.

2. Supported account type — Select Multiple Entra ID tenants and allow all tenants.

3. Redirect URL — Select platform as Web. Based on your cluster, enter the appropriate redirect URL:

   • Prod US: https://app.prod1.theloops.ai/v1/oauth/callback

   • Prod EU: https://app.eu.prod1.theloops.ai/v1/oauth/callback

   • IFS US: https://app.ifs-us.theloops.ai/v1/oauth/callback

   • IFS EU: https://app.ifs-eu.theloops.ai/v1/oauth/callback

   • Preprod: https://app.preprod.theloops.ai/v1/oauth/callback

4

Click Register.

Add API Permissions

1

Go to API Permissions.

2

Click Add a permission.

3

Select Dynamics CRM.

4

Choose Delegated Permission → user_impersonation and click Add permissions.

Grant Admin Consent

1

Click Grant admin consent and ensure the status shows Granted.

Create Client Secret

1

Go to Certificates & secrets.

2

Click New client secret.

3

Add a Description and Expiry date (as per your preference).

4

Click Add.

5

Copy the Client Secret Value (shown only once).

Once the client secret expires, you will need to repeat this step to generate a new client secret and update it in the IFS Loops integration authentication page.

Add Dynamics Integration in IFS Loops

1

Log in to the IFS Loops platform using your credentials.

2

Navigate to the Connectors section from the sidebar.

3

Click on the Add Integration button.

4

Choose Dynamics from the list.

5

Enter a unique Integration Name and select the required capability:

1. Helpdesk — To pull ticket details.

2. CRM — To pull customer details.

3. Content Management — To pull knowledge articles.

6

Click on the Next button.

7

Enter the following authentication details:

1. Domain — From the Dynamics URL, extract the domain.

   1. For example, from https://orgb713773c.crm.dynamics.com, enter orgb713773c.crm.

2. Client ID and Client Secret — Enter the Client ID and Client Secret copied from Azure (Section 1).

3. App ID — Extract the App ID from the Dynamics URL when you are logged into Dynamics.

   1. For example, from https://orgb713773c.crm8.dynamics.com/main.aspx?appid=3f82b518-7c43-f011-877a-002248d64834&..., the App ID is 3f82b518-7c43-f011-877a-002248d64834.

8

Click on the Connect button.

9

A login screen will appear. Sign in using a tenant admin account and grant the required permissions.

10

On success, you will see a popup: "Integration Configured Successfully"

Setup Webhook

Webhook setup is required to receive live updates (such as case creation, updates, and comments) from Dynamics in IFS Loops. This setup is applicable only for the Helpdesk capability.

1

If you have not installed the Plugin Registration Tool, download it using PowerShell.

1. Open PowerShell.

2. Run the following script:

[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12
$sourceNugetExe = "https://dist.nuget.org/win-x86-commandline/latest/nuget.exe"
$targetNugetExe = ".\nuget.exe"
Remove-Item .\Tools -Force -Recurse -ErrorAction Ignore
Invoke-WebRequest $sourceNugetExe -OutFile $targetNugetExe
Set-Alias nuget $targetNugetExe -Scope Global -Verbose

# Download Plugin Registration Tool
./nuget install Microsoft.CrmSdk.XrmTooling.PluginRegistrationTool -O .\Tools
md .\Tools\PluginRegistration
$prtFolder = Get-ChildItem ./Tools | Where-Object {$_.Name -match 'Microsoft.CrmSdk.XrmTooling.PluginRegistrationTool.'}
move .\Tools\$prtFolder\tools\*.* .\Tools\PluginRegistration
Remove-Item .\Tools\$prtFolder -Force -Recurse

2

After execution, the tool will be available in the same directory where you ran the script.

Open Plugin Registration Tool

1

Navigate to the directory path and open the PluginRegistration folder.

2

Open the PluginRegistration application.

3

Click on Create New Connection.

4

Sign in using admin credentials.

Register Webhook

1

Click on Register → Register New Webhook.

2

Enter the following details:

1. Name — Any meaningful name.

2. Endpoint URL — Copy from the IFS Loops Dynamics integration configuration page.

3

Under HTTP Headers, add:

• Key: client

• Value: theLoops

• Header keys and values are case-sensitive. Ensure they are entered exactly as shown.

4

Click Save.

Register Step for Case Creation

1

Right-click on the created webhook → Register New Step.

2

Enter:

1. Message: Create

2. Primary Entity: incident

3. Execution Mode: Asynchronous

3

Click Register New Step.

Register Step for Case Update

1

Right-click on the created webhook → Register New Step.

2

Enter:

1. Message: Update

2. Primary Entity: incident

3. Execution Mode: Asynchronous

3

Click Register New Step.

Register Step for Annotation Creation

1

Right-click on the created webhook → Register New Step.

2

Enter:

1. Message: Create

2. Primary Entity: annotation

3. Execution Mode: Asynchronous

3

Click Register New Step.

Register Step for Annotation Update

1

Right-click on the created webhook → Register New Step.

2

Enter:

1. Message: Update

2. Primary Entity: annotation

3. Execution Mode: Asynchronous

3

Click Register New Step.

Verify Setup

1

Ensure all steps are successfully registered under the webhook.

2

Final setup should show all created steps linked to the webhook.

Use the Dynamics Integration in IFS Loops

Once the integration is added, follow the steps below:

1

Go to your Dynamics integration.

2

Navigate to the Jobs / Data Ingestion tab.

3

If the capability is Helpdesk or CRM, select a date range to pull the data. For Content Management, a date range is not required.

4

Select Ingress Type as Full Ingress.

5

Click on Start Ingress.

6

After a few minutes, check the job status to confirm it is successful.

Regenerate Token

1

Go to your Dynamics integration. Click on the Edit button.

2

Navigate to the Authentication tab.

3

Click on the Regenerate Token button.

4

A login screen will appear. Log in using your credentials.

5

On success, you will see a popup: "Integration updated successfully".