Integração 3CX com Office 365 via API Azure

As edições PBX 3CX v16 Pro e Enterprise oferecem integração total com aplicativos do Office 365. Em particular, é implementado o seguinte:

• Sincronização de usuários do Office 365 e extensões 3CX (usuários).
• Sincronização de contatos pessoais de usuários do Office e catálogo de endereços pessoal 3CX.
• Sincronização dos status do calendário do usuário do Office 365 (ocupado) e status do número de ramal 3CX.   

Para fazer chamadas a partir da interface web dos aplicativos Office, 3CX usa a extensão 3CX Clique para ligar para navegadores Chrome и Firefox. Você também pode usar atalhos de teclado em 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 integração limitada ou nenhuma integração com 3CX:

• Assinaturas sem gerenciamento de usuários, ou seja, todas as assinaturas “domésticas”.
• Assinaturas sem 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 seu servidor 3CX para transmitir status em tempo real. Se uma conexão persistente não for possível, o 3CX ainda realizará a sincronização diária.

Observe que a sincronização é realizada apenas em uma direção - do Office 365 para 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 através da interface 3CX, ele reverterá ao estado anterior durante a próxima sincronização manual ou automática.

Aplicativo de autenticação do Microsoft Azure

Primeira etapa de conexão Integração com Office 365 — criação de um aplicativo individual 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. Entre no portal do Office 365 com suas credenciais de administrador global e vá para Registros de aplicativos do Microsoft Azure.
3. Clique em Novo registro e especifique o nome do aplicativo, por exemplo, Aplicativo 3CX PBX Office 365 Sync.
4. Na seção Tipos de conta suportados, deixe a opção padrão Somente contas neste diretório da organização
5. Na seção Redirect URI (opcional), selecione o tipo Web e cole o URI de redirecionamento da seção da interface 3CX: Configurações > Integração com Office 365 > guia Configurações > Etapa 3. Seção Plataforma e permissões, por exemplo. empresa.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 App ID (Cliente) e cole-o no campo apropriado na interface de gerenciamento 3CX, Configurações > Integração com o Office 365 > guia Opções > Passo 1. Configure o ID do aplicativo.

Chaves de autenticação

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

1. Na interface 3CX (Configurações > Integração com Office 365 > guia Opçõ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 Carregar certificado e carregue a chave gerada.

Permissões de aplicativos

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

1. Vá para Permissões de API, clique em Adicionar permissão e selecione Microsoft Graph.
2. Adicione permissões de API em Permissões de aplicativo: Calendars > Calendars.Read, Contacts > Contacts.Read, Directory > Directory.Read.All e clique em Adicionar permissões.
3. Na seção Conceder consentimento, clique em Conceder consentimento do administrador para... para habilitar permissões.
4. Aguarde cerca de 10 minutos para que as alterações tenham efeito corretamente.
5. Mude 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.

Capacidades de sincronização

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

• Sincronização de usuários - Os usuários do Office 365 são sincronizados com os usuários 3CX (extensões). Na interface de gerenciamento 3CX, os usuários sincronizados são colocados no grupo organizacional Azure AD.
• Sincronização de contatos - Os contatos pessoais do Office 365 são sincronizados com o catálogo de endereços 3CX. O usuário vê esses contatos nos aplicativos 3CX para todas as plataformas.
• Sincronização de calendário - altera automaticamente o status de uma extensão 3CX dependendo se ela está ocupada no calendário do Office 365:

Após a conclusão de um evento no calendário do Office 365, o status do usuário 3CX também é sincronizado e retorna ao seu estado anterior.

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

Isso completa a integração.

Fonte: habr.com