CallerHub
EN
Download

Microsoft 365 and Exchange: contacts as caller names

Many contacts are kept in Microsoft 365 mailboxes or in the tenant directory. Phone systems, however, usually ask via HTTP or LDAP. In between you need a service that reads the contacts through Microsoft Graph and gives the phone system the name.

Prepare access to Microsoft 365

Microsoft Graph allows access to contacts and users through an app registration in Microsoft Entra ID (Microsoft guide):

  1. In Entra ID, create a new registration under App registrations.
  2. Under API permissions, add an application permission for Microsoft Graph: Contacts.Read for the contacts of mailboxes or User.Read.All for the tenant directory.
  3. Grant admin consent.
  4. Create a client secret and note its expiry date.

Agree with your Microsoft 365 administration which mailboxes are to be read. Note the tenant (e.g. company.onmicrosoft.com or the tenant ID), the client ID and the client secret.

With CallerHub: the data source Microsoft 365 (Graph)

  1. Under Data sources, choose Add data source, select “Microsoft 365 (Graph)” as the type, enter a label, Create.
  2. Enter tenant, client ID and client secret.
  3. Define what is read: the contacts of certain mailboxes (e.g. sales@company.com, reception@company.com) or the users of the tenant.
  4. Test connection, then Save and apply.

CallerHub then provides the names to every connected phone system, together with further sources such as a CRM. If a field contains more than one number, e.g. “Tel. 030 23125456, mobile 0171 3920012”, CallerHub takes each valid number separately.

Data sources · New data source
New data source dialog: choose type, enter name, create.

Exchange Server on premises (EWS)

For an Exchange Server in your own network, CallerHub reads contacts through Exchange Web Services: EWS address (e.g. https://mail.company.com/EWS/Exchange.asmx), mailboxes and a user account with permission on these mailboxes.

For Exchange Online, use the source Microsoft 365 (Graph). Microsoft is blocking EWS in Exchange Online step by step from October 2026 and switches it off completely from 1 April 2027 (Microsoft announcement).

The Microsoft 365 and Exchange sources have not yet been checked with real tenants. Check permissions and settings against the Microsoft documentation.

Frequently asked questions

Contacts.Read or User.Read.All – which permission do I need?

Contacts.Read for contacts stored in mailboxes, for example the sales mailbox. User.Read.All for the tenant directory, that is colleagues with their phone numbers. Both are application permissions and need the consent of an administrator.

Are the contacts transferred to a CallerHub cloud?

No. CallerHub runs on your own Windows computer or server, reads the contacts through Microsoft Graph and keeps the phone number list in memory only. There is no cloud service and no CallerHub account.

What happens when the client secret expires?

Then the sign-in at Microsoft fails. The most recently loaded phone number list stays in use; the state of the data source shows the error. Enter a new secret in good time.

Does CallerHub also evaluate calls from Microsoft Teams?

Yes. For call analytics, CallerHub reads the call records of Teams Phone through Microsoft Graph, with an app registration in Entra ID and the permission CallRecords.Read.All.

Try it

Test it with your own data.

Try the full edition for 30 days: choose “Request trial …” in CallerHub and the trial key arrives by e-mail. The setup wizard guides you through data source, phone system and test lookup. After that, CallerHub continues as the free basic edition without losing settings or data.