Preview · This help is still growing and will be extended over time.

Integration · Administrator

Configure the Dynamics 365 integration

Connecting your Dynamics 365 environment to echo for caller identification, opportunities and activities

Updated: November 2026

With the Microsoft Dynamics 365 integration, echo searches the contacts, accounts and leads of your Dynamics 365 environment when a call comes in or when you search in echo. For a record from Dynamics, the contact cockpit can also show opportunities, lets users create activities in Dynamics, and shows Dynamics activities and notes in the timeline.

The connection is set up once for the whole organization by an administrator: you enter the address of your Dynamics environment and grant echo permission in Microsoft Entra ID. Users don't sign in separately. echo accesses Dynamics on behalf of the signed-in Microsoft 365 user, so every user sees exactly the records their own Dynamics 365 security roles allow.

Fig. 1: echo reads Dynamics 365 with the permissions of the user who is signed in to Teams.
Good to knowIf Dynamics 365 is not offered when you add an integration, it is not activated for your organization yet. Contact echo support (opens in a new tab).

Prerequisites

Find your organization URL

echo needs the address of your Dynamics environment, for example https://muster.crm17.dynamics.com. You find it:

Enter only the address up to .dynamics.com, without a path and without a slash at the end.

Connect Dynamics 365

1

Add Dynamics 365 as an integration

In echo, open Settings → Integrations, click Add integration and select Dynamics 365. If you select it during the initial setup, the wizard shows the same connection form as a separate step.

2

Enter the organization URL

Open Settings → Dynamics 365. In the Dynamics 365 Environment panel, enter the address in 1 Organization URL.

Fig. 2: Settings → Dynamics 365: organization URL and the Connect button.
3

Grant consent

Click 2 Connect. A Microsoft sign-in window opens. Sign in with your administrator account and accept the requested permission. echo asks for the delegated permission user_impersonation on your Dynamics environment, which lets echo access Dynamics as the signed-in user.

When the consent succeeds, the Connect button turns green with a check mark and echo saves the organization URL. If the consent fails or you close the window, nothing is saved.

To switch to another environment, enter the new organization URL and click Connect again.

Permissions in Dynamics 365

echo has no access of its own. Every request runs with the permissions of the signed-in user, so what a user can see and do in echo depends on their security roles in Dynamics 365:

In echoThe user needs in Dynamics 365
Identify callers and searchRead access to contacts, accounts and leads
OpportunitiesRead access to opportunities
Activities and notes in the timelineRead access to activities and notes
Create activitiesPermission to create phone calls, emails, appointments or tasks
Create a new contactPermission to create contacts and accounts
Add the incoming number to a contactWrite access to contacts

Users who have no user in the Dynamics environment get no results from Dynamics.

What echo shows from Dynamics 365

Caller identification. echo looks up the caller's number in the phone fields of contacts and leads (telephone1, telephone2, mobilephone) and of accounts (telephone1, telephone2). Dynamics compares the whole field, so echo tries the common notations of the number, for example +41 44 123 45 67, +41441234567 and 044 123 45 67.

Search. Users can also search Dynamics by name or by the primary email address (emailaddress1).

Links to Dynamics. Open contact in Dynamics, Open account in Dynamics and Open lead in Dynamics open the record in Dynamics 365.

Depending on the features enabled for your organization, the contact cockpit also offers for a record from Dynamics:

Remove the integration

On the Settings → Dynamics 365 page, click Remove Dynamics 365 under Remove integration and confirm with Remove. echo then no longer searches Dynamics. You can add the integration again at any time.

The consent in Microsoft Entra ID stays in place. If you want to revoke it too, do so in the Microsoft Entra admin center under Enterprise applications.

Troubleshooting

The Dynamics 365 settings are missing. Your account is not an echo administrator; integration settings are only shown to administrators. Ask an administrator, see User administration.

“An error occurred while saving the Dynamics 365 connection settings.” The consent worked, but saving failed. Click Connect again.

The consent window shows an error. Check that you signed in with an account that may grant admin consent, and that the organization URL is correct and complete (https://…dynamics.com).

Callers from Dynamics are not recognized. Check that:

Opportunities, activities or notes are missing. These sections only appear for records from Dynamics, and only if the user's security roles allow reading them.