Encontrar tarefa por condição
O robô «Encontrar tarefa por condição» busca tarefas do Bitrix24 por filtro: responsável, título, grupo/projeto, prazo, vínculo com CRM, status ou um filtro JSON personalizado. Retorna o ID e o título da primeira tarefa encontrada, a lista de todos os IDs, o número de tarefas encontradas e um indicador «encontrado» (Y/N) para a ramificação do processo de negócios.
O robô busca tarefas no Bitrix24 por meio do método tasks.task.list e é usado em processos de negócios e robôs. Filtros disponíveis: ID do responsável, título (busca por ocorrência), ID do grupo ou projeto, prazo de e até (formatos DD.MM.AAAA ou AAAA-MM-DD), vínculo com CRM (ex.: LEAD_4, DEAL_10, CONTACT_7, CO_5), status (1 nova, 2 aguardando controle, 3 em andamento, 5 concluída, 6 adiada) e um filtro JSON personalizado. A ordenação é definida pelo campo DEADLINE, ID ou CREATED_DATE (padrão ID decrescente) e o número de resultados é limitado pelo parâmetro limite (padrão 5, máximo 50). É preciso informar ao menos um parâmetro de filtro. Use o robô para encontrar tarefas em atraso de um responsável, verificar se existe uma tarefa aberta para um negócio ou reunir uma lista de IDs para processamento em massa. Retorna o ID e o título da primeira tarefa, um array com todos os IDs, 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 responsável | int | — | |
| Título da tarefa (busca por ocorrência) | string | — | |
| ID do grupo / projeto | int | — | |
| Prazo de (DD.MM.AAAA ou AAAA-MM-DD) | string | — | |
| Prazo até (DD.MM.AAAA ou AAAA-MM-DD) | string | — | |
| Vínculo com CRM (ex.: LEAD_4, DEAL_10, CONTACT_7, CO_5) | string | — | |
| Status: 1 nova · 2 aguardando controle · 3 em andamento · 5 concluída · 6 adiada | string | — | |
| Filtro personalizado (JSON, ex.: {"!STATUS":6}) | string | — | |
| Ordenação: DEADLINE / ID / CREATED_DATE (padrão ID DESC) | string | — | |
| Máximo de resultados (padrão 5) | int | — |
O que o robô retorna?
| Parâmetro | Tipo |
|---|---|
| ID da primeira tarefa encontrada | int |
| Título da primeira tarefa | string |
| Todos os IDs encontrados | int |
| Número de tarefas encontradas | int |
| Encontrado (Y/N) | string |
Cenário: verificar tarefas abertas de um negócio
- Um negócio passa para a etapa «Fechamento»
- O robô busca tarefas vinculadas a esse negócio no CRM com status diferente de concluída
- Com found = Y o processo notifica o responsável, com N faz o negócio avançar