Integração do Google Workspace para o Sistema Telefônico 3CX

Introdução

O 3CX pode se integrar ao Google para fornecer a seguinte funcionalidade:

• Sincronizar contas de Usuário do Google Workspace.
• Sincronização dos contatos pessoais do Usuário com a agenda telefônica pessoal do 3CX (uma via).
• O status do Perfil 3CX é alterado com base nos eventos do Google Calendar, ou seja, se você estiver em uma reunião, seu status será definido como ocupado.
• Crie e use o Google Buckets para o Armazenamento Remoto do Sistema Telefônico 3CX.
• Use o Google Speech para transcrição de gravações e correios de voz.
• Use contas do Google Workspace para enviar e-mails.
• Ativação do Google SSO para permitir que os usuários façam login no Cliente Web usando suas credenciais do Google (precisa ser configurado separadamente no Google Project criado).
• Ativação do Google ReCaptcha para proteção contra ataques automatizados e abusos.

Configuração da Integração com o Google

Etapa 1: Função de Super Admin no Espaço de Trabalho

Para que a integração funcione, o usuário de login deve ter a Função de Super Admin no espaço de trabalho. Siga as etapas abaixo para conceder a Função de Super Admin ao usuário que você usará para autenticar a Integração do Google em seu PABX.

1. Faça login em https://admin.google.com/
2. Navegue até Directory > Users (Diretório > Usuários).

3. Edite o usuário que deseja elevar para Super Admin e abra a seção Funções e Privilégios de Administrador.
4. Ative a função de Super Admin para o usuário que você usará para autenticar a Integração com o Google e clique em Save (Salvar).

Etapa 2: Funções no Nível da Organização no Google Console

Além disso, caso pretenda ativar os recursos a seguir, você precisará atribuir a função IAM de Administrador da Conta de Faturamento ao seu usuário no Google Console.

• Use o Google Cloud para armazenamento remoto do Sistema Telefônico 3CX.
• Use Transcrição para gravações e correios de voz.

Para fazer isso, siga estas etapas:

1. Façalogin em https://console.cloud.google.com
2. Verifique se você está operando no nível da Organização. Você pode selecionar a organização clicando no menu suspenso na parte superior da página.
3. No menu de navegação à esquerda, vá para IAM & Admin > IAM.
4. Clique em Grant Access (Conceder Acesso).
5. No painel direito aberto > Campo New Principals, adicione o endereço de e-mail do usuário que está autenticando a integração com o Google.
6. Em Assign Roles (Atribuir Funções), adicione a função Billing Account Administrator (Administrador da Conta de Cobrança), conforme mostrado na captura de tela.
7. Salvar.

Etapa 3: Desativar a Aplicação da Criação da Chave da Conta de Serviço - Se Aplicável

Dependendo da data de criação de sua conta do Google, a política organizacional disableServiceAccountKeyCreation pode ser aplicada por padrão, proibindo a Criação de Chaves de conta para sua conta.

Nesse caso, você pode receber uma reclamação de erro sobre a criação de chaves não permitida durante a integração do Google ao seu PABX.

Para superar isso, talvez seja necessário interromper a aplicação dessa política usando as etapas a seguir:

Observação: Para gerenciar as Políticas da Organização na sua conta do Google, é necessário fazer login no Console do Google com um usuário que tenha a função de Administrador de Políticas da Organização.

1. No Console do Google, navegue até IAM & Admin > Organization Policies.
2. Procure por iam.disableServiceAccountKeyCreation se estiver usando a versão antiga da restrição ou iam.managed.disableServiceAccountKeyCreation se estiver usando a nova versão da restrição.
3. Abra Disable service account key creation e clique em Manage Policy.
4. Em Policy Source Selecione Override parent’s policy.
5. Em Rules Adicione uma regra com Enforcement = Off.
6. Clique em Set Policy.

Etapa 4: Integrar o PABX ao Google

1. No Console do Admin do PABX, navegue até Integrações > Google e clique em Configurar.

2. Você será direcionado para a página de integração a seguir. Selecione todos os recursos necessários que planeja usar e clique em Connect (Conectar).

3. Autentique-se usando o usuário ao qual você deu todas as funções e permissões relevantes nas etapas anteriores quando solicitado a fazer login na sua Conta do Google.
4. Se solicitado, selecione All (Todos) para permitir que o 3CX acesse os recursos necessários e clique em Continue (Continuar).

5. Durante o processo de autenticação (Somente se for o primeiro login de um novo usuário), caso receba a mensagem sobre a aceitação dos termos de serviço, siga estas etapas. Se você não receber essa mensagem, pule para a etapa 9 abaixo.

6. Navegue até https://console.developers.google.com/terms/appsadmin.
7. Você deve ter recebido uma solicitação para aceitar os termos de serviço.

8. Clique em Accept (Aceitar) e repita o processo de autenticação na etapa 4.2 acima.
9. Quando a autenticação for concluída, você verá a seguinte página.

10. Copie o ID do Cliente gerado e clique no link para Abrir a Delegação em todo o domínio no Painel do Admin.
11. Clique em Add New (Adicionar Novo) em API Clients (Clientes da API), forneça o ID do Cliente que você copiou acima e preencha todos os valores de escopos do OAuth listados na tela anterior (copie-os diretamente da página).
12. Quando terminar, Clique em Authorize (Autorizar).

13. Clique no botão Voltar na tela anterior e você será redirecionado para o Console do Admin PABX, onde a integração do Google Workspace será exibida conforme configurada, fornecendo a ID do Projeto gerada pelo processo acima.

Ativação da Sincronização

Depois de finalizar a Integração do Google com o PABX, você pode prosseguir com a sincronização dos usuários do Google para o 3CX:

1. No Console do Admin do 3CX, vá para Usuários e clique em Google.
2. Ative Sync Google Users para sincronizar usuários do Google para o 3CX. A sincronização é unidirecional (Google para 3CX) e ocorre imediatamente quando você salva a configuração e, em seguida, uma vez por dia, durante a noite.
3. É possível definir um número de ramal inicial a ser atribuído aos usuários importados do Google. Caso contrário, ele usará o primeiro ramal disponível.
4. Não é necessário sincronizar todos os usuários. É possível excluir determinados usuários ou especificar apenas um conjunto específico de usuários para sincronização. Clique no botão Add para configurar.

Selecione Opções de Sincronização

Depois de ativar a sincronização de usuários, você pode selecionar o que sincronizar para os usuários importados do Google

1. Ative o SSO para permitir que os usuários façam login no cliente Web usando suas Credenciais do Google (precisa ser configurado separadamente. Veja como aqui).
2. Sincronize as Fotos de Usuário do Google com o 3CX como um Avatar ativando Sync user photo.
3. Você pode ativar a opção Sync Personal Contacts (Sincronizar Contatos Pessoais), que sincronizará os Contatos do Usuário do Google com a Agenda Telefônica Pessoal do 3CX. Essa é uma sincronização unidirecional. Os contatos precisam ser gerenciados e atualizados pelo Google.
4. Ative Use calendar events as presence (Usar eventos do calendário como presença) para atualizar automaticamente o status dos usuários do 3CX com base em suas reuniões agendadas no Google Calendar. Portanto, se você estiver em uma reunião agendada, seu telefone não tocará. No final da Entrada do Google Calendar, o 3CX muda o perfil de volta para o status anterior. Se um perfil 3CX Business Trip/Lunch for selecionado, as alterações nas informações do calendário serão ignoradas.

O mapeamento dos Tipos de Reunião do Google Calendar para os Perfis do 3CX é o seguinte:

• Event > Do Not Disturb (Evento > Não Perturbe)
• Focus Time > Do Not Disturb (Hora do Foco > Não Perturbe)
• Out of Office > Away (Fora do Escritório > Ausente)

Recursos Adicionais

Google Cloud para Armazenamento Remoto

Configurando a integração do Google em seu 3CX, se receber as permissões apropriadas durante o processo de configuração, o 3CX criará automaticamente um bucket do Google para seu projeto do Google Cloud e definirá as configurações de Armazenamento do 3CX de acordo.

Then you can just navigate to Admin Console > System > Storage and select which data you want to store on this remote Google Location. You can select to store remotely your Chat Files, Faxes, Recordings, Voicemails and Backups as needed.

Em seguida, basta navegar até Admin Console > System > Storage e selecionar os dados que deseja armazenar nesse Local remoto do Google. Você pode optar por armazenar remotamente seus Arquivos de Chat, Faxes, Gravações, Correios de voz e Backups, conforme necessário.

Google Speech para Transcrição

Se as permissões relevantes forem selecionadas, você poderá ativar a transcrição do Google Speech usando a Configuração do Google criada automaticamente pelo processo de integração.

Depois de finalizar a Integração com o Google e configurar o armazenamento no 3CX, basta navegar até Console do Admin > Integrações > Transcrição e ativar a transcrição usando o Google Speech para seu Idioma preferido.

Use o Google Workspace para Enviar E-mails

Com os direitos adequados durante o processo de integração, o 3CX configurará automaticamente as Configurações de E-mail do Sistema para usar a conta integrada do Google Workspace para enviar E-mails do sistema.

Google ReCaptcha

Depois de configurar a Integração com o Google com a permissão relevante durante o processo de configuração, você pode ativar o Google ReCaptcha no Console do Admin > Integrações > Google para ser executado em segundo plano, protegendo o 3CX contra ataques automatizados e abusos.

Informações Técnicas & FAQ

Tempo Real vs. Sincronização Diária

Os dados a seguir são sincronizados em tempo real com as alterações no Google:

• Primeiro Nome do Usuário
• Sobrenome do Usuário
• Foto do Usuário
• Telefone Comercial do Usuário
• Novo usuário criado no workspace
• Suspender/excluir Usuário em Workspace > Desative a Extensão 3CX
• Cancelar a Suspensão do Usuário em Workspace > Ative a Extensão 3CX
• Eventos do calendário

No restante dos Dados em que não ouvimos alterações ao vivo, o PABX sincronizará uma vez por dia. A sincronização diária é controlada pelo parâmetro GW_SYNC_TIME. Ele armazena a hora do dia em um formato de 24 horas: HH:MM:SS, em que o PABX sincronizará novamente todos os dados do Google.

Status de Sincronização do Calendário

A criação de uma entrada no Google Calendar sincronizará a presença do usuário da seguinte forma:

• Event > DND (Evento > Não Perturbe)
• Out of Office > Away (Fora do Escritório > Ausente)
• Focus Time > DND (Hora do Foco > Não Perturbe)

Sincronização de Dados de Usuários e Contatos

Para usuários sincronizados, sincronizamos as seguintes informações do Google:

• Primeiro Nome
• Último Nome
• E-mail
• Telefone (Comercial) para o Celular do usuário no 3CX
• Foto

Para contatos sincronizados, sincronizamos as seguintes informações do Google:

• Primeiro Nome
• Último Nome
• Foto
• Empresa
• Título
• Celular
• Celular2
• Início
• Negócios
• Negócios2
• E-mail
  

Para sincronizar adequadamente essas informações de contato, é necessário marcá-las no Google Contacts, conforme mostrado na captura de tela abaixo.

Configuração Existente do Google Storage

Caso você já tenha o Google Storage ativado, durante o processo de integração, o assistente o informará e não o reconfigurará para você.

Limitações e Problemas Conhecidos

• Os contatos da empresa não existem
• O Gmail tem um tamanho máximo de anexo de 25 Mb por mensagem
• Não há como ouvir alterações em contatos pessoais
• A criação de contatos do Cliente Web para o Google estará disponível em uma versão futura

Veja Também

• Configuração do Logon Único do Google SSO
• Como Integrar seu PABX ao Microsoft 365 | 3CX 

Última Atualização
Este documento foi atualizado pela última vez em 19 de fevereiro de 2025
https://www.3cx.com.br/docs/manual/google-workspace/