Principal Integrações Integração CV CRM

Integração CV CRM

Última atualização em Aug 20, 2026

Integração CV CRM

Conecte o CV CRM (Construtor de Vendas) ao SimplesDesk e integre o atendimento da incorporadora ao funil de vendas: conversas novas viram leads no CV com origem e mídia, as interações do atendimento ficam registradas para o corretor, e webhooks do CV (lead novo, reserva) criam e etiquetam contatos aqui automaticamente — podendo disparar fluxos de boas-vindas.

Quando utilizar

  • Incorporadoras e construtoras que gerenciam o funil comercial no CV CRM e atendem pelo WhatsApp;
  • Você quer que todo lead do WhatsApp entre no CV automaticamente, com o interesse anotado para o corretor;
  • Leads e reservas criados no CV devem iniciar uma conversa ou régua de mensagens aqui.

Como conectar

  1. Acesse Configurações → Integrações e clique no card CV CRM.
  2. Preencha o Subdomínio do seu ambiente CV (https://SUBDOMINIO.cvcrm.com.br).
  3. Preencha o E-mail e o Token do usuário administrativo do CV (gerado no cadastro do usuário → Token).
  4. (Opcional) Informe a Senha do usuário de API — habilita a busca de pessoas pela API v3.
  5. Clique em Testar e conectar.

O que é enviado automaticamente

Com a integração conectada:

  • Conversa nova → cria/atualiza o lead no CV com nome, e-mail/telefone do contato, a conversão "SimplesDesk" e a tag simplesdesk — o CV faz o match por e-mail/telefone e associa a reservas e pré-cadastros existentes;
  • Oportunidade ganha no CRM → registra uma interação no lead do CV, visível ao corretor no funil.

Webhook de entrada (CV → SimplesDesk)

No card da integração você encontra a URL do webhook. Cadastre-a nos webhooks do CV CRM (lead novo e reserva): os contatos são criados/etiquetados aqui automaticamente com as etiquetas cv-crm e cv-reserva — prontos para segmentação e fluxos.


Agente de IA

Nas configurações do assistente (Central IA → seu assistente → Integrações), ative o CV CRM:

Capacidade O que a IA passa a fazer
Localizar pessoa Busca por telefone, CPF/CNPJ, e-mail ou nome — por padrão usa os dados do contato da conversa (requer a senha da API v3)
Criar/atualizar lead Registra o lead com o interesse identificado (empreendimento, tipologia, faixa de valor) e o código de origem (WA, FB, GO…)
Registrar interação Deixa o resumo do atendimento anotado no lead, visível ao corretor no funil
Leads recentes Para gestor/corretor: "quantos leads entraram hoje?" (leitura via CVDW — pode ter alguns minutos de atraso)
Assistências recentes Pós-obra: acompanha os chamados de assistência técnica mais recentes (a abertura é feita pelo painel do CV)

Nós de fluxo

No editor de fluxos, a categoria CV CRM traz três nós:

  • Buscar Pessoa (CV) — localiza por telefone, CPF ou e-mail (vazio = telefone do contato). Grava {{variables.cvcrm_person_count}}, {{variables.cvcrm_idpessoa}} e {{variables.cvcrm_person_nome}}; não encontrou = saída vermelha. Requer a senha v3 na integração;
  • Criar Lead no CV — cria/atualiza o lead com os dados do contato da conversa, mais os campos Interesse e Código de origem (opcionais, aceitam variáveis). Grava {{variables.cvcrm_idlead}} e {{variables.cvcrm_lead_criado}};
  • Registrar Interação (CV) — grava o texto informado como interação no lead (match por e-mail/telefone do contato). Grava {{variables.cvcrm_interacao_registrada}}.

Gatilho: Evento de integração

O gatilho Evento de integração escuta dois eventos do CV:

  • Lead novo (lead_novo);
  • Reserva criada/atualizada (reserva).

O fluxo dispara com as variáveis {{variables.cv_idlead}} · {{variables.cv_idreserva}} · {{variables.cv_gatilho}}.


Exemplo: lead novo no CV dispara boas-vindas no WhatsApp

Objetivo: o lead que entra no CV (site, feirão, portais) recebe a primeira mensagem em segundos.

  1. Cadastre o webhook do SimplesDesk no CV para o evento lead novo;
  2. Crie um fluxo com gatilho Evento de integração → CV CRM → Lead novo;
  3. Enviar Mensagem: "Olá! Recebemos seu interesse em nossos empreendimentos 🏢 Posso te apresentar as opções?" — e siga com botões (plantas, valores, agendar visita);
  4. Ao final, Registrar Interação (CV) anota o resultado da conversa no lead — o corretor abre o CV já sabendo o que o cliente quer.

No caminho inverso, um fluxo de qualificação no WhatsApp termina com Criar Lead no CV preenchendo o interesse coletado: {{variables.resposta_interesse}}.

📗 Para dominar o editor, veja os tutoriais da categoria Fluxos — do primeiro fluxo ao gatilho de evento de integração.

📘 Precisa de ajuda? Fale com nosso suporte pelo chat — é só chamar.