Visualizações de calendário
- Como qualquer tipo personalizado pode ser exibido como um calendário
- Quando um tipo ganha uma visualização de calendário e como abri-la
- Como o modelo Agenda usa o calendário para compromissos
- Como funcionam os registros recorrentes
No AutoTalk, um calendário é uma forma de visualizar um tipo personalizado — não um aplicativo nativo separado. Qualquer tipo personalizado cujos registros tenham um campo Data ou Data e hora pode ser exibido em um calendário, para que você navegue e gerencie esses registros por dia, semana ou mês em vez de uma lista plana.
Quando um tipo ganha um calendário?
Um tipo personalizado ganha uma visualização de calendário quando sua definição inclui uma configuração de calendário — no mínimo, qual campo de data/hora marca o início de cada registro. Você também pode apontar para um campo de fim, um título, uma cor e um campo de recorrência.
Depois que o calendário está configurado, o tipo passa a ter uma visualização de calendário ao lado da listagem normal, acessível pelo item daquele tipo no menu lateral. Tipos sem campo de data — ou sem configuração de calendário — aparecem como lista.
O modelo Agenda
A forma mais rápida de ter um calendário funcionando é o modelo de onboarding Agenda. Quando você cria uma empresa com o modelo Agenda, o AutoTalk provisiona um conjunto de tipos personalizados prontos para agendamento de compromissos:
| Tipo | O que guarda |
|---|---|
| Eventos | Os compromissos em si — data/hora, quem e o quê |
| Serviços | Serviços agendáveis, cada um com duração e preço |
| Horários de Trabalho | A agenda semanal normal de cada funcionário |
| Períodos do Funcionário | Folgas e exceções pontuais de disponibilidade |
O tipo Eventos já vem com uma configuração de calendário, então abre diretamente como um calendário. Esse é o mesmo mecanismo que você pode adicionar a qualquer tipo personalizado — o modelo Agenda é só um exemplo pronto, ajustado para agendamentos.
As visualizações do calendário
Um calendário oferece quatro formas de olhar os mesmos registros:
- Dia — um único dia, hora a hora. Melhor para um olhar detalhado dos registros do dia.
- Semana — a semana atual ao longo das horas de trabalho. Bom para encontrar lacunas e sobreposições.
- Mês — um mês inteiro de uma vez. Bom para uma visão geral.
- Agenda — uma lista cronológica dos próximos registros.
Use as setas de navegação para mudar de período e os filtros para restringir quais registros aparecem (por exemplo, pelo funcionário a quem um Evento está atribuído).
Criando um registro pelo calendário
Usando o tipo Eventos do modelo Agenda como exemplo:
- Navegue até a data com as setas ou trocando de visualização.
- Clique em um horário (visualização Dia/Semana) ou em uma data (visualização Mês) para começar um novo Evento.
- Preencha os campos do registro. Para Eventos, são o contato, o(s) serviço(s), o funcionário atribuído e o horário de início/fim — mas o formulário sempre reflete os campos que o seu tipo personalizado define.
- Salve. O registro aparece no calendário imediatamente.
Você pode abrir qualquer registro para editá-lo, arrastá-lo para um novo horário para reagendar ou excluí-lo. Para Eventos, o horário de fim e o título podem ser preenchidos automaticamente pelos workflows do modelo Agenda (por exemplo, calculando o fim a partir da duração dos serviços selecionados).
Registros recorrentes
Se a configuração de calendário declarar um campo de recorrência, os registros podem se repetir em uma programação em vez de serem recriados manualmente. A recorrência é armazenada como uma string RRULE padrão, então um tipo pode expressar padrões diários, semanais ou mensais (por exemplo, uma sessão semanal toda terça às 10:00).
Um registro recorrente é armazenado como um único registro, e o calendário o expande em um evento por ocorrência dentro do período visível. Editá-lo edita esse único registro, então a mudança se aplica à série inteira, e não a uma ocorrência específica.
Como os registros se conectam (exemplo do modelo Agenda)
No modelo Agenda, cada Evento liga outros três registros:
| Campo | O que responde |
|---|---|
| Contato | Para quem é o compromisso? |
| Serviço | O que será feito? |
| Funcionário | Quem vai realizar? |
O Contato é um registro de contato real, então um Evento referencia o contato em vez de copiar os dados dele. Os workflows do modelo Agenda também gravam um carimbo de data/hora lastScheduledEventAt no contato (usado, por exemplo, para retomar o contato após um período de inatividade); os compromissos em si não são listados no perfil do contato. Essa ligação de três pontas é específica do desenho do modelo Agenda; os seus próprios tipos com calendário podem referenciar quaisquer registros que façam sentido para eles.
Próximos passos
- Criando um Tipo Personalizado — defina um tipo e seus campos, incluindo campos de Data / Data e hora
- Gerenciando registros — adicionar, editar e filtrar registros
- Usando Tipos Personalizados com agentes de IA e MCP — permita que agentes leiam e gravem registros do calendário