Bitrix24 icon

Bitrix24

Interact with Bitrix24 CRM and business platform
Join our community

Actions290

Overview

This node integrates with the Bitrix24 CRM and business platform, allowing users to interact with various Bitrix24 resources programmatically. Specifically, for the Document Generator resource with the Get Regions operation, it retrieves region-related data from Bitrix24.

Common scenarios where this node is beneficial include automating workflows that require fetching regional information for document generation, customer segmentation, or localization tasks within Bitrix24. For example, a user might want to generate documents customized by region or filter CRM records based on geographic regions.

Properties

Name Meaning
Authentication Method of authenticating with Bitrix24. Options:
- OAuth2 (recommended for production)
- Webhook (simpler but less secure)
- API Key

Output

The node outputs an array of JSON objects representing the requested data from Bitrix24. For the Get Regions operation under the Document Generator resource, the output JSON will contain region details as returned by the Bitrix24 API.

If the node supports binary data output (not explicitly shown in the provided code), it would typically represent files or attachments related to the document generation process. However, based on the static analysis, this node primarily outputs JSON data.

Dependencies

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

    • OAuth2 authentication token
    • Webhook URL
    • API key credential

  • The node depends on internal helper functions (makeStandardBitrix24Call) to perform API calls to Bitrix24 endpoints.

  • No additional external services are required beyond Bitrix24 itself.

Troubleshooting

  • Common Issues:

    • Authentication failures due to incorrect or expired credentials.
    • API rate limits or permission issues from Bitrix24 side.
    • Network connectivity problems preventing API calls.

  • Error Messages:

    • Errors thrown during execution will include the error message from Bitrix24 or the HTTP request.
    • If continueOnFail is enabled, errors are returned as part of the output JSON with fields error, resource, and timestamp.

  • Resolution Tips:

    • Verify that the selected authentication method is correctly configured and valid.
    • Ensure the Bitrix24 account has sufficient permissions to access the requested resource.
    • Check network connectivity and firewall settings.
    • Enable continueOnFail cautiously to handle errors gracefully in workflows.

Links and References

Discussion