Sincronização de Agenda (Google e iCal)
Espelhe suas sessões no Google Agenda ou assine um feed iCal no iPhone, Apple e Outlook.
Funcionalidade nova
Este recurso faz parte das funcionalidades de mercado recém-lançadas.
A Sincronização de Agenda leva as suas próximas sessões para fora da Akesia: você pode conectar sua conta do Google para criar os eventos automaticamente no Google Agenda, ou assinar um feed iCal para ver a agenda no iPhone, Apple Calendar, Outlook e outros apps.
Pré-requisitos
- Conexão com o Google: depende das variáveis de ambiente
CALENDAR_SYNC_PROVIDER=google,GOOGLE_CALENDAR_CLIENT_IDeGOOGLE_CALENDAR_CLIENT_SECRET. As três precisam estar presentes: semCALENDAR_SYNC_PROVIDER=googleo sistema usa o cliente de simulação (mock) e a sincronização não chega ao Google de verdade. Sem elas, o botão de conectar responde com o toast "Integração com Google não está configurada." — a interface avisa de forma explícita, sem falha silenciosa. OpcionalmenteGOOGLE_CALENDAR_REDIRECT_URIeNEXT_PUBLIC_APP_URLmontam as URLs de redirecionamento e do feed. (NEXTAUTH_URLfoi removida: num produto servido em vários domínios ela fixava um só, e mandava o visitante de um domínio para o login de outro.) - Permissão: a feature
calendar_syncjá vem como WRITE por padrão para ADMIN e PROFISSIONAL — não é preciso configurar nada no RBAC. - Perfil profissional: só usuários com perfil profissional têm sessões para sincronizar. Para os demais, a seção mostra a mensagem "Esta seção está disponível apenas para usuários com perfil profissional…".
- O feed iCal é público por design: a URL
/api/public/calendar/<token>é protegida apenas pelo token de 256 bits e por rate-limit. Trate a URL como um segredo.
Como usar
Para o profissional
Conectar o Google Agenda
- No menu do usuário (topo à direita), clique em Meu perfil; no celular, toque em Perfil na barra inferior.
- Role até a seção Sincronização de Agenda.
- No card Google Agenda, clique em Conectar Google Agenda e autorize no consentimento do Google.
- Você volta ao perfil; o card passa a exibir o e-mail da conta e o selo Conectado. Os eventos das suas próximas sessões dos próximos 90 dias são criados no seu calendário principal do Google.
- Opcional — em Agenda de destino, clique em Criar agenda "Akesia —
{clínica}" para separar os atendimentos da sua vida pessoal. Os eventos que já existiam são movidos para a nova agenda na hora; se a troca for interrompida, o cartão mostra quantos faltam e o link Concluir migração retoma de onde parou. - Opcional — em Privacidade, escolha Total (recomendado) (o evento aparece como "Atendimento —
{clínica}") ou Primeiro nome. Marque Sincronizar lembretes e notas se quiser incluir esses tipos.
Assinar pelo iPhone, Apple ou Outlook (feed iCal)
- Vá em Meu perfil → Sincronização de Agenda → card Link iCal (Apple, Outlook e outros).
- Clique em Gerar link iCal e depois no botão de copiar (ícone) ao lado da URL.
- No iPhone: Ajustes → Calendário → Contas → Adicionar conta → Outra → Assinar calendário e cole a URL. O calendário atualiza no ritmo do app (normalmente a cada algumas horas).
Trocar ou revogar o link iCal já compartilhado
- No card Link iCal, clique em Gerar novo link — o link anterior para de funcionar imediatamente.
- Copie a nova URL. Para desativar totalmente, clique em Desativar.
Desconectar o Google
- Vá em Meu perfil → Sincronização de Agenda → card Google Agenda → Desconectar.
- Se quiser, marque Remover também os eventos já criados no Google e clique em Confirmar.
Para o administrador
- O administrador usa o mesmo caminho (Meu perfil → Sincronização de Agenda) para conectar ou gerar o próprio feed, desde que tenha perfil profissional.
- O status de conexão dos profissionais também aparece como selo (Conectado, Erro, Revogada ou Não conectado) na tabela de profissionais.
O link iCal é um segredo
Qualquer pessoa com a URL do feed iCal consegue ver a sua agenda — ela é protegida apenas pelo token. Não a compartilhe publicamente e, se suspeitar que vazou, use Gerar novo link para invalidar o anterior na hora.