Registro de atendimentos

Abra Atendimento → Cadastrar no menu lateral para lançar um contato com o cliente. Use Atendimento → Gerenciar para consultar e manter os registros. No manual, Atendimento tem um capítulo próprio, separado de Gestão.

Na tela Cadastrar, a seção Dados do atendimento usa o mesmo padrão visual do cadastro de Pedidos. Cliente, tipo e potencial ficam alinhados na primeira linha do formulário; as observações ficam logo abaixo. O campo em foco usa uma borda simples, como nos demais formulários.

Registrar atendimento

Em Cliente, digite o nome, o código ou o CPF/CNPJ e escolha a pessoa na lista exibida logo abaixo do campo. A busca começa no primeiro caractere e informa quando não há cliente ativo encontrado. Confira o código exibido antes do nome.
Selecione o Tipo: WhatsApp, Telefone, Presencial ou Outro.
Indique o Potencial de negócio de 1 (baixo) a 5 (alto) e, se desejar, escreva o resumo em Observações.
No celular, permita o acesso à localização deste site no navegador e mantenha a localização do aparelho ativa. O sistema começa a captura ao abrir a tela e a repete ao salvar se a posição tiver mais de 30 segundos. Sem coordenadas válidas, o registro é bloqueado e um aviso temporário informa o que verificar. No desktop, a localização é opcional. Depois de preencher os campos, clique em Registrar na barra superior.

Se aparecer uma mensagem pedindo a preparação da tabela ao tentar Registrar, solicite ao administrador que execute scripts/Database/pessoasatendimento.sql no banco do ERP. Sem a tabela, nenhum atendimento é salvo. No celular, as colunas de coordenadas também são necessárias; em instalações já existentes, o mesmo script pode ser reaplicado para criá-las.

O formulário não reserva uma faixa para mensagens abaixo dos botões. Erros de seleção, localização ou gravação aparecem em avisos temporários quando a ação é executada.

Gerenciar registros

Atendimento → Gerenciar segue a disposição de Pedidos → Gerenciar: filtros compactos e alinhados à esquerda no topo, com a tabela ocupando a área restante. Data inicial e Data final vêm preenchidas com o primeiro e o último dia do mês vigente; altere ou limpe as datas para consultar outro período. Informe também Número e/ou Pessoa, se precisar, e clique em Buscar. A busca por pessoa aceita código ou parte do nome. A tabela mostra até 100 atendimentos ativos da empresa que atendem aos filtros, do mais recente para o mais antigo, com data e hora, cliente, colaborador, tipo, potencial, observações e coordenadas quando disponíveis. Role a tabela para conferir as linhas. O histórico de visitas da planilha CRM Inova não é importado.

Na coluna Ações, oos ícones ficam centralizados na altura da linha. O ícone de mapa abre as coordenadas do atendimento no Google Maps em outra aba; ele aparece somente quando há latitude e longitude válidas. Use o ícone de lápis para abrir o formulário de edição. Altere cliente, tipo, potencial ou observações e clique em Salvar alterações na barra superior; Cancelar edição descarta as mudanças. Use o ícone de lixeira para remover um contato e confirme a ação. Os ícones mostram sua função ao passar o cursor e têm nome para navegação por teclado.

Para obter a lista completa, clique em Excel (CSV) ao lado de Buscar. O arquivo inclui todos os contatos ativos que atendem aos filtros, mesmo quando a tela mostra apenas os 100 mais recentes. Latitude e longitude são exportadas em colunas próprias quando registradas.

Regras de negócio

Apenas um colaborador autenticado pode registrar. O cliente escolhido precisa estar ativo na base de Pessoas acessada no login; a busca não exige empresa no cadastro da pessoa. Digitar um nome sem selecionar a sugestão não identifica o cliente.
Tipo e potencial de 1 a 5 são obrigatórios. A observação é opcional e aceita até 1.000 caracteres.
Ao salvar, o sistema grava empresa, colaborador e data/hora do servidor na entidade PessoasAtendimento. O cadastro de clientes, pedidos e orçamentos não é alterado.
A localização é a posição do aparelho do operador, não o endereço do cliente. No modo mobile, registrar um novo atendimento exige latitude e longitude válidas fornecidas pelo navegador; se a permissão for negada, a captura falhar ou as colunas não existirem no banco, o lançamento é bloqueado. A posição é procurada ao abrir a tela e atualizada ao salvar quando tiver mais de 30 segundos. No desktop, a tela não solicita localização e o atendimento pode ser salvo sem coordenadas, inclusive em bancos antigos sem essas colunas. A edição preserva a localização original.
Ao editar, o sistema altera apenas cliente, tipo, potencial e observações do contato ativo da empresa acessada. Data/hora, colaborador e coordenadas originais são preservados. A validação do cliente e dos campos é a mesma de um novo lançamento.
Remover marca o contato com status 9; não apaga fisicamente o registro. Ele deixa de aparecer em Gerenciar e de contar como último contato nas consultas que consideram apenas atendimentos ativos.
Número identifica o atendimento; as datas filtram o momento do registro, incluindo todo o dia final. O intervalo inicial corresponde ao mês vigente no aparelho, do primeiro ao último dia, e pode ser alterado ou limpo. Pessoa aceita código, nome ou CPF/CNPJ. Todos os filtros se aplicam aos registros ativos da empresa acessada.
O ícone de mapa usa as coordenadas guardadas no atendimento para abrir o Google Maps. Registros sem um par válido de latitude e longitude não mostram essa ação; abrir o mapa não altera o atendimento.
A exportação respeita os mesmos filtros, sem o limite visual de 100 linhas. O arquivo é CSV compatível com Excel, em UTF-8, com separador ponto e vírgula; não é um arquivo .xlsx.
O painel de Gestão calcula clientes atendidos e carteira com pedidos e orçamentos; os contatos lançados aqui não modificam esses indicadores.