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 |
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