Actualizar contacto por ID
El robot «Actualizar contacto por ID» modifica cualquier contacto por su identificador desde cualquier contexto de proceso de negocio en Bitrix24 (Alaio). Los campos a modificar se pasan como JSON en formato camelCase (name, lastName, assignedById, companyId y otros). Devuelve un indicador de éxito Y/N para la ramificación condicional del proceso y funciona a través del método universal de CRM crm.item.update.
El robot actualiza un contacto arbitrario por su ID, incluso cuando el proceso de negocio se ejecuta sobre otra entidad de CRM — una negociación, un prospecto o una tarea. El ID del contacto y el conjunto de campos se indican de forma explícita: los campos se pasan como una cadena JSON en formato camelCase (por ejemplo {"name":"John","lastName":"Smith","assignedById":5,"companyId":12}). La actualización usa el método universal crm.item.update, por lo que están disponibles todos los campos del contacto, incluidos los personalizados. Casos típicos: cuando cambia la etapa de la negociación, actualizar el contacto vinculado; fijar el responsable y la empresa a partir de datos de un sistema externo; cambiar de forma masiva los campos de los contactos desde un proceso superior. Devuelve un indicador Correcto (Y/N): Y si la actualización tiene éxito, N si el ID está vacío, el JSON está vacío o no es válido, o si hay un error de API — compárelo en la condición del siguiente paso.
¿Qué parámetros de entrada acepta el robot?
| Parámetro | Tipo | ¿Obligatorio? | Por defecto |
|---|---|---|---|
| ID del contacto | int | sí | |
| Campos a actualizar (JSON camelCase): {"name":"John","lastName":"Smith","assignedById":5,"companyId":12} | string | sí |
¿Qué devuelve el robot?
| Parámetro | Tipo |
|---|---|
| Éxito (Y/N) | string |
¿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: no se ha indicado {id}
- Error: fields_json está vacío
- Error: fields_json contiene un JSON no válido
- Error de la API
Escenario: actualización de un contacto desde un proceso sobre una negociación
- La negociación pasa a una nueva etapa del embudo
- El robot actualiza el contacto vinculado: assignedById y companyId se pasan como JSON
- Un resultado Y confirma la actualización para el siguiente paso