Bitrix24Install

Overview

This node integrates with the Bitrix24 platform, enabling users to interact with various Bitrix24 resources including CRM entities and Smart Process Automation (SPA) types. Specifically, for the "SPA" resource and the "Get SPA List" operation, the node fetches a list of Smart Process Automation types available in the Bitrix24 account.

Common scenarios where this node is beneficial include:

• Automating workflows that require retrieving SPA types to dynamically build forms or process data.
• Integrating Bitrix24 SPA data into other systems or dashboards.
• Managing or reporting on SPA entities programmatically.

For example, a user might use this node to get all SPA types to populate a dropdown menu in a workflow, allowing subsequent steps to act based on the selected SPA type.

Properties

The node also requires selecting the Resource ("SPA" in this case) and Operation ("Get SPA List"). The provided properties JSON only includes the Authentication property, which controls how the node authenticates requests to Bitrix24.

Output

The output of the node is an array of JSON objects representing the SPA types retrieved from Bitrix24. Each item typically contains fields such as:

• id or entityTypeId: Identifier of the SPA type.
• title or name: Human-readable name of the SPA type.
• Additional metadata like whether automation is enabled.

If the node encounters an error during execution and "Continue On Fail" is enabled, it outputs an object with an error message, the resource name, and a timestamp.

No binary data output is produced by this node.

Dependencies

• Requires valid authentication credentials for Bitrix24 via one of the supported methods (OAuth2, webhook URL, or API key).
• Uses Bitrix24 REST API endpoints to fetch SPA types (crm.type.list).
• The node depends on internal helper functions to make standardized API calls to Bitrix24.

Troubleshooting

• Common issues:

  • Authentication failures due to incorrect or expired credentials.
  • API rate limits or connectivity issues causing failed API calls.
  • No SPA types returned if none are configured in the Bitrix24 account.

• Error messages:

  • Errors during API calls will be thrown with messages indicating failure reasons.
  • If "Continue On Fail" is enabled, errors are returned in the output JSON under the error field.

• Resolutions:

  • Verify and refresh authentication credentials.
  • Check network connectivity and Bitrix24 API status.
  • Ensure SPA types exist in the Bitrix24 instance.

Links and References

• Bitrix24 REST API Documentation
• Bitrix24 Smart Process Automation Overview
• n8n documentation on creating custom nodes