A Agenda (rota /agenda) é o calendário interno do Syncro pra eventos com horário marcado — reuniões, demos, ligações agendadas, visitas, etc. Diferente de tarefas (que têm só data de vencimento), eventos têm início e fim definidos com hora exata, suportam links de videoconferência, lista de convidados e conflito de agenda automático.
A agenda usa FullCalendar com visualização Mês / Semana / Dia, e pode opcionalmente sincronizar com Google Calendar (veja Sincronizar com Google Calendar).
Pré-requisitos
Permissão de admin ou manager pra criar eventos. Usuários comuns só visualizam.
(Opcional) Lead já cadastrado se você quer vincular o evento a ele.
Acessar a agenda
Clique em Agenda no menu lateral.
Você vê o calendário FullCalendar com a visualização do mês corrente.
Eventos existentes aparecem como blocos coloridos:
Azul (#0085F3) — eventos criados no Syncro
Verde (#10B981) — eventos importados do Google Calendar (se sync ativo)
No canto superior, há botões Hoje / Mês / Semana / Dia pra alternar visualização.
No canto direito, botões <** **> pra navegar entre períodos.
Criar um evento
Forma 1 — Botão "Novo evento"
Clique em Novo evento no topo da agenda.
Modal Novo Evento abre.
Preencha:
Título (obrigatório): ex "Reunião com cliente Acme". Placeholder: "Ex: Reunião com cliente".
Início (obrigatório): data e hora de início.
Fim (obrigatório): data e hora de fim. Deve ser depois do início.
Dia inteiro (checkbox opcional): marca evento como dia inteiro (sem horário específico).
Local (opcional): seleciona o tipo de localização (veja seção abaixo).
Convidados (opcional): emails das pessoas convidadas. Receberão convite automático do Google Calendar (se sync ativo).
Descrição (opcional): detalhes ou pauta da reunião.
Contato vinculado (opcional): lead associado ao evento.
Criar tarefa vinculada (checkbox): cria também uma Task pro evento (útil pra follow-up integrado com o sistema de tarefas).
Clique em Salvar.
Aparece Salvando... durante o processo.
Se houver conflito de horário (você já tem outro evento nesse slot), o sistema avisa antes de salvar.
Sucesso: modal fecha, evento aparece no calendário.
Forma 2 — Clicar no calendário
Na visualização Semana ou Dia, clique e arraste na faixa de horário desejada.
Modal abre com Início e Fim já preenchidos.
Preencha o resto e salve.
Tipos de localização
O campo Local permite escolher o formato:
Tipo | Quando usar | Campo extra |
|---|---|---|
Nenhum | Local não importa / é assumido | — |
Zoom | Reunião por Zoom | URL da sala |
Google Meet | Reunião por Google Meet | URL da sala |
Telefone | Ligação telefônica | Número de telefone |
Presencial | Reunião em algum endereço | Endereço completo |
Customizado | Qualquer outro caso | Texto livre |
A escolha é exibida no detalhe do evento e pode ser usada pra reminders enviados aos participantes.
Validações
Quando você salva:
Título: obrigatório. Se vazio: "O título é obrigatório."
Início: obrigatório. Se vazio: "Informe a data/hora de início."
Fim: obrigatório. Se vazio: "Informe a data/hora de fim."
Fim > Início: obrigatório. Se ao contrário: "O fim deve ser após o início."
Se houver conflito:
Aparece mensagem de erro 409 com texto tipo "slot ocupado".
O evento não é criado.
Você precisa escolher outro horário.
💡 Dica: pra ver disponibilidade antes de marcar, mude pra visualização Semana ou Dia e veja onde estão seus blocos atuais.
Ver disponibilidade
Há um endpoint interno (/agenda/disponibilidade) que retorna slots livres entre dois horários — usado por agentes IA pra sugerir horários ao lead. Hoje a UI não expõe esse cálculo num "buscar disponibilidade" visual, mas a função existe no backend.
Editar um evento
Clique no evento na agenda.
Popup mostra título, data/hora, local, attendees.
Clique em Editar.
Modal de edição abre.
Ajuste campos.
Clique em Salvar.
⚠️ Atenção: editar horário de evento que tem lembretes (
EventReminder) configurados reagenda os lembretes pro novo horário automaticamente.
Excluir um evento
Clique no evento.
Popup com botão Excluir.
Confirmação: "Excluir evento — Tem certeza que deseja excluir este evento do Google Calendar?".
Confirme.
Evento é removido. Se sincronizado com Google, também é removido lá.
Ver evento no Google Calendar
Se o evento está sincronizado com Google (status Sincronizado), no popup tem o link Abrir no Google Calendar que leva você direto pro evento no Calendar oficial.
Eventos criados por agentes IA
Se você tem um agente IA com tool de calendário habilitada, ele pode criar eventos em nome do usuário durante conversas com leads:
"Posso agendar uma reunião amanhã às 15h?" → IA cria CalendarEvent automaticamente
Esses eventos aparecem na agenda com badge "Criado por IA" no popup. Veja Tools do agente IA.
Lembretes automáticos
Eventos com lead vinculado geram lembretes automáticos que são enviados pro lead via WhatsApp:
Lembrete 24h antes do evento
Lembrete 1h antes do evento
Os lembretes podem ser customizados (offsets diferentes, mensagem template). Veja Lembretes de eventos.
Sincronização com Google Calendar
A agenda do Syncro pode sincronizar bidirecionalmente com o Google Calendar:
Eventos do Syncro aparecem no Google
Eventos do Google aparecem no Syncro
Edição de qualquer lado se reflete no outro
Pra ativar, veja Sincronizar com Google Calendar.
Limites
Não há limite de quantidade de eventos.
Eventos podem ter qualquer duração (5 minutos, 8 horas, etc).
Sem limite de attendees.
O sistema é otimizado pra exibir até dezenas de milhares de eventos sem degradação.
Próximos passos
Pra sincronizar com Google Calendar, veja Sincronizar Google Calendar
Pra entender lembretes WhatsApp, veja Lembretes de eventos