Pular para o conteúdo do manual
PlenoAgent Suite · Módulo Gestão Técnica

Manual de Gestão Técnica

Guia prático para o trabalho técnico de campo: o aplicativo do técnico (ordens, relatórios, inventário, avisos e localização sem conexão), o despacho e a revisão na web, e o diagnóstico dos problemas mais comuns.

Versão1.1 · setembro 2026
AlcanceMódulo Gestão Técnica (FieldOps)
PerfilTécnico de campo e despachante

1O que é o FieldOps e quem usa

O FieldOps organiza o trabalho técnico do ISP: o despachante cria e atribui ordens na web, o técnico as executa com o aplicativo móvel e o supervisor revisa relatórios, inventário e métricas. Tudo fica registrado com histórico: quem fez o quê, quando e por qual motivo.

Perfis e ferramentas do FieldOps
PerfilFerramentaO que faz
TécnicoAplicativo Android (APK da PlenoAgent)Ver suas ordens, navegar até o local, registrar chegada e início, completar checklist e relatório, fotografar evidências, movimentar inventário e pedir ajuda ao assistente.
DespachanteMódulo FieldOps na webCriar e atribuir ordens, ver calendário e mapa, revisar e devolver relatórios, ativar serviços, gerenciar turnos, ausências, habilidades, SLA e alertas.
SupervisorMódulo FieldOps na webRevisar relatórios, conciliar inventário e mudanças de rede, consultar indicadores e resolver conflitos.
Uma única verdade

O aplicativo, a web e o assistente usam os mesmos serviços. Um relatório concluído no telefone e um ditado ao assistente passam pelas mesmas validações e deixam o mesmo histórico.

2Instalar o aplicativo e entrar

  1. Na web, abra Gestão Técnica e entre na aba Móvel: lá está a versão publicada do aplicativo com seu tamanho, o hash SHA-256 e o Android mínimo exigido. Baixe o APK com Baixar. Se a sua empresa verifica hashes, compare o SHA-256 do arquivo com o mostrado na tela.

  2. Instale o APK. Se o Android pedir para permitir instalar desta fonte, ative apenas para esta instalação e desative depois.

  3. Abra o aplicativo e informe o endereço do servidor da sua empresa, seu usuário e sua senha.

  4. Quando o aplicativo pedir permissões de localização, câmera e notificações, aceite: sem localização não há acompanhamento de turno, sem câmera não há evidências e sem notificações você não recebe os avisos de ordens atribuídas ou devolvidas. O porquê de cada permissão é explicado na tela antes de pedir.

  5. Ao entrar, você verá suas abas: Trabalho (suas ordens), Inventário (seu material e equipamentos), Avisos (atribuições, mudanças de horário e relatórios devolvidos), Sincronização (estado da sua fila local) e Assistente (ajuda com seus dados).

Ao sair

Sair apaga do telefone as ordens baixadas, os rascunhos, a fila pendente, as fotos não enviadas e a chave local. Sincronize antes de sair ou de trocar de aparelho, ou esse trabalho será perdido.

3A jornada do técnico, passo a passo

  1. Inicie seu turno ao começar o dia. O acompanhamento de localização só funciona dentro de um turno ativo e para quando você o encerra.

  2. Abra a ordem: você verá cliente, contato autorizado, endereço, coordenadas, janela de visita, NAP/porta ou AP/setor e os equipamentos disponíveis. Se um dado diz desconhecido, ninguém o confirmou; se diz desatualizado, passou mais de 30 dias sem confirmação.

  3. Toque em Como chegar para navegar com o mapa do telefone e registre A caminho, Chegada e Início com seus botões. A chegada é confirmada manualmente: o GPS é aproximado e nenhuma geocerca muda o estado por você.

  4. Se precisar interromper o trabalho, use Pausar escrevendo o motivo (é obrigatório) e retome depois com seu botão. As pausas descontam do tempo de SLA, por isso o motivo fica sempre registrado.

  5. Complete o checklist, as medições, os materiais e as fotos. Você pode salvar um rascunho a qualquer momento, mesmo sem internet.

  6. Envie o relatório quando estiver completo. O servidor verifica requisitos, fotos verificadas e versão da ordem: se faltar algo, ele diz exatamente o quê.

  7. Se o supervisor devolver o relatório, corrija o solicitado e envie de novo: a revisão anterior é conservada, nada é apagado.

Estados de uma ordem
EstadoSignificado
AtribuídaTem responsável. O técnico ainda não atuou nela.
A caminho / No local / Em andamentoViagem, chegada confirmada e trabalho em curso.
PausadaTrabalho interrompido com motivo obrigatório. As pausas descontam do SLA.
Em revisãoRelatório enviado, aguardando o supervisor.
ConcluídaRelatório aprovado. Só então o serviço pode ser ativado.
Falhada / CanceladaNão pôde ser concluída ou foi cancelada, sempre com motivo registrado.
O relatório não ativa sozinho

Concluir um relatório nunca ativa nem fatura o serviço por si só. A ativação é solicitada pelo supervisor como ação explícita e fica registrada com seu resultado.

4Trabalhar sem conexão, e avisos

4.1A fila local

O aplicativo baixa suas ordens para trabalhar sem internet e guarda cada mudança em uma fila no telefone que sobrevive a reinícios. Ao recuperar o sinal, a fila sincroniza operação por operação. A aba Sincronização mostra quantas operações seguem guardadas apenas no telefone.

Estados de sincronização
EstadoSignificadoO que fazer
LocalSalvo apenas no telefone.Nada: será sincronizado sozinho.
PendenteNa fila aguardando rede.Recupere a cobertura e abra o aplicativo.
SincronizadoConfirmado pelo servidor.Nada.
ConflitoAlgo mudou no servidor (reatribuição, outro técnico consumiu o equipamento, porta ocupada).Leia o motivo, conserve seu rascunho e coordene com o despacho. Nada é sobrescrito sozinho.
RejeitadoSem permissão ou dados inválidos.Corrija e tente de novo, ou peça ajuda.
Acesso sem conexão

Os dados baixados vencem em 72 horas e as fotos pendentes são conservadas até verificação no servidor. Uma foto nunca é apagada do telefone antes de confirmação acima.

4.2Avisos: o que o aplicativo avisa

A aba Avisos notifica o que muda em suas ordens ao sincronizar: ordem atribuída, horário modificado e relatório devolvido. Cada aviso indica a ordem e seu motivo; com Marcar tudo como lido você limpa a lista. Os avisos chegam ao sincronizar, por isso abra o aplicativo com internet ao começar o dia para não trabalhar com informação antiga.

5Relatório: checklist, fotos e envio

Cada tipo de trabalho tem seu modelo: uma instalação de fibra pede potência óptica, serial, NAP/porta e ONU; uma de rádio pede sinal, AP e CPE. O aplicativo só exige o do seu modelo.

  • Fotos: cada foto fica vinculada à ordem escolhida antes de disparar. Revise o requisito que ela cobre: o envio é bloqueado se faltar uma foto obrigatória ou se alguma não terminou de verificar.
  • Confirmação do cliente: se o modelo exigir, registre Confirmada, Ausente ou Recusada com nome ou motivo. É uma confirmação operacional, não uma assinatura digital certificada.
  • Envio: o botão de envio valida tudo junto. Se algo falhar, o aplicativo lista cada campo pendente para você completar e tentar de novo.

6Inventário em campo

Consulte seu material e equipamento sob custódia em Inventário. Para registrar um serial ou MAC, use o leitor de QR ou digite à mão: o aplicativo mostra para você confirmar duas vezes antes de aceitar.

  1. Reservar separa uma unidade para sua ordem.

  2. Entregar e Instalar a vinculam ao serviço; Devolver e Retirar a devolvem à custódia.

  3. Substituir troca um equipamento instalado por outro dentro da mesma ordem; Inspecionar registra a revisão do equipamento sem movê-lo.

  4. Consumir desconta materiais (cabo, conectores) com sua unidade de medida.

Um único vencedor

Se dois técnicos tentarem o mesmo serial ou porta, só o primeiro consegue; o segundo vê um conflito claro. Os conflitos de equipamento e porta nunca se resolvem como "o último que escreve vence": ficam pendentes até o despacho resolvê-los.

7Localização durante o turno

O mapa do despacho mostra sua última posição com sua idade e precisão. O estado de localização é independente do estado da ordem.

Estados de localização
EstadoSignificado
AtualPonto de há menos de 2 minutos.
DesatualizadaEntre 2 e 10 minutos. Revise cobertura e economia de bateria.
Sem conexão / Permissão negada / Fora de turnoSem pontos recentes, sem permissão ou sem turno ativo.

Se o mapa parar de ver você, verifique nesta ordem: turno ativo, permissão de localização em Sempre ou Durante o uso mais segundo plano, economia de bateria desativada para o aplicativo e cobertura de dados.

No painel do módulo, o despachante vê o mapa com a última posição de cada técnico e pode abrir o trajeto do dia para revisar por onde passou. A empresa configura por quantos dias a localização é conservada (30 por padrão); vencido esse prazo, os pontos antigos são eliminados.

8O assistente: aplicativo e WhatsApp

8.1Ajuda dentro do aplicativo

A aba Assistente responde com seus dados autorizados ("para qual NAP vai minha próxima instalação?", "qual ONU tenho disponível?") e ajuda a montar o rascunho perguntando cada dado faltante e confirmando a ordem antes de salvar. Toda tentativa fora da sua permissão é rejeitada. O assistente precisa de internet: sem conexão, use os formulários, que funcionam igual.

8.2Falar pelo WhatsApp: como se configura

Os técnicos também podem usar o assistente pelo WhatsApp. A configuração está na web, na aba Agente do módulo:

  1. Escolha os técnicos autorizados: só eles poderão falar com o assistente.

  2. Escolha o modelo de IA e o modelo de transcrição (para as mensagens de voz).

  3. Conecte o número de WhatsApp de duas formas: reutilizando uma sessão da empresa já conectada, ou escaneando um novo QR com o telefone que levará o número.

  4. Revise o estado do agente: conectado, conectando ou desconectado. Se desconectar, volte à aba e gere um novo QR.

Sempre há plano B

Se o assistente estiver indisponível (sem modelo, sem créditos ou sem WhatsApp), os formulários, a sincronização e as fotos seguem funcionando igual. O aplicativo não depende da IA para o essencial.

9Despacho e revisão na web

9.1Fila, calendário e atribuição

A fila mostra ordens sem atribuir com filtros por zona, prioridade, estado e vencimento. Ao atribuir, o sistema verifica turno, ausências, habilidades e sobreposições: se houver incompatibilidade, a atribuição para e mostra cada motivo. Você pode escolher outro responsável ou forçá-la com motivo, que fica registrado.

9.2Sugestões, SLA e alertas

Para cada ordem você pode pedir sugestões ordenadas com suas razões (disponível, habilidades, proximidade, carga). Os SLA por tipo e prioridade medem resposta, chegada e resolução no horário comercial da empresa, descontando pausas; as extensões levam motivo auditado. Os alertas avisam uma única vez por atraso, ordem sem aceite, falta de localização ou relatório devolvido, e se resolvem sozinhos quando a causa desaparece. O painel principal resume as métricas de tempo do dia (resposta, chegada e resolução) por técnico e equipe.

9.3Revisão, ativação e recorrência

Em Relatórios você aprova ou devolve com motivo; cada correção cria uma revisão nova sem apagar a anterior. A ativação do serviço é um botão explícito após a aprovação. A manutenção recorrente gera ordens automaticamente (diárias, semanais ou mensais) para serviços ou pontos de rede como NAPs, OLTs e roteadores.

10Diagnóstico e suporte

Minhas ordens não aparecem
Abra Sincronização e sincronize. Se acabou de reinstalar ou sair, entre de novo: o cache local foi apagado.
Uma operação ficou em conflito
Leia o código e o detalhe no cartão de sincronização. Não tente de novo às cegas: se outro técnico pegou o equipamento ou a porta, coordene com o despacho.
O mapa não me mostra atualizado
Confirme turno ativo, permissão de localização, bateria sem restrição e cobertura. Sem sinal não há pontos: o mapa mostra como desatualizado em vez de inventar sua posição.
A câmera ou o QR não respondem
Revise a permissão de câmera do sistema e reabra o detalhe da ordem. Você sempre pode digitar o serial à mão com dupla confirmação.
O envio de uma foto não avança
Mantenha o aplicativo aberto com rede. A foto é conservada no telefone e a fila retoma de onde parou.
O assistente não responde
Use os formulários: o essencial não precisa de IA. Avise o suporte com a hora e a mensagem de erro.
Não recebo avisos de ordens novas
Revise a permissão de notificações do sistema e abra o aplicativo com internet: os avisos chegam ao sincronizar. Se a ordem tampouco aparece em Trabalho, sincronize manualmente em Sincronização.
O que enviar ao suporte

Versão do aplicativo (visível no app), seu usuário, número da ordem, hora aproximada do problema, captura do estado de sincronização e se você estava com dados, Wi-Fi ou sem rede.

PlenoAgent Suite · Manual de Gestão Técnica v1.1 · setembro 2026
Descreve a interface e o comportamento implementados na data desta edição.