Bitrix24 icon

Bitrix24

Interact with Bitrix24 CRM and business platform

Actions290

Overview

The Bitrix24 node integrates with the Bitrix24 CRM and business platform, enabling automation workflows to interact with various Bitrix24 resources. Specifically, for the Task resource with the Complete operation, this node allows users to mark tasks as completed within their Bitrix24 environment.

This is useful in scenarios such as:

  • Automatically completing tasks when certain conditions are met in a workflow.
  • Synchronizing task statuses between Bitrix24 and other systems.
  • Streamlining project management by programmatically updating task progress.

For example, after a deal is closed in a sales pipeline, a workflow could automatically complete all related tasks in Bitrix24 using this node.

Properties

Name Meaning
Authentication Method of authenticating with Bitrix24:
- OAuth2 (recommended for production)
- Webhook (simpler but less secure)
- API Key
Options Collection of optional parameters to customize the request:
- Filter: JSON criteria to filter tasks
- Order: JSON defining sort order
- Select: JSON array specifying which fields to retrieve
- Group: JSON criteria for grouping results
- Custom Parameters: Additional JSON parameters to include in the API call

Output

The node outputs an array of items where each item contains a json object representing the response from Bitrix24 after attempting to complete the specified task(s). The structure typically includes:

  • Confirmation or status of the completion action.
  • Any error messages if the operation failed.
  • Metadata such as timestamps and resource identifiers.

If the node encounters an error during execution and "Continue On Fail" is enabled, it outputs an item with an error field describing the issue, along with the resource name and timestamp.

The node does not output binary data.

Dependencies

  • Requires connection to Bitrix24 via one of the supported authentication methods (OAuth2, webhook URL, or API key).
  • Needs proper configuration of credentials in n8n corresponding to the chosen authentication method.
  • Relies on Bitrix24 API endpoints to perform operations on tasks.

Troubleshooting

  • Common Issues:

    • Authentication failures due to incorrect or expired credentials.
    • Invalid or malformed JSON in the options properties (Filter, Order, Select, Group, Custom Parameters).
    • Attempting to complete a task that does not exist or is already completed.
    • Network connectivity issues preventing API calls.
  • Error Messages:

    • Errors returned from Bitrix24 API will be included in the output if "Continue On Fail" is enabled.
    • Typical errors might include permission denied, invalid parameters, or resource not found.
  • Resolutions:

    • Verify and refresh authentication credentials.
    • Ensure JSON inputs are valid and correctly formatted.
    • Confirm the task ID or criteria used to identify tasks are correct.
    • Check network connectivity and Bitrix24 service status.

Links and References

Discussion