Bitrix24 icon

Bitrix24

Interact with Bitrix24 CRM and business platform

Actions89

Overview

This node integrates with the Bitrix24 platform, specifically supporting operations on various resources including Smart Process Automation (SPA). The "Get SPA Info" operation retrieves detailed information about a specific SPA type within Bitrix24. This is useful for users who want to fetch metadata or configuration details of SPA entities to automate workflows, analyze data structures, or synchronize SPA data with other systems.

Practical examples include:

  • Fetching SPA type fields and properties to dynamically build forms or interfaces.
  • Retrieving SPA metadata to trigger conditional automation based on SPA state.
  • Integrating SPA data into external reporting or CRM systems.

Properties

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

Output

The node outputs an array of items where each item contains a json object representing the response from Bitrix24 for the requested SPA information. The structure of the JSON depends on the specific SPA info retrieved but generally includes fields and metadata related to the SPA type.

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 in the source code.

Dependencies

  • Requires authentication credentials for Bitrix24 via one of the supported methods (OAuth2, webhook URL, or API key).
  • Uses internal helper functions to make API calls to Bitrix24 endpoints.
  • No additional external services beyond Bitrix24 are required.

Troubleshooting

  • Common issues:

    • Incorrect or expired authentication credentials can cause API call failures.
    • Missing or invalid SPA type identifiers when requesting SPA info may result in empty or error responses.
    • Network connectivity problems can prevent successful API communication.

  • Error messages:

    • Errors thrown during execution will include the message from the Bitrix24 API or internal exceptions.
    • If "Continue On Fail" 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 SPA type ID or parameters used are correct and exist in the Bitrix24 account.
    • Check network access and firewall settings to allow outbound requests to Bitrix24 APIs.

Links and References

Discussion