Bitrix24Install

Overview

This node integrates with the Bitrix24 platform, specifically to interact with its CRM and business resources. 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 include:

• Fetching all tasks assigned to a user or within a project.
• Retrieving tasks filtered by status, priority, or deadline.
• Exporting task lists for reporting or synchronization with other systems.
• Automating workflows that depend on task data from Bitrix24.

Practical example:

• A marketing team uses this node to pull all open tasks related to a campaign, sorted by due date, to generate a daily progress report.

Properties

Output

The node outputs an array of task objects in the json field. Each object represents a task record retrieved from Bitrix24 according to the specified filters and options.

• The structure of each task object depends on the selected fields; if no specific selection is made, default fields are returned.
• If binary data were involved (not indicated here), it would be summarized accordingly, but this node focuses on JSON task data.

Example output snippet (conceptual):

[
  {
    "ID": "123",
    "TITLE": "Prepare monthly report",
    "STATUS": "In Progress",
    "DEADLINE": "2024-07-01T12:00:00Z",
    "ASSIGNED_BY_ID": "45"
  },
  ...
]

Dependencies

• Requires valid authentication credentials for Bitrix24 via one of the supported methods (OAuth2, webhook URL, or API key).
• The node internally calls Bitrix24 REST API endpoints to fetch task data.
• No additional external services beyond Bitrix24 are required.
• Proper configuration of credentials in n8n is necessary for successful API communication.

Troubleshooting

• Authentication errors: Ensure the chosen authentication method is correctly configured and the credentials are valid. OAuth2 tokens may expire and require refresh.
• API rate limits: Bitrix24 may impose limits on API calls; using "Return All" with large datasets might hit these limits.
• Invalid filter/order/select JSON: Malformed JSON in options can cause API errors. Validate JSON syntax before execution.
• No results returned: Check filter criteria to ensure they match existing tasks; also verify permissions of the authenticated user.
• Error messages containing API response details: Review the error message for hints about missing permissions, invalid parameters, or connectivity issues.

Links and References

• Bitrix24 REST API Documentation
• Bitrix24 Tasks API Reference
• n8n Documentation on Credentials