Bitrix24Install

Overview

This node integrates with the Bitrix24 platform, enabling automation workflows to interact with various Bitrix24 resources. Specifically, for the "Open Lines" resource and the "Transfer Session" operation, it facilitates transferring a chat or communication session within Bitrix24's Open Lines feature. This is useful in scenarios where customer support sessions need to be reassigned or escalated to different agents or departments.

Practical examples include:

• Automatically transferring a live chat session to a specialized support team based on customer input.
• Reassigning open communication lines when an agent becomes unavailable.
• Routing sessions dynamically based on business rules implemented in n8n workflows.

Properties

Note: The "Options" property is shown only when the resource is "openLines".

Output

The node outputs an array of items, each containing a json field with the response data from Bitrix24 after processing the requested operation. For the "Transfer Session" operation, this typically includes confirmation details about the session transfer, such as success status or error messages.

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

No binary data output is indicated by the source code.

Dependencies

• Requires valid authentication credentials for Bitrix24, which can be provided via OAuth2, webhook URL, or API key.
• Uses internal helper functions to make standardized API calls to Bitrix24 endpoints.
• No additional external dependencies beyond Bitrix24 API access.

Troubleshooting

• Common issues:

  • Invalid or expired authentication credentials leading to authorization errors.
  • Incorrectly formatted filter or sort JSON causing API request failures.
  • Network connectivity problems preventing API calls.

• Error messages:

  • Errors thrown during execution will include the message returned by Bitrix24 or generated internally.
  • If "Continue On Fail" is enabled, errors are returned in the output JSON under the error key.

• Resolution tips:

  • Verify that the selected authentication method is correctly configured and active.
  • Ensure JSON inputs for filters and sorting are valid and conform to Bitrix24 API expectations.
  • Check network connectivity and Bitrix24 service status.

Links and References

• Bitrix24 Open Lines Documentation
• Bitrix24 REST API Reference
• n8n Documentation on Credentials