Bitrix24 icon

Bitrix24

Interact with Bitrix24 CRM and business platform
Join our community

Actions290

Overview

This node interacts with the Bitrix24 platform, specifically supporting operations on various resources including Smart Process Automation (SPA) types. The "Get Type" operation under the SPA resource retrieves details about a specific Smart Process type by its ID.

Common scenarios for this node include:

  • Automating workflows that require fetching metadata or configuration of a Smart Process type in Bitrix24.
  • Integrating Bitrix24 SPA data into other systems or processes.
  • Dynamically loading SPA type information to drive conditional logic or UI elements in automation.

For example, a user might use this node to get the definition of a SPA type before creating or updating items of that type elsewhere in their workflow.

Properties

Name Meaning
Authentication Method to authenticate with Bitrix24: OAuth2 (recommended), Webhook (simpler), or API Key.
Type ID The identifier of the Smart Process type to retrieve. This is selected from available SPA types loaded dynamically.

Output

The node outputs an array of items where each item contains a json object representing the response from Bitrix24 for the requested SPA type. The exact structure depends on the Bitrix24 API response but generally includes fields describing the SPA type's properties and metadata.

If an error occurs and "Continue On Fail" is enabled, the output will contain an item with an error field describing the issue, along with the resource name and a timestamp.

No binary data output is indicated.

Dependencies

  • Requires connection to Bitrix24 via one of the supported authentication methods (OAuth2, webhook URL, or API key).
  • Uses Bitrix24 API endpoints internally to fetch SPA type data.
  • The node relies on internal helper functions to make authenticated API calls to Bitrix24.
  • No additional external services beyond Bitrix24 are required.

Troubleshooting

  • Common issues:

    • Invalid or expired authentication credentials can cause API call failures.
    • Selecting a non-existent or invalid SPA Type ID will result in errors or empty responses.
    • Network connectivity problems may prevent successful API communication.

  • Error messages:

    • Errors thrown during execution typically include the API error message.
    • If "Continue On Fail" is enabled, errors are returned as part of the output JSON with an error property.

  • Resolutions:

    • Verify and refresh authentication credentials.
    • Ensure the SPA Type ID is valid and exists in the Bitrix24 account.
    • Check network access and firewall settings.
    • Review Bitrix24 API limits and permissions.

Links and References

Discussion