Sincronizar com Google Agenda / iCal
OAuth Google bidirecional e feed iCal público; tratamento de erros de sync.
Funcionalidade nova
Você pode ver suas sessões da clínica diretamente no seu Google Agenda, Apple Calendar ou Outlook, sem precisar abrir a Akesia para conferir os horários do dia. São duas formas de conectar: a conexão Google (atualiza quase em tempo real e pode bloquear seus horários ocupados de volta na agenda da clínica) e o link iCal (assinatura somente leitura, funciona em qualquer aplicativo de calendário).
Funcionalidade recente
A Sincronização de Agenda é uma adição recente. Ela fica em Perfil → Sincronização de Agenda e está disponível apenas para usuários com perfil profissional — são eles que possuem sessões para sincronizar. Se você não vê a seção, é porque sua conta não tem um perfil profissional vinculado.
Onde encontrar
Abra seu Perfil e role até o bloco Sincronização de Agenda. Ele tem dois cartões:
Google Agenda
Conexão em tempo quase real, com privacidade configurável e bloqueio opcional dos seus horários pessoais.
Link iCal (Apple, Outlook e outros)
Assinatura somente leitura por um link secreto. Sem conta Google.
A Akesia é a fonte oficial
Os eventos da clínica no seu calendário são um espelho dos seus atendimentos. Alterações feitas diretamente no Google (mover, renomear ou apagar um evento da clínica) serão sobrescritas na próxima sincronização. Para mudar uma sessão, edite-a sempre dentro da Akesia.
Conectar o Google Agenda
No cartão Google Agenda, clique em Conectar Google Agenda.
Você é levado à tela de consentimento do Google. Escolha a conta e autorize o acesso ao calendário.
Ao voltar para a Akesia, o cartão mostra o e-mail conectado e a etiqueta de status Conectado. A Akesia já começa a enviar suas próximas sessões dos próximos 90 dias para o calendário.
O que entra (e o que fica de fora)
A sincronização cobre da semana anterior em diante: tudo o que está por vir, mais os últimos 7 dias. Sessões mais antigas que isso não são enviadas — o passado não muda a sua rotina, e despejar anos de histórico só encheria o calendário.
O recorte vale para criar evento. Uma sessão antiga que já tem evento no calendário continua sendo atualizada normalmente, e o cancelamento apaga o evento em qualquer data — senão uma sessão desmarcada do mês passado deixaria um evento que você não conseguiria remover pelo sistema.
A partir daí, cada vez que você cria, edita, confirma ou cancela uma sessão, o evento correspondente é atualizado no Google automaticamente — normalmente em segundos. Uma rotina de verificação também roda a cada 10 minutos para garantir que nada fique para trás.
O que é sincronizado
| Tipo de agendamento | Vai para o Google? | Bloqueia horário? |
|---|---|---|
| Consulta, Tarefa, Reunião | Sempre | Sim (evento "ocupado") |
| Lembrete, Nota | Só se você ativar a opção | Não (evento "livre") |
Para incluir lembretes e notas, marque Sincronizar lembretes e notas (não bloqueiam horário no Google). Esses eventos entram como "livre", então não fazem o Google considerar você ocupado naquele horário.
Sessões canceladas são removidas do calendário automaticamente.
Agenda de destino (recomendado: uma agenda só da clínica)
Por padrão os eventos vão para a sua agenda principal do Google, misturados com a sua vida pessoal. Em Agenda de destino você escolhe outra agenda — ou clica em Criar agenda "Akesia — nome da clínica" para a Akesia criar uma nova, exclusiva dos atendimentos. Assim dá para esconder, compartilhar ou limpar os eventos da clínica sem tocar nos seus compromissos pessoais.
Ao trocar a agenda de destino, a Akesia move os eventos já criados para a nova agenda na mesma hora — o evento é movido, não recriado, então o histórico e os convites continuam os mesmos. Enquanto a mudança acontece, o cartão mostra quantos eventos já foram movidos.
Se a troca for interrompida
Fechar a página no meio da mudança não quebra nada: a Akesia sabe quantos eventos ainda estão na agenda anterior e mostra "N evento(s) ainda estão na agenda anterior — Concluir migração". Clicar nesse link retoma exatamente de onde parou.
Privacidade do que aparece no calendário
Você decide quanta informação aparece no título do evento. A Akesia nunca envia telefone, CPF, e-mail ou anotações da sessão para o calendário — apenas o título e o horário.
Os eventos aparecem como "Atendimento — nome da clínica", sem qualquer nome de paciente. É a opção indicada para quem compartilha o calendário ou o usa em telas visíveis a terceiros.
Os eventos mostram apenas o primeiro nome do paciente, por exemplo "Atendimento — Maria". Quando a sessão não tem paciente (tarefa, lembrete etc.), volta para o formato "Total".
Ao trocar o modo de privacidade, a Akesia re-titula os eventos dos próximos 90 dias para você não precisar fazer nada manualmente.
Bloquear seus horários pessoais (mão dupla)
Marque Bloquear horários ocupados da minha agenda pessoal para que os compromissos que você já tem no Google apareçam como horários ocupados dentro da Akesia, evitando que alguém marque uma sessão por cima deles.
A agenda de destino dos atendimentos nunca é lida aqui: seria a Akesia enxergando os próprios eventos e bloqueando duas vezes o mesmo horário.
Como essa opção lê a sua agenda do Google, ela pede uma autorização adicional. Ao marcá-la pela primeira vez, você é redirecionado para uma nova tela de consentimento do Google. Após autorizar, a opção fica ativa. A Akesia só enxerga os intervalos ocupados (início e fim) — nunca os títulos ou detalhes dos seus compromissos pessoais.
Desconectar
No cartão Google Agenda, clique em Desconectar. Antes de confirmar, você pode marcar Remover também os eventos já criados no Google:
- Sem marcar: a conexão é encerrada, mas os eventos que a Akesia já criou permanecem no seu calendário.
- Marcando: a Akesia apaga do Google os eventos das sessões antes de encerrar a conexão.
Link iCal (Apple, Outlook e outros)
Se você não usa Google, pode assinar sua agenda da clínica por um link iCal em qualquer aplicativo de calendário (Apple Calendar, Outlook etc.). É uma assinatura somente leitura — o aplicativo busca os horários, mas não consegue alterá-los.
No cartão Link iCal, clique em Gerar link iCal.
Use o botão de copiar para pegar o endereço gerado.
Cole o link no seu aplicativo. No iPhone, por exemplo: Ajustes → Calendário → Contas → Adicionar conta → Outra → Assinar calendário.
O feed traz suas sessões dos próximos 90 dias e dos últimos 7 dias — o mesmo recorte que a conexão Google usa, para os dois nunca mostrarem conjuntos diferentes. Sessões canceladas simplesmente não entram no feed: alguns aplicativos continuam exibindo o evento marcado como cancelado em vez de removê-lo, então é mais limpo não enviá-lo.
O link iCal tem privacidade própria, escolhida no cartão dele e independente da conexão Google: dá para deixar o Google mostrando o primeiro nome do paciente e o iCal só com o nome da clínica, ou o contrário. Antes o feed seguia o padrão Total sem oferecer escolha, e era por isso que ele mostrava o nome da clínica mesmo com o Google configurado para exibir o primeiro nome.
Primeiro nome no iCal exige mais cuidado
O feed é servido por um endereço público — quem tem o link lê os títulos sem precisar entrar no sistema. Com Total, o pior caso é alguém descobrir seus horários ocupados. Com Primeiro nome, o link passa a expor o primeiro nome de pacientes, e aí ele merece o mesmo cuidado de um dado clínico.
No modo Total, o feed iCal também esconde o título que você escreveu em tarefas, reuniões, lembretes e notas — eles saem como "Tarefa — {clínica}", "Reunião — {clínica}" e assim por diante. É uma diferença proposital em relação à conexão Google, onde esses títulos aparecem inteiros.
O motivo é que esses títulos são texto livre, e texto livre acaba carregando nome de gente: uma reunião chamada "Supervisão Lívia" ou uma tarefa "Retornar para a mãe do João" viraria conteúdo legível em um endereço público. Na sua agenda do Google, que é sua e exige login, o título continua inteiro — lá você precisa reconhecer o próprio compromisso.
Se o link iCal for de uso pessoal e você preferir ver os títulos como escreveu, mude o feed para Primeiro nome: nesse modo a clínica já aceitou expor nomes, e os títulos de equipe voltam a aparecer.
Trate o link como uma senha
O link iCal é secreto: qualquer pessoa com ele consegue ver os títulos e horários das suas sessões. Não o compartilhe. Se ele vazar, clique em Gerar novo link — o link anterior para de funcionar imediatamente — ou em Desativar para encerrar a assinatura de vez.
Calendários assinados não atualizam em tempo real: eles seguem o ritmo do seu aplicativo (geralmente a cada algumas horas, e o intervalo é definido pelo próprio app, não pela Akesia). Para ver as mudanças quase imediatamente, use a conexão Google.
Quando a sincronização dá erro
O cartão do Google mostra uma etiqueta de status que indica a saúde da conexão:
| Etiqueta | O que significa | O que fazer |
|---|---|---|
| Conectado | Tudo certo, sincronizando normalmente. | Nada. |
| Erro | Uma tentativa de sincronizar falhou após várias tentativas automáticas. | Clique em Tentar novamente. |
| Revogada | O acesso ao Google foi retirado (você revogou a permissão na conta Google, ou ela expirou). | Clique em Reconectar e autorize novamente. |
A Akesia não desiste no primeiro tropeço: cada sincronização é repetida automaticamente, com intervalos crescentes, antes de marcar a conexão como Erro. Quando isso acontece — ou quando o acesso é revogado — você também recebe um e-mail avisando que a sincronização foi interrompida, com o link para reconectar pelo perfil.
Se aparecer Erro, leia a mensagem exibida e clique em Tentar novamente. A Akesia reenvia suas próximas sessões dos próximos 90 dias.
Se aparecer Revogada, clique em Reconectar para refazer a autorização do Google. Depois disso a sincronização é retomada e o histórico recente é reenviado.
Se o problema persistir, desconecte e conecte novamente o Google Agenda.
Cada profissional sincroniza apenas as próprias sessões, e tudo fica restrito à sua clínica. Um erro na sua conexão nunca afeta a sincronização de outro colega.