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 (Alaio). 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 |
¿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 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