Añadir valor a un campo múltiple
El robot «Añadir valor a un campo múltiple» agrega un nuevo valor a un campo múltiple de CRM (negociación, contacto, empresa o prospecto) en los procesos de negocio y robots de Bitrix24 (Alaio) sin sobrescribir los valores existentes. Los duplicados se omiten por defecto. Devuelve un indicador «Correcto» Y/N y el número resultante de elementos en el campo.
El robot agrega un único valor a un campo múltiple de CRM conservando todos los valores introducidos previamente — a diferencia de una actualización normal del campo, que sobrescribe la lista entera. La entrada es el tipo de entidad (deal, contact, company o lead), su ID, el código de campo (p. ej. UF_CRM_TAGS o PHONE) y el valor a añadir; el indicador «Omitir si ya existe» (por defecto Y) evita repeticiones. Casos de uso típicos: añadir una etiqueta a una negociación cuando ocurre un evento; agregar un teléfono adicional a un contacto sin perder el principal; acumular valores en un campo múltiple personalizado a medida que avanza el proceso. Si la entidad no se encuentra o los parámetros no son válidos, se devuelve «Correcto» = N. Devuelve «Correcto» Y/N y el número resultante de elementos en el campo — úselos en los siguientes pasos del proceso de negocio.
¿Qué parámetros de entrada acepta el robot?
| Parámetro | Tipo | ¿Obligatorio? | Por defecto |
|---|---|---|---|
| Tipo de entidad: deal / contact / company / lead | string | sí | |
| ID de la entidad | int | sí | |
| Código de campo (p. ej. UF_CRM_TAGS o PHONE) | string | sí | |
| Valor a añadir | string | sí | |
| Omitir si ya existe (Y/N, por defecto Y) | string | — |
¿Qué devuelve el robot?
| Parámetro | Tipo |
|---|---|
| Correcto (Y/N) | string |
| Número resultante de elementos en el campo | int |
¿Qué errores puede devolver el robot?
El robot escribe estos mensajes en el registro del proceso de negocio cuando no puede completar un paso. El texto indica qué corregir en la configuración o en los datos.
- Error: parámetros no válidos
- Entidad no encontrada
Escenario: etiquetar una negociación al pagar
- Una negociación entra en la etapa «Pagado»
- El robot añade el valor «pagado» al campo múltiple de etiquetas de la negociación
- Con «Correcto» = Y el proceso continúa y el número resultante de elementos se usa más adelante