Integração com Google Workspace

Visão Geral

A integração com o Google Workspace conecta o Cloud PABX da Virtual-Call ao diretório do Google Workspace (anteriormente G Suite) da sua organização. Após a configuração, ela realiza a sincronização unidirecional de usuários do Google Workspace para o PABX, criando e atribuindo ramais automaticamente, e permite que os usuários sincronizados façam login no cliente UC da Virtual-Call com suas credenciais do Google por meio de Single Sign-On (SSO).

Esta integração é ideal para organizações que utilizam o Google Workspace para gerenciar seus usuários e desejam eliminar o provisionamento manual de ramais e o gerenciamento de senhas separadas para o sistema telefônico.

O que a integração oferece

• Sincronização de usuários: Usuários do Google Workspace (usuários individuais, usuários de unidades organizacionais específicas ou grupos específicos) são sincronizados para o Cloud PABX. Os ramais são criados e atribuídos automaticamente para os usuários sincronizados.
• Dados de usuário sincronizados: Os seguintes campos são sincronizados do Google Workspace e só podem ser atualizados no Google (as alterações são refletidas no PABX no próximo ciclo de sincronização): nome, sobrenome, endereço de e-mail, número de celular, cargo.
• Gerenciamento automático de ramais: Quando um novo usuário é adicionado ao Google Workspace e se enquadra no escopo de sincronização, seu ramal no PABX é criado automaticamente. Quando um usuário é removido do Google Workspace, seu ramal pode ser excluído automaticamente.
• Single Sign-On (SSO): Os usuários sincronizados podem fazer login no cliente UC da Virtual-Call usando suas credenciais do Google — sem precisar de uma senha separada do PABX.

Pré-requisitos

• Uma conta do Google Workspace (edição Business ou Enterprise)
• Uma conta do Google com privilégios de Super Administrador na sua organização Google Workspace
• Acesso ao Google Cloud Console para criar um projeto e configurar credenciais OAuth
• Acesso de administrador ao portal web do Cloud PABX da Virtual-Call.

Visão geral da configuração

A integração requer etapas tanto no Google Cloud Console quanto no portal web do Cloud PABX. A conexão usa OAuth 2.0 para autenticação segura.

Parte 1: Obter URIs de redirecionamento do PABX

1. Faça login no portal web do Cloud PABX como administrador.
2. Acesse Integrações > Google Workspace.
3. Anote os URI(s) de Redirecionamento exibidos na página — você precisará deles ao configurar as credenciais OAuth no Google Cloud Console.

Parte 2: Configurar um projeto no Google Cloud

1. Abra o Google Cloud Console e faça login com sua conta de Super Administrador do Google Workspace.
2. Crie um novo projeto (ou selecione um existente).
3. No menu à esquerda, acesse APIs e Serviços > Tela de consentimento OAuth.
   • Selecione Interno como tipo de usuário (limita o acesso apenas à sua organização).
   • Preencha as informações obrigatórias do aplicativo (nome do app, e-mail de suporte, etc.) e clique em Salvar e continuar.
4. Acesse APIs e Serviços > Credenciais e clique em Criar credenciais > ID do cliente OAuth.
   • Selecione Aplicativo da Web como tipo de aplicativo.
   • Em URIs de redirecionamento autorizados, adicione o(s) URI(s) copiados do PABX na Parte 1.
   • Clique em Criar.
5. Após a criação, copie e salve o ID do cliente e o Segredo do cliente — você precisará deles na próxima etapa.

Parte 3: Ativar a API Admin SDK

1. No Google Cloud Console, acesse APIs e Serviços > Biblioteca.
2. Pesquise por Admin SDK API e clique em Ativar. Esta API é necessária para que o PABX possa ler dados de usuários e unidades organizacionais do seu diretório Google Workspace.

Parte 4: Conectar o PABX ao Google Workspace

1. Retorne ao portal web do Cloud PABX: Integrações > Google Workspace.
2. Insira os seguintes dados:
   • ID do Cliente: Do cliente OAuth criado no Google Cloud Console
   • Segredo do Cliente: Do cliente OAuth criado no Google Cloud Console
3. Clique em Autorizar. Você será redirecionado para a página de login do Google — faça login com sua conta de Super Administrador do Google Workspace e conceda as permissões solicitadas.
4. Após a autorização, você será retornado ao portal do PABX. O status da conexão deve aparecer como conectado.

Sincronização de usuários

Após a conexão ser estabelecida, configure quais usuários serão sincronizados:

1. No portal web do Cloud PABX, acesse Integrações > Google Workspace > Sincronização de Usuários.
2. Escolha o escopo de sincronização:
   • Todos os Usuários: Sincronizar todos os usuários da sua organização Google Workspace
   • Unidades organizacionais específicas: Sincronizar apenas usuários pertencentes às OUs do Google selecionadas.
   • Grupos específicos: Sincronizar apenas usuários pertencentes aos grupos do Google selecionados.
3. Configure a Regra de atribuição de ramal para definir como os números de ramal do PABX são atribuídos aos usuários sincronizados.
4. Clique em Salvar e depois em Sincronizar agora para realizar a primeira sincronização.

As sincronizações subsequentes ocorrem automaticamente. Alterações feitas nos usuários do Google Workspace são refletidas no PBX após o próximo ciclo de sincronização.

Single Sign-On (SSO)

Após a integração ser ativada, os usuários sincronizados podem usar suas credenciais do Google para fazer login no cliente UC da Virtual-Call:

• Na tela de login do cliente UC, selecione Entrar com o Google.
• O usuário é redirecionado para a página de login do Google. Após fazer login com suas credenciais do Google, ele é conectado automaticamente ao cliente UC.

Nenhuma configuração adicional de SSO é necessária — o SSO é ativado automaticamente assim que a integração com o Google Workspace está ativa.

Solução de problemas

• A autorização falha ou fica presa na tela de consentimento do Google.
  Certifique-se de que está fazendo login com uma conta de Super Administrador do Google Workspace. Verifique se o URI de redirecionamento no seu cliente OAuth do Google Cloud corresponde exatamente ao URI exibido no portal do PABX (incluindo qualquer barra final).
• Os usuários não são sincronizados após salvar a configuração.
  Clique em Sincronizar agora para acionar uma sincronização imediata. Certifique-se de que a API Admin SDK está ativada no seu projeto do Google Cloud. Verifique se a conta autorizada tem acesso para ler dados de usuários.
• Apenas alguns usuários aparecem após a sincronização.
  Verifique a configuração do escopo de sincronização. Usuários fora das unidades organizacionais ou grupos selecionados não serão incluídos. Certifique-se de que as OUs ou grupos selecionados contêm os usuários esperados no Google Workspace.
• O login SSO não funciona.
  Certifique-se de que o usuário foi sincronizado com sucesso (visível na lista de usuários do PABX). Verifique se a conta do Google do usuário está ativa e não está suspensa. O e-mail da conta do Google deve corresponder ao e-mail do ramal do usuário no PABX.