Desassociar corretor de vários leads (ação em lote)

🔒

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)

Painéis aceitos: gestor e imobiliaria.

Equivale à ação em lote "Desassociar Corretor" da listagem de leads
(Comercial › Leads › Gestão de Leads › Ação), com as mesmas regras da tela.
Recebe até 100 ids de lead por chamada (ids repetidos são ignorados).

Remove somente o corretor: a imobiliária continua associada ao lead
(inclusive para usuário Imobiliária com corretores associados). Para cada lead
desassociado: histórico do lead, registro de perda do corretor com o motivo
31 ("Corretor desassociado por ação em lote."), cancelamento das tarefas
pendentes do corretor no lead e, quando a configuração estiver ativa, e-mail
ao corretor desvinculado.

Permissão:

  • Gestor: permissão de perfil "Desassociar Corretor em Lote" (comercial|leads|28) — sem ela, 403.
  • Imobiliária: sempre pode chamar, mas a situação atual de cada lead precisa
    liberar a ação no workflow (opção 43); caso contrário, o lead é recusado.

Resultado por lead (em itens, na ordem enviada). Recusa ou erro em um lead
não interrompe os demais e não muda o status HTTP, que é 200 sempre que o lote roda:

resultadomotivoQuando
corretor_desassociadonullCorretor removido do lead
recusadolead_nao_encontradoLead inexistente ou fora do escopo de visualização do usuário
recusadocorretor_parceiro_nao_pode_ser_desassociadoO corretor do lead é parceiro
recusadosituacao_nao_permite_desassociar_corretorPainel Imobiliária e a situação do lead não libera a ação no workflow
recusadolead_sem_corretorO lead não tem corretor associado
erroerro_ao_desassociar_corretorFalha inesperada ao desassociar este lead
Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params
idsLeads
array of integers
required
length between 1 and 100

Ids dos leads cujo corretor será desassociado

idsLeads*
Responses

403

Gestor sem a permissão de perfil "Desassociar Corretor em Lote" (comercial|leads|28), ou painel não aceito.

Language
Credentials
Bearer
JWT
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json