Bitrix24 Auxiliary icon

Bitrix24 Auxiliary

Управление вспомогательными сущностями в Bitrix24

Actions10

Overview

This node integrates with Bitrix24 to manage sales funnels (referred to as "Воронка продаж" or categories) within the CRM. It supports creating, updating, retrieving, listing, and deleting sales funnel categories. The node can handle single or multiple funnel creations in one execution.

Typical use cases include automating the setup of sales pipelines in Bitrix24, bulk creation of multiple sales funnels, or updating existing funnels programmatically. For example, a sales manager could automate the creation of standardized sales funnels for different product lines or regions without manual input in the Bitrix24 UI.

Properties

Name Meaning
Name The name/title of the sales funnel category to create or update.
Sort Numeric value defining the order/sorting priority of the sales funnel. Defaults to 100.
Is Default Boolean flag indicating if this funnel should be set as the default one.
Multiple Items Boolean flag to indicate whether to create multiple sales funnels in one operation.
Items When creating multiple funnels, this is a collection of funnel definitions, each with:
- Name: Funnel name
- Sort: Sorting order
- Is Default: Whether it is the default funnel

Output

The output is a JSON array where each element corresponds to the result of an individual API call for creating or updating a sales funnel category. Each element contains:

  • success: Boolean indicating if the operation succeeded.
  • id: The unique identifier of the created or updated sales funnel.
  • Other fields reflect the properties sent (e.g., name, sort, isDefault).

In case of errors, the output may contain objects with an error field describing the issue.

No binary data output is produced by this node.

Dependencies

  • Requires a valid Bitrix24 API authentication token configured in n8n credentials.
  • Uses the Bitrix24 webhook URL to send HTTP POST requests to Bitrix24 REST API endpoints.
  • Relies on the Axios HTTP client library for making API calls.

Troubleshooting

  • Missing Credentials: If no API credentials or webhook URL are provided, the node will throw an error indicating missing credentials or webhook URL.
  • API Errors: Errors returned from Bitrix24 API (e.g., invalid parameters, permission issues) are caught and reported with descriptive messages.
  • Multiple Items Handling: When using multiple items mode, ensure the items property is correctly populated; otherwise, no funnels will be created.
  • Continue On Fail: If enabled, the node continues processing remaining items even if some fail, returning error details per failed item.
  • Common Error Messages:
    • "No credentials got returned!": Check that the API key credential is properly set up.
    • "Webhook URL is required!": Ensure the webhook URL is configured in the credentials.
    • "Bitrix24 API error: ...": Indicates an error response from Bitrix24; verify request parameters and permissions.

Links and References

This summary focuses exclusively on the "Воронка продаж" (category) resource with the "Create" operation as requested.

Discussion