Bitrix24Install

Overview

This node integrates with the Bitrix24 platform, specifically enabling interaction with its CRM and business automation features. The "Get SPA Info" operation under the "SPA" resource allows users to retrieve detailed information about Smart Process Automation (SPA) entities within Bitrix24.

Typical use cases include:

• Fetching metadata or configuration details of SPA types for automation workflows.
• Integrating SPA data into external systems or dashboards.
• Automating processes based on SPA entity information.

For example, a user might want to get all available SPA types and their fields to dynamically build forms or reports in an external application.

Properties

Output

The node outputs JSON data representing the result of the requested SPA information retrieval. The structure depends on the specific SPA info requested but generally includes:

• Details about SPA types such as IDs, titles, and descriptions.
• Field definitions for SPA entities including field names, types, and whether they are required or read-only.
• Metadata related to SPA automation capabilities.

If an error occurs during execution, the output JSON will contain an error field with the error message, the resource name, and a timestamp.

The node does not explicitly output binary data.

Dependencies

• Requires connection to Bitrix24 via one of the supported authentication methods (OAuth2, webhook URL, or API key).
• Uses Bitrix24 REST API endpoints such as crm.type.list and crm.item.fields to fetch SPA-related data.
• Relies on internal helper functions to make authenticated API calls to Bitrix24.

No additional external services or environment variables beyond the configured Bitrix24 credentials are needed.

Troubleshooting

• Common Issues:

  • Authentication failures due to incorrect or expired credentials.
  • API rate limits or permission restrictions from Bitrix24.
  • Missing or invalid SPA type identifiers when requesting fields.

• Error Messages:

  • Errors returned from Bitrix24 API calls will be surfaced in the output JSON's error field.
  • If the node fails to load SPA types or fields, it returns descriptive error messages indicating the failure reason.

• Resolutions:

  • Verify that the selected authentication method is correctly configured and has sufficient permissions.
  • Ensure the SPA type ID parameter is provided and valid when fetching SPA item fields.
  • Check Bitrix24 API quotas and adjust usage accordingly.

Links and References

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