Bitrix24

Overview

This node integrates with the Bitrix24 platform, specifically enabling interaction with its Smart Process Automation (SPA) features. The "Get SPA List" operation retrieves a list of SPA types available in the connected Bitrix24 account. This is useful for workflows that need to dynamically access or manipulate SPA entities, such as fetching SPA definitions for reporting, automation, or further processing within n8n.

Practical examples include:

• Automatically retrieving all SPA types to populate dropdowns or options in subsequent workflow steps.
• Using the SPA list to trigger actions based on specific SPA types.
• Integrating SPA data into external systems by first obtaining the SPA type identifiers.

Properties

Output

The node outputs an array of SPA types in the json field of each item. Each SPA type object typically contains:

• name: A human-readable name of the SPA type, often including its ID.
• value: The unique identifier (ID) of the SPA type as a string.
• description: Additional descriptive text about the SPA type.

Example output JSON snippet:

[
  {
    "name": "Customer Onboarding (ID: 123)",
    "value": "123",
    "description": "Customer Onboarding"
  },
  {
    "name": "Order Processing (ID: 456)",
    "value": "456",
    "description": "Order Processing"
  }
]

If an error occurs during retrieval, the output will contain an error message describing the failure.

Dependencies

• Requires connection to a Bitrix24 instance.
• Needs one of the following authentication methods configured in n8n:
  • OAuth2 credentials (recommended)
  • Webhook URL
  • API key credential
• Uses Bitrix24's REST API endpoint crm.type.list to fetch SPA types.

Troubleshooting

• Common issues:

  • Authentication failures due to incorrect or expired credentials.
  • Network connectivity problems preventing API calls.
  • Insufficient permissions in Bitrix24 account to access SPA types.
  • Empty or missing SPA types if none are defined in Bitrix24.

• Error messages and resolutions:

  • "Failed to load SPA types: <error message>": Indicates an issue calling the Bitrix24 API. Verify credentials and network access.
  • "No SPA types available": Means no SPA types were found; confirm that SPA types exist in your Bitrix24 environment.
  • If the node returns an error object in output, check the detailed message and timestamp for troubleshooting.

Links and References

• Bitrix24 REST API Documentation
• Bitrix24 Smart Process Automation Overview
• n8n Documentation on Credentials