Bitrix24

Overview

This node integrates with the Bitrix24 platform, specifically enabling interaction with its Smart Process Automation (SPA) features. The "Set SPA Config" operation allows users to configure or update settings related to a Smart Process within Bitrix24. This is useful for automating business workflows and managing custom data structures in Bitrix24.

Common scenarios include:

• Automating CRM processes by configuring SPA entities.
• Updating SPA configurations dynamically based on external triggers.
• Managing custom business logic embedded in Bitrix24's SPA framework.

For example, a user might use this node to set up a new SPA type configuration when a new project starts or update SPA parameters as part of an automated workflow triggered by changes in other systems.

Properties

The node also supports selecting the Resource (SPA) and Operation (Set SPA Config), but these are fixed by your request context.

Output

The node outputs JSON data representing the result of the SPA configuration operation. The exact structure depends on the Bitrix24 API response but generally includes confirmation of the updated configuration or error details if the operation fails.

If an error occurs and the node is configured to continue on failure, the output JSON will contain an error field with the error message, along with the resource name and a timestamp.

No binary data output is indicated.

Dependencies

• Requires connection to Bitrix24 via one of the supported authentication methods:

  • OAuth2 token credential
  • Webhook URL credential
  • API key credential

• Uses Bitrix24 REST API endpoints internally to perform SPA-related operations.

• No additional external services beyond Bitrix24 are required.

• Proper credentials must be configured in n8n for the chosen authentication method.

Troubleshooting

• Common issues:

  • Authentication failures due to invalid or expired tokens/keys.
  • Insufficient permissions in Bitrix24 to modify SPA configurations.
  • Incorrect SPA type or entity IDs leading to API errors.
  • Network connectivity problems affecting API calls.

• Error messages:

  • Errors returned from Bitrix24 API will appear in the output JSON under the error field if "Continue On Fail" is enabled.
  • Typical messages may include authorization errors, missing fields, or invalid parameters.

• Resolutions:

  • Verify that the correct authentication method and valid credentials are used.
  • Ensure the Bitrix24 user has appropriate rights to manage SPA configurations.
  • Double-check input parameters such as SPA type IDs.
  • Check network access and proxy settings if applicable.

Links and References

• Bitrix24 Official API Documentation
• Bitrix24 Smart Process Automation Overview
• n8n documentation on Bitrix24 Integration