Integração com o Microsoft Entra ID

Visão geral

A integração com o Microsoft Entra ID (antigo Azure Active Directory) conecta o Virtual-Call Cloud PABX ao diretório Microsoft 365 da sua organização. Após a configuração, três recursos principais ficam disponíveis: provisionamento automático de usuários e ramais a partir do diretório Entra ID, Single Sign-On (SSO) para o Virtual-Call UC Cliente e sincronização de contatos do Outlook para os UC Clientes dos usuários.

A integração é especialmente útil para organizações que gerenciam seus usuários de forma centralizada no Microsoft 365, pois elimina a necessidade de criar e manter ramais manualmente no PABX.

Recursos da integração

• Sincronização de usuários: Usuários e grupos do Microsoft Entra ID são sincronizados automaticamente com o Cloud PABX. Ramais são criados e atribuídos automaticamente para novos usuários. Alterações feitas no Entra ID (nome, e-mail, cargo) são refletidas automaticamente no PABX.
• Single Sign-On (SSO): Usuários sincronizados podem fazer login no Virtual-Call UC Cliente usando suas credenciais Microsoft — sem necessidade de uma senha separada do PABX.
• Sincronização de contatos do Outlook: Contatos pessoais do Outlook e contatos de caixas de correio compartilhadas são sincronizados com o PABX e disponibilizados no diretório de contatos do UC Cliente.
• Sincronização de presença do Microsoft Teams: O status de presença do Teams dos usuários pode ser sincronizado com o PABX.

Pré-requisitos

• Tenant Microsoft Entra ativo (assinatura Microsoft 365)
• Conta Microsoft com privilégios de Administrador Global no tenant do Entra
• Acesso de administrador ao portal web do Virtual-Call Cloud PABX

Visão geral da configuração

A integração requer etapas tanto no Microsoft Entra admin center quanto no portal web do Cloud PABX. O processo é dividido em quatro partes:

Parte 1: Registrar o aplicativo no Microsoft Entra

1. Acesse o portal web do Cloud PABX como administrador.
2. Navegue até Integrações > Microsoft Entra ID.
3. Anote os URIs de redirecionamento exibidos na página — você precisará deles nas próximas etapas.
4. Em uma nova aba do navegador, acesse o Microsoft Entra admin center e faça login com sua conta de Administrador Global.
5. Acesse Aplicativos > Registros de aplicativos e clique em Novo registro.
6. Configure o registro do aplicativo:
   • Nome: Insira um nome descritivo (ex: "Virtual-Call PABX Integration")
   • Tipos de conta com suporte: Selecione Contas somente neste diretório organizacional
   • URI de redirecionamento: Selecione Web como plataforma e cole o URI de redirecionamento copiado do portal do Cloud PABX
7. Clique em Registrar.

Parte 2: Conceder permissões de API

1. No aplicativo recém-registrado, acesse Permissões de API.
2. Clique em Adicionar uma permissão e selecione Microsoft Graph.
3. Adicione as permissões necessárias para sincronização de usuários e acesso a contatos (Permissões de aplicativo). As permissões específicas necessárias estão listadas na página de configuração da integração no portal do Cloud PABX.
4. Clique em Conceder consentimento do administrador para aprovar as permissões para toda a organização.

Parte 3: Gerar um segredo do cliente

1. No aplicativo, acesse Certificados e segredos > Segredos do cliente.
2. Clique em Novo segredo do cliente.
3. Insira uma descrição e selecione um período de validade, depois clique em Adicionar.
4. Importante: Copie o Valor do segredo imediatamente — ele será exibido apenas uma vez.

Parte 4: Conectar o PABX ao Microsoft Entra ID

1. Retorne ao portal web do Cloud PABX e acesse Integrações > Microsoft Entra ID.
2. Insira os seguintes dados do aplicativo registrado:
   • ID do Tenant: Encontrado na página de Visão Geral do aplicativo
   • ID do Aplicativo (Client ID): Encontrado na página de Visão Geral do aplicativo
   • Segredo do Cliente: O valor do segredo copiado na etapa anterior
3. Clique em Salvar e depois em Testar Conexão para verificar se a conexão está funcionando.

Sincronização de usuários

Após o estabelecimento da conexão, configure quais usuários serão sincronizados:

1. No portal web do Cloud PABX, acesse Integrações > Microsoft Entra ID > Sincronização de Usuários.
2. Escolha o escopo da sincronização:
   • Todos os usuários: Sincronizar todos os usuários do tenant Entra
   • Grupos específicos: Sincronizar apenas usuários de grupos Entra selecionados
   • Filtro personalizado: Usar filtros avançados para definir quais usuários incluir
3. Configure como os ramais são atribuídos aos usuários sincronizados (numeração automática ou baseada em um atributo específico do Entra).
4. Clique em Salvar e depois em Sincronizar agora para executar a primeira sincronização.

As sincronizações subsequentes ocorrem automaticamente. Quaisquer alterações feitas nos usuários no Entra ID (adições, modificações ou exclusões) serão refletidas no PABX após a próxima sincronização.

Single Sign-On (SSO)

Após a integração ser conectada, você pode habilitar o SSO para que os usuários façam login no UC Cliente com suas credenciais Microsoft:

1. No portal web do Cloud PABX, acesse Integrações > Microsoft Entra ID > SSO.
2. Ative o botão Permitir Login SSO.
3. Certifique-se de que o URI de redirecionamento SSO foi adicionado ao aplicativo do Microsoft Entra (conforme descrito na Parte 1, etapa 3).
4. Clique em Salvar.

Após a ativação, os usuários verão a opção "Entrar com a Microsoft" na tela de login do UC Cliente.

Sincronização de contatos do Outlook

Para sincronizar os contatos do Outlook das caixas de correio dos usuários com o diretório de contatos do PABX:

1. No portal web do Cloud PABX, acesse Integrações > Colaboração.
2. Em Sincronização de Contatos do Microsoft Outlook, ative o botão.
3. Opcional: Ative a Sincronização de Contatos de Caixa de Correio Compartilhada e selecione quais caixas de correio incluir.
4. Clique em Salvar.

Solução de problemas

• O teste de conexão falha.
  Verifique se o ID do Tenant, Client ID e Segredo do Cliente foram inseridos corretamente. Certifique-se de que o segredo do cliente não expirou. Verifique se o consentimento do administrador foi concedido para todas as permissões de API necessárias.
• Os usuários não são sincronizados após salvar a configuração.
  Clique em Sincronizar agora para acionar uma sincronização imediata. Verifique o log de sincronização para obter detalhes sobre erros.
• O login SSO não funciona.
  Verifique se o URI de redirecionamento SSO foi adicionado corretamente aos URIs de redirecionamento do aplicativo Entra. O URI deve corresponder exatamente, incluindo barras finais.
• Usuários sincronizados não conseguem fazer login via SSO.
  Certifique-se de que o endereço de e-mail do usuário no Entra ID corresponde ao endereço de e-mail no ramal do PABX. A correspondência para o SSO é feita com base no endereço de e-mail.