Buscar elemento de proceso inteligente
El robot «Buscar elemento de proceso inteligente» busca elementos de proceso inteligente de Bitrix24 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 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 |
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