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.

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.

Por que isso é importante?
Padroniza e fortalece a integração com sistemas parceiros, permitindo acesso estruturado e escalável aos pré-cadastros. Antes, a ausência de um endpoint robusto e filtrável limitava consultas eficientes, aumentava a complexidade das integrações e dificultava análises ou automações baseadas nesses dados, principalmente em cenários com alto volume.

Como funciona?
Foi disponibilizado um endpoint GET da listagem de pré-cadastros na V3, que permite a listagem paginada dos registros com suporte a múltiplos filtros (como id do pré-cadastro, documento do cliente, correspondente, imobiliária, corretor, entre outros). A resposta segue um padrão estruturado com informações de paginação (total, limite, página) e uma lista de pré-cadastros contendo não apenas os dados principais, mas também todos os relacionamentos relevantes (empreendimento, unidade, leads, cliente, situação, etc.). O endpoint garante consistência de contrato, retorno adequado mesmo sem dados relacionados e performance otimizada para grandes volumes.

Por que isso é importante?
Facilita e agiliza o contato com leads internacionais, reduzindo fricção operacional para corretores e times de atendimento. Antes, a limitação a números brasileiros criava barreiras no processo comercial, obrigando ações manuais ou externas ao sistema, o que impactava diretamente a conversão e o tempo de resposta.

Como funciona?
Foi adicionado o botão de WhatsApp tanto na listagem quanto na tela de administração do lead para números internacionais. Agora, ao clicar, o sistema abre o WhatsApp Web já direcionando para a conversa com o número do lead, independentemente do país, desde que esteja no formato válido internacional (com código do país).

Campanha de ativação

Nova configuração; Manter origem dos leads ativados. 

Por que isso é importante?

Atualmente, quando um lead é reativado por uma campanha de ativação, sua conversão pode acabar sendo atribuída ao corretor/gestor/imobiliárioa e à própria campanha. Isso gera inconsistência na origem do lead, especialmente em cenários onde o lead foi ofertado pela incorporadora e não pelo corretor/gestor/imobiliária.

Essa distorção impacta diretamente análises, relatórios e regras de negócio baseadas na origem, além de não refletir corretamente a jornada real do lead.

Como funciona?

Foi criada uma nova configuração nas campanhas de ativação: "manter origem dos leads ativados", que vem desabilitada por padrão.

Quando ativada:

• Leads reativados pela campanha mantêm sua origem original (primeira origem registrada)
• A conversão do lead não será atribuída a origem painel corretor/painel gestor/painel imobiliaria
• Garante que a origem continue refletindo a captação inicial (ex: incorporadora, facebook, google, site, etc.)

Quando desativada:

• O comportamento atual é mantido
• A conversão pode ser atribuída à campanha de ativação e ao corretor/imobiliária/gestor

Essa configuração permite maior controle sobre a atribuição de origem, respeitando o contexto real da aquisição do lead.

Vencimento de leads

Adicionamos a situação que tiver a flag "reserva" do workflow de leads nas configurações de vencimento de leads e vencimento de leads por empreendimento. 

Por que isso é importante?

Antes da melhoria, situações com a flag "Reserva" não eram consideradas nas configurações de vencimento de leads, o que gerava inconsistências no controle de prazos e acompanhamento desses leads.

Isso impactava diretamente a gestão, já que leads em etapas relevantes do funil (com reserva) ficavam fora das regras de vencimento, prejudicando visibilidade, priorização e possíveis automações.

Como funciona?

Passamos a considerar as situações do workflow de leads que possuem a flag "Reserva" dentro das configurações de:

• Vencimento de leads
• Vencimentos por empreendimento

Com isso:

• Situações marcadas como "Reserva" agora podem ser configuradas normalmente nas regras de vencimento
• Essas situações passam a respeitar os prazos definidos, assim como as demais etapas do workflow
• A gestão de leads fica mais consistente, incluindo todas as etapas relevantes no controle de vencimentos

A alteração garante que nenhuma etapa importante do funil fique fora das regras de vencimento.

Novo filtro na listagem de leads

Código interno do lead. 

Por que isso é importante?

A ausência do código interno na listagem de leads dificulta a identificação rápida e precisa dos registros, principalmente em cenários de importação onde os leads podem ter dados semelhantes.

Além disso, a inclusão desse filtro padroniza a experiência com outras listagens do sistema, trazendo mais consistência e facilitando a navegação e busca por parte dos usuários.

Como funciona?

Foi adicionado um filtro por código interno do lead na listagem de leads.

Com isso, o usuário pode:

• Buscar diretamente um lead específico utilizando seu código interno
• Identificar com mais precisão leads oriundos de importações ou integrações
• Utilizar o mesmo padrão de busca já existente em outras listagens do sistema

O filtro funciona de forma direta na listagem, retornando o lead correspondente ao código informado.