Foi adicionado o novo parâmetro momento do lead (idmomento_lead)  na API de leads.

Observação: o momento precisa seguir as regras de associação com empreendimento e situação.

Clique aqui para conhecer as APIs do CV CRM.

Integração:

• Clientes que contratam o Avendre podem fazer a gestão completa de parcerias por lá.
• O Avendre envia os corretores parceiros e os leads oriundos dessas parcerias diretamente ao CV.

Corretores parceiros:

• Cadastrados no CV com campos básicos: nome, telefone, CRECI.
• Associados a uma imobiliária existente ou criada automaticamente com base no gestor.
• Cadastrados com login inativo (sem acesso ao painel do corretor).
• Identificados visualmente com o rótulo “Corretor parceiro”.

Filtros:

• Listagens: corretor, leads, pré-cadastro, simulação e reserva. 

• Relatórios: leads, pré-cadastro, simulação e reserva. 

 Regras específicas dos leads de parceiros:

• Não vencem (sem data limite).
• Não participam de campanhas de ativação, mesmo que se enquadrem nos filtros.
• Não entram nas filas de distribuição.

• Só podem ser removidos por:

  • Ação manual do gestor.
  • Ação automatizada via descarte de lead.

Observações:

• A gestão total da parceria é feita na Avendre.

• O CV atua apenas como recebedor dos dados e executor de regras específicas.

  
  

Ao criar uma interação com o lead, o gestor pode escolher se ela será visível:

• Apenas para o corretor atual.
• Ou também para o próximo corretor (caso haja troca).

O que foi adicionado:

• A linha do tempo do lead agora exibe qual foi a decisão do gestor no momento da interação.
• Isso é visível apenas para o Painel do Gestor.

Webhook de mensagens pendentes

• Um novo webhook foi criado para notificar sistemas externos quando há mensagens pendentes no chat.

Finalidade:

• Dar visibilidade e dados para uso em sistemas diversos para integração e notificação da mesma.

API para cadastro de templates + ID no webhook de mensagens

• Criação de uma API para cadastro de templates usados em mensagens ativas no WhatsApp. 

Por que isso foi criado:

• Em integrações com plataformas externas de WhatsApp, o CV precisa informar qual template está sendo usado.
• Essas mensagens precisam de templates aprovados com antecedência.

Como funciona:

1. A plataforma externa envia o template (ex.: "Olá, tudo bem?") via API.
2. O template recebe um ID no CV.
3. Quando o corretor inicia uma conversa ativa, o CV envia um webhook com o ID do template.
4. A plataforma aplica o template correto e dispara a mensagem.

Regra de encerramento automático do chat (WhatsApp Web e API)

• Campo na edição dos “Canais do Comunicador” que permite definir quantos dias o chat pode ficar inativo antes de ser encerrado automaticamente.

Comportamento:

• Se definido, o sistema fecha o chat após esse prazo de inatividade.
• Conversa é salva na timeline do lead.

Se não for preenchido:

• O chat nunca será encerrado automaticamente, mesmo com semanas de inatividade.

Benefício:

• Ajuda a manter o ambiente limpo e sem “conversas fantasmas”.
• Melhora a performance visual e o controle de interações abertas.

Regra de encerramento da sessão (WhatsApp API)

Contexto:

• Conforme as regras da API oficial do WhatsApp, uma sessão expira em 24h após a última mensagem do cliente.

O que foi adicionado:

• Quando essa janela de 24h expira:

  • O sistema exibe um aviso no chat.
  • Um botão direciona o atendente para iniciar uma nova conversa ativa.
  • O atendente também pode aguardar o cliente responder (o que reabre a sessão).

Justificativa:

• Evita tentativas inválidas de envio fora do prazo.
• Garante que as mensagens estejam dentro das regras de mensageria da Meta.

Antes só era possível mudar o tipo de documento (ex.: RG, CNH). E não se podia trocar a pessoa associada ao documento (ex.: de Titular para Associado).

Agora é possível editar a pessoa vinculada ao documento (ex.: transferir um comprovante de endereço do Titular para o Cônjuge).

Requisitos:

• Usuário precisa ter permissão para editar ou excluir documentos.
• Toda modificação é registrada no histórico, com identificação do responsável.

Lógica anterior (padrão):

• Sorteio embaralhava todas as posições da fila.
• Utilizado para manter a distribuição justa em qualquer quantidade de atendentes.

Novo comportamento (quando > 100 participantes):

• O sistema não embaralha mais toda a fila.
• Ele sorteia apenas o próximo (P) atendente a receber um lead.
• A fila mantém a ordem original dos demais participantes.

Exemplo prático:

• Fila com 130 corretores.
• Sorteado: corretor X (posição 47).
• Ele sobe para a posição 1.
• Demais corretores seguem a ordem antiga a partir dele.

Controles:

• O gestor pode optar por sortear manualmente toda a fila.
• Ou editar a ordem diretamente, como já é possível atualmente.

Foi adicionado um campo para registrar o motivo ao cancelar um atendimento.

Objetivo:

• Rastreabilidade total das interações canceladas.
• Permite entender se o cancelamento foi por engano, duplicidade, erro de registro, etc.

As anotações automáticas criadas durante importações de leads via sistema não entram mais nos Relatórios e API de interações (GET).

Benefícios:

• Mais fidelidade nos relatórios de interação.
• APIs retornam apenas interações relevantes.

O campo “Nome” na planilha de importação de atendimentos gerava confusão. Agora, para evitar confusão, o campo foi renomeado para “Título do atendimento”, que é sua real função.

Foi adicionado um novo botão no Portal do Cliente, que permite consultar a situação do contrato - para integração com o Mega. Para que esse botão seja exibido, é necessário solicitar ao nosso time, através do e-mail: suporte@cvcrm.com.br.