Bitrix24Install

Overview

This node integrates with the Bitrix24 platform, specifically allowing interaction with various Bitrix24 resources such as CRM entities and timelines. The "Timeline" resource with the "Get Comment Fields" operation enables users to retrieve metadata about comment fields associated with timeline entries in Bitrix24.

Typical use cases include:

• Fetching available comment field definitions to dynamically build forms or filters.
• Automating workflows that depend on specific comment attributes within Bitrix24 timelines.
• Integrating Bitrix24 timeline comments into external systems by understanding their structure.

For example, a user might want to list all comment fields to allow selection of which fields to display or filter on in a custom dashboard.

Properties

Output

The node outputs an array of items where each item contains a json object representing the response from Bitrix24 for the requested resource and operation.

For the "Get Comment Fields" operation under the "Timeline" resource, the output json will contain the metadata of comment fields retrieved from Bitrix24. This typically includes field IDs, labels, types, and other descriptive information about each comment field.

No binary data output is indicated for this operation.

Dependencies

• Requires connection to Bitrix24 via one of the supported authentication methods (OAuth2, webhook URL, or API key).
• Uses Bitrix24 API endpoints internally to fetch resource data.
• No additional external services beyond Bitrix24 are required.
• Proper credentials must be configured in n8n for the chosen authentication method.

Troubleshooting

• Authentication errors: Ensure that the selected authentication method is correctly configured with valid credentials. OAuth2 tokens may expire and require refresh.
• API call failures: Network issues or incorrect permissions in Bitrix24 can cause API calls to fail. Verify API access rights and network connectivity.
• Invalid filter/order JSON: If using the "Filter" or "Order" options, ensure the JSON syntax is correct and matches Bitrix24 API expectations.
• Empty or missing results: This may indicate no comment fields exist or insufficient permissions. Confirm that the Bitrix24 account has access to timeline comment data.
• Error messages in output: When continueOnFail is enabled, errors are returned in the output JSON under an error property with a timestamp. Review these messages for troubleshooting.

Links and References

• Bitrix24 Official API Documentation
• Bitrix24 Timeline API Reference
• n8n Documentation on Creating Custom Nodes