Configuração do Google Console

Antes que o módulo Google Workspace possa se comunicar com os serviços do Google, você precisa criar um projeto no Google Cloud, ativar as APIs necessárias e gerar credenciais OAuth. Este guia orienta você em cada etapa.

Etapa 1: Criar um Projeto no Google Cloud

1. Acesse o Google API Console.
2. Clique em Select a project na barra de navegação superior e depois clique em New Project.
3. Insira um Nome do Projeto (ex.: "Integração Concord CRM").
4. Clique em Create e aguarde o projeto ser provisionado.
5. Certifique-se de que o novo projeto está selecionado no menu suspenso de projetos.

informação

Se você já possui um projeto no Google Cloud que deseja reutilizar, selecione-o na lista de projetos em vez de criar um novo.

Etapa 2: Ativar as APIs Necessárias

Com seu projeto selecionado, ative cada uma das seguintes APIs:

1. Navegue até APIs & Services → Library.
2. Pesquise e ative cada API individualmente:
   • Google Drive API
   • Google Docs API
   • Google Sheets API
   • Google Slides API

Para cada API:

1. Clique no nome da API nos resultados da pesquisa.
2. Clique em Enable.
3. Aguarde a confirmação antes de prosseguir para a próxima.

aviso

Todas as quatro APIs devem estar ativadas para que o módulo funcione corretamente. Se alguma API estiver faltando, o serviço do Google correspondente não estará acessível pelo CRM.

Etapa 3: Configurar a Tela de Consentimento OAuth

1. Navegue até APIs & Services → OAuth consent screen.
2. Selecione o Tipo de Usuário:
   • External -- Recomendado para a maioria das configurações. Permite que qualquer conta Google autorize.
   • Internal -- Disponível apenas para contas Google Workspace (pagas). Limita o acesso aos usuários da sua organização.
3. Clique em Create.
4. Preencha os campos obrigatórios:
   • App Name -- Um nome que os usuários verão durante a autorização (ex.: "Concord CRM").
   • User Support Email -- Seu endereço de e-mail de suporte.
   • Developer Contact Information -- Seu endereço de e-mail.
5. Clique em Save and Continue nas etapas de Scopes e Test Users (nenhuma alteração necessária para configuração básica).
6. Clique em Back to Dashboard na aba Summary.

Status de Publicação

Status	HTTPS Necessário	Observações
Testing	Não	Limitado a 100 usuários de teste; exibe aviso extra de consentimento
Production	Sim	Disponível para todos os usuários; seu site deve usar HTTPS

dica

Para configuração e testes iniciais, mantenha o aplicativo no modo Testing. Depois de verificar que tudo funciona, mude para Production para uma experiência de autorização sem interrupções.

Etapa 4: Criar Credenciais OAuth

1. Navegue até APIs & Services → Credentials.
2. Clique em Create Credentials → OAuth client ID.
3. Selecione Web application como tipo de aplicação.
4. Insira um Nome para a credencial (ex.: "Concord CRM OAuth").
5. Em Authorized redirect URIs, adicione o seguinte:

https://seudominio.com/google-workspace/callback

Substitua seudominio.com pelo domínio real onde seu Concord CRM está instalado.

6. Clique em Create.
7. Uma caixa de diálogo exibirá seu Client ID e Client Secret. Copie ambos os valores.

aviso

A URI de redirecionamento deve corresponder exatamente à URL da sua instalação do Concord CRM, incluindo o protocolo (HTTPS) e o caminho. Uma URI de redirecionamento incorreta causará falha na autorização.

Etapa 5: Conectar ao Concord CRM

1. Faça login no seu Concord CRM como administrador.
2. Navegue até as configurações do módulo Google Workspace.
3. Cole o Client ID e o Client Secret da etapa anterior.
4. Clique em Save & Authorize.
5. Uma tela de consentimento do Google aparecerá. Selecione sua conta Google e conceda as permissões solicitadas.
6. Você será redirecionado de volta ao Concord CRM. O status da conexão deve exibir Authorized.

informação

Se seu aplicativo Google Cloud estiver no modo Testing, você verá uma tela de aviso adicional durante a autorização. Clique em Continue para prosseguir. Este aviso não aparece no modo Production.

Solução de Problemas

Problema	Solução
"Error 400: redirect_uri_mismatch"	Verifique se a URI de redirecionamento no Google Cloud corresponde exatamente à URL do CRM
Autorização falha silenciosamente	Certifique-se de que todas as quatro APIs estão ativadas no projeto Google Cloud
"Access blocked: App not verified"	Mude para o modo Production ou adicione sua conta como usuário de teste
Conexão cai após algum tempo	Re-autorize nas configurações do módulo; verifique as configurações de atualização do token

Recomendações de Segurança

• Restrinja as credenciais OAuth ao seu domínio específico usando URIs de redirecionamento autorizados.
• Use HTTPS na sua instalação do Concord CRM para proteger os tokens OAuth em trânsito.
• Revise o acesso às APIs periodicamente no Google Cloud Console para garantir que nenhuma permissão desnecessária esteja concedida.
• Rotacione as credenciais se suspeitar que foram comprometidas.

Suporte

Se precisar de ajuda para configurar seu projeto Google Cloud, visite a Área de Tickets de Suporte da Themesic para assistência.