Actualizar tarea por ID
El robot «Actualizar tarea por ID» modifica una tarea existente de Bitrix24 por su ID desde cualquier contexto de proceso de negocio. Los campos se pasan como JSON con códigos en MAYÚSCULAS (TITLE, RESPONSIBLE_ID, DEADLINE, PRIORITY, etc.) y se aplican mediante el método tasks.task.update. Devuelve un indicador «Éxito (Y/N)» según el resultado de la llamada a la API.
El robot actualiza una tarea existente por su ID llamando al método tasks.task.update. La entrada es un ID numérico de la tarea y un conjunto de campos como JSON; los códigos de los campos se indican en MAYÚSCULAS, tal como exige la API de tareas — por ejemplo, {"TITLE":"Nuevo título","RESPONSIBLE_ID":5,"DEADLINE":"2024-12-31T23:59:59+03:00","PRIORITY":"2"}. Cuándo usarlo: reasignar al responsable o cambiar el plazo de la tarea cuando una negociación pasa a una nueva etapa; añadir un marcador de etapa al título; subir la prioridad según una condición del proceso. El robot devuelve «Éxito (Y/N)»: N si falta el ID, el JSON está vacío o no es válido, o la API devolvió un error (el texto del error va al registro). Use el indicador «Éxito» en la condición del siguiente paso para separar las ramas de actualización correcta y fallida.
¿Qué parámetros de entrada acepta el robot?
| Parámetro | Tipo | ¿Obligatorio? | Por defecto |
|---|---|---|---|
| ID de la tarea | int | sí | |
| Campos a actualizar (UPPERCASE JSON): {"TITLE":"Nuevo título","RESPONSIBLE_ID":5,"DEADLINE":"2024-12-31T23:59:59+03:00","PRIORITY":"2"} | string | sí |
¿Qué devuelve el robot?
| Parámetro | Tipo |
|---|---|
| Éxito (Y/N) | string |
Escenario: reasignación de una tarea al avanzar una negociación
- Una negociación pasa a la etapa «En curso»
- El robot llama a la actualización de la tarea por su ID con los campos {"RESPONSIBLE_ID":5}
- Con «Éxito» = Y el proceso continúa, con N pasa a la rama de gestión de errores