Integração da 3CX com o Office 365 por meio da API do Azure

A edição PBX 3CX v16 do Pro e Enterprise oferece total integração com aplicativos do Office 365. Em particular, implementado:

  • Sincronize usuários do Office 365 e extensões 3CX (usuários).
  • Sincronize contatos pessoais entre usuários do Office e seu catálogo de endereços pessoal 3CX.
  • Sincronize o status do calendário do usuário do Office 365 (ocupado) e o status da extensão 3CX.

Para fazer chamadas a partir da interface da web do aplicativo Office, a 3CX usa a extensão 3CX Click to Call para os navegadores Chrome e Firefox . Você também pode usar atalhos de teclado no aplicativo 3CX para Windows .

Para começar, você precisará de uma assinatura do Office 3CX e credenciais de administrador do portal do Office com privilégios de Administrador Global.

Algumas assinaturas do Office 365 têm pouca ou nenhuma integração com o 3CX:

  • Assinaturas sem gerenciamento de usuários, ou seja, todas as assinaturas domésticas.
  • As assinaturas sem o Exchange não podem sincronizar contatos e calendário (Office 365 Business e Office 365 Pro Plus).

Os servidores do Office 365 devem ter uma conexão direta com o servidor 3CX para relatórios de status em tempo real. Se não for possível fornecer uma conexão permanente, o 3CX ainda executará a sincronização diária.

Observe que a sincronização é apenas uma maneira - do Office 365 ao 3CX. Para uma sincronização bem-sucedida, os usuários do Office 365 devem ter o atributo "UserType" definido como "Membro" (definido no Active Directory). Se um usuário sincronizado do Office 365 for excluído ou modificado pela interface 3CX, ele retornará ao estado anterior durante a próxima sincronização manual ou automática.

Aplicativo de autenticação do Microsoft Azure




A primeira etapa para conectar a integração do Office 365 é criar um aplicativo personalizado em sua conta para autorizar a integração.

  1. Na interface de gerenciamento 3CX, vá para Configurações - Office 365 - guia Configurações - seção Etapa 3 e copie o URL de redirecionamento.
  2. Faça logon no portal do Office 365 com credenciais de Administrador Global e acesse a página Registro do Aplicativo Microsoft Azure .
  3. Clique em Novo registro e insira o nome do aplicativo, por exemplo, 3CX PBX Office 365 Sync App.
  4. Na seção Tipos de conta suportados, deixe a opção padrão Contas apenas neste diretório da organização
  5. Na seção URI de redirecionamento (opcional), especifique o tipo da Web e insira o URI de redirecionamento na seção da interface 3CX: Configurações> Integração com o Office 365> guia Configurações> seção Etapa 3. Plataforma e permissões, por exemplo, company.3cx.eu : 5001 / oauth2office2
  6. Clique em Registrar e o aplicativo será criado.
  7. A página de configurações do aplicativo criado é aberta. Copie o valor do Identificador de aplicativo (cliente) e cole-o no campo correspondente na interface de gerenciamento 3CX, Configurações> Integração com o Office 365> guia Configurações> Etapa 1. Configure o ID do aplicativo.



Chaves de autenticação


Agora você precisa estabelecer uma relação de confiança de chave pública entre o sistema 3CX v16 e o ​​aplicativo que você criou no portal do Office 365.

  1. Na interface 3CX (Configurações> Integração com o Office 365> guia Configurações), clique em Gerar um novo par de chaves e salve a chave public_key.pem.
  2. Vá para a página de configurações do aplicativo na seção Certificados e segredos. Clique em Enviar certificado e faça upload da chave gerada.




Permissões do aplicativo


A etapa final da configuração é definir as permissões da API na seção Permissões da API. Essas permissões determinam como o sistema 3CX acessa sua conta do Office 365.

  1. Vá para a seção Permissões da API, clique em Adicionar permissão e selecione Microsoft Graph.
  2. Adicione permissões de API na seção Permissões do aplicativo: Calendários> Calendários.Leia, Contatos> Contatos.Leia, Diretório> Directory.Read.All e clique em Adicionar Permissões.
  3. Na seção Conceder consentimento, clique em Conceder consentimento do administrador para ... para ativar as permissões.
  4. Aguarde cerca de 10 minutos para que as alterações entrem em vigor corretamente.
  5. Alterne para a interface 3CX e, na seção Integração com o Office 365, clique em Entrar no Office 365. Confirme as permissões para o aplicativo criado e a conexão entre os sistemas será estabelecida.



Recursos de sincronização


A sincronização entre o 3CX e o Office 365 é configurada em três guias:

  • Sincronização de usuário - os usuários do Office 365 são sincronizados com os usuários do 3CX (números de ramal). Na interface de gerenciamento 3CX, os usuários sincronizados são hospedados em um grupo organizacional do Azure AD.
  • Sincronização de contatos - os contatos pessoais do Office 365 são sincronizados com o seu catálogo de endereços 3CX. O usuário vê esses contatos nos aplicativos 3CX para todas as plataformas.
  • Sincronização de calendário - Altere automaticamente o status da extensão 3CX com base na sua carga de trabalho no calendário do Office 365:

Depois que o evento é concluído no calendário do Office 365, o status do usuário 3CX também é sincronizado e retornado ao seu estado anterior.

Todos os itens de sincronização podem ser configurados para todos os usuários do Office 365 e para usuários selecionados.



Isso completa a integração.

Source: https://habr.com/ru/post/pt452838/


All Articles