Documentação Completa de Operações
O módulo Agendou é a central de gerenciamento de ordens de serviço e atendimentos técnicos. Ele permite a visualização da disponibilidade da equipe, o controle de status de serviços e a roteirização automatizada.
01
A tela de Agenda Administrativa é o painel de controle do gestor. Nela, é possível visualizar a distribuição de tarefas por período e por profissional.
No topo da página, indicadores coloridos facilitam a leitura rápida do status da operação:
Total
Quantidade total de serviços no período selecionado.
Encerrado
Atendimentos já finalizados. (Cor Cinza)
Livre
Horários ou profissionais disponíveis para novos agendamentos. (Cor Verde)
Ocupado
Serviços confirmados ou em execução. (Cor Laranja)
Reagendado
Serviços que sofreram alteração de data/hora. (Cor Vermelha)
- Modos de Exibição: Alternância rápida entre as visões Diário, Semanal e Mensal.
- Navegação Temporal: Seletor de data para consulta de históricos ou planejamentos futuros.
- Ações Rápidas:
- Filtros: Refinamento da busca por critérios específicos.
- Incluir Serviço Manualmente: Atalho para o formulário de novo agendamento.
- Executar Roteirização: Botão de inteligência para otimização de trajetos técnicos.
A tabela central correlaciona os Profissionais com os dias/horários:
- Exibe o volume de atendimentos por técnico.
- Apresenta o percentual de ocupação (ex: "10% utilizado"), auxiliando na identificação de gargalos ou ociosidade.
Este modal é utilizado para cadastrar manualmente um atendimento que não foi originado automaticamente pelo sistema.

| Bloco | Campo | Tipo | Descrição |
|---|
| Cliente | Buscar por CPF | Busca | Aciona a busca por clientes já cadastrados na base de dados (Campo obrigatório). |
| Cliente | Nome Completo | Texto | Nome completo do cliente. |
| Cliente | E-mail / Celular | Contato | Dados de contato para envio de confirmações e contato do técnico. |
| Serviço | Data e Hora | Data/Hora | Definição da data e horário de início do atendimento. |
| Serviço | Tipo de Serviço | Select | Define a categoria da O.S (Instalação, Reparo, Manutenção, etc). |
| Serviço | Origem | Select | Identifica por qual canal o pedido foi solicitado. |
| Serviço | Profissional | Select | Seleciona o técnico que será responsável pela execução. |
| Serviço | Status | Select | Define a situação atual do agendamento (ex: Agendado, Pendente). |
| Local | CEP | Busca | Aciona a busca automática de logradouro a partir do CEP informado. |
| Local | Endereço Completo | Texto | Inclui campos para UF, Cidade, Bairro, Rua e Número. |
| Local | Complemento | Texto | Campo livre para informações adicionais (Bloco, Apto, Referência). |
| Notas | Observações | Texto Longo | Campo livre para inserir qualquer informação técnica ou observação relevante. |
O sistema permite um refinamento preciso da grade através do modal de Filtros Avançados, garantindo agilidade na localização de demandas específicas.
Campos Disponíveis para Filtragem:- Profissional: Permite selecionar um técnico específico para ver sua agenda individual ou visualizar "Todos os profissionais".
- Prioridade: Segmenta os atendimentos pelo nível de urgência definido no cadastro (Alta, Média, Baixa, Urgente).
- Tipo de serviço: Filtra por categorias específicas (Acompanhamento, Fibra - Manutenção, Fibra Ativação CRM, Fibra Retirada - Faturamento e Rádio - Retirada.).
- Status: Visualiza agendamentos em estados específicos (Encerrado, Livre, Ocupado, Reagendado).
- Origem: Filtra pelo canal de entrada do serviço (Interna, CRM, ERP Voalle).
- Cidade: Segmenta a visualização por localidade de atendimento.
Ações:- Limpar Filtros: Reseta todas as seleções para o padrão inicial, exibindo todos os registros.
- Aplicar: Processa os critérios selecionados e atualiza a grade da Agenda Administrativa.
02
O menu Motivos de Quebra tem como objetivo centralizar as justificativas para interrupções ou falhas no fluxo de trabalho e agendamentos. Essas informações são cruciais para a geração de relatórios de desempenho e identificação de gargalos operacionais.
Seguindo o padrão visual do módulo Agendou > Cadastros, a tela apresenta uma listagem organizada contendo os motivos já registrados no sistema.
Componentes Principais:- Botão Novo (+): Localizado no canto superior direito, permite a abertura do formulário para criação de um novo motivo.
- Barra de Pesquisa: Campo para realizar buscas rápidas por nome entre os motivos já cadastrados.
- Tabela de Dados: Exibe as colunas Nome do motivo e o Status (Ativo/Inativo).
- Ações: Ícones para Editar (lápis amarelo) ou Excluir (lixeira vermelha) um registro específico.
Para inserir um novo motivo de quebra no sistema, siga os passos abaixo:
- No menu lateral, acesse: Agendou > Cadastros > Motivos de quebra.
- Clique no botão (+) verde no canto superior direito da tela.
- No formulário que será exibido, preencha as seguintes informações:
- Descrição/Nome: Insira o nome claro da ocorrência (ex: "Problema Mecânico", "Cliente Ausente", "Clima Adverso").
- Status: Defina se o motivo está disponível para uso imediato.
- Clique no botão Salvar para confirmar o registro.
| Ação | Descrição |
|---|
| Editar | Sempre que precisar corrigir a grafia ou nomenclatura de um motivo. |
| Excluir | Utilize apenas para motivos criados erroneamente. Se o motivo já foi utilizado em atendimentos passados, recomenda-se apenas inativá-lo para manter a integridade do histórico. |
| Padronização | Mantenha nomes curtos e objetivos para facilitar a seleção pelo técnico em campo. |
O menu Origens é utilizado para identificar a procedência dos serviços. Através dele, o sistema consegue rastrear se uma demanda foi gerada internamente ou através de integrações externas (APIs).
Colunas da Tabela:- Nome: Identificação amigável da origem (ex: CRM, ERP Voalle, Interna).
- Descrição: Texto explicativo opcional sobre a finalidade ou regra daquela origem.
- Identificador: Código técnico utilizado pelo sistema para reconhecimento via API (ex: crm-api, erp-voalle, internal).
Como Cadastrar:- Acesse Agendou > Cadastros > Origens.
- Clique no botão (+) verde no canto superior direito.
- Preencha os campos Nome*, Identificador* e Descrição.
- Clique em Adicionar.
O menu Prioridades permite classificar a urgência dos serviços. Essas definições são essenciais para organizar a fila e destacar visualmente os chamados mais críticos na agenda.
Colunas da Tabela:- Nome: O rótulo da prioridade (ex: Urgente, Alta, Média, Baixa).
- Peso: Valor numérico que determina a relevância para ordenação. Quanto menor o número, maior o peso (Ex: Peso 0 é prioridade máxima).
- Cor: Identificador visual que será aplicado nos cards e dashboards.
Lógica de Ordenação: O sistema utiliza o campo peso para organizar as filas automaticamente. O peso 0 tem precedência sobre o peso 1, e assim por diante.
O menu Profissionais é o local onde são cadastrados todos os colaboradores (técnicos, motoristas, etc.) que prestam serviços e utilizam o sistema através do módulo Agendou.
Colunas da Tabela:- Nome / Tipo de profissional: Nome completo e a categoria funcional do colaborador.
- Email / Celular: Informações básicas de contato.
- Status: Indica se o colaborador está Ativo ou Inativo no sistema.
- Ações: Botões para Ver horários (azul), Editar (amarelo) e Excluir (vermelho).
Clique no botão (+) verde e preencha o formulário:
- Dados Básicos: Selecione o usuário correspondente (previamente cadastrado no hLiberty). Defina o Nome, Status, Contato e o Tipo de profissional.
- Integração ERP: Vincule ao registro correspondente do profissional dentro do ERP para sincronização de dados.
Acesse através do botão azul "Ver horários". Esta configuração é fundamental, pois determina quando o profissional aparecerá como "Livre" na agenda administrativa. Para configurar: clique no botão (+) verde, selecione os Dias da semana, a Hora inicial / Hora final e o Status. Clique em Adicionar.
O menu Status gerencia as diferentes fases de um atendimento, controlando regras de comportamento e a representação visual na agenda.
Colunas da Tabela:- Nome / Descrição / Cor (Texto e Fundo).
- Regras de Fluxo: Indica se o status permite ser Reagendado, Removido ou se é considerado um Status Final (conclusivo).

03
O menu Clientes é o repositório central de todos os usuários e empresas atendidos pela Liberty. Permite o gerenciamento completo de dados cadastrais e o vínculo direto com os agendamentos de serviços.
Componentes Principais da Listagem:- Barra de Pesquisa: Localize rapidamente por Nome, CPF/CNPJ ou Código identificador.
- Tabela de Dados: Exibe colunas de Nome, Documento, Telefone e Localidade.
- Ações: Visualizar perfil (azul), Editar (amarelo) e Excluir (vermelho).
Cadastro de Clientes: O formulário é dividido em blocos de Dados Cadastrais (Razão Social/Nome, CPF/CNPJ) e Informações de Contato (E-mail, Celular, Logradouro completo).

O menu Minha Agenda é o painel de controle individual e simplificado do colaborador em campo. Ele exibe automaticamente apenas os serviços que foram vinculados ao perfil do usuário logado.
- Filtro de Período: Permite que o técnico navegue entre sua escala de datas passadas para consulta ou futuras para planejamento.
- Visão em Lista/Cards: Apresenta o Horário, o nome do Cliente, o Tipo de serviço e o Endereço de forma clara e direta.
Ao clicar em um agendamento específico, o profissional tem acesso às funções de execução:
- Detalhes do Cliente: Acesso rápido a telefones de contato e observações técnicas inseridas no agendamento.
- Localização e Rotas: Botão de integração com aplicativos de GPS para traçar o melhor trajeto até o endereço.
- Check-in/Check-out: Registro obrigatório do horário de chegada e saída para controle de tempo de permanência no local.
⚠️ Nota Operacional Importante: Para que a agenda individual funcione corretamente, o usuário do hLiberty deve estar vinculado a um cadastro de Profissional Ativo e possuir uma escala de horários configurada no sistema.
04
O menu Roteirizações é a ferramenta de inteligência logística do sistema. Sua função é organizar e otimizar as rotas diárias da equipe, agrupando os atendimentos por proximidade geográfica e disponibilidade de horários.
- Botão Nova Roteirização (+): Inicia o processo de cálculo e criação de novas rotas.
- Histórico de Execuções: Tabela que exibe o Status da roteirização, Início, Término e o resumo dos atendimentos processados.
Para criar uma nova roteirização, o gestor define critérios fundamentais: Nome da Rota, Seleção de Período (datas), Status dos serviços a serem incluídos e o Horário previsto de execução.
| Recurso | Descrição |
|---|
| Otimização de Tempo | O sistema calcula o melhor trajeto reduzindo o tempo ocioso entre um cliente e outro. |
| Economia de Combustível | Agrupa serviços por bairros ou regiões próximas, evitando deslocamentos desnecessários. |
| Confirmação na Agenda | Após processada, a rota otimizada é enviada diretamente para a "Minha Agenda" dos profissionais correspondentes. |
Após a execução, o sistema oferece uma visão geográfica com pontos numerados na ordem sugerida pelo algoritmo, permitindo que o gestor identifique a mancha de atendimento e realize ajustes manuais se necessário.
💡 Dica Técnica: Para que a roteirização tenha 100% de precisão, é vital que os cadastros de Clientes possuam o CEP correto, garantindo a geolocalização exata dos pontos no mapa.
WIKI LIBERTY • MANUAL TÉCNICO COMPLETO • AGENDOU ©
ÚLTIMA ATUALIZAÇÃO: 24 DE MARÇO DE 2026