# Integração CV CRM

![Integração CV CRM](https://chat.simplesdesk.com.br/rails/active_storage/blobs/proxy/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBOE5sQmc9PSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--3c4c66d594ae5782d1f1c16ca6ef7da829fb133d/simplesdesk-cvcrm.png)

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.