Log spent time into a task
The "Log spent time into a task" robot adds a time-tracking record to a task by its ID in Bitrix24 (Alaio) business processes and robots: the minutes, a comment, and optionally an employee. The record shows up in the task Time tracking tab and counts in reports. It returns the record ID and a Success Y/N flag.
The robot logs labor into a task from a process — no manual stopwatch, no forgotten entries. The input is the task ID, the time in minutes, an optional comment, and the employee to book the time on (by default the user the application acts as). The record lands in the standard task time tracking and shows in labor reports. Typical use cases: auto-book a standard allowance for a routine operation (a site visit, a call, an installation) on its completion; log request handling time from process data; accumulate labor on scheduled work without the assignee doing anything. If the task is not found or the minutes are missing, Success = N is returned. It returns the record ID and the Y/N flag — use them in the next steps of the business process.
What input parameters does the robot accept?
| Parameter | Type | Required? | Default |
|---|---|---|---|
| Task ID | int | yes | |
| Time spent, minutes | int | yes | |
| Record comment (optional) | string | — | |
| Employee (optional, defaults to the application user) | user | — |
What does the robot return?
| Parameter | Type |
|---|---|
| Time record ID | int |
| Success (Y/N) | string |
Scenario: a standard allowance for a site visit
- A site visit task reaches the Completed status
- The robot logs 90 minutes into the task with the comment Standard visit allowance
- The labor lands in the report — the assignee booked nothing by hand