Bitrix24Install

Overview

This node integrates with the Bitrix24 platform, specifically allowing users to interact with various Bitrix24 resources such as CRM entities and business processes. The "Task" resource with the "Get" operation enables retrieving detailed information about a specific task by its ID.

Common scenarios for this node include:

• Fetching details of a particular task in Bitrix24 to use in workflows or automation.
• Integrating task data into other systems or reports.
• Triggering subsequent actions based on task properties or status.

Practical example:

• A workflow that retrieves a task's details when triggered, then updates another system with the task's status or assigned user.

Properties

Output

The node outputs an array of items where each item contains a json property holding the retrieved task data from Bitrix24. The structure of the json output corresponds to the task entity fields returned by the Bitrix24 API, including standard task attributes such as ID, title, description, status, assigned user, creation date, etc.

If an error occurs during execution and the node is configured to continue on failure, the output will contain an item with an error field describing the issue, along with the resource name and a timestamp.

The node does not output binary data.

Dependencies

• Requires valid authentication credentials for Bitrix24, which can be provided via OAuth2, webhook URL, or API key.
• The node depends on Bitrix24's REST API endpoints to fetch task data.
• No additional external services are required beyond Bitrix24 itself.
• Proper configuration of authentication credentials in n8n is necessary.

Troubleshooting

• Common issues:

  • Invalid or expired authentication credentials leading to authorization errors.
  • Incorrect or missing Task ID causing the API call to fail or return no data.
  • Malformed JSON in optional parameters (Filter, Order, Select, Group, Custom Parameters) causing request errors.
  • Network connectivity issues preventing access to Bitrix24 API.

• Error messages:

  • Errors thrown by the node will include the message from the Bitrix24 API or internal processing errors.
  • If "Continue On Fail" is enabled, errors are returned in the output JSON under the error key.

• Resolutions:

  • Verify and refresh authentication credentials.
  • Ensure the Task ID is correct and exists in Bitrix24.
  • Validate JSON syntax in optional parameters before running the node.
  • Check network connectivity and firewall settings.

Links and References

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