Actualizar prospecto por ID
El robot «Actualizar prospecto por ID» modifica cualquier prospecto por su identificador desde cualquier contexto de proceso de negocio en Bitrix24. Los campos a modificar se pasan como JSON en formato camelCase (title, stageId, assignedById 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 prospecto arbitrario por su ID, incluso cuando el proceso de negocio se ejecuta sobre otra entidad de CRM — una negociación, un contacto o una tarea. El ID del prospecto y el conjunto de campos se indican de forma explícita: los campos se pasan como una cadena JSON en formato camelCase (por ejemplo {"title":"Nuevo prospecto","stageId":"NEW","assignedById":5,"ufCrm_123":"valor"}). La actualización usa el método universal crm.item.update, por lo que están disponibles todos los campos del prospecto, incluidos los personalizados. Casos típicos: cuando se activa el proceso, mover el prospecto a la etapa adecuada; fijar el responsable a partir de datos de un sistema externo; cambiar de forma masiva las etapas de los prospectos 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 prospecto | int | sí | |
| Campos a actualizar (JSON camelCase): {"title":"New lead","stageId":"NEW","assignedById":5,"ufCrm_123":"value"} | string | sí |
¿Qué devuelve el robot?
| Parámetro | Tipo |
|---|---|
| Éxito (Y/N) | string |
Escenario: actualización de un prospecto desde un proceso
- El proceso del prospecto llega al paso de calificación
- El robot actualiza el prospecto: stageId y assignedById se pasan como JSON
- Un resultado Y confirma la actualización para el siguiente paso