Integração Google Calendar & Google Meet
A integração do MentoraOS com o Google Calendar (Google Agenda) e o Google Meet permite que professores sincronizem suas aulas automaticamente com seus calendários pessoais ou corporativos do Google e gerem links oficiais de videochamadas do Google Meet com um único clique.
1. Como Funciona a Integração?
| Recurso | Benefício para a Escola e Docentes |
|---|---|
| Sincronização em Tempo Real | Toda aula criada, reagendada ou cancelada no MentoraOS é espelhada automaticamente na sua agenda do Google. |
| Geração Automática de Google Meet | Criação instantânea de salas virtuais seguras anexadas ao evento no calendário e visíveis para alunos e professores no portal. |
| Processamento Assíncrono com Fila | As aulas são salvas instantaneamente na plataforma sem travar ou aguardar a resposta da rede externa. |
| Badges de Confirmação | Acompanhamento visual transparente do status de sincronização (Pendente, Sincronizado, Erro na agenda). |
Fonte Única de Verdade
O calendário do MentoraOS é sempre a fonte canônica de verdade sobre horários, turmas e planos pedagógicos. O Google Calendar atua como um espelho de notificação e ponto de entrada rápido no celular e computador.
2. Passo 1: Habilitação pela Gestão Escolar
Antes de qualquer professor conectar sua conta, a escola precisa habilitar a funcionalidade:
- Acesse as Configurações da Escola: Entre com um usuário administrador e vá em Administração → Configurações & Backup.
- Localize o Card Google Calendar: Verifique se o recurso consta como contratado na licença ativa da sua instituição.
- Ative a Sincronização: Ligue a chave "Habilitar Google Calendar para a instituição".
- Pronto! A partir deste momento, todos os professores terão o card de integração disponível em seus perfis.
Licença Contratada
Caso a licença da escola não contemple a integração com o Google Calendar, o card permanecerá visível porém bloqueado com uma mensagem informativa de indisponibilidade. Fale com a equipe comercial do MentoraOS para atualizar seu plano.
3. Passo 2: Conexão da Conta Google pelo Professor
Cada professor decide se deseja ou não sincronizar suas aulas e conecta sua própria conta do Google:
- Abra o Perfil do Docente: No canto superior direito, clique no seu nome e selecione Meu Perfil.
- Localize o Card Google Calendar: Role até a seção de integrações.
- Ative a Opção: Marque a caixa de seleção "Ativar Google Calendar neste perfil".
- Inicie o Vínculo: Clique no botão azul "Conectar conta Google".
- Autorize no Google:
- Faça login com a conta Google onde você deseja receber as aulas.
- Conceda as permissões solicitadas para ver/editar eventos da sua agenda (
calendar.events) e visualizar seu e-mail (userinfo.email). - Se aparecer a tela informativa "O Google não verificou este app", clique em Avançado (canto inferior esquerdo) e depois em Acessar MentoraOS (não seguro) para concluir o consentimento.
- Confirmação: Você será redirecionado de volta para o MentoraOS exibindo Status: Conectado e o e-mail da conta Google vinculada.
4. Passo 3: Agendando Aulas com Google Meet
Com a conta conectada, o agendamento de aulas passa a contar com suporte nativo à agenda externa:
- No menu do professor, acesse Calendário / Aulas e clique em Agendar Aula.
- Selecione a turma, a data e o horário do encontro.
- Por padrão, as seguintes opções virão marcadas:
- Sincronizar com Google Agenda: Cria o evento na sua agenda do Google.
- Gerar link do Google Meet: Cria automaticamente a sala de videoconferência.
- (Opcional) Se você utilizar outra ferramenta de videoconferência (ex: Zoom, Microsoft Teams), basta colar o link manual no campo correspondente; o sistema desabilitará automaticamente a criação do Google Meet.
- Clique em Salvar Aula.
5. Entendendo os Badges de Status da Aula
No card da aula agendada, o MentoraOS exibe badges visuais indicando o ciclo de vida da sincronização:
flowchart LR
A["Aula Salva"] --> B["Badge: Pendente (Laranja)"]
B --> C["Worker processa em segundo plano"]
C -- Sucesso --> D["Badge: Sincronizado (Verde) + Link Meet"]
C -- Falha Esgotada --> E["Badge: Erro na agenda (Vermelho) + Botão Reenviar"]| Badge | Significado | Ação Necessária |
|---|---|---|
Pendente (Laranja) | A aula foi salva com sucesso no MentoraOS e está na fila para envio ao Google Calendar. | Nenhuma. O processamento ocorre em segundo plano em instantes. |
Sincronizado (Verde) | O evento foi criado na sua agenda do Google e o link do Google Meet está ativo. | O link do Meet já está acessível para você e seus alunos. |
Erro na agenda (Vermelho) | Ocorreu uma falha temporária ou o acesso do Google foi revogado. | Clique no botão Reenviar para a agenda no card da aula. |
6. Dúvidas Frequentes & Solução de Problemas
Por que apareceu a mensagem 'O Google não verificou este app' no login?
Como o MentoraOS solicita acesso à criação de eventos na agenda e a verificação formal de marca pelo Google está em fase de homologação, o Google exibe esse aviso de cautela. Basta clicar em Avançado e selecionar Acessar MentoraOS (não seguro) para permitir o vínculo de teste com total segurança.
Meus alunos precisam conectar contas Google?
Não. Somente o professor vincula sua conta Google para gerar as salas e os eventos. Os alunos visualizam o link do Google Meet diretamente pelo portal do aluno ou pelo bot do Telegram (@MentoraOSBot).
O que acontece se eu remarcar uma aula no MentoraOS?
O MentoraOS enviará automaticamente uma atualização para o Google Calendar, alterando o horário do evento já existente sem mudar o link do Google Meet.
Como trocar ou desconectar minha conta do Google?
Acesse Meu Perfil, localize o card do Google Calendar e desmarque o checkbox "Ativar Google Calendar neste perfil" ou clique em Desconectar conta. Seus eventos futuros não serão mais enviados até uma nova reconexão.