Actions89
- Direct API Actions
- CRM Actions
- Task Actions
- User Actions
- SPA Actions
- Activity Actions
- Automation Actions
- Document Generator Actions
- Data Storage Actions
- Chat Actions
Overview
The Bitrix24 node allows interaction with the Bitrix24 CRM and business platform, specifically supporting operations on various resources including Smart Process Automation (SPA) items. The Update Item operation for the SPA resource enables users to update fields of an existing SPA item by specifying its type and ID.
This node is beneficial in scenarios where automated workflows need to modify SPA records dynamically based on external triggers or data changes. For example, updating a customer support ticket's status or modifying project task details stored as SPA items within Bitrix24.
Properties
| Name | Meaning |
|---|---|
| Authentication | Method used to authenticate with Bitrix24: OAuth2 (recommended), Webhook URL (simpler but less secure), or API Key authentication. |
| Type ID | The identifier of the Smart Process type to which the item belongs. This determines the schema of fields available. |
| Item ID | The unique identifier of the SPA item to update. |
| Fields | A collection of fields to update on the SPA item. Each field consists of a selectable field name (loaded dynamically based on the selected Type ID) and the value to set. Multiple fields can be updated at once. |
| Use JSON Format for Fields | Boolean flag indicating whether to provide the fields as a JSON object instead of individual key-value pairs. |
| Fields (JSON) | When "Use JSON Format for Fields" is enabled, this property accepts the fields as a JSON object mapping field names to values. |
Output
- The node outputs an array of items, each containing a
jsonproperty. - The
jsonoutput typically contains the response from Bitrix24 after attempting to update the SPA item, including success confirmation or error details. - If an error occurs and "Continue On Fail" is enabled, the output will include an error message, the resource name, and a timestamp.
- The node does not output binary data.
Dependencies
- Requires connection to a Bitrix24 instance via one of the supported authentication methods (OAuth2, webhook URL, or API key).
- Needs appropriate permissions in Bitrix24 to update SPA items.
- Uses Bitrix24 API endpoints such as
crm.item.fieldsto load field metadata andcrm.type.listto retrieve SPA types. - No additional external dependencies beyond Bitrix24 API access.
Troubleshooting
Common Issues:
- Incorrect or missing SPA Type ID or Item ID will cause the update to fail.
- Providing invalid field names or values that do not conform to the SPA schema may result in API errors.
- Authentication failures due to expired tokens or incorrect credentials.
- Network connectivity issues preventing API calls.
Error Messages:
- Errors returned from Bitrix24 API are surfaced in the node output when "Continue On Fail" is enabled.
- Typical messages include "Failed to load SPA types," "No fields found for this SPA type," or specific API error messages related to invalid parameters.
Resolutions:
- Verify the SPA Type ID and Item ID are correct and exist in Bitrix24.
- Ensure fields being updated are valid for the selected SPA type.
- Check authentication credentials and refresh tokens if necessary.
- Confirm network connectivity and Bitrix24 service availability.