Buscar elemento de proceso inteligente
El robot «Buscar elemento de proceso inteligente» busca elementos de proceso inteligente de Bitrix24 (Alaio) por filtro: etapa, responsable o un filtro JSON personalizado. Devuelve el ID y el título del primer elemento encontrado, la lista de todos los ID, el número de elementos encontrados y un indicador «encontrado» (Y/N) para la ramificación posterior del proceso de negocio.
El robot busca elementos de proceso inteligente en el CRM de Bitrix24 (Alaio) mediante el método crm.item.list y se utiliza en procesos de negocio y robots. Se indica el ID del tipo de proceso inteligente (obligatorio) y cualquiera de estas condiciones: etapa (stageId), ID del responsable y un filtro JSON personalizado para campos no estándar. El orden se establece por el campo id, createdTime o updatedTime (por defecto updatedTime descendente) y el número de resultados se limita con el parámetro límite (por defecto 5, máximo 50). Use el robot cuando necesite encontrar un elemento de proceso inteligente vinculado a una negociación o un contacto, comprobar si existe un elemento abierto en una etapa concreta o reunir una lista de ID para procesamiento por lotes. Devuelve el ID y el título del primer elemento, un array con todos los ID encontrados, 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 tipo de proceso inteligente (encuéntrelo en CRM → Procesos inteligentes → ajustes) | int | sí | |
| Etapa (p. ej. DT{entityTypeId}:{stageCode}) | string | — | |
| ID del responsable | int | — | |
| Filtro personalizado (JSON, p. ej. {"contactId":"123"}) | string | — | |
| Orden: id / createdTime / updatedTime (por defecto updatedTime DESC) | string | — | |
| Máximo de resultados (por defecto 5) | int | — |
¿Qué devuelve el robot?
| Parámetro | Tipo |
|---|---|
| ID del primer elemento encontrado | int |
| Título del primer elemento | string |
| Todos los ID encontrados | int |
| Número de elementos encontrados | 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: indique el ID del tipo de proceso inteligente
- Error de API
- No se encontraron elementos
Escenario: buscar una solicitud activa por contacto
- Una negociación pasa a la etapa «En curso»
- El robot busca elementos de proceso inteligente por ID de tipo y un filtro con el ID del contacto
- Con found = Y el proceso toma el ID del elemento encontrado y lo actualiza, con N crea uno nuevo