Roboteka
Roboteka · Robots · Find task by condition

Find task by condition

The Find Task by Condition robot searches Bitrix24 (Alaio) tasks by filter: responsible, title, group/project, deadline, CRM link, status or a custom JSON filter. It returns the ID and title of the first task found, the list of all IDs, the number of tasks found and a found flag (Y/N) for branching the business process.

The robot searches for tasks in Bitrix24 (Alaio) via the tasks.task.list method and is used in business processes and robots. Available filters: responsible user ID, title (substring search), group or project ID, deadline from and to (DD.MM.YYYY or YYYY-MM-DD formats), CRM link (e.g. L_4, D_10, C_7, CO_5), status (1 new, 2 pending review, 3 in progress, 5 completed, 6 deferred) and a custom JSON filter. Sorting is set by the DEADLINE, ID or CREATED_DATE field (default ID descending) and the number of results is capped by the limit parameter (default 5, maximum 50). At least one filter parameter must be provided. Use the robot to find a responsible user's overdue tasks, check whether an open task exists for a deal, or collect a list of IDs for bulk processing. It returns the ID and title of the first task, an array of all IDs, their count and a found flag (Y/N) — use it in the condition of the next step.

What input parameters does the robot accept?

Parameter Type Required? Default
Responsible user ID int —
Task title (substring search) string —
Group / project ID int —
Deadline from (DD.MM.YYYY or YYYY-MM-DD) string —
Deadline to (DD.MM.YYYY or YYYY-MM-DD) string —
CRM link (e.g. L_4, D_10, C_7, CO_5) string —
Status: 1 new · 2 pending review · 3 in progress · 5 completed · 6 deferred string —
Custom filter (JSON, e.g. {"!STATUS":6}) string —
Sort by: DEADLINE / ID / CREATED_DATE (default ID DESC) string —
Maximum results (default 5) int —

What does the robot return?

Parameter Type
ID of the first task found int
Title of the first task string
All found IDs int
Number of tasks found int
Found (Y/N) string

What errors can the robot return?

The robot writes these messages to the business process log when it cannot complete a step. The text tells you what to fix in the settings or the data.

  • Error: no filter parameters provided
  • API error
  • No tasks found

Scenario: check open tasks for a deal

  1. A deal moves to the Closing stage
  2. The robot searches tasks linked to that deal in CRM with a status not equal to completed
  3. When found = Y the process notifies the responsible user, on N it moves the deal forward

Related robots

Related articles

Install Describe a task — we build the robot for free