A página de Conexões em /mentor/settings/connections é onde você vincula seu calendário e seus provedores de vídeo ao MoveMentors. Hoje existem três integrações: Google Calendar (com Meet), Apple Calendar e Zoom.
O que cada conexão faz
| Provedor | O que lê | O que escreve |
|---|---|---|
| Google Calendar e Meet | Sua disponibilidade no calendário que você escolher | Reservas de aulas online aparecem no seu calendário com um link do Google Meet |
| Apple Calendar | Sua disponibilidade do iCloud | Nada de volta para o iCloud (a API da Apple não permite como a do Google) |
| Zoom | Nada | Quando uma reserva é confirmada em uma aula configurada com Zoom, criamos uma reunião na sua conta Zoom |
Você pode conectar qualquer combinação. Se conectar Google e Zoom, poderá escolher por aula qual provedor hospeda a sessão.
Google Calendar e Meet
Vá para /mentor/settings/connections
A página de Conexões do seu painel de mentor.
Clique em 'Connect Google'
Você será redirecionado para a tela de consentimento OAuth do Google.
Escolha sua conta Google e conceda permissão
Pedimos dois escopos: ler eventos do calendário (para sua disponibilidade) e criar eventos (para reservas e links do Meet). Nada além disso.
Escolha um calendário (se tiver mais de um)
Por padrão usamos o principal. Se preferir um calendário "MoveMentors" dedicado, crie-o primeiro no Google Calendar e depois selecione-o na página de conexões.
Uma vez conectado, qualquer aula que você marcar como online vai gerar um link do Google Meet automaticamente quando um aluno reservar. O link aparece no e-mail de confirmação, na página de confirmação da reserva e no evento do Google Calendar daquela sessão.
Apple Calendar
A Apple não oferece OAuth para acesso a calendário de terceiros. Em vez disso, você gera uma "senha específica de app" na sua conta Apple ID e cola no MoveMentors. A autenticação de dois fatores no Apple ID precisa estar ativa antes de você criar senhas específicas de app.
Entre em appleid.apple.com
Use o mesmo Apple ID que você usa no iCloud Calendar.
Abra 'Login e Segurança'
Na barra lateral.
Clique em 'Senhas Específicas de App'
Se você não vê essa opção, a autenticação de dois fatores não está ativa. Ative primeiro (Ajustes → 'Segurança da Conta' → 'Autenticação de Dois Fatores') e volte.
Clique em 'Gerar uma senha específica de app'
Ou o botão '+'.
Marque como 'MoveMentors' e clique em Criar
A Apple pode pedir que você digite novamente sua senha do Apple ID para confirmar.
Copie a senha que a Apple mostra
Tem o formato
xxxx-xxxx-xxxx-xxxx. Você verá apenas uma vez, e a Apple não permite consultar de novo. Se perder, gere uma nova e revogue a anterior.Volte ao MoveMentors e vá para /mentor/settings/connections
Clique em 'Connect Apple'. Informe seu e-mail do Apple ID e a senha específica de app que você acabou de copiar. Clique em Connect.
Se a conexão falhar, os motivos mais comuns são:
- Formato de senha errado: precisa ser a senha específica de app no formato
xxxx-xxxx-xxxx-xxxx, não sua senha real do Apple ID. - Dois fatores não ativos: ver Passo 3.
- Senha expirada ou revogada: a Apple invalida as senhas específicas de app quando você troca a senha do Apple ID ou revoga manualmente. Gere uma nova.
Zoom
A integração Zoom do MoveMentors cria uma reunião Zoom na sua conta sempre que uma reserva é confirmada em uma aula configurada com Zoom como provedor de vídeo. Adicionar, usar e remover o app são todas ações iniciadas a partir do MoveMentors.
Adicionar Zoom (Connect)
Você precisa de uma conta Zoom
Uma conta gratuita funciona (limite de 40 minutos em reuniões em grupo). Um plano Pro pago remove esse limite. Cadastre-se em zoom.us se ainda não tiver conta.
Vá para /mentor/settings/connections e clique em 'Connect Zoom'
Você será redirecionado para a tela de consentimento OAuth do Zoom.
Conceda as permissões solicitadas
Três escopos: criar reuniões na sua conta (
meeting:write:meeting), ler detalhes de reuniões (meeting:read:meeting) e ler seu perfil básico (user:read:user) para que a informação do host fique correta. Nada além disso.Pronto
Você voltará ao MoveMentors com a linha do Zoom mostrando 'Connected as <seu nome>'.
Usar Zoom (por aula)
Para cada aula online que você criar, é possível escolher Google Meet ou Zoom como provedor de vídeo. Se você só conectou um dos dois, ele é usado automaticamente, sem seletor.
Quando um aluno reserva uma aula com Zoom, o MoveMentors:
- Cria uma reunião agendada na sua conta Zoom (tipo 2: agendada, com join-before-host ativo, sem sala de espera).
- Armazena a URL da reunião na reserva.
- Envia o link no e-mail de confirmação.
- Mostra a URL na página de confirmação do aluno e na sua página de gerenciamento da sessão.
Cada sessão de uma aula recorrente recebe sua própria reunião agendada.
Remover Zoom (Disconnect)
Vá para /mentor/settings/connections
A página de Conexões.
Clique em 'Disconnect' na linha do Zoom
Apagamos imediatamente os tokens criptografados do Zoom do nosso banco e paramos de criar novas reuniões.
Opcionalmente, revogue também no Zoom
Entre em marketplace.zoom.us → 'Manage' → 'Added Apps' → revogue MoveMentors. Isso remove nosso app da sua lista de apps instalados no lado do Zoom.
Reuniões passadas que já foram criadas na sua conta Zoom permanecem; não as apagamos retroativamente. Se quiser limpar, faça isso na sua conta Zoom.
Quais credenciais armazenamos
- Google: um refresh token OAuth e um access token. Criptografados em repouso com AES-256-GCM. Renovamos o access token automaticamente sem pedir suas permissões de novo.
- Apple: seu e-mail do Apple ID e a senha específica de app. Criptografados em repouso com AES-256-GCM. Usados para requisições CalDAV em
caldav.icloud.com. - Zoom: um refresh token OAuth e um access token. Criptografados em repouso com AES-256-GCM. O Zoom rotaciona o refresh token a cada refresh; re-persistimos a cada rotação.
Nada é registrado em texto claro, enviado por conexões inseguras, ou compartilhado com terceiros. Você pode revogar o acesso a qualquer momento nas configurações do provedor:
- Google: myaccount.google.com → Segurança → Apps de terceiros
- Apple: appleid.apple.com → Senhas Específicas de App → revogue a do MoveMentors
- Zoom: marketplace.zoom.us → Manage → Added Apps → revogue MoveMentors
O que sincroniza e quando
- Uma reserva é confirmada → link do Meet ou Zoom é gerado, evento adicionado ao calendário (para aulas online no Google), e-mail de confirmação sai
- Uma reserva é cancelada → evento removido do calendário (só Google; Apple é só-leitura do nosso lado)
- Horário de uma aula muda → evento no seu calendário se move (só Google)
- Você desconecta → eventos já criados permanecem no calendário; paramos de enviar novos; credenciais criptografadas são apagadas
As atualizações acontecem quase em tempo real via jobs em background.
Perguntas comuns
Posso sincronizar com o Outlook? Ainda não nativamente. Alternativa: inscreva-se no feed .ics da sua programação a partir da página de Conexões (veja "For other calendar apps" no final). Funciona no Outlook, Fastmail, ProtonCalendar ou qualquer app que aceite assinaturas webcal.
Meus eventos aparecem no fuso horário errado. Provavelmente o fuso horário da sua conta de calendário difere do da aula. O evento é guardado no fuso da aula (correto); seu calendário mostra convertido para o fuso da sua conta (correto). Fica "estranho" quando você viaja. Ajuste o fuso do app de calendário se mudou em definitivo.
Sincronização parou de funcionar / eventos estão desatualizados. Causa mais comum: token expirou ou foi revogado. Vá para /mentor/settings/connections; a linha do provedor afetado mostrará "Not connected". Reconecte.
Minhas reservas presenciais também podem aparecer no meu calendário? Por enquanto o Google só grava reservas de aulas online no seu calendário (para que o link do Meet fique no evento). Para aulas presenciais, inscreva-se no feed .ics da sua programação (página de Conexões → final), que inclui tudo que você ensina.
O limite de 40 minutos do Zoom atrapalha? O plano gratuito do Zoom limita reuniões em grupo a 40 minutos. Opções: atualize o Zoom para o Pro (cerca de US$ 15/mês) para remover o limite, ou mude a aula para Google Meet (que não tem limite de tempo no plano gratuito do Google).
Próximos passos
- Horários e recorrência: como configurar os horários das aulas.
- Sincronização de calendário para estudantes: o equivalente para alunos.