Definir valor de campo em uma entidade relacionada
O robô «Definir valor de campo em uma entidade relacionada» define o valor de qualquer campo de uma entidade do CRM pelo seu ID em processos de negócios e robôs do Bitrix24. Aceita o tipo de entidade (deal, contact, company ou lead), seu ID, o código do campo (p. ex. TITLE ou UF_CRM_123456) e o novo valor. Retorna um indicador Y/N de se o campo foi atualizado.
O robô grava um valor em um campo arbitrário de outra entidade do CRM pelo seu ID, permitindo que um processo de uma entidade atualize uma relacionada — algo que as ações integradas do designer de processos não fazem. Ele recebe o tipo de entidade (deal, contact, company ou lead), o ID da entidade, o código do campo (um padrão como TITLE ou um personalizado como UF_CRM_123456) e o novo valor. Casos típicos de uso: a partir de um processo de um negócio, gravar um status ou comentário em uma empresa ou contato vinculado; definir a pessoa responsável ou um campo personalizado em uma entidade pai; sincronizar um valor entre registros relacionados do CRM. Retorna um indicador de sucesso Y/N — verifique-o na condição da etapa seguinte para tratar uma atualização malsucedida (por exemplo um ID ou código de campo incorreto).
Quais parâmetros de entrada o robô aceita?
| Parâmetro | Tipo | Obrigatório? | Padrão |
|---|---|---|---|
| Tipo de entidade: deal / contact / company / lead | string | sim | |
| ID da entidade | int | sim | |
| Código do campo (p. ex. TITLE, UF_CRM_123456) | string | sim | |
| Novo valor | string | sim |
O que o robô retorna?
| Parâmetro | Tipo |
|---|---|
| Sucesso (Y/N) | string |
Cenário: gravar um valor em uma empresa relacionada a partir de um processo de negócio
- Um negócio entra na etapa «Em andamento»
- O robô grava o texto «Cliente ativo» no campo COMMENTS da empresa (pelo seu ID)
- Com Y a etapa seguinte continua o processo, com N notifica a pessoa responsável