Agenda
A agenda é onde visitas técnicas e callbacks ficam organizados. Sincroniza com Google Calendar.
Permissão: agenda:view.
Onde fica
/agenda (lista + calendário) e /operacoes/agenda (visão alternativa).
Visualizações
Calendário (default)
Estilo Google Calendar: dia/semana/mês, eventos coloridos por categoria, drag-drop para re-agendar, filtro por técnico.
Cores:
- Visita técnica
- Confirmação de cliente
- Callback
- Alerta crítico
Lista
Tabela com data/hora, cliente, endereço, técnico, status, notas.
Tipos de evento
- Visita técnica — instalação, reparo, mudança, inspeção (campos: cliente, endereço, técnico, tipo, janela 4h, descrição, anexos)
- Callback — IA agenda quando cliente pediu retorno em hora específica
- Confirmação outbound — IA liga 1 dia antes da visita para confirmar
Cenário típico — agendamento via IA
Como o cliente agenda na prática:
- Cliente liga: “Preciso marcar uma visita.”
- IA pergunta: “Para que dia? Tenho horários disponíveis amanhã e quinta.”
- Cliente: “Quinta de manhã.”
- IA consulta Google Calendar: vê slot 8h-12h livre
- IA confirma: “Marquei para quinta-feira, das 8h às 12h. Tudo bem?”
- Cliente: “Sim.”
- IA chama tool
schedule_visit→ cria evento no Google Calendar - IA: “Perfeito! No dia anterior, vou te ligar para confirmar.”
- Conversa encerra
- No dia seguinte: campanha automática roda e a IA liga para confirmar
Status de evento
| Status | Significa |
|---|---|
pending | Agendado, aguardando dia |
confirmed | Cliente confirmou |
executed | Visita feita (técnico marcou ok) |
canceled | Cliente cancelou |
no_show | Cliente não estava |
Bug conhecido: o resumo “Cancelados” mostra
0hardcoded (schema sem coluna status). Estamos corrigindo.
Re-agendar / cancelar
Drag-and-drop no calendário ou abrir evento → editar → salvar. Cancelar via botão no evento. Cliente recebe notificação automática.
Sincronização com Google Calendar
Necessária para a IA agendar autônomo. → Conectar Google Calendar
- Eventos criados pelo ConectAI → vão pro Google Calendar
- Eventos do Google Calendar → ConectAI lê (mas não modifica os que não criou)
- Slots disponíveis = horário sem conflito com outros eventos
Notificações automáticas
- Cliente recebe lembrete 1 dia antes (template HSM
confirmacao_visita) - Cliente confirma respondendo SIM ou NÃO
- Técnico recebe alerta 1h antes (em breve)
Métricas
Em /inteligencia/relatorios: % de no-show, % confirmadas, tempo médio entre agendamento e visita, top horários.