Bitrix24Install

Overview

This node integrates with the Bitrix24 platform, allowing users to interact with various Bitrix24 resources such as CRM entities and business platform features. Specifically, for the Disk resource with the Get Shared Items operation, it retrieves items that have been shared within the Bitrix24 disk storage system.

Common scenarios where this node is beneficial include:

• Automating retrieval of files or folders shared across a Bitrix24 workspace.
• Integrating Bitrix24 shared disk content into workflows for further processing or notifications.
• Synchronizing shared disk items with other systems or databases.

For example, a user might use this node to fetch all shared documents in a team folder to generate reports or trigger alerts when new shared items appear.

Properties

Output

The node outputs an array of items representing the shared disk objects retrieved from Bitrix24. Each item’s json field contains the data returned by the Bitrix24 API for shared disk items, which typically includes metadata such as file/folder IDs, names, sharing details, timestamps, and permissions.

If the node supports binary data output (e.g., file contents), it would be included accordingly, but based on the provided code and context, the output focuses on JSON metadata about shared items.

Dependencies

• Requires authentication credentials for Bitrix24, which can be configured using one of the supported methods: OAuth2, webhook URL, or API key.
• The node depends on internal helper functions to make standardized API calls to Bitrix24 endpoints.
• No additional external services are required beyond Bitrix24 itself.

Troubleshooting

• Authentication errors: Ensure the selected authentication method is correctly configured with valid credentials or tokens.
• API call failures: Errors may occur if the filter or order JSON is malformed; verify JSON syntax and correctness.
• Pagination issues: If many shared items exist, use the Start property to paginate through results properly.
• Permission errors: The authenticated user must have sufficient rights to access shared disk items in Bitrix24.
• Error messages: If the node throws errors containing messages from Bitrix24 API, check the message details for invalid parameters or access issues.

To resolve common errors:

• Double-check authentication setup.
• Validate JSON inputs for filters and ordering.
• Confirm user permissions in Bitrix24.
• Use "Continue On Fail" option to handle intermittent API errors gracefully.

Links and References

• Bitrix24 Official API Documentation
• Bitrix24 Disk API Reference
• OAuth2 Authentication Guide for Bitrix24
• Bitrix24 Webhook Usage Instructions