Sincronizar calendário

Abra Ajustes → Sincronizar Calendário, uma linha da seção Você, entre Horário de Trabalho e Assinatura. O Google Calendar é o único calendário ao qual o Maestra se conecta.

Conectar uma conta Google

1. Abra Ajustes → Sincronizar Calendário.
2. Use a ação de adicionar no cabeçalho da seção Google Calendar e conclua a tela de consentimento do Google.
3. A conta autorizada aparece como um cartão com o endereço de e-mail dela.

Uma primeira sincronização roda assim que a conta é conectada. É possível conectar mais de uma conta Google, e cada uma mantém o próprio cartão.

Escolha quais calendários são espelhados

Cada conta conectada lista os calendários dela em Calendários, uma linha por calendário, cada uma com o próprio botão. O calendário principal da conta já vem ativado na conexão; os outros ficam desativados até serem ativados.

Os calendários são redescobertos em toda sincronização, então um calendário criado depois aparece por conta própria, com o botão desativado.

Desativar um calendário remove os bloqueios espelhados dele. Ativar dispara uma sincronização completa para que nada fique de fora.

O que aparece na agenda

Cada intervalo ocupado se torna um cartão cinza discreto, com a forma de um atendimento e marcado como Ocupado, organizado nas mesmas colunas de sobreposição dos atendimentos, para que um conflito fique visível. Os cartões de ocupado retiram disponibilidade onde o tempo bloqueado à mão já retirava, então os horários sugeridos e a busca pelo próximo horário disponível deixam esses períodos de fora.

Um cartão de ocupado é inerte: não há o que abrir nem o que arrastar. Ele não tem barra de destaque, que segue sendo a marca de um atendimento real. Os intervalos sincronizados nunca são faixas de dia inteiro, e sim sempre cartões, porque a disponibilidade é informada em instantes, não em dias inteiros.

O sombreamento da grade continua respondendo a outra pergunta, que é quando o profissional não está trabalhando, então um cartão de ocupado não sombreia o próprio horário. Ele retira aquele horário do tempo agendável.

Frequência da sincronização

• Uma sincronização roda na hora em que a conta é conectada.
• Depois disso, cada conexão consulta o Google a cada 15 minutos.
• Sincronizar agora, no cartão da conta, roda uma sincronização na hora.

Cada leitura cobre a janela inteira, e não um fluxo de mudanças, então um calendário que o profissional limpou também fica limpo aqui: o que o calendário informa é o que a agenda mostra.

A janela espelhada vai do início do dia UTC atual até 180 dias à frente. O tempo ocupado que já passou não é espelhado, porque não pode causar um agendamento duplo.

O que a conexão lê

A conexão lê apenas horários livres e ocupados. A resposta de disponibilidade do Google traz instantes de início e fim e nada além disso, então nenhum id, título, local, convidado ou organizador de evento chega ao Maestra, nem em princípio. Os dois escopos pedidos são calendar.freebusy e calendar.calendarlist.readonly, que é o que também fornece o nome de cada calendário para a linha dele.

A conexão é somente leitura no outro sentido também. Os atendimentos agendados no Maestra nunca são escritos de volta no Google, e nenhum escopo de escrita é pedido.

Nota

Somente os horários ocupados são importados. Títulos de eventos, convidados e outros detalhes nunca são lidos nem armazenados. O token de acesso do Google fica criptografado na API e nunca chega ao cliente.

Desconectar

Desativar um único calendário remove apenas os bloqueios dele. Desconectar, no cartão da conta, remove a conta, os calendários dela e todos os bloqueios de ocupado que vieram dela. A confirmação mostra o e-mail da conta antes de qualquer exclusão.

Se a autorização for revogada ou expirar do lado do Google, o cartão passa a oferecer uma linha para reconectar em vez de sincronizar. Toque nela para passar pelo consentimento de novo: os bloqueios espelhados continuam no lugar até a conexão ser restaurada ou desconectada.