Central de Ajuda - Módulo Agenda
Sumário
Visão Geral
Como Acessar a Agenda
Visões do Calendário
Criando um Novo Evento / Tarefa
Editando um Evento
Arrastar e Redimensionar Eventos
Tipos de Tarefa
Tipos de Integração
Filtros da Agenda
Filtro por Responsável
Filtro por Status
Pesquisa de Eventos
Aniversários
Pedidos e Incidentes na Agenda
Configurações da Agenda
Anexos e Arquivos
Integração com WhatsApp
Uso no Celular (Mobile)
Permissões de Acesso
Perguntas Frequentes (FAQ)
---
Visão Geral
O Módulo Agenda é a central de gerenciamento de compromissos, tarefas e atividades do Calcme. Ele permite visualizar e organizar em um calendário interativo todos os eventos da sua equipe, incluindo tarefas, visitas, reuniões, ligações, pedidos, incidentes e até aniversários de clientes.
A tela da agenda é composta por duas áreas principais:
Painel lateral esquerdo: contém o mini-calendário para navegação de datas, filtros por tipo de agenda, tipo de tarefa, status, integração e filtro por responsável.
Área principal (calendário): exibe os eventos no formato de semana, mês ou agenda (lista).
---
Como Acessar a Agenda
Para acessar o módulo, navegue até o menu Agenda no painel principal do sistema. A agenda também pode ser acessada a partir de outros módulos, como Pedidos, Incidentes e PCP, onde ela exibe as tarefas vinculadas àquele contexto específico.
---
Visões do Calendário
A agenda oferece três modos de visualização:
Visão Semanal (Semana)
Exibe os 7 dias da semana em colunas (ou 5 dias úteis, caso os finais de semana estejam ocultos).
Cada coluna é dividida em faixas de horário, permitindo ver com precisão quando cada evento acontece.
Eventos que duram o dia inteiro aparecem em uma faixa separada no topo.
Uma linha indicadora de horário atual mostra o momento presente no calendário.
Visão Mensal (Mês)
Exibe o mês inteiro em formato de grade.
Os eventos aparecem dentro das células de cada dia.
Quando há muitos eventos em um único dia, um indicador "+X mais" é exibido. Clique nele para expandir e visualizar todos os eventos daquele dia.
Visão de Agenda (Lista)
Exibe os eventos em formato de lista vertical organizada por data.
Ideal para ter uma visão rápida e sequencial de todos os compromissos.
Para alternar entre as visões, use os botões de visualização disponíveis na barra superior do calendário.
---
Criando um Novo Evento / Tarefa
Existem duas formas de criar um novo evento:
Pelo botão "Criar"
Clique no botão "Criar" localizado na barra superior da agenda.
Um formulário será aberto para preencher os detalhes da tarefa.
Preencha as informações necessárias: título, tipo de tarefa, responsável, data/hora de início e término, observações, checklist e anexos.
Clique em Salvar para confirmar.
Clicando diretamente no calendário
Clique em um horário ou dia desejado diretamente no calendário.
O formulário de criação será aberto com a data e horário já preenchidos automaticamente.
Complete as demais informações e salve.
> Nota: É necessário ter a permissão de inserção na agenda para criar eventos.
---
Editando um Evento
Para editar um evento existente:
Clique duas vezes no evento no calendário, ou
Clique no evento para abrir o tooltip com os detalhes e use o botão de edição.
O formulário de edição será aberto com as informações atuais do evento.
Faça as alterações desejadas e clique em Salvar.
> Nota: É necessário ter a permissão de atualização na agenda para editar eventos.
---
Arrastar e Redimensionar Eventos
O módulo agenda permite interações rápidas via arrastar e soltar:
Arrastar (Mover)
Clique e segure um evento, arraste-o para outro horário ou dia.
Ao soltar, a data e o horário do evento serão atualizados automaticamente.
Redimensionar
Na visão semanal, passe o mouse sobre a borda inferior de um evento.
Arraste para cima ou para baixo para alterar a duração do evento.
A data final será ajustada automaticamente.
> Essas ações requerem permissão de atualização na agenda.
---
Tipos de Tarefa
A agenda suporta 7 tipos de tarefa, cada um identificado por uma cor e ícone específicos:
Tipo Cor Descrição
Tarefa Azul Atividade genérica ou to-do
CheckList Cinza escuro Lista de verificação com itens a serem marcados
Comentário Cinza Nota ou observação registrada
Visita Laranja Visita presencial a um cliente ou local
Reunião Ciano Encontro ou reunião agendada
WhatsApp Verde Interação via WhatsApp
Ligação Cinza Chamada telefônica agendada
Cada tipo possui um ícone visual distinto no calendário para fácil identificação.
---
Tipos de Integração
As tarefas podem estar vinculadas a outros módulos do sistema. Os tipos de integração disponíveis são:a
Integração Descrição
Orçamento Tarefa vinculada a um orçamento
Pedido Tarefa vinculada a um pedido
Item do Pedido Tarefa vinculada a um item específico de um pedido
Incidente Tarefa vinculada a um incidente
Item do Incidente Tarefa vinculada a um item específico de um incidente
Avulsa Tarefa independente, sem vínculo com outro módulo
> Quando uma tarefa está vinculada a um pedido ou orçamento, um badge com o ID do registro é exibido no evento para referência rápida.
---
Filtros da Agenda
O painel lateral esquerdo oferece múltiplos filtros organizados em grupos:
Filtro por Tipo de Agenda
Selecione quais categorias de eventos deseja visualizar:
Pedido — exibe pedidos pela data de entrega
Incidente — exibe incidentes pela data de entrega
Tarefas — exibe todas as tarefas agendadas
Aniversários — exibe aniversários de clientes
Marque ou desmarque as caixas de seleção para controlar quais itens aparecem no calendário.
Filtro por Tipo de Tarefa
Filtre as tarefas por tipo específico (Tarefa, CheckList, Comentário, Visita, Reunião, WhatsApp, Ligação). Você pode combinar múltiplos tipos.
Filtro por Integração
Filtre tarefas pelo módulo de origem (Orçamento, Pedido, Item do Pedido, Incidente, Item do Incidente, Avulsa).
Todos os filtros selecionados são salvos automaticamente nas suas configurações de usuário, então ao retornar à agenda, seus filtros estarão preservados.
---
Filtro por Responsável
Se você possui permissão para visualizar tarefas de outros colaboradores, um seletor de responsáveis estará disponível no painel lateral:
Clique no campo "Responsável".
Selecione um ou mais colaboradores da lista.
A agenda será atualizada para exibir apenas os eventos dos colaboradores selecionados.
> Se nenhum colaborador estiver disponível, a mensagem "Nenhum funcionário disponível" será exibida.
---
Filtro por Status
Filtre os eventos pelo estado atual:
Status Descrição
Em aberto Tarefas ainda não concluídas e dentro do prazo
Atrasadas Tarefas cuja data limite já passou sem conclusão
Concluídas Tarefas já finalizadas (exibidas com texto riscado)
Por padrão, a agenda exibe tarefas Em aberto e Atrasadas. Marque Concluídas para incluir também as tarefas já finalizadas.
---
Pesquisa de Eventos
Use a barra de pesquisa no topo da agenda para buscar eventos por texto:
A pesquisa filtra por nome da tarefa, descrição, nome do cliente ou do responsável.
Os resultados são atualizados automaticamente após uma breve pausa na digitação (500ms).
Para limpar a pesquisa, apague o texto do campo.
---
Aniversários
A agenda pode exibir aniversários de clientes e contatos:
Os aniversários aparecem como eventos de dia inteiro com um visual especial (borda colorida em gradiente).
Exibem o nome da pessoa e a idade que ela está completando.
Para ativar, marque a opção "Aniversários" no filtro de tipo de agenda no painel lateral.
---
Pedidos e Incidentes na Agenda
Além das tarefas, a agenda pode exibir pedidos e incidentes diretamente no calendário:
Pedidos aparecem como eventos de dia inteiro na data de entrega prevista, identificados pelo nome do cliente e o ID do pedido.
Incidentes funcionam de forma semelhante, exibidos na data de entrega.
Ao clicar em um pedido ou incidente, você pode visualizar os detalhes e, se disponível, acessar a funcionalidade de mensagens via WhatsApp.
> A exibição de pedidos e incidentes depende das permissões do usuário.
---
Configurações da Agenda
Acesse as configurações clicando no ícone de engrenagem na barra superior do calendário. As opções disponíveis são:
Exibir Final de Semana
Ative ou desative a exibição de sábados e domingos no calendário.
Quando desativado, apenas os dias úteis (segunda a sexta) serão exibidos.
Modo de Cores
Escolha como os eventos são coloridos no calendário:
Por Tipo de Tarefa (padrão): cada evento recebe a cor correspondente ao seu tipo (tarefa = azul, visita = laranja, etc.).
Por Responsável: cada colaborador recebe uma cor única, permitindo identificar rapidamente de quem é cada tarefa.
> Todas as configurações são salvas automaticamente no seu perfil de usuário.
---
Anexos e Arquivos
As tarefas na agenda podem conter arquivos anexados:
Ao visualizar os detalhes de uma tarefa (pelo tooltip), você pode ver os anexos vinculados.
É possível adicionar novos arquivos ou remover arquivos existentes, dependendo das suas permissões.
Os arquivos podem ser baixados diretamente pelo tooltip do evento.
> Permissões necessárias: Visualizar arquivos, Inserir arquivos e Remover arquivos de tarefas.
---
Integração com WhatsApp
A agenda possui integração com o módulo de WhatsApp do sistema:
A partir de um pedido ou incidente exibido na agenda, você pode abrir uma janela de mensagens.
A janela permite enviar e visualizar mensagens diretamente vinculadas ao registro.
Essa funcionalidade depende da permissão de WhatsApp na agenda estar ativa.
---
Uso no Celular (Mobile)
A agenda é totalmente responsiva e se adapta a telas de dispositivos móveis:
Em telas menores (até 490px), o painel lateral é recolhido automaticamente.
Um botão flutuante "Criar" aparece no canto da tela para criação rápida de eventos.
A navegação por gestos de toque é suportada (arrastar para navegar entre dias/semanas).
O botão de alternância do painel lateral permite expandir/recolher os filtros quando necessário.
---
Permissões de Acesso
O módulo agenda utiliza um sistema de permissões granular. Abaixo estão as permissões disponíveis:
Permissão Descrição
Visualizar Agenda Acesso básico para visualizar a agenda
Visualizar Pedidos Exibir pedidos no calendário
Visualizar Incidentes Exibir incidentes no calendário
Visualizar PCP Acesso à agenda pelo módulo PCP
Visualizar Orçamentos Exibir tarefas vinculadas a orçamentos
Visualizar Tarefas Exibir tarefas no calendário
Inserir Criar novos eventos e tarefas
Atualizar Editar eventos existentes (inclui arrastar e redimensionar)
Remover Excluir eventos da agenda
Concluir Marcar tarefas como concluídas
Ver Outros Responsáveis Visualizar tarefas de outros colaboradores e usar o filtro de responsável
WhatsApp na Agenda Acessar mensagens WhatsApp a partir da agenda
Visualizar Valores Ver valores financeiros de pedidos
> As permissões são configuradas pelo administrador do sistema no módulo de gestão de usuários e perfis.
---
Perguntas Frequentes (FAQ)
1. Por que não consigo ver os pedidos na agenda?
Verifique se:
Você tem a permissão "Visualizar Pedidos" ativa no seu perfil.
O filtro "Pedido" está marcado no painel lateral (seção "Agenda").
O filtro de integração "Pedido" também está selecionado.
2. Por que meus eventos sumiram do calendário?
Verifique os filtros no painel lateral:
Confirme que os tipos de tarefa desejados estão selecionados.
Verifique se o status correto está marcado (Em aberto, Atrasadas ou Concluídas).
Confira se o filtro de responsável não está limitando a visualização a outro colaborador.
Verifique o período de datas selecionado no mini-calendário.
3. Não consigo criar uma nova tarefa. O que fazer?
A criação de tarefas requer a permissão "Inserir" na agenda. Solicite ao administrador do sistema que ative essa permissão no seu perfil.
4. Como faço para ver as tarefas de outros colaboradores?
Você precisa da permissão "Ver Outros Responsáveis". Com ela ativa, o seletor de responsáveis aparecerá no painel lateral, permitindo escolher quais colaboradores visualizar.
5. Como alterar a data de uma tarefa rapidamente?
Basta arrastar o evento no calendário para a nova data/horário desejado. A alteração é salva automaticamente. Essa ação requer permissão de atualização.
6. O que significa o evento com texto riscado?
Eventos com texto riscado são tarefas concluídas. Para ocultá-los, desmarque o filtro "Concluídas" no painel de status.
7. O que significa o evento com destaque vermelho/alaranjado?
Eventos destacados com cores de alerta indicam tarefas atrasadas — ou seja, a data limite já passou e a tarefa ainda não foi concluída.
8. Como vejo os aniversários dos meus clientes?
Marque a opção "Aniversários" no filtro de tipo de agenda. Os aniversários aparecerão como eventos de dia inteiro com um visual especial de borda colorida.
9. Posso usar a agenda no celular?
Sim! A agenda é totalmente responsiva. No celular, o painel lateral é recolhido automaticamente e um botão flutuante "Criar" facilita a criação de eventos.
10. Minhas configurações de filtro são salvas?
Sim. Todas as configurações (filtros selecionados, modo de visualização, preferência de cores e exibição de finais de semana) são salvas automaticamente no seu perfil e restauradas ao acessar a agenda novamente.
11. O que são os badges numéricos nos eventos?
Os badges (etiquetas com números) exibidos nos eventos representam o ID do registro vinculado (pedido, orçamento ou incidente). Clique no evento para ver mais detalhes sobre o vínculo.
12. Como funciona o indicador "+X mais" na visão mensal?
Na visão de mês, quando há muitos eventos em um mesmo dia, o calendário exibe um indicador como "+3 mais". Clique nele para expandir e ver todos os eventos daquele dia.
13. Posso ocultar os finais de semana?
Sim. Acesse as Configurações (ícone de engrenagem) e desative a opção "Exibir Final de Semana". O calendário passará a exibir apenas os dias úteis.
14. Qual a diferença entre "Tipo de Tarefa" e "Tipo de Integração"?
Tipo de Tarefa define a natureza da atividade (Tarefa, Visita, Reunião, etc.).
Tipo de Integração define a qual módulo do sistema a tarefa está vinculada (Orçamento, Pedido, Incidente, Avulsa, etc.).
15. Como excluir um evento da agenda?
Clique no evento para abrir o tooltip e utilize o botão de exclusão. Será solicitada uma confirmação antes da remoção. Essa ação requer permissão de remoção.
---
Documentação do Módulo Agenda — Calcme