Credenciais do Google e Sincronização
Visão Geral
O CRM possui a capacidade de sincronizar as reuniões de um usuário com seu Google Calendar. Esta é uma sincronização bidirecional, e alterações em qualquer uma das pontas da sincronização geram atualizações na outra.
Não há intermediários neste processo. Seus dados não passam por terceiros. É apenas sua instância do CRM e os servidores do Google.
Requisitos
Credenciais API Válidas
Para sincronizar as reuniões do usuário do CRM com o Google Calendar, o sistema deve possuir credenciais válidas salvas.
Essas credenciais são criadas no Console de Desenvolvedores do Google, baixadas como arquivo JSON e importadas para o CRM. Há instruções de como fazer isso mais adiante nesta página.
Acesso à Internet pelo Servidor do CRM
O servidor do CRM deve ter acesso à internet. Contudo, o servidor não precisa ser acessível publicamente. O usuário deve conseguir acessar tanto o Google quanto o CRM simultaneamente para autorizar o acesso ao calendário. Após essa autorização, a sincronização é executada periodicamente sem interação do usuário. O usuário não precisa estar logado no CRM para que a sincronização funcione.
Pelo Menos Uma Conta Google
Você precisará de uma Conta Google para criar as credenciais API e de uma conta para sincronizar. Podem ser a mesma conta se houver apenas um usuário. As credenciais API precisam ser geradas apenas uma vez, a partir de uma única conta. Essas credenciais podem ser usadas para sincronizar todos os usuários após eles autorizarem o acesso à sua conta. Podem ser contas genéricas @gmail.com ou qualquer nível de conta GSuite (Basic/Business/Enterprise).
Gerando e Instalando Credenciais Google
Gerando Credenciais
Certifique-se de estar logado em uma conta Google antes de prosseguir.
Acesse o Console de Desenvolvedores do Google
|
Clique no menu suspenso no topo da tela. |
|
|
Clique no botão 'New Project'. |
|
|
Dê ao projeto um nome descritivo, como 'CRM Google Sync', e clique em 'Create'. |
|
|
No topo da página, clique no dropdown ‘Select a project’… |
|
|
… depois clique no projeto que você acabou de criar. |
|
|
Agora você verá o projeto selecionado e uma mensagem informando que nenhuma API está habilitada. Clique no link ‘Library’ na mensagem. |
|
|
No campo de busca, digite “Calendar” e clique no resultado ‘Google Calendar API’. |
|
|
Clique no botão ‘Enable’. |
|
|
Com a API habilitada, vamos criar as credenciais. Clique no botão ‘Create credentials’. |
|
|
Configure as opções na seção 1 conforme indicado. Clique em ‘What credentials do I need?’ para continuar. |
|
|
Na Seção 2, dê um nome descritivo. Deixe ‘JavaScript origins’ em branco. Note que essa URL não precisa ser pública, somente acessível para o usuário que realizará a autorização da sincronização. Para ambiente de produção é fortemente recomendado usar HTTPS em um site público. |
|
|
Crie um nome descritivo novamente. Há mais opções em ‘More customization options’, mas não são necessárias para esta função. Clique em ‘Continue’. |
|
|
Clique no botão ‘Download’ e salve o arquivo .json. Usaremos esse arquivo posteriormente no CRM. Clique em ‘Done’ quando terminar. Isso é tudo o que precisamos para que todos os usuários possam sincronizar seus calendários. |
|
Instalando Credenciais
Faça login no CRM como usuário administrador.
Acesse ‘Administração’.
Role até a seção 'Google Suite'.
Clique em 'Google Calendar Settings'.
|
Note que está escrito ‘Unconfigured’. Isso significa que nenhum arquivo JSON está instalado. |
|
|
O sistema retornará ao menu 'Administração'. Entre novamente em 'Google Calendar Settings'. |
|
Se precisar instalar novas credenciais, basta fazer o upload novamente, o arquivo anterior será substituído.
Autorizando Acesso ao Calendário
Esta ação precisa ser realizada pelo usuário para habilitar a sincronização com o Google Calendar
|
Clique no menu abaixo do seu nome, no canto superior direito do CRM, e selecione ‘Profile’. |
|
|
Acesse a aba ‘Advanced’. |
|
|
Você verá o subtítulo ‘Google Account Synchronization’ no final da página. Se ele não aparecer, significa que o servidor do CRM não possui as credenciais Google instaladas. |
|
|
Se estiver logado em várias contas Google, será solicitado escolher qual deseja sincronizar. Caso contrário, será exibido o diálogo abaixo: |
|
|
Ao clicar em ‘Allow’, você será redirecionado de volta à página de perfil. Acesse novamente a aba ‘Advanced’ e deverá ver: |
|
Marque a opção ‘Enable Calendar Sync’ e clique em ‘Save’.
Pronto! Por padrão, a sincronização acontece a cada 15 minutos. Isso pode ser alterado pelo Administrador na configuração do Scheduler.
Problemas Conhecidos
Se o valor "google_calendar_sync_name" for alterado, isso causará a ressincronização de todas as reuniões. Isso acontece porque o Google entende que todas as reuniões atuais são itens novos e únicos no Calendário.
A melhor forma de evitar isso é não alterar o valor "google_calendar_sync_name" localizado no arquivo config.php.
Desabilitando a Sincronização do Google Calendar
Se desejar desabilitar completamente a sincronização com o Google Calendar ou reiniciar o token, faça o seguinte:
|
Desative a tarefa ‘Google Sync Calendars’ em Administração/Scheduler. |
|
|
Apague a linha do token do Google Cloud no arquivo |
|
Para resetar a autorização do Google, o usuário pode resetar suas configurações pessoais. Pode ser desnecessário se o token já foi apagado da configuração administrativa e a tarefa do scheduler está desativada.