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. LEAD_4, DEAL_10, CONTACT_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. LEAD_4, DEAL_10, CONTACT_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 |
Scenario: check open tasks for a deal
- A deal moves to the Closing stage
- The robot searches tasks linked to that deal in CRM with a status not equal to completed
- When found = Y the process notifies the responsible user, on N it moves the deal forward