Foram disponibilizadas novas APIs para consulta, cadastro e gestão de regras e pagamentos de comissão, ampliando as possibilidades de integração com sistemas externos.

⚠️ Importante:
O uso dessas APIs depende de liberação prévia pelo time do CV, pois não são APIs públicas.

• Consulta de regra de comissão, para verificar os dados de regra da comissão da reserva
  https://{dominiodocliente}.cvcrm.com.br/api/v1/comercial/reservas/{idReserva}/regras-comissao
•  Cadastro de Regra de Comissão
  https://{dominiodocliente}.cvcrm.com.br/api/v3/comercial/reservas/{idReserva}/comissoes
•  Deleção de regra de comissão
  /v3/comercial/reservas/{idReserva}/comissoes/{idRegra}
  Precisa passar um Id por vez
•  Pagamento de comissão
  Cadastro de pagamento de comissão, precisa consultar o idRegra de comissão
  POST
  /v3/financeiro/comissoes/{idComissao}/pagamentos
  Cadastra um pagamento para uma comissão
•  Atualização de pagamento de comissão
  PATCH
  /v3/financeiro/comissoes/{idComissao}/pagamentos/{idPagamento}
  Atualiza um pagamento de comissão
•  Deleção de pagamento de comissão
  DELETE
  /v3/financeiro/comissoes/{idComissao}/pagamentos
  Remove pagamentos de uma comissão

Foi implementado o Diagnóstico da Integração, um recurso que permite antecipar possíveis inconsistências no envio de reservas para o Sienge, orientando os ajustes necessários antes ou após a integração.

O diagnóstico é apresentado em três categorias:

• Avisos: não bloqueiam o envio da reserva, mas sinalizam comportamentos esperados ou pontos de atenção que podem demandar ajuste.
• Problemas: impedem o envio da reserva, indicando de forma objetiva o que precisa ser corrigido para que a integração ocorra com sucesso.
• Sucesso: informa que as validações foram atendidas e que a reserva está em conformidade para integração.

Para isso, o recurso varre todo o conjunto de regras necessárias para o correto funcionamento da integração, aplicando o diagnóstico correspondente conforme o cenário identificado.

A execução do diagnóstico poderá ocorrer em dois momentos:

• Ao avançar a reserva para a etapa marcada com a flag “Pode Faturar”;
• Ou posteriormente ao envio, permitindo validar também o comportamento da integração após a tentativa de processamento.

No CV Sign, a rubrica passa a ter um formato próprio de exibição, deixando de aparecer como uma variação da assinatura.

Agora, a rubrica é exibida utilizando as iniciais do nome do assinante, criando uma diferenciação visual clara em relação à assinatura completa.

Por que isso é importante?

Essa melhoria traz mais clareza na leitura dos documentos assinados, permitindo identificar de forma mais rápida:

• Onde há assinaturas completas
• Onde há rubricas

Isso melhora a compreensão do documento e deixa o processo de assinatura mais organizado e padronizado.

Exemplo de variável de assinatura + marcação de local de rubrica:

Essa exibição ocorre:

• No processo de assinatura no CV Sign

• No documento final após a assinatura

Observação: as limitações relacionadas à paginação de rubrica permanecem as mesmas. Essa atualização altera apenas o formato de exibição da rubrica, trazendo um novo visual que diferencia claramente rubrica e assinatura.

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