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 with the "Set SPA Permissions" operation, the node allows managing permissions related to Smart Process Automation entities within Bitrix24.

Common scenarios where this node is beneficial include automating permission assignments for SPA entities, integrating Bitrix24 SPA workflows into broader automation pipelines, or programmatically updating access controls on SPA records based on external triggers.

For example, a user might automate granting specific user groups access to certain SPA records when a new SPA item is created, or adjust permissions dynamically as part of a business process.

Properties

Note: The provided properties JSON only includes the "Authentication" property relevant to this operation. Other properties related to SPA permissions would be defined elsewhere in the node's configuration but are not included here.

Output

The node outputs an array of items, each containing a json object representing the response from Bitrix24 after processing the requested operation. For the "Set SPA Permissions" operation, the output JSON typically contains confirmation of permission changes or error details if the operation failed.

If the node encounters an error during execution and the "Continue On Fail" option is enabled, it outputs an item with an error field describing the issue, along with the resource name and a timestamp.

The node does not explicitly output binary data.

Dependencies

• Requires valid authentication credentials for Bitrix24, which can be provided via OAuth2, webhook URL, or API key.
• Uses internal helper functions to make standard API calls to Bitrix24 endpoints.
• No additional external services beyond Bitrix24 are required.
• Proper configuration of authentication credentials in n8n is necessary for successful operation.

Troubleshooting

• Common Issues:

  • Incorrect or expired authentication credentials leading to authorization errors.
  • Insufficient permissions in Bitrix24 account to modify SPA permissions.
  • Network connectivity issues preventing API calls to Bitrix24.
  • Invalid or missing parameters for the SPA entity or permissions settings.

• Error Messages:

  • Errors thrown by the node will include the message from Bitrix24 API responses.
  • If "Continue On Fail" is enabled, errors are returned as part of the output JSON with fields error, resource, and timestamp.

• Resolutions:

  • Verify that the selected authentication method is correctly configured and active.
  • Ensure the Bitrix24 user or API key has sufficient rights to manage SPA permissions.
  • Check network connectivity and firewall settings.
  • Confirm all required input parameters for the SPA permissions operation are provided and valid.

Links and References

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