Nova API: envio de mensagens do repasse

Novo endpoint:

  • POST
  • https://{dominiodocliente}.cvcrm.com.br/api/v2/cv/repasses/mensagens

O que faz:

  • Permite que sistemas externos enviem mensagens diretamente para o histórico do repasse.

Vantagem:

  • Garante integração bidirecional com o repasse.
  • Melhora a comunicação automatizada com clientes e equipes.

Pré-cadastro: Alteração da pessoa no documento anexado

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.

Workflow de Reservas: duas novas permissões

Novas permissões adicionadas:

  1. Permitir edição do indexador pelo corretor/imobiliária.
  2. Permitir edição do portador pelo corretor/imobiliária.

Aplicação:

  • Cada permissão pode ser ativada individualmente por perfil.
  • Garante maior controle sobre quem pode alterar dados críticos da reserva.

Empreendimentos: nova opção para inativar

A funcionalidade de inativação foi criada para dar mais controle interno sobre os empreendimentos que não devem mais receber novas ações, como cadastros, reservas ou vendas. Essa inativação não remove o empreendimento da base de dados e nem o torna invisível, mas o torna inativo comercialmente.

Casos de Uso Comuns:

  • Substituição de empreendimento: se você deseja manter o valor contratado, mas quer trocar o empreendimento por outro (ex.: vendeu tudo no antigo). Nesse caso, o antigo é inativado comercialmente e um novo espaço pode ser cadastrado.
  • Downgrade: quando o você quer reduzir o valor contratado, sem excluir o empreendimento, a inativação também é usada.

Permissões e Fluxo de Ação

  • Somente o time interno pode realizar essa inativação.
  • Você, cliente, não tem permissão para inativar comercialmente.
  • Para iniciar o processo, você deve abrir uma solicitação para a inativação de um empreendimento específico.
  • Após validação, a equipe responsável realiza a ação.

Como solicitar?

 Você, cliente, como usuário gestor, precisa seguir o passo a passo:

1. Acessa a listagem de empreendimentos

2. Abre o cadastro do empreendimento

3. Solicita a inativação e preenche o motivo

4. Confirma a solicitação

Assim, nosso time interno receberá a solicitação e irá realizar a inativação do empreendimento.


O que acontece após a inativação comercial?

  • O empreendimento não pode mais receber cadastros, vendas ou novas reservas.
  • Não aparece mais nas telas de seleção para esses tipos de ação.
  • Continua visível para o cliente no portal, permitindo acesso a:

    • Boletos e extratos.
    • Dados financeiros e históricos.
    • Documentos e dossiês já emitidos.

O que é bloqueado:

  • Novas reservas, agendamentos ou pré-cadastros.
  • Geração de novos chamados ou serviços vinculados ao empreendimento.

Novidades na Interface

  • Novo filtro adicionado na listagem de empreendimentos: "Inativados".
  • Permite identificar rapidamente quais empreendimentos estão nessa condição.
  • Não interfere nos filtros do Painel (ativo/inativo).
  • Interface ajustada para mostrar claramente que se trata de um status comercial, não operacional.

Novidades do Comunicador CV CRM

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.


Filas de Distribuição de Leads: nova lógica para filas com mais de 100 participantes

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.

Mostrar entradas anterioresMostrar entradas anteriores