Integração com Google Agenda
Configuração da Integração com o Google Agenda
1. Configurar a Tela de Permissão OAuth
No menu lateral esquerdo do Google Cloud Console, acesse “APIs e Serviços” e selecione “Tela de permissão OAuth”.
Clique em “Começar” para iniciar a configuração do projeto.
Preencha as informações solicitadas:
- Nome do aplicativo: Informe o nome da clínica ou outro nome de sua preferência.
- E-mail de contato: Informe um endereço de e-mail válido.
- Público: Selecione a opção “Externo”.
- Dados de contato: Informe o endereço Gmail do profissional que utilizará a integração.
Após preencher todos os campos, conclua esta etapa.
2. Criar um Cliente OAuth
Clique em “Criar um cliente OAuth”.
Configure os seguintes dados:
- Tipo de aplicativo: Selecione “Aplicação da Web”.
- Nome: Informe novamente o nome da clínica.
- Origens JavaScript autorizadas: Adicione a URL do sistema da clínica.
- URLs de redirecionamento autorizadas: Informe a mesma URL do sistema, acrescentando ao final:
/oauth/google/callback
Clique em “Criar” para finalizar.
3. Definir os Escopos da API
No menu lateral, clique em “Adicionar e remover escopos”.
Na barra de pesquisa, procure por “Google Calendar API” e selecione os seguintes escopos:
auth/calendarauth/calendar.events
Após selecionar os escopos necessários, salve as configurações.
4. Adicionar Usuários de Teste
No menu lateral, acesse “Público-alvo” e localize a seção “Usuários de teste”.
Adicione um novo usuário informando o endereço de e-mail do profissional que utilizará a integração.
Importante: O endereço informado deve ser uma conta Gmail válida.
5. Gerar o Arquivo JSON de Integração
No menu lateral, clique em “Clientes”.
Na seção “Chaves secretas de clientes”, localize o cliente criado e realize o download do arquivo JSON.
Guarde este arquivo, pois ele será utilizado na configuração do sistema da clínica.
6. Configurar o Sistema da Clínica
Acesse o sistema da clínica utilizando um usuário com perfil de gerente.
Em seguida:
- Acesse o menu “Dados da Clínica”.
- Localize a opção “Integração com o Google Agenda”.
- Faça o upload do arquivo JSON baixado anteriormente.
- Salve as alterações.
7. Habilitar a Integração para os Profissionais
No cadastro de cada profissional de saúde, habilite a opção “Integração com o Google Agenda”.
Importante: O e-mail cadastrado para o profissional deve ser uma conta Gmail.
8. Conectar ao Google Agenda
Acesse o sistema com o usuário do profissional de saúde.
Dentro da agenda:
- No menu lateral esquerdo, clique em “Conectar ao Google Agenda”.
- Será exibida a tela de autenticação do Google.
- Faça login utilizando a conta Gmail cadastrada.
- Autorize o acesso clicando em “Continuar”.
Após a conclusão da autenticação, o sistema retornará automaticamente para a agenda e exibirá uma mensagem de confirmação.
9. Testar a Sincronização
Com a integração concluída, realize um teste de sincronização:
- Acesse o sistema como profissional, gerente ou secretária.
- Crie um novo evento na agenda do profissional (consulta, compromisso ou atendimento).
- Verifique se o evento foi sincronizado automaticamente com o Google Agenda.
A integração garante que compromissos e consultas permaneçam sincronizados entre o sistema e o Google Agenda, reduzindo falhas de comunicação e contribuindo para uma gestão mais eficiente da agenda da clínica.
