Agenda

O que essa tela faz

Gerencia a agenda pessoal do Marcos: visitas às lojas/unidades, viagens e compromissos gerais — tudo na mesma tabela (compromissos_marcos) que a assistente por voz (Sofia) também usa. Cada compromisso pode ganhar uma sala de vídeo (via Daily.co) e gerar um link de reunião pronto pra mandar — essa sala é a mesma que abre pro convidado na tela pública /reuniao/[id]. Por padrão, os compromissos são privados (só o Marcos vê); só aparecem pro primeiro escalão da equipe (na área deles, /colaboradores/minha-area ou /colaboradores/editar/[token]) os que forem marcados como "Mostrar pro primeiro escalão".

Campo a campo

• Tipo (obrigatório) — Visita, Viagem ou Compromisso; cada um com cor/ícone próprio na lista.
• Título (obrigatório) — texto livre.
• Local (opcional) — escolha entre as unidades cadastradas (Admin → Unidades) ou "Outro local

(digitar)" pra texto livre; o fuso horário do compromisso segue o da unidade escolhida (ou o do aparelho do Marcos, se "sem local").

• Início (obrigatório) e Fim (opcional) — data e hora, no fuso mostrado logo abaixo do

campo Local.

• Dia inteiro (checkbox) — ignora o horário quando marcado.
• Criar sala de vídeo (checkbox) — gera (ou remove, se desmarcado depois) uma sala Daily.co

vinculada ao compromisso; ao ligar, o compromisso passa a ter o link /reuniao/[id].

• Mostrar pro primeiro escalão (checkbox) — desligado (padrão) = só o Marcos vê; ligado =

aparece na agenda que colaboradores do primeiro escalão veem na área deles.

• Observação (opcional) — texto livre.
• Aviso "Ninguém está vendo sua agenda ainda." — aparece quando existe gente com acesso de

primeiro escalão mas nenhum compromisso está marcado como visível — lembrete pra não deixar a aba da equipe vazia sem motivo.

• Sugestão de check-in por localização (topo da tela) — se o navegador autorizar geolocalização

e o Marcos estiver a até 60 km de uma unidade com coordenadas cadastradas, aparece um cartão "Você parece estar em [cidade]" oferecendo registrar a visita na hora.

Ações disponíveis

• "Novo" — abre o formulário de compromisso em branco.
• Editar (ícone lápis) — abre o mesmo formulário preenchido.
• Excluir (ícone lixeira) — pede confirmação; na prática cancela o compromisso

(status = "cancelado"), não apaga o histórico — ele some da lista e dos avisos da Sofia.

• "Fazer check-in" (sugestão por localização) — cria uma visita "agora" na unidade sugerida,

já marcada como visível pro primeiro escalão. "Agora não" dispensa a sugestão sem registrar nada.

• "Entrar na reunião" (quando o compromisso tem sala) — abre /reuniao/[id] em nova aba.
• "Copiar convite" — copia o link /reuniao/[id] pra área de transferência.
• "Enviar convite" — abre um seletor de destinatários (colaboradores e contatos com WhatsApp

cadastrado, ou um número digitado à mão) e dispara o convite da reunião pelo WhatsApp.

Dúvidas frequentes

P: Marquei "Criar sala de vídeo" mas o compromisso não ganhou link. R: A sala é criada de forma assíncrona ao salvar; se a criação falhar (ex.: Daily.co fora do ar), o compromisso é salvo normalmente e aparece o aviso "Compromisso salvo, mas a sala de vídeo falhou: [motivo]" — tente editar e salvar de novo.

P: Enviei um convite e a mensagem "não saiu de verdade". R: Se aparecer o aviso "Envio real está DESLIGADO (modo teste)", o ambiente está em modo de teste — o convite foi montado mas não foi enviado de verdade pelo WhatsApp.

P: Por que "Excluir" some o compromisso mas eu ainda vejo ele em outro lugar? R: Excluir aqui só cancela (status = "cancelado") — o registro continua existindo no banco pra histórico, só não aparece mais na lista nem nos avisos.

Erros comuns