Encontrar tarefa por condição
O robô «Encontrar tarefa por condição» busca tarefas do Bitrix24 (Alaio) 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 (Alaio) 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.: L_4, D_10, C_7, CO_5), status (1 nova, 2 pendente, 3 em andamento, 4 aguardando controle, 5 concluída, 6 adiada; vários separados por vírgulas) 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.: L_4, D_10, C_7, CO_5) | string | — | |
| Status, vários separados por vírgulas: 1 nova · 2 pendente · 3 em andamento · 4 aguardando controle · 5 concluída · 6 adiada | string | — | |
| Filtro personalizado (JSON, ex.: {"!REAL_STATUS":5}) | 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 |
Quais erros o robô pode retornar?
O robô grava essas mensagens no histórico do processo de negócios quando não consegue concluir uma etapa. O texto mostra o que corrigir nas configurações ou nos dados.
- Erro: nenhum parâmetro de filtro informado
- Erro de API
- Nenhuma tarefa encontrada
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
Robôs semelhantes
Artigos relacionados
- ID de registro no Bitrix24: como achar o ID de negócio, contato, tarefa ou usuário
- Tarefas recorrentes no Bitrix24: modelos, agenda e por que uma deixa de aparecer
- Como encontrar um negócio, contato ou lead a partir de um processo no Bitrix24
- Campos nas tarefas do Bitrix24: de sistema, personalizados e automação
- Robôs em tarefas do Bitrix24: como ativar, o que fazem e como vincular a tarefa a um negócio