Obter o valor de um campo de uma entidade relacionada
O robô «Obter o valor de um campo de uma entidade relacionada» lê o valor de qualquer campo de um negócio, contato, empresa ou lead do Bitrix24 pelo tipo e ID da entidade. Retorna o valor do campo indicado (um array é unido em uma string com vírgulas) e um indicador Y/N de se a entidade foi encontrada. Útil para puxar dados de cards relacionados para um processo de negócios.
O robô extrai o valor de um campo específico de uma entidade CRM pelo seu ID — uma forma de «puxar» dados de um card relacionado diretamente para o processo de negócios. Como entrada recebe o tipo de entidade (deal, contact, company, lead), seu ID e o código do campo (ex. TITLE, UF_CRM_123456, ASSIGNED_BY_ID). Como saída retorna o valor do campo e um indicador found (Y/N); se o campo contiver vários valores, eles são unidos em uma string com vírgulas. Use quando um processo em uma entidade precisar de dados de outra: pegar o nome da empresa ao trabalhar com um negócio, o responsável de um contato relacionado, o valor de um campo personalizado para uma condição ou para inserir em um e-mail. Se a entidade não for encontrada ou os parâmetros forem inválidos, o robô retorna found=N e um valor vazio — use esse indicador na condição da próxima etapa.
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 (ex. TITLE, UF_CRM_123456, ASSIGNED_BY_ID) | string | sim |
O que o robô retorna?
| Parâmetro | Tipo |
|---|---|
| Valor do campo | string |
| Entidade encontrada (Y/N) | string |
Cenário: inserir o nome da empresa em um e-mail
- Um processo de negócios é iniciado em um negócio
- O robô lê o campo TITLE da empresa pelo seu ID e retorna o valor
- A próxima etapa insere o nome da empresa no texto do e-mail ao cliente