Rotina de CRM do Portal

Histórico de Alterações

Data	Quem	Comentários
09/10/2026	Renato Lima	Criação do documento

Documento Anexo

Este documento foi criar pela desenvolvedora, após realizar modificações na funcionalidade de CRM implementadas.

Rotina de CRM do Portal

Portal GeoSales — Documentação funcional

Objetivo da rotina

A rotina de CRM centraliza no Portal GeoSales o acompanhamento do relacionamento com clientes e prospects. Ao acessar um cliente pelo Atendimento, o usuário pode consultar, na mesma tela, notas, eventos, tarefas e contatos, além das informações comerciais já existentes, como pedidos, financeiro e pesquisas.

O objetivo é registrar atividades de relacionamento que antes poderiam ficar em agendas pessoais, papéis ou e-mails, mantendo o histórico vinculado ao cliente.

Conceitos principais

Evento

Compromisso com data e hora, como reunião, visita ou apresentação. Possui início e fim, participantes e pode ter repetição.

Tarefa

Pendência com prazo, como retornar uma ligação, enviar uma proposta ou cobrar um documento. Possui assunto, vencimento, responsável e prioridade.

Evento e Tarefa possuem abas e telas de cadastro próprias. A distinção é definida explicitamente pelo campo Tipo no cadastro de Tipo de Atividade, e não por inferência a partir de outros campos.

O termo “Atividade” permanece no nome da configuração dos tipos, embora o conceito de pendência seja apresentado ao usuário como “Tarefa”.

Migração dos tipos existentes

Na migração, todos os tipos existentes foram classificados como Evento. Nenhum foi convertido automaticamente em Tarefa, pois não era possível determinar a intenção de cada tipo anterior. Por isso, inicialmente, o Cadastro de Tarefa pode apresentar a lista de tipos vazia. Para utilizar tarefas, é necessário cadastrar um tipo com o campo Tipo definido como Tarefa.

Cadastro de Tipo de Atividade

O Tipo de Atividade define quais opções estarão disponíveis para os usuários no cadastro de eventos e tarefas.

Campo	Descrição
Tipo	Obrigatório. Define se o tipo será utilizado para Evento ou Tarefa.
Online	Indica que o evento é remoto e dispensa endereço. O campo é exibido somente quando Tipo = Evento.
Perfis	Define quais perfis podem utilizar o tipo. Sem perfil vinculado, o tipo não é exibido para usuários.
Ativo	Permite desativar o tipo sem excluí-lo. Os registros existentes vinculados a ele permanecem íntegros.

Regras para o cadastro de Evento

• O endereço é obrigatório quando o tipo selecionado é Evento e não está marcado como Online.
• Para eventos online, o endereço não é exigido.
• A obrigatoriedade de hora é controlada por um indicador legado que não está disponível na tela de tipos.
• Tipos antigos mantêm a configuração de obrigatoriedade de hora que já possuíam.
• Todo tipo criado atualmente é configurado sem exigir hora.

Como os tipos são exibidos aos usuários

Para que um tipo apareça no cadastro, todas as condições abaixo devem ser atendidas:

1. O tipo deve estar ativo.
2. O tipo deve estar vinculado ao perfil do usuário logado.
3. O campo Tipo deve corresponder à tela: o Cadastro de Evento apresenta somente tipos de Evento, e o Cadastro de Tarefa apresenta somente tipos de Tarefa.

Se um tipo não aparecer, verificar primeiro se está ativo e vinculado ao perfil do usuário. Em seguida, confirmar se o tipo está classificado corretamente como Evento ou Tarefa.

Mesa do cliente

A mesa do cliente é acessada pelo Atendimento e reúne as informações comerciais e de relacionamento. Cada aba depende da permissão correspondente do usuário.

Aba	Conteúdo
Mesa	Painel comercial existente, com pedidos, informações financeiras e pesquisas.
Notas	Linha do tempo de anotações livres sobre o cliente, agrupadas por recência, com autor e resumo.
Eventos	Compromissos do cliente organizados em linha do tempo por data.
Tarefas	Pendências do cliente, exibidas com prazo e prioridade.
Contatos	Pessoas vinculadas ao cliente, com nome, cargo, telefone e e-mail.

Abas Eventos e Tarefas

As abas de Eventos e Tarefas possuem filtros no topo, sete indicadores clicáveis na lateral que funcionam como atalhos de filtragem e registros exibidos em cartões. As ações dos cartões permitem operar sem sair da listagem.

Recurso	Eventos	Tarefas
Filtros	Período, status e tipo	Período, status, prioridade e tipo
Ações do cartão	Notas, editar e alterar status	Notas, editar, alterar status e prioridade
Ordenação	Por data	Por data e, no mesmo dia, por prioridade

A alteração do status pelo cartão não exige abrir o cadastro do registro.

Aba Contatos

A aba Contatos apresenta as pessoas vinculadas ao cliente e um resumo do relacionamento com quatro indicadores:

• Quantidade total de contatos cadastrados.
• Quantidade de contatos com telefone informado.
• Quantidade de contatos com cargo informado.
• Quantidade de contatos já vinculados a algum evento.

É possível criar um evento diretamente a partir de um contato. Nesse caso, o evento fica relacionado tanto ao cliente quanto à pessoa com quem será realizado o contato.

Cadastro de Evento e Cadastro de Tarefa

As telas são separadas porque os registros possuem campos e comportamentos diferentes.

Cadastro de Evento

Contém dados de data e hora, endereço/local, convidados e repetição. Possui as abas Detalhes, Convidados e Repetição.

Cadastro de Tarefa

Contém assunto, tipo, vencimento, descrição, prioridade e responsável.

Ambos permitem vincular o registro a um cliente ou cliente prospect e, opcionalmente, a um contato daquele cliente.

Status inicial

Na criação, o campo Status é preenchido com Agendado e fica bloqueado. O status é liberado para alteração durante a edição do registro.

Atendimento ao Cliente e Prospect

A tela de busca foi renomeada para contemplar clientes e prospects e recebeu filtros voltados à prospecção:

• Busca por e-mail.
• Filtro por data de cadastro, permitindo informar um intervalo, somente uma data mínima ou somente uma data máxima.

Status e prioridade

Todo Evento e toda Tarefa possuem status. O status pode ser definido no cadastro, quando permitido, ou alterado pela ação disponível no cartão. Somente as tarefas possuem prioridade.

Status disponíveis

Status	Cor	Significado
Agendado	Azul	Estado inicial de um novo registro.
Reagendado	Laranja	O compromisso foi remarcado.
Cancelado	Vermelho	O compromisso ou atividade não será realizado.
Finalizado	Verde	Registro concluído.

Prioridade das tarefas

A prioridade possui cinco níveis, de Muito Baixa a Muito Alta, com Normal como padrão. Ela se aplica somente às tarefas.

As tarefas são ordenadas primeiro pela data de vencimento e, dentro do mesmo dia, da maior para a menor prioridade. Dessa forma, os vencimentos mais próximos aparecem primeiro e as tarefas mais urgentes ficam no topo do dia.

Repetição de eventos

Um evento pode se repetir diariamente, semanalmente ou mensalmente. Cada ocorrência é armazenada como um registro próprio, e as ocorrências são relacionadas por um identificador de série. Assim, uma ocorrência pode ser tratada isoladamente sem alterar as demais.

Frequência	Limite a partir da data inicial
Diária	3 meses
Semanal	12 meses
Mensal	24 meses

Quando a repetição é utilizada, a data final é obrigatória e deve estar entre a data inicial do evento e o limite permitido para a frequência selecionada. Na repetição mensal, também são informados os dias do mês em que o evento ocorrerá.

Convidados e notificações por e-mail

Um evento pode possuir dois tipos de convidados:

• Usuários do sistema: pessoas da própria empresa, selecionadas em uma lista.
• Convidados externos: pessoas de fora da empresa, informadas por nome e e-mail, sem necessidade de possuir usuário no Portal.

Quando a opção de notificação está habilitada na criação do evento, o sistema gera um e-mail com base em um modelo configurável e o coloca na fila de envio automático. Se a logomarca da empresa estiver cadastrada, ela será incluída no e-mail.

Atenção: para eventos recorrentes, o e-mail de notificação é disparado uma única vez, e não para cada ocorrência gerada.

Visibilidade dos registros

Um Evento ou uma Tarefa fica visível para o usuário quando ele é o criador do registro ou o responsável por ele. O campo de responsável permite que um usuário crie uma tarefa e a atribua a outra pessoa.

Permissões de acesso

O acesso à rotina é controlado pelo Controle de Acessos e pelo Controle de Ações. As permissões relacionadas estão agrupadas sob o módulo CRM.

Permissão	Efeito
VISUALIZAR_MODULO_CRM	Exibe o módulo CRM no menu lateral.
VISUALIZAR_MENU_LISTAGEM_NOTA	Libera a aba Notas e a tela de listagem de notas.
VISUALIZAR_MENU_CADASTRO_EVENTO	Libera as abas Eventos e Tarefas e as respectivas telas de cadastro. A permissão é compartilhada pelas duas abas.
VISUALIZAR_ABA_CONTATO_CLIENTE	Libera a aba Contatos.
MANTER_CONTATO_CLIENTE	Permite incluir, editar e excluir contatos. Sem essa permissão, o usuário pode apenas consultar.
OCULTAR_ABA_MESA_CLIENTE	Oculta a aba Mesa para usuários que utilizam o Portal apenas como CRM e não precisam da parte comercial.
VISUALIZAR_MENU_LISTAGEM_TIPO_EVENTO	Libera a tela de cadastro dos tipos.
VISUALIZAR_MENU_LISTAGEM_FASE_PEDIDO	Libera a tela de fases do pedido, também localizada no módulo CRM.

Considerações para liberação aos clientes

• As permissões criadas para a rotina começam desativadas e não são atribuídas automaticamente aos perfis. Devem ser concedidas conforme a necessidade de cada cliente.
• As permissões criadas nesta rotina estão vinculadas ao plano comercial Evolution. Mesmo concedidas, não alcançam clientes de outros planos.
• As telas que vieram do módulo Eventos mantiveram os planos comerciais que já possuíam.
• Como algumas telas mudaram de módulo, os perfis que já as utilizavam precisam receber a permissão VISUALIZAR_MODULO_CRM para voltar a visualizá-las.

Estrutura de dados

Evento e Tarefa compartilham a mesma tabela

Eventos e tarefas são armazenados na tabela EVENTO. Não existe uma tabela exclusiva para tarefas. A distinção entre Evento e Tarefa é determinada pelo Tipo de Atividade vinculado ao registro.

Por isso, relatórios e integrações que precisem separar eventos de tarefas devem considerar o tipo associado ao registro.

Tabelas envolvidas

Tabela	Finalidade
EVENTO	Armazena o registro, incluindo título, descrição, datas, horas, endereço, status, prioridade, responsável, criador e vínculos com cliente e contato.
TIPO_EVENTO	Armazena os tipos configuráveis, incluindo os indicadores de Evento/Tarefa e Online. Na tela, é apresentada como Tipo de Atividade.
TIPO_EVENTO_PERFIL	Define quais perfis podem utilizar cada tipo.
PARTICIPANTE_EVENTO	Armazena convidados que são usuários do sistema.
PARTICIPANTE_EXTERNO_EVENTO	Armazena convidados externos, com nome e e-mail.
FREQUENCIA_EVENTO	Armazena os dias em que ocorre uma repetição.
CLIENTE_SOCIO_APROVACAO	Armazena contatos de clientes. A tabela, originalmente utilizada para sócios de clientes prospect, foi estendida para funcionar também como cadastro de contatos.

Relacionamentos entre os dados

• Cada registro da tabela EVENTO referencia um registro de TIPO_EVENTO, que determina se é Evento ou Tarefa.
• Cada registro pode estar vinculado a um cliente e, opcionalmente, a um contato desse cliente.
• Os convidados usuários do sistema e os convidados externos são armazenados em tabelas distintas.
• Cada ocorrência de uma repetição possui uma linha própria na tabela EVENTO; as ocorrências são relacionadas pelo identificador de série.
• Os contatos são mantidos na tabela CLIENTE_SOCIO_APROVACAO, que reúne registros de sócios e contatos. Essa característica deve ser considerada na elaboração de relatórios e integrações.

Módulo CRM no menu lateral

O Portal passou a apresentar o módulo CRM no menu lateral, reunindo telas que anteriormente estavam distribuídas entre os módulos Eventos e Vendas.

Itens do menu CRM:

• Tipo de Atividades — cadastro dos tipos.
• Listagem de Eventos.
• Cadastro de Tarefa.
• Listagem de Fases do Pedido.
• Listagem de Notas.

Com essa reorganização, o módulo Eventos deixou de existir como item de menu. As telas que estavam nesse módulo passaram para CRM; Notas e Fases do Pedido, antes localizadas em Vendas, também foram migradas.

Referência documental

Documentação elaborada a partir do código e das telas do Portal GeoSales.

Observação: este conteúdo foi convertido do documento funcional “Rotina de CRM do Portal”, datado de 30/09/2026. As imagens e capturas de tela do PDF original não foram incorporadas ao texto Wiki. """ path="/mnt/data/Rotina_de_CRM_do_Portal_Wiki.txt" with open(path,"w",encoding="utf-8") as f:

   f.write(content)

print(path, len(content), content.count("\n"))