Bitrix24Install

Overview

The node integrates with the Bitrix24 platform, specifically enabling operations on various Bitrix24 resources. For the Telephony resource and the Finish External Call operation, it allows users to programmatically finish an external call by specifying the call's unique identifier. This is useful in scenarios where calls are managed outside of Bitrix24 but need to be synchronized or finalized within the Bitrix24 telephony system.

Practical examples include:

• Automatically ending a call in Bitrix24 after it has been completed in an external telephony system.
• Synchronizing call status between third-party call centers and Bitrix24 CRM.
• Triggering workflows or logging activities in Bitrix24 once an external call finishes.

Properties

Output

The node outputs JSON data representing the result of the requested operation. For the "Finish External Call" operation, the output JSON typically contains confirmation or details about the finished call as returned by the Bitrix24 API.

If an error occurs during execution, the output JSON will contain an error field with the error message, along with the resource name and a timestamp.

The node does not explicitly handle binary data for this operation.

Dependencies

• Requires access to the Bitrix24 platform via one of the supported authentication methods (OAuth2, webhook URL, or API key).
• Proper credentials must be configured in n8n corresponding to the chosen authentication method.
• Network connectivity to Bitrix24 API endpoints is necessary.

Troubleshooting

• Common issues:

  • Invalid or expired authentication credentials can cause authorization failures.
  • Providing an incorrect or non-existent Call ID will result in errors from the Bitrix24 API.
  • Network issues or API rate limits may cause request failures.

• Error messages:

  • Errors returned from Bitrix24 API will be included in the output JSON under the error field.
  • If the node is set to continue on failure, it returns the error information without stopping the workflow.
  • To resolve errors, verify the Call ID correctness, ensure valid credentials, and check network connectivity.

Links and References

• Bitrix24 Telephony API Documentation
• Bitrix24 API Authentication Methods