Actions10
Overview
This node interacts with Bitrix24 CRM to manage sales funnel statuses ("Статус воронки"). Specifically, the Update operation for the "Статус воронки" resource allows users to update one or multiple status elements within a sales funnel category. It supports modifying properties such as the status name, sort order, color, and semantic meaning (process, success, failure).
Common scenarios include:
- Adjusting the workflow stages in a sales funnel by updating existing statuses.
- Bulk updating multiple statuses at once to reorganize or recolor them.
- Integrating Bitrix24 sales funnel updates into automated workflows, e.g., syncing status changes from external systems.
Practical example:
- A sales manager wants to rename a stage from "Negotiation" to "In Negotiation" and change its color to blue. Using this node, they can update that specific status by providing its ID and new properties.
- Alternatively, an admin can update several statuses simultaneously to reflect a new sales process structure.
Properties
| Name | Meaning |
|---|---|
| Category ID | The ID of the sales funnel category to which the status belongs. |
| Status Name | The name/title of the status stage. |
| Status Sort | Numeric value defining the order of the status in the funnel (lower numbers appear first). |
| Status Color | HEX color code representing the status color (e.g., "#00FF00" for green). |
| Status Semantic | Semantic meaning of the status: "Процесс" (Process), "Успех" (Success), or "Неудача" (Failure). Options: P, S, F |
| Multiple Items | Boolean flag indicating whether to update multiple statuses at once. |
| Items | When Multiple Items is true, this is a collection of statuses to update, each with: |
| - Name: status name | |
| - Sort: numeric sort order | |
| - Color: HEX color | |
| - Semantic: semantic meaning (P, S, F) |
Output
The node outputs an array of JSON objects, each representing the result of an update request for a status. Each object contains:
success: Boolean indicating if the update was successful.id: The unique identifier of the updated status.- Other fields reflecting the updated status properties, such as
NAME,SORT,COLOR,SEMANTIC_INFO,CATEGORY_ID,ENTITY_ID, andSTATUS_ID.
If errors occur during execution, error messages are included in the output objects under the error key.
No binary data output is produced by this node.
Dependencies
- Requires a valid Bitrix24 API webhook URL credential configured in n8n.
- Uses HTTP POST requests to Bitrix24 REST API endpoints for status management.
- Optionally sets the default language environment variable based on credentials (defaulting to Russian).
Troubleshooting
- Missing Credentials or Webhook URL: The node throws an error if no credentials or webhook URL are provided. Ensure the Bitrix24 API credential with a valid webhook URL is configured.
- API Errors: If Bitrix24 returns an error (e.g., invalid ID, permission denied), the node surfaces the error message prefixed with "Bitrix24 API error:". Check the validity of IDs and permissions.
- Partial Failures with Multiple Items: When updating multiple statuses, some may fail while others succeed. Enable "Continue On Fail" to receive partial results with error details per item.
- Invalid Property Values: Providing invalid HEX colors or semantic codes outside the allowed options may cause API errors.
- Network Issues: Axios errors related to network connectivity will be reported; verify internet access and Bitrix24 service availability.