Bitrix24 icon

Bitrix24

Interact with Bitrix24 CRM and business platform
Join our community

Actions290

Overview

This node interacts with the Bitrix24 platform, specifically focusing on the "Disk" resource and the "Get Files" operation. It allows users to retrieve files from a specified folder within Bitrix24's file storage system. This is useful for automating workflows that require access to documents or media stored in Bitrix24, such as syncing files to other services, processing attachments, or backing up data.

Practical examples include:

  • Automatically fetching all files from a project folder to process or archive them.
  • Integrating Bitrix24 file storage with external document management systems.
  • Triggering downstream automation based on files retrieved from a specific folder.

Properties

Name Meaning
Authentication Method of authenticating with Bitrix24: OAuth2 (recommended), Webhook (simpler but less secure), or API Key authentication.
Folder ID The unique identifier of the folder in Bitrix24 Disk from which to retrieve files.
Options Additional optional parameters:
- Filter: JSON object specifying criteria to filter files.
- Order: JSON object defining sorting order.
- Start: Number indicating the start position for pagination (offset).

Output

The node outputs an array of items where each item's json property contains metadata about a file retrieved from the specified folder. Typical fields may include file identifiers, names, sizes, creation/modification dates, and other relevant attributes provided by Bitrix24's API.

If the node supports binary data output (not explicitly shown in the code snippet), it would represent the actual file content, enabling further processing or saving of the files.

Dependencies

  • Requires valid authentication credentials for Bitrix24, which can be configured using OAuth2, webhook URL, or API key methods.
  • Relies on Bitrix24's REST API endpoints to fetch file information.
  • No additional external libraries beyond those bundled with the node are required.

Troubleshooting

  • Common Issues:

    • Invalid or expired authentication credentials will cause API calls to fail.
    • Incorrect Folder ID may result in empty results or errors.
    • Improperly formatted JSON in Filter or Order options can cause parsing errors.

  • Error Messages:

    • Errors returned from Bitrix24 API will be surfaced with their message in the output if "Continue On Fail" is enabled.
    • Network or permission errors typically indicate issues with authentication setup or API access rights.

  • Resolutions:

    • Verify and refresh authentication credentials.
    • Double-check the Folder ID exists and is accessible.
    • Validate JSON syntax in filter/order inputs before execution.

Links and References

Discussion