Bitrix24Install

Overview

This node integrates with the Bitrix24 platform, specifically enabling interaction with its CRM and business process management features. The "Workflow" resource with the "Get Tasks" operation allows users to retrieve tasks related to workflows or business processes from Bitrix24.

Common scenarios for this node include:

• Automating task retrieval for monitoring workflow progress.
• Integrating Bitrix24 task data into other systems or dashboards.
• Filtering and sorting tasks based on custom criteria to streamline business process management.

For example, a user might configure this node to fetch all active tasks assigned to a particular department or user, sorted by due date, to generate daily reports or trigger notifications.

Properties

Output

The node outputs an array of items where each item contains a json field representing a task retrieved from Bitrix24 workflows. The structure of each task's JSON depends on the Bitrix24 API response but typically includes fields such as task ID, status, assigned user, creation/modification dates, and other task metadata.

If the node supports binary data output (not explicitly shown in the provided code), it would represent attachments or files related to tasks; however, this is not indicated here.

Dependencies

• Requires access to a Bitrix24 account with appropriate permissions to read workflow tasks.
• Needs one of the supported authentication methods configured in n8n:
  • OAuth2 credentials
  • Webhook URL
  • API key credential
• Uses Bitrix24 API endpoints internally via helper functions to fetch data.
• No additional external dependencies beyond standard HTTP requests to Bitrix24 APIs.

Troubleshooting

• Authentication errors: Ensure that the selected authentication method is correctly configured with valid credentials or tokens. OAuth2 requires proper token refresh handling.
• API rate limits: Bitrix24 may limit the number of API calls; using pagination wisely and limiting Max Pages to Load can help avoid hitting these limits.
• Invalid filter/order JSON: The Filter and Order properties expect valid JSON objects. Malformed JSON will cause errors. Validate JSON syntax before input.
• Empty results: If no tasks are returned, verify that the filter criteria match existing tasks and that the user has permission to view them.
• Continue on Fail: If enabled, the node returns error details in the output instead of failing the workflow, which helps in debugging.

Links and References

• Bitrix24 REST API Documentation
• Bitrix24 Business Process Documentation
• n8n Documentation on Creating Nodes