CVcvcrm
Conversões do Lead

Registrar conversão do lead

🔒 Autenticação necessária

Esta API utiliza Bearer Token no header Authorization. Consulte o tutorial completo antes de fazer sua primeira chamada: Como autenticar nas APIs do CV CRM (v3+ — Bearer Token)

Registra uma conversão para o lead e aplica os efeitos descritos na introdução (última conversão, bolsão, integração, fila, notificação e RD Station).

Disponível para os painéis Gestor, Imobiliária e Corretor. Exige a permissão comercial|leads|2 no perfil do usuário.

post/leads/{idLead}/conversoes

Request

  • Base URL
    https://integracao.cvcrm.com.br/api/v4/comercial
  • URL
    https://integracao.cvcrm.com.br/api/v4/comercial/leads/{idLead}/conversoes
  • Auth
    HTTP bearer

Path parameters

idLeadinteger required

Identificador do lead.

Request body

conversaostring required

Nome da conversão (ex.: nome da landing page ou campanha). Criado no cadastro de conversões se ainda não existir.

origemstring

Código de origem da conversão cadastrado no CV. Omitido usa o painel autenticado; não cadastrado vira ND.

integracao'RD' | 'SS' | 'FB'

Integração de marketing de onde veio a conversão: RD RD Station, SS SharpSpring, FB Facebook.

idIntegracaostring

Identificador do lead na base da integração. Aceita texto ou número e é gravado como texto. Tamanho máximo: 45 caracteres com FB, 80 com RD, 100 com SS ou sem integração; acima disso retorna 400.

idFormulariointeger

Identificador do formulário do Facebook cadastrado no CV (o mesmo idformulario da integração Facebook do CV, não o id do formulário na Meta). Só é aceito com integracao = FB; caso contrário retorna 422.

idMidiainteger

Identificador da mídia da conversão.

idEmpreendimentosinteger[]

Empreendimentos de interesse associados à conversão.

dataCadConversaostring

Data da conversão em ISO, YYYY-MM-DD ou YYYY-MM-DD HH:MM:SS. Só a data grava 00:00:00; omitida usa a data e hora do registro.

Example request

{
  "conversao": "LP Lançamento Empreendimento X",
  "origem": "FB",
  "integracao": "FB",
  "idIntegracao": "fb-lead-99182",
  "idFormulario": 771,
  "idMidia": 12,
  "idEmpreendimentos": [
    301
  ],
  "dataCadConversao": "2026-07-20 14:32:00"
}

Response

Conversão registrada. idConversao é o identificador do registro no histórico de conversões do lead.

statusstring
codeinteger

Example response

{
  "status": "success",
  "code": 201,
  "data": {
    "idConversao": 55210
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.