Integração com Microsoft

Introdução

O 3CX se integra ao Microsoft 365 para oferecer as seguintes funcionalidades:

• Sincronizar contas de usuário do Microsoft 365.
• Permitir que os usuários façam login no 3CX Web Client usando sua Conta Microsoft (SSO).
• Sincronizar os contatos pessoais dos usuários do M365 para a Agenda Pessoal do 3CX (unidirecional).
• Sincronizar os contatos da caixa de correio compartilhada do M365 para a Agenda da Empresa 3CX (unidirecional).
• Sincronizar a presença entre 3CX e Teams — as atualizações de presença são trocadas entre o 3CX e o Microsoft Teams.
• Enviar notificações por e-mail usando o M365.

A Integração com o M365 requer contas do Microsoft 365 com um plano de assinatura do Exchange, como:

• Microsoft 365 Business Basic, Standard or Premium
• Microsoft 365 F3, E3 or E5

Passo 1: Configurar Acesso ao Microsoft 365

Neste passo, configure sua conta do Microsoft 365 para permitir a sincronização com o 3CX, da seguinte forma:

• No Admin Console do 3CX, acesse "Admin → Integrações → M365"
• Clique no botão Configure (Configurar); você será redirecionado para https://integrations.3cx.com
• Clique no botão Connect (Conectar) e faça login na sua conta de administrador do Azure

• Marque a caixa de seleção Consent on behalf of your organisation (Consentir em nome da sua organização) para conceder as permissões solicitadas pelo Assistente 3CX MS 365; clique no botão Accept (Aceitar)
• O aplicativo será criado e você poderá prosseguir com a configuração da Integração M365; clique no botão Back (Voltar) para retornar ao Admin Console do 3CX.

Passo 2: Configurar Sincronização

Para sincronizar os usuários do Microsoft 365 para o 3CX:

• No Admin Console do 3CX, acesse "Admin → Usuários" e clique no M365
• Marque a caixa de seleção Sincronizar Usuários do Microsoft 365; observe que:

• a sincronização é unidirecional — do M365 para o 3CX
• a sincronização ocorre diariamente, durante a noite
• se você excluir um usuário do 3CX mas não do M365, o usuário reaparecerá no 3CX no dia seguinte
• se você excluir ou desativar um usuário do M365, o usuário permanecerá no 3CX e deverá ser removido manualmente
• a sincronização funciona para no máximo 650 usuários

• Para manter os usuários do M365 em um intervalo específico de ramais, você pode definir um número de ramal inicial:

• isso garante que ramais menores nunca sejam atribuídos a usuários importados do M365
• se não for definido, o usuário importado do M365 receberá o primeiro ramal disponível

Configurar o que sincronizar

• Você pode Configurar o que sincronizar:

• Habilitar SSO para permitir que os usuários façam login no cliente web usando suas credenciais Microsoft
• Você pode Sincronizar Telefone do Escritório com a Identificação de Chamadas Efetuadas do 3CX para definir o número de escritório M365 do usuário como a Identificação de Chamadas Efetuadas do usuário no 3CX
• Você pode Sincronizar Foto do Usuário do M365 para usar como avatar do usuário no 3CX
• Você pode Sincronizar Contatos Pessoais do M365 para a agenda pessoal do usuário no 3CX; lembre-se de que:

• a sincronização é unidirecional (do M365 para o 3CX)
• os contatos dos usuários precisarão ser gerenciados e atualizados a partir do M365

Configurar quais usuários sincronizar

• Você pode Configurar Quais Usuários sincronizar:

• Selecione quais usuários do M365 incluir ou excluir da sincronização; clique no botão Selecionar Usuários para configurar
• Você pode Sincronizar apenas de departamentos selecionados. Clique no botão Selecionar Departamentos para configurar

• O Selecionar Departamentos exibirá a lista de departamentos obtida do M365; escolha os que deseja incluir e clique no botão OK
• usuários que não estejam nos departamentos selecionados não serão sincronizados
• lembre-se de que:

1. novos departamentos são criados com base nos nomes dos grupos do M365
2. os departamentos já existentes no 3CX NÃO são sobrescritos; se o nome do departamento M365 já existir no 3CX, um novo departamento será criado com um número incremental
3. se você configurou a integração M365 antes da versão 20 atualização 8 do 3CX, será necessário reconfigurar para obter todos os direitos necessários para esta funcionalidade

• Você pode escolher se deseja (ou não) Incluir Usuários Convidados

Passo 3: Sincronizar Presença entre 3CX e Teams

Você pode configurar Sincronização de Presença entre 3CX e Teams. Antes de ativar esta opção, lembre-se de que:

• Os usuários já estão sincronizados e adicionados conforme descrito acima no Passo 2
• Somente usuários do M365 com licença habilitada para o Teams (como Business Basic, Standard ou Premium) podem usar a sincronização de presença

Para ativar Sincronização de Presença:

• No Admin Console do 3CX, acesse "Admin → Usuários" e clique no M365
• Selecione a(s) direção(ões) de sincronização:

• 3CX para Teams; ou
• Teams para 3CX; ou
• Ambas as direções: 3CX para Teams e Teams para 3CX

• Ative a sincronização clicando no botão Authorize (Autorizar)

A seção Alterar Presença Padrão pode ser expandida para personalizar o mapeamento de status entre 3CX e Teams. As configurações padrão predefinidas geralmente são suficientes para o funcionamento correto; se você fizer alterações, certifique-se de evitar a criação de loops de status.

Passo 4: Sincronizar Agenda Telefônica

Para ativar a sincronização da Agenda Telefônica do M365 para o 3CX:

• No Admin Console do 3CX, acesse "Sistema → Agenda Telefônica" e clique no M365

• Clique no botão Selecionar Caixa de Correio para selecionar quais caixas compartilhadas incluir ou excluir da sincronização e clique no botão OK

Observe que todos os contatos nas “Pastas Conhecidas” (pastas padrão) são sincronizados.

Passo 5: Envio de E-mails via M365

Se você selecionou a opção Enviar e-mails via Microsoft 365 no Passo 1, o seu 3CX será configurado automaticamente para enviar e-mails pela sua conta M365.

Você pode personalizar o endereço de e-mail de origem para e-mails enviados pelo M365 acessando "Sistema → E-mail" no Admin Console do 3CX; o endereço de e-mail de origem deve:

• existir na sua conta M365
• ter licença para envio de e-mails

Explicações e Limitações da Sincronização

A seguir, explicamos algumas “pegadinhas” relacionadas à sincronização das quais os usuários talvez precisem estar cientes:

• 3CX ao Teams > On a Call - Você pode sincronizar o status “Em uma Chamada” do 3CX com o status “Em uma Chamada” do Teams. Quando você faz ou recebe uma chamada no 3CX, o cliente do Teams mostrará Ocupado > Em uma chamada.
• Teams ao 3CX > In a Call - O MS só envia o status Ocupado/Em Chamada depois que a chamada é atendida. Durante o estado de toque, nenhum status é enviado. Esse status só é enviado se você estava em Disponível antes da chamada. Se o status do seu Teams for Ocupado e você fizer uma chamada, mesmo depois que a chamada for atendida, o Teams não enviará o status Ocupado/Em Chamada.
• Disponível (Ocioso) - Se você estiver com o status Disponível no Teams e sair ou mover o aplicativo para segundo plano (celular), ocorrerá o seguinte:

• Após 5 minutos, o MS envia AvailableIdle:Inactive, e o Cliente Web 3CX muda para Available.
• Depois de mais 5 minutos, a MS envia Away:Away, e o Cliente Web muda para Away.
• Quando você reabre o aplicativo Teams, a MS envia Available:Available, e o Cliente Web volta para Available.

• Ocupado (Ocioso) - Se você estiver com o status Busy no Teams e sair ou mover o aplicativo para segundo plano (celular), ocorrerá o seguinte:

• Após 5 minutos, o MS envia BusyIdle:Busy, e o Cliente Web 3CX muda para DND.
• Após mais 5 minutos, a MS envia Offline:Offline, e o Cliente Web permanece em DND.
• Quando você reabre o aplicativo Teams, a MS envia Busy:Busy, e o cliente Web permanece em DND.

• Notificação de presença Offline:Offline - Essa notificação é ignorada porque está desativada na configuração. Quando você ativa o aplicativo Teams, recebemos da MS uma notificação de Busy:Busy e o Cliente Web permanece em DND.

• A definição temporária do status a partir do 3CX não sincronizará a presença com o Teams.
• Os Status do Custom1 / Custom2 3CX não são sincronizados com as equipes.
• Se você definir o status do 3CX como Custom1 / Custom2, as alterações no Teams não serão refletidas no 3CX.
• As alterações de status da Autoswitch serão sincronizadas com as equipes, desde que os status Custom1 / Custom2 não sejam usados em System > Options > Scheduler.
• A ativação da sincronização bidirecional (Teams para 3CX e 3CX para Teams) pode causar status conflitantes e um loop entre 3CX <> Teams, em que cada um pode substituir o status configurado. Por exemplo:

• 3CX ao Teams = Ausente > Ausente
• Teams ao 3CX = Ausente > Não Perturbe
• Isso fará com que as equipes mudem para Ausente e voltem para DND no 3CX. Para evitar isso, configure os dois lados para alternar para o mesmo status:
• 3CX ao Teams = Ausente > Ausente
• Teams ao 3CX = Ausente > Ausente

• A sincronização Teams > In a Call requer a sincronização de status Disponível para funcionar corretamente. Se "Disponível" não estiver sincronizado, atender ou fazer uma chamada no Teams mudará o Cliente Web 3CX para DND, mas nunca voltará para Disponível após o término da chamada.
• Teams ao 3CX > Status Disponível (Ocioso), Mesmo que esse status seja excluído (menu suspenso desmarcado), sair do cliente Teams fará com que a MS envie uma notificação Away:Away após 10 minutos. Como resultado, o status do 3CX mudará para Away, independentemente das configurações de sincronização.

Veja também

• Veja como integrar o 3CX com a API CRM.
• Configure o 3CX com o Microsoft Teams.
• Configuração do Logon Único do Google SSO
• Integração com o Google Workspace

Última Atualização
Este documento foi atualizado pela última vez em 29 de janeiro de 2026
https://www.3cx.com.br/docs/manual/microsoft-365/