Atualizar negócio por ID
O robô «Atualizar negócio por ID» altera qualquer negócio pelo seu identificador a partir de qualquer contexto de processo de negócios no Bitrix24. Os campos a alterar são passados como JSON no formato camelCase (title, stageId, opportunity, assignedById e outros). Retorna um indicador de sucesso Y/N para a ramificação condicional do processo e funciona através do método universal de CRM crm.item.update.
O robô atualiza um negócio arbitrário pelo seu ID, mesmo quando o processo de negócios é executado sobre outra entidade de CRM — um contato, um lead ou uma tarefa. O ID do negócio e o conjunto de campos são informados explicitamente: os campos são passados como uma string JSON no formato camelCase (por exemplo {"title":"Novo negócio","stageId":"C1:WON","opportunity":50000,"assignedById":5}). A atualização usa o método universal crm.item.update, portanto todos os campos do negócio ficam disponíveis, inclusive os personalizados. Casos típicos: quando a etapa do contato muda, atualizar o negócio vinculado; definir o responsável e o valor a partir de dados de um sistema externo; alterar em massa as etapas dos negócios a partir de um processo superior. Retorna um indicador Sucesso (Y/N): Y em uma atualização bem-sucedida, N com ID vazio, JSON vazio ou inválido, ou erro de API — compare-o na condição da próxima etapa.
Quais parâmetros de entrada o robô aceita?
| Parâmetro | Tipo | Obrigatório? | Padrão |
|---|---|---|---|
| ID do negócio | int | sim | |
| Campos para atualizar (JSON camelCase): {"title":"New deal","stageId":"C1:WON","assignedById":5,"opportunity":50000} | string | sim |
O que o robô retorna?
| Parâmetro | Tipo |
|---|---|
| Sucesso (Y/N) | string |
Cenário: atualização de um negócio a partir de um processo sobre um contato
- O contato passa para uma nova etapa do funil
- O robô atualiza o negócio vinculado: stageId e opportunity são passados como JSON
- Um resultado Y confirma a atualização para a próxima etapa