Adicionar valor a um campo múltiplo

O robô «Adicionar valor a um campo múltiplo» acrescenta um novo valor a um campo múltiplo do CRM (negócio, contato, empresa ou lead) em processos de negócios e robôs do Bitrix24 sem sobrescrever os valores existentes. Duplicatas são ignoradas por padrão. Retorna um indicador «Sucesso» Y/N e o número resultante de elementos no campo.

O robô adiciona um único valor a um campo múltiplo do CRM mantendo todos os valores inseridos anteriormente — diferente de uma atualização comum do campo, que sobrescreve a lista inteira. A entrada é o tipo de entidade (deal, contact, company ou lead), seu ID, o código do campo (ex. UF_CRM_TAGS ou PHONE) e o valor a adicionar; o indicador «Ignorar se já existir» (padrão Y) evita repetições. Casos típicos de uso: acrescentar uma tag a um negócio quando ocorre um evento; adicionar um telefone extra a um contato sem perder o principal; acumular valores em um campo múltiplo personalizado conforme o processo avança. Se a entidade não for encontrada ou os parâmetros forem inválidos, é retornado «Sucesso» = N. Retorna «Sucesso» Y/N e o número resultante de elementos no campo — use-os nas próximas etapas do processo de negócios.

Quais parâmetros de entrada o robô aceita?

O que o robô retorna?

Cenário: marcar um negócio com tag no pagamento

1. Um negócio entra na etapa «Pago»
2. O robô adiciona o valor «pago» ao campo múltiplo de tags do negócio
3. Com «Sucesso» = Y o processo continua e o número resultante de elementos é usado adiante

Robôs semelhantes

• Verificar se um valor existe no array
• Tamanho do array / número de elementos
• Obter elemento do array por índice
• Remover valor de um campo múltiplo

Artigos relacionados

• Arrays e campos múltiplos nos processos de negócios do Bitrix24 2026-06-12