Encontrar item de processo inteligente
O robô «Encontrar item de processo inteligente» busca itens de processo inteligente do Bitrix24 por filtro: etapa, responsável ou um filtro JSON personalizado. Retorna o ID e o título do primeiro item encontrado, a lista de todos os IDs, o número de itens encontrados e um indicador «encontrado» (Y/N) para a ramificação posterior do processo de negócios.
O robô busca itens de processo inteligente no CRM do Bitrix24 por meio do método crm.item.list e é usado em processos de negócios e robôs. Informa-se o ID do tipo de processo inteligente (obrigatório) e qualquer uma destas condições: etapa (stageId), ID do responsável e um filtro JSON personalizado para campos não padrão. A ordenação é definida pelo campo id, createdTime ou updatedTime (padrão updatedTime decrescente) e o número de resultados é limitado pelo parâmetro limite (padrão 5, máximo 50). Use o robô quando precisar encontrar um item de processo inteligente vinculado a um negócio ou contato, verificar se existe um item aberto em uma etapa específica ou reunir uma lista de IDs para processamento em lote. Retorna o ID e o título do primeiro item, um array com todos os IDs encontrados, sua quantidade e um indicador «encontrado» (Y/N) — use-o na condição da próxima etapa.
Quais parâmetros de entrada o robô aceita?
| Parâmetro | Tipo | Obrigatório? | Padrão |
|---|---|---|---|
| ID do tipo de processo inteligente (encontre em CRM → Processos inteligentes → configurações) | int | sim | |
| Etapa (ex.: DT{entityTypeId}:{stageCode}) | string | — | |
| ID do responsável | int | — | |
| Filtro personalizado (JSON, ex.: {"contactId":"123"}) | string | — | |
| Ordenação: id / createdTime / updatedTime (padrão updatedTime DESC) | string | — | |
| Máximo de resultados (padrão 5) | int | — |
O que o robô retorna?
| Parâmetro | Tipo |
|---|---|
| ID do primeiro item encontrado | int |
| Título do primeiro item | string |
| Todos os IDs encontrados | int |
| Número de itens encontrados | int |
| Encontrado (Y/N) | string |
Cenário: encontrar uma solicitação ativa por contato
- Um negócio passa para a etapa «Em andamento»
- O robô busca itens de processo inteligente por ID de tipo e um filtro com o ID do contato
- Com found = Y o processo pega o ID do item encontrado e o atualiza, com N cria um novo