Cenário Atual

No Comunicador do CV CRM, existe uma regra de priorização que define para qual usuário uma conversa é direcionada quando um lead envia uma mensagem. Atualmente, o corretor tem prioridade sobre o gestor: se um lead está vinculado a ambos, a conversa é aberta para o corretor.

Objetivo da Melhoria

Permitir que imobiliárias configurem a prioridade de atendimento no Comunicador, possibilitando que gestores sejam priorizados sobre corretores quando esse for o modelo operacional adotado pelo cliente.

Como isso vai ajudar?

Para operações que utilizam SDRs como principal ponto de atendimento, essa configuração permitirá uma dinâmica mais eficiente e alinhada ao fluxo de trabalho da equipe.

Como configurar?

Dentro do canal desejado, acesse o menu "Regras e Configurações" e localize o campo "Inverter preferência de atendimento". Basta habilitá-lo para que o comportamento seja invertido e a prioridade passe a ser do gestor.

🔹 O que é?

Foi adicionada uma coluna de Reservas na listagem de Processos. Ela exibe o ID da reserva vinculada (mais recente) ao processo como um link clicável direto. Quando o processo possui mais de uma reserva, os demais IDs aparecem ao passar o mouse.

🔹 Por que é importante?

Antes, para descobrir qual reserva estava associada a um processo, era necessário acessar o processo e navegar dentro dele. Agora essa informação fica visível direto na listagem, reduzindo cliques, acelerando a consulta e facilitando a navegação entre processos e reservas relacionadas.

🔹 Como funciona?

• Se o processo tem uma reserva: o ID aparece como link clicável, abrindo a reserva diretamente.
• Se o processo tem mais de uma reserva: o primeiro ID é exibido com link clicável, mas ao passar o mouse, os demais IDs aparecem em um tooltip, não clicáveis.
• Se não há reserva vinculada: a célula exibe um traço.

🔹 O que é?

Foi adicionado um filtro de Time na listagem de corretores, permitindo buscar e visualizar corretores por time (Gestão de Times), além de exibir as informações de time de forma padronizada na tela.

🔹 Por que é importante?

Antes dessa melhoria, identificar quais corretores pertencem a cada time exigia esforço manual e a visualização era inconsistente. Agora, gestores têm controle real sobre a atuação dos timesdireto na listagem de corretores.

🔹 Como funciona?

1. Na listagem de corretores, um novo campo de filtro "Time" estará disponível no topo da tela.
2. Ao selecionar um time, a lista é filtrada automaticamente, exibindo apenas os corretores daquele time.
3. As informações do time aparecem de forma padronizada em cada linha da listagem.

🔹 O que é? Uma nova variável de contrato que permite incluir automaticamente a quantidade de vagas de garagem da unidade diretamente no texto do contrato, sem precisar preencher esse dado manualmente.

🔹 Por que é importante? Vagas de garagem são uma informação relevante em contratos de compra, locação ou cessão de unidades. Sem essa variável, o dado precisava ser inserido à mão em cada contrato, aumentando o risco de erro e retrabalho. Com ela, o contrato reflete automaticamente o que está cadastrado na unidade.

🔹 Como funciona?

1. No cadastro da unidade, preencha o campo Quantidade de vagas de garagem
2. Ao gerar o contrato, insira a variável correspondente [[UNIDADE][QTD_VAGAS_GARAGEM]] no cadastro do contrato modelo
3. O sistema puxa automaticamente o valor cadastrado e o exibe no contrato gerado

Por que isso é importante?
Garante consistência de permissões, permitindo controlar se corretor e imobiliária podem ou não aprovar/reprovar documentos no pré-cadastro.

Como funciona?
Foi adicionada a permissão “Alterar  situação dos documentos” no workflow de pré-cadastros para os perfis de corretor e imobiliária.

Regras de funcionamento:

• Por padrão, a permissão vem habilitada. Não alterando o funcionamento atual.
• Quando habilitada, corretor e imobiliária podem aprovar ou reprovar documentos normalmente.
• Quando desabilitada, esses perfis deixam de ter essa ação disponível no pré-cadastro.
• Essa permissão já existia porém apenas para gestor e correspondente.

Por que isso é importante?
Permite maior escala e flexibilidade na captação de leads, possibilitando gerenciar múltiplas contas do Facebook e centralizar as integrações em um único sistema.

Como funciona?
Agora é possível conectar múltiplas contas do Facebook na integração de leads.

Regras de funcionamento:

• O gestor visualiza por padrão apenas as contas que ele conectou.
• Existe uma permissão de perfil que permite visualizar todas as contas conectadas.
• Há um limite padrão de até 10 contas conectadas simultaneamente.
• Esse limite pode ser ajustado via configurações comerciais.

Permissão de perfil para visualizar todas as contas conectadas: 

Caso não libere, verá apenas as suas próprias contas conectadas. 

Por que isso é importante?

Permite que integrações executem ações em nome de diferentes usuários e painéis, garantindo mais controle, consistência nas regras e rastreabilidade das operações.

Como funciona?
Foram adicionados dois novos parâmetros opcionais nas APIs de pré-cadastro: id_usuario e painel.

Esses parâmetros estão disponíveis nos seguintes endpoints:

• Mensagens do pré-cadastro:https://{dominiodocliente}.cvcrm.com.br/api/v3/comercial/precadastros/mensagens
• Documentos do pré-cadastro:https://{dominiodocliente}.cvcrm.com.br/api/v1/comercial/precadastro/documentos
• Aprovar/Reprovar documentos:https://{dominiodocliente}.cvcrm.com.br/api/v3/comercial/precadastro/aprovar-reprovar-documentos
• Edição de pré-cadastro (PUT):https://{dominiodocliente}.cvcrm.com.br/api/v1/comercial/precadastro/[idPrecadastroOuCodigoInterno]

Regras de funcionamento:

• Caso nenhum dos parâmetros seja informado, a API considera automaticamente o usuário autenticado que está realizando a requisição.
• Caso ambos os parâmetros sejam informados, a ação será executada no contexto do usuário (id_usuario) e do painel (painel) definidos.
• Caso apenas um dos parâmetros seja informado, a requisição será considerada inválida e não será processada.

Com isso, integrações passam a ter controle explícito sobre o contexto da operação, mantendo compatibilidade com o comportamento atual quando os parâmetros não são utilizados.

Agora, ao gerar uma comissão a partir da reserva, o sistema passa a criar automaticamente as linhas de pagamento, independentemente da configuração de retirada ou não do subtotal.

Por que isso é importante?

Antes, quando a regra estava configurada para não retirar do subtotal, a comissão era criada, mas sem as linhas de pagamento, exigindo lançamento manual pelo time financeiro.

Com a melhoria:

• Reduzimos esforço operacional
• Eliminamos etapas manuais
• Evitamos erros no lançamento das comissões

Como funciona?

• Ao gerar uma comissão (via reserva):
  • O sistema cria automaticamente as linhas de pagamento
• Esse comportamento ocorre:
  • Independentemente de a comissão estar dentro ou fora do contrato
  • Independentemente da regra de subtotal

Impacto na operação

• Automatização do processo financeiro
• Redução de retrabalho
• Maior consistência nos dados de pagamento
• Agilidade no fluxo de comissões

Por que isso é importante?
Garante segurança e confidencialidade das informações dos clientes, evitando exposição indevida de documentos entre corretores diferentes. Além disso, resolve um problema real do processo comercial do cliente, onde dados sensíveis estavam sendo compartilhados sem controle, o que pode gerar riscos legais e quebra de confiança. 

Também padroniza o comportamento entre workflows (pré-cadastro e reservas), reduzindo inconsistências no produto.

Como funciona?
Foi criada a permissão "Importar documentos da pessoa" dentro do workflow de pré-cadastro.

• Quando habilitada, o usuário pode importar documentos já existentes de outros pré-cadastros vinculados ao mesmo cliente.
• Quando desabilitada, não irá aparecer o botão de importar documentos.
  Isso dá controle direto ao cliente sobre quem pode reutilizar documentos e evita o compartilhamento indevido de informações confidenciais.
• Por padrão a permissão virá liberada nos clientes para evitar conflitos na forma como já é utilizado. 

Por que isso é importante?

Permite que sistemas externos sejam notificados em tempo real sempre que um correspondente é associado a um pré-cadastro, garantindo sincronização automática de dados, redução de processos manuais e maior agilidade no fluxo operacional entre plataformas integradas.

Como funciona?
Foi criado um novo gatilho de webhook chamado "Associar correspondente". Sempre que um pré-cadastro receber a associação de uma empresa correspondente ou de um usuário correspondente, o sistema irá disparar automaticamente o webhook (caso esteja configurado), enviando os dados atualizados do pré-cadastro para a URL definida.