Bitrix24Install

Overview

This node interacts with the Bitrix24 platform, specifically focusing on Smart Process Automation (SPA) entities when using the "Get Types" operation. It retrieves a list of SPA types available in the Bitrix24 environment. This is useful for workflows that need to dynamically fetch and work with different SPA entity types, such as automating business processes, managing custom data structures, or integrating SPA data into other systems.

Practical examples include:

• Automatically listing all SPA types to populate dropdowns in subsequent workflow steps.
• Fetching SPA type IDs to query or manipulate specific SPA records.
• Integrating SPA metadata into reporting or synchronization tasks.

Properties

Output

The output is an array of SPA type objects, each containing at least:

• name: A string combining the SPA type title and its ID, e.g., "Example Type (ID: 123)".
• value: The SPA type ID as a string.
• description: A textual description of the SPA type, typically the title or name.

The output is structured as JSON under the json property of each item. There is no binary data output for this operation.

Example output snippet:

[
  {
    "name": "Customer Feedback (ID: 101)",
    "value": "101",
    "description": "Customer Feedback"
  },
  {
    "name": "Order Processing (ID: 102)",
    "value": "102",
    "description": "Order Processing"
  }
]

Dependencies

• Requires connection to a Bitrix24 instance.
• Needs one of the supported authentication methods configured in n8n: OAuth2, Webhook URL, or API Key.
• Uses Bitrix24 API endpoints internally to fetch SPA types (crm.type.list).
• No additional external dependencies beyond standard Bitrix24 API access.

Troubleshooting

• Common issues:

  • Authentication failures due to incorrect or expired credentials.
  • API rate limits or pagination limits causing incomplete data retrieval.
  • Network connectivity problems preventing API calls.

• Error messages:

  • Errors during SPA type loading will be logged and may appear as "Failed to load SPA types: <error message>".
  • If no SPA types are found, the output may contain a placeholder entry indicating no types are available.

• Resolutions:

  • Verify and refresh authentication credentials.
  • Check network connectivity and Bitrix24 API availability.
  • Adjust "Max pages to load" or enable "Return All" to ensure complete data retrieval.
  • Review Bitrix24 API permissions for the authenticated user.

Links and References

• Bitrix24 REST API Documentation
• Bitrix24 Smart Process Automation Overview
• n8n Documentation on Creating Bitrix24 Nodes (for general context)