Bitrix24 icon

Bitrix24

Interact with Bitrix24 CRM and business platform
Join our community

Actions290

Overview

This node interacts with the Bitrix24 platform, specifically providing operations on various resources such as CRM entities and disk storage. For the Disk - List Files operation, it retrieves a list of files from a specified folder in the Bitrix24 disk storage.

Common scenarios where this node is beneficial include:

  • Automating file management workflows by listing files in a particular folder.
  • Integrating Bitrix24 file storage with other systems or processes.
  • Fetching file metadata for reporting or processing purposes.

Practical example:

  • You want to retrieve all files stored in a project folder within Bitrix24 to process them further or sync with another cloud storage service.

Properties

Name Meaning
Authentication Method used to authenticate with Bitrix24. Options:
• OAuth2 (recommended for production)
• Webhook (simpler but less secure)
• API Key authentication
Folder ID The unique identifier of the folder in Bitrix24 disk from which to list files. This is required.
Return All Boolean flag indicating whether to return all files or limit the results. If false, only up to the specified maximum pages will be returned.
Max pages to load When "Return All" is false, this limits how many pages of results to fetch. Each page contains up to 50 items.
Options Additional optional parameters:
• Filter: JSON object specifying filter criteria for files.
• Order: JSON object specifying sort order of the results.
• Start: Number indicating start position for pagination.

Output

The node outputs an array of items where each item represents a file retrieved from the specified folder. Each item's json property contains the file's metadata as returned by the Bitrix24 API.

If binary data output is supported (not explicitly shown in the provided code), it would represent the actual file content; however, based on the static analysis, this operation focuses on listing file metadata only.

Dependencies

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

Troubleshooting

  • Common issues:

    • Invalid or expired authentication credentials leading to authorization errors.
    • Incorrect Folder ID causing empty results or errors.
    • Improperly formatted JSON in the "Filter" or "Order" options causing API request failures.
    • Pagination limits not set correctly, resulting in incomplete data retrieval.

  • Error messages:

    • Errors thrown by the Bitrix24 API will be surfaced, e.g., "Invalid folder ID" or "Authentication failed".
    • If the node is configured to continue on failure, error details will be included in the output JSON under an error field along with resource and timestamp information.

  • Resolutions:

    • Verify and refresh authentication credentials.
    • Double-check the Folder ID value.
    • Validate JSON syntax in filter/order fields.
    • Adjust pagination settings according to expected data volume.

Links and References

Discussion