Buscar tarea por condición
El robot «Buscar tarea por condición» busca tareas de Bitrix24 (Alaio) por filtro: responsable, título, grupo/proyecto, fecha límite, vínculo con CRM, estado o un filtro JSON personalizado. Devuelve el ID y el título de la primera tarea encontrada, la lista de todos los ID, el número de tareas encontradas y un indicador «encontrado» (Y/N) para la ramificación del proceso de negocio.
El robot busca tareas en Bitrix24 (Alaio) mediante el método tasks.task.list y se utiliza en procesos de negocio y robots. Filtros disponibles: ID del responsable, título (búsqueda por coincidencia), ID del grupo o proyecto, fecha límite desde y hasta (formatos DD.MM.AAAA o AAAA-MM-DD), vínculo con CRM (p. ej. L_4, D_10, C_7, CO_5), estado (1 nueva, 2 pendiente, 3 en curso, 4 esperando control, 5 completada, 6 aplazada; varios separados por comas) y un filtro JSON personalizado. El orden se establece por el campo DEADLINE, ID o CREATED_DATE (por defecto ID descendente) y el número de resultados se limita con el parámetro límite (por defecto 5, máximo 50). Debe indicarse al menos un parámetro de filtro. Use el robot para encontrar las tareas vencidas de un responsable, comprobar si existe una tarea abierta para una negociación o reunir una lista de ID para procesamiento masivo. Devuelve el ID y el título de la primera tarea, un array con todos los ID, su cantidad y un indicador «encontrado» (Y/N) — úselo en la condición del siguiente paso.
¿Qué parámetros de entrada acepta el robot?
| Parámetro | Tipo | ¿Obligatorio? | Por defecto |
|---|---|---|---|
| ID del responsable | int | — | |
| Título de la tarea (búsqueda por coincidencia) | string | — | |
| ID del grupo / proyecto | int | — | |
| Fecha límite desde (DD.MM.AAAA o AAAA-MM-DD) | string | — | |
| Fecha límite hasta (DD.MM.AAAA o AAAA-MM-DD) | string | — | |
| Vínculo con CRM (p. ej. L_4, D_10, C_7, CO_5) | string | — | |
| Estado, varios separados por comas: 1 nueva · 2 pendiente · 3 en curso · 4 esperando control · 5 completada · 6 aplazada | string | — | |
| Filtro personalizado (JSON, p. ej. {"!REAL_STATUS":5}) | string | — | |
| Orden: DEADLINE / ID / CREATED_DATE (por defecto ID DESC) | string | — | |
| Máximo de resultados (por defecto 5) | int | — |
¿Qué devuelve el robot?
| Parámetro | Tipo |
|---|---|
| ID de la primera tarea encontrada | int |
| Título de la primera tarea | string |
| Todos los ID encontrados | int |
| Número de tareas encontradas | int |
| Encontrado (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 proporcionado ningún parámetro de filtro
- Error de API
- No se encontraron tareas
Escenario: comprobar tareas abiertas de una negociación
- Una negociación pasa a la etapa «Cierre»
- El robot busca tareas vinculadas a esa negociación en CRM con un estado distinto de completada
- Con found = Y el proceso avisa al responsable, con N hace avanzar la negociación
Robots similares
Artículos relacionados
- ID en Bitrix24: cómo encontrar el ID de una negociación, contacto, tarea o usuario
- Tareas recurrentes en Bitrix24: plantillas, calendario y por qué una deja de aparecer
- Cómo buscar una negociación, un contacto o un prospecto desde un proceso de Bitrix24
- Campos en las tareas de Bitrix24: del sistema, personalizados y automatización
- Robots en tareas de Bitrix24: activación, funciones y vínculo con negociaciones