Bitrix24 icon

Bitrix24

Interact with Bitrix24 CRM and business platform

Actions290

Overview

This node integrates with the Bitrix24 platform, specifically allowing users to manage telephony external lines. The "Add External Line" operation lets you add a new external phone line to your Bitrix24 telephony setup. This is useful for organizations that want to connect additional phone numbers or lines to their Bitrix24 telephony system, enabling call routing, management, and tracking within the Bitrix24 environment.

Practical examples include:

  • Adding a new business phone number to Bitrix24 for customer support.
  • Integrating a new external SIP line for sales calls.
  • Expanding telephony capabilities by adding multiple external lines for different departments.

Properties

Name Meaning
Authentication Method of authenticating with Bitrix24: OAuth2 (recommended), Webhook (simpler), or API Key
Line Name The name assigned to the external line
Line Number The phone number associated with the external line

Output

The node outputs JSON data representing the result of the operation performed on Bitrix24. For the "Add External Line" operation, this typically includes details about the newly added external line such as its ID, status, and any relevant metadata returned by the Bitrix24 API.

If the node encounters an error and "Continue On Fail" is enabled, it outputs an object containing the error message, resource name, and timestamp.

No binary data output is indicated in the source code.

Dependencies

  • Requires authentication credentials for Bitrix24 via one of the supported methods: OAuth2 token, webhook URL, or API key.
  • Relies on Bitrix24's telephony API endpoints to perform operations.
  • No additional external dependencies beyond standard HTTP requests to Bitrix24 APIs.
  • Proper configuration of credentials in n8n is necessary for successful API communication.

Troubleshooting

  • Common Issues:

    • Incorrect or expired authentication credentials leading to authorization errors.
    • Invalid or improperly formatted phone numbers causing API rejections.
    • Network connectivity issues preventing access to Bitrix24 services.
  • Error Messages:

    • Errors thrown during execution will contain the message from Bitrix24 API or internal processing errors.
    • If "Continue On Fail" is enabled, errors are returned in the output JSON with fields error, resource, and timestamp.
  • Resolutions:

    • Verify and refresh authentication credentials.
    • Ensure phone numbers conform to expected formats.
    • Check network connectivity and firewall settings.
    • Review Bitrix24 API limits and permissions.

Links and References

Discussion