Preview · This help is still growing and will be extended over time.
Configure the Dynamics 365 integration
Connecting your Dynamics 365 environment to echo for caller identification, opportunities and activities
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.
Prerequisites
- A Dynamics 365 environment in the same Microsoft 365 tenant as your Teams.
- You are an echo administrator. Only administrators see the integration settings.
- Your Microsoft account may grant admin consent for the organization in Microsoft Entra ID (for example as Global Administrator).
- Every user who should see Dynamics data has a user in the Dynamics environment with suitable security roles (see Permissions in Dynamics 365).
Find your organization URL
echo needs the address of your Dynamics environment, for example https://muster.crm17.dynamics.com. You find it:
- in the Power Platform admin center under Environments → your environment → Environment URL, or
- in your browser's address bar when you open Dynamics 365.
Enter only the address up to .dynamics.com, without a path and without a slash at the end.
Connect Dynamics 365
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.
Enter the organization URL
Open Settings → Dynamics 365. In the Dynamics 365 Environment panel, enter the address in 1 Organization URL.
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:
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:
- Opportunities – name, estimated value, estimated close date and status, with Open in Dynamics.
- Activities – create a phone call, email, appointment or task in Dynamics with Create activity.
- Timeline – activities and notes from Dynamics next to emails and meetings.
- Add incoming number to this contact – saves the number the user searched for on the selected contact.
- Create new contact – if echo finds nobody, users can create the record in Dynamics (Create in → 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:
- the organization URL points to the right environment;
- the user has a Dynamics 365 user account with read access to contacts, accounts and leads in that environment;
- the number is stored in one of the phone fields listed above, in a usual notation.
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.