Foram realizadas melhorias nas APIs relacionadas à consulta de tipos de documentos utilizados no pagamento de comissões, além da ampliação de filtros em outras consultas existentes.

O objetivo é tornar as consultas mais confiáveis, previsíveis e fáceis de utilizar nas integrações e operações do dia a dia.

Consulta de tipos de documentos para pagamento de comissões

A consulta pode ser acessada em:

https://integracao.cvcrm.com.br/api/v3/configuracoes/tipos-arquivos-pagamentos-comissoes

Comportamento após a melhoria

• Apenas opções válidas e ativas passam a aparecer na listagem
• Consultas com informações preenchidas incorretamente podem retornar mensagens de inconsistência
• Situações inesperadas continuam sendo tratadas como erro interno

Essas mudanças aumentam a confiabilidade dos dados retornados pela API.

Novos filtros em consultas existentes

Também foram adicionados filtros por nome em algumas consultas já existentes, facilitando buscas quando não se possui o código ou documento do registro.

Consultas que passaram a contar com esse filtro:

• Consulta de corretores
• Consulta de usuários administrativos
• Consulta de imobiliárias
• Consulta de usuários de imobiliárias

Na prática, isso permite localizar registros com mais facilidade quando o cliente não tiver em mãos um código ou documento. 

Nova consulta de imobiliárias

Foi disponibilizada uma nova API para consulta de imobiliárias, com possibilidade de busca por nome.

Endereço:

https://integracao.cvcrm.com.br/api/v1/cadastros/imobiliarias

Comportamentos esperados

• A consulta retorna normalmente quando os dados informados estão corretos
• Consultas com parâmetros inválidos retornam mensagem de preenchimento incorreto
• Falhas inesperadas continuam sendo tratadas como erro interno

Foi adicionado o botão “Ask IA” nas principais listagens do sistema, permitindo que os usuários acessem rapidamente uma inteligência artificial com contexto específico da tela em que estão.

O botão está disponível nas seguintes listagens:

• Leads
• Pré-cadastro
• Reservas
• Simulações
• Repasse
• Atendimento
• Comissão
• Agendamento
• Assistência

Ao clicar no botão, o usuário é direcionado para uma IA (ChatGPT ou Claude) com um prompt estruturado automaticamente e com o link do material de apoio correspondente àquela listagem.

Por que isso é importante?

Essa melhoria reduz a dependência de conhecimento prévio e acelera o onboarding de usuários, permitindo que encontrem respostas de forma mais rápida e autônoma.

Com isso, é possível:

• Diminuir dúvidas operacionais
• Reduzir a necessidade de suporte
• Acelerar o aprendizado do sistema
• Facilitar o entendimento de fluxos mais complexos

Como funciona?

Ao clicar no botão “Ask IA” dentro de uma listagem:

1. O usuário é direcionado para a IA escolhida (ChatGPT ou Claude).
2. Um prompt estruturado é gerado automaticamente.
3. O link do artigo da base de conhecimento daquela tela é incluído no contexto.

Com essas informações, a IA consegue:

• Responder dúvidas sobre a funcionalidade
• Gerar resumos do conteúdo
• Explicar como utilizar recursos daquela tela específica

Alteramos a forma de envio do valor de ganho dos leads para o RD Station.

Antes, era enviada a soma do valor de contrato de todas as reservas em situações ativas vinculadas ao lead.
Agora, passamos a enviar apenas a soma das reservas que estão efetivamente vendidas, ou seja, na situação final do workflow.

Por que isso é importante?

Essa mudança garante que o valor enviado ao RD Station represente vendas reais, evitando superestimação de receita.

Com isso, as análises e automações passam a ter:

• Maior precisão nos dados de receita
• Melhor qualidade nas métricas de conversão
• Tomada de decisão mais confiável
• Aderência às boas práticas de mercado

Como funciona agora?

Ao converter um lead, o sistema passa a considerar apenas reservas com status de venda concluída para calcular o valor de contrato enviado ao RD Station.

• Reservas vendidas → entram no cálculo do ganho
• Reservas em andamento ou apenas ativas → não são mais consideradas

Foi adicionada a coluna Forma de Pagamento na extração dos seguintes relatórios:

• Relatório de Solicitação de Pagamento de Comissão

• Relatório de Provisão de Pagamento de Comissão

Por que isso é importante?

Implementar esse dado vai facilitar a vida dos usuários que fazem a gestão dos pagamentos de comissão por dentro e por fora da incorporadora.

Foram adicionados dois novos gatilhos de webhook no fluxo de reservas, permitindo que integrações externas sejam notificadas automaticamente quando determinados eventos ocorrerem.

Os novos eventos disponíveis são:

• cessao_realizada
• permuta_realizada

Com isso, sistemas integrados podem reagir automaticamente quando uma cessão ou permuta for concluída.

Objetivo da mudança

A melhoria amplia as possibilidades de integração da plataforma com sistemas externos.

Agora, parceiros e serviços conectados ao CV CRM podem acompanhar mudanças importantes no processo de reserva sem depender de monitoramento manual ou consultas frequentes à API.

Eventos adicionados

🔹 Cessão realizada (cessao_realizada)

Quando uma cessão é finalizada, o sistema dispara automaticamente um webhook específico para esse evento.

Nesse envio são incluídas informações como:

• Dados da reserva
• Dados da pessoa envolvida na cessão

Isso permite que integrações externas identifiquem:

• A reserva que sofreu alteração
• O novo titular vinculado à operação

🔹 Permuta realizada (permuta_realizada)

Quando uma permuta é concluída, o sistema também dispara um webhook específico.

Nesse caso, o objetivo principal é informar que a reserva passou por uma operação de permuta, permitindo que o sistema externo trate essa atualização.

Benefícios da melhoria

• Mais automação nas integrações
• Redução de processos manuais
• Atualização mais rápida de sistemas terceiros
• Maior cobertura dos eventos importantes do fluxo de reservas

Foi implementada a inclusão do Tipo de Venda nos processos de atualização em lote e também na consulta via API, ampliando a visibilidade e padronização desse dado dentro do sistema.

Por que isso é importante?

O Tipo de Venda é um elemento relevante no processo comercial, pois pode influenciar regras de negociação, atualização de valores e classificação das reservas.

Com essa melhoria, passa a ser possível:

• Atualizar o tipo de venda em massa por meio de importação de planilha
• Consultar os tipos de venda disponíveis via API
• Garantir maior padronização e consistência nas integrações

1. APIs – GET Tipo de Venda

Foi disponibilizada consulta via API (GET) para listar os tipos de venda cadastrados.

Informações retornadas:

• ID
• Nome
• Status (ativo/inativo)

➡️ Benefício: padroniza as integrações e evita inconsistências causadas por uso incorreto de IDs.

2. Atualização em lote (importação)

Foi adicionado suporte completo ao Tipo de Venda no fluxo de importação.

Novo campo disponível:

• Tipo de venda

Disponível em:

• Mapeamento de colunas na tela de processamento
• Modelo de planilha de importação

Comportamento do sistema:

• Se informado: o tipo de venda será vinculado à reserva
• Se inválido: o sistema seguirá a regra de validação configurada (bloqueio ou alerta)

➡️ Benefício: garante que grandes volumes de dados já sejam importados com a estrutura correta.

Foi disponibilizado um novo menu de ativação de leads, trazendo uma interface mais moderna e organizada para a gestão das Campanhas de Ativação.

Por que isso é importante?

A nova tela torna o processo de ativação mais claro e eficiente, permitindo:

• Visualizar rapidamente os leads disponíveis
• Acompanhar o progresso das campanhas
• Agilizar o contato e o atendimento
• Ter maior controle sobre o andamento das ativações

Como funciona?

O novo menu apresenta uma interface mais intuitiva, exibindo informações importantes do lead diretamente na tela, como:

• Foto do lead
• Momento atual do lead no funil

Também são exibidos indicadores de progresso da campanha, como:

• Quantidade de leads disponíveis para atendimento (em campanhas proporcionais)
• Porcentagem de leads ativados, descartados ou marcados para falar depois

Recursos adicionais

A nova tela também apresenta:

• Botão direto para abrir o WhatsApp Web, facilitando o contato rápido com o lead
• Informação da data de início da campanha
• Período restante até o encerramento da campanha
• Separação dos números do atendente por campanha
• Visualização das campanhas em que o usuário está trabalhando
• Possibilidade de selecionar campanhas com apenas um clique, dependendo da configuração da campanha

Foi disponibilizado o campo Cadastro Imobiliário Brasileiro (CIB) no cadastro de Unidades, ampliando também seu uso em:

• Variáveis de contrato
• Exportação de unidades
• Importação de unidades

Com isso, o sistema passa a suportar o identificador nacional do imóvel dentro dos principais fluxos operacionais.

Por que isso é importante?

O CIB é o identificador oficial do imóvel no Brasil, funcionando como um “CPF do imóvel”, sendo cada vez mais exigido em processos:

• Legais
• Fiscais
• Contratuais

Antes dessa melhoria:

• O CIB não estava disponível no cadastro de unidades
• Não era possível utilizá-lo em contratos
• Clientes precisavam manter controles paralelos fora do sistema

Com essa atualização, garantimos maior padronização e conformidade com as exigências da Receita Federal.

Como funciona?

O novo campo CIB foi adicionado ao cadastro de unidades, permitindo seu preenchimento e utilização em diferentes pontos da plataforma:

• Pode ser incluído diretamente no cadastro da unidade
• Está disponível como variável para contratos (${[[UNIDADE][CIB]]}), permitindo sua utilização automática em documentos
• Pode ser utilizado nos processos de importação e exportação de unidades

Assim, o identificador pode ser inserido automaticamente em documentos gerados pelo sistema.

Essa melhoria tem como objetivo alinhar o sistema à forma real de operação dos clientes, onde o apelido do corretor é muitas vezes a principal referência no dia a dia — até mais do que o nome completo.

Por que isso é importante?

Na prática, os times comerciais:

• Se comunicam utilizando apelidos
• Reconhecem corretores pelo apelido
• Tomam decisões operacionais baseadas nessa identificação

Quando o sistema exibe apenas o nome completo, pode ocorrer:

• Dificuldade na identificação rápida
• Possibilidade de confusão entre corretores
• Desalinhamento com a linguagem natural do time

O que mudou no sistema?

A proposta não é substituir o nome completo, mas complementar a identificação com o apelido, tornando essa informação visível em pontos estratégicos do sistema.

1. Relatórios

Foi adicionada uma nova coluna de Apelido do Corretor nos relatórios de:

• Reservas
• Comissões
• Simulações

Benefício: leitura mais rápida e identificação mais aderente ao uso real do time comercial.

2. Listagens (Simulação)

Também foram incluídas melhorias na organização e localização de corretores:

• Filtro por time

Benefício: facilita encontrar corretores utilizando referências que os usuários já conhecem.