Autenticação necessáriaEsta 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:
resultado | motivo | Quando |
|---|---|---|
corretor_desassociado | null | Corretor removido do lead |
recusado | lead_nao_encontrado | Lead inexistente ou fora do escopo de visualização do usuário |
recusado | corretor_parceiro_nao_pode_ser_desassociado | O corretor do lead é parceiro |
recusado | situacao_nao_permite_desassociar_corretor | Painel Imobiliária e a situação do lead não libera a ação no workflow |
recusado | lead_sem_corretor | O lead não tem corretor associado |
erro | erro_ao_desassociar_corretor | Falha inesperada ao desassociar este lead |
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
403Gestor sem a permissão de perfil "Desassociar Corretor em Lote" (comercial|leads|28), ou painel não aceito.
