Actions89
- Direct API Actions
- CRM Actions
- Task Actions
- User Actions
- SPA Actions
- Activity Actions
- Automation Actions
- Document Generator Actions
- Data Storage Actions
- Chat Actions
Overview
This node integrates with the Bitrix24 platform, specifically to interact with its CRM and business services. The "Task" resource with the "Get All" operation allows users to retrieve multiple task records from Bitrix24. It supports filtering, sorting, selecting specific fields, grouping, and custom parameters to tailor the data retrieval.
Common scenarios for this node include:
- Fetching all tasks assigned to a user or team for reporting.
- Retrieving tasks filtered by status, deadline, or priority.
- Exporting task data for synchronization with other systems.
- Automating workflows based on task lists.
For example, a user might configure the node to return all tasks due this week, sorted by priority, selecting only the task ID, title, and deadline fields.
Properties
| Name | Meaning |
|---|---|
| Authentication | Method of authenticating with Bitrix24: - OAuth2 (recommended for production) - Webhook (simpler but less secure) - API Key |
| Return All | Boolean flag indicating whether to return all matching tasks or limit the number of results returned. |
| Options | Collection of optional parameters to customize the query: - Filter: JSON object specifying filter criteria - Order: JSON object defining sort order - Select: JSON array listing fields to retrieve - Group: JSON object for grouping criteria - Custom Parameters: JSON object for any additional API parameters - Access Token: String token for authentication override |
Output
The node outputs an array of task objects in the json field of each item. Each object corresponds to a task retrieved from Bitrix24 and contains the fields requested via the "Select" option or defaults if none specified.
If binary data were involved (not indicated here), it would be summarized accordingly, but this node focuses on JSON task data.
Dependencies
- Requires access to a Bitrix24 account with appropriate permissions.
- Needs one of the supported authentication methods configured in n8n:
- OAuth2 credentials
- Webhook URL
- API key credential
- The node internally uses Bitrix24 API endpoints to fetch task data.
- No additional external dependencies beyond standard HTTP requests to Bitrix24.
Troubleshooting
- Authentication errors: Ensure that the selected authentication method is correctly configured and valid. For OAuth2, verify token validity and scopes. For webhook or API key, confirm the credentials are correct and have sufficient permissions.
- Empty results: Check the filter criteria JSON for correctness and ensure tasks matching the criteria exist.
- Invalid JSON in options: The filter, order, select, group, and custom parameters must be valid JSON. Malformed JSON will cause errors.
- API rate limits or timeouts: If retrieving many tasks, consider enabling "Return All" carefully to avoid hitting API limits.
- Error messages: Errors thrown by the Bitrix24 API will be surfaced. Review the error message for details and adjust parameters or authentication accordingly.