Microsoft 365 e Exchange: contactos como nomes de chamadores
Muitos contactos são mantidos em caixas de correio do Microsoft 365 ou no diretório do tenant. As centrais telefónicas, no entanto, costumam perguntar via HTTP ou LDAP. Entre ambos, é preciso um serviço que leia os contactos através do Microsoft Graph e dê o nome à central telefónica.
Preparar o acesso ao Microsoft 365
O Microsoft Graph permite o acesso a contactos e utilizadores através de um registo de aplicação no Microsoft Entra ID (guia da Microsoft):
- No Entra ID, crie um novo registo em Registos de aplicações.
- Em Permissões de API, adicione uma permissão de aplicação para o Microsoft Graph:
Contacts.Readpara os contactos das caixas de correio ouUser.Read.Allpara o diretório do tenant. - Conceda o consentimento de administrador.
- Crie um segredo do cliente e anote a data de expiração.
Combine com a administração do Microsoft 365 que caixas de correio devem ser lidas. Anote o tenant (p. ex. company.onmicrosoft.com ou o ID do tenant), o ID do cliente e o segredo do cliente.
Com o CallerHub: a origem de dados Microsoft 365 (Graph)
- Em Origens de dados, escolha Adicionar origem de dados, selecione “Microsoft 365 (Graph)” como tipo, indique um nome e clique em Criar.
- Introduza o tenant, o ID do cliente e o segredo do cliente.
- Defina o que é lido: os contactos de determinadas caixas de correio (p. ex.
sales@company.com,reception@company.com) ou os utilizadores do tenant. - Testar ligação e, depois, Guardar e aplicar.
O CallerHub fornece então os nomes a todas as centrais telefónicas ligadas, juntamente com outras origens, como um CRM. Se um campo contiver mais de um número, p. ex. “Tel. 030 23125456, telemóvel 0171 3920012”, o CallerHub usa cada número válido separadamente.

Exchange Server local (EWS)
Para um Exchange Server na sua própria rede, o CallerHub lê os contactos através dos Exchange Web Services: endereço EWS (p. ex. https://mail.company.com/EWS/Exchange.asmx), caixas de correio e uma conta de utilizador com permissão sobre essas caixas de correio.
Para o Exchange Online, use a origem Microsoft 365 (Graph). A Microsoft bloqueia o EWS no Exchange Online gradualmente a partir de outubro de 2026 e desativa-o por completo a partir de 1 de abril de 2027 (anúncio da Microsoft).
As origens Microsoft 365 e Exchange ainda não foram verificadas com tenants reais. Confirme as permissões e as definições na documentação da Microsoft.
Perguntas frequentes
Contacts.Read ou User.Read.All – de que permissão preciso?
Contacts.Read para contactos guardados em caixas de correio, por exemplo a caixa de correio de vendas. User.Read.All para o diretório do tenant, ou seja, os colegas com os seus números de telefone. Ambas são permissões de aplicação e precisam do consentimento de um administrador.
Os contactos são transferidos para uma nuvem do CallerHub?
Não. O CallerHub é executado no seu próprio computador ou servidor Windows, lê os contactos através do Microsoft Graph e mantém a lista de números de telefone apenas em memória. Não há serviço na nuvem nem conta CallerHub.
O que acontece quando o segredo do cliente expira?
Nesse caso, o início de sessão na Microsoft falha. A última lista de números de telefone carregada continua em uso; o estado da origem de dados mostra o erro. Introduza atempadamente um novo segredo.
O CallerHub também analisa chamadas do Microsoft Teams?
Sim. Para a análise de chamadas, o CallerHub lê os registos de chamadas do Teams Phone através do Microsoft Graph, com um registo de aplicação no Entra ID e a permissão CallRecords.Read.All.
Teste com os seus próprios dados.
Experimente a edição Completa durante 30 dias: peça o período de teste no CallerHub e a chave de teste chega por e-mail. O assistente de configuração guia-o pela origem de dados, pela central telefónica e pela consulta de teste. Depois, o CallerHub continua como edição Básica gratuita, sem perder definições nem dados.