Bitrix24 icon

Bitrix24

袪邪斜芯褌邪 褋 Bitrix24 API

Actions30

小屑邪褉褌-锌褉芯褑械褋褋 → 袩芯谢褍褔懈褌褜

AI-generated

Overview

This node interacts with the Bitrix24 API to perform operations on Smart Process entities. It supports creating, updating, retrieving (by ID or filter), listing, and deleting records within a specified Smart Process type. This is useful for automating CRM workflows involving custom data structures defined as Smart Processes in Bitrix24, such as managing custom business objects or specialized data collections.

Use Case Examples

  1. Create a new Smart Process record with specified fields in a custom entity type.
  2. Retrieve a Smart Process record by its ID or by applying filter criteria to find matching records.
  3. List all or a limited number of Smart Process records, optionally filtered and selecting specific fields.
  4. Update an existing Smart Process record by ID with new field values provided in JSON or form format.

Properties

Name Meaning
entityTypeId Specifies the Smart Process entity type to operate on, identifying the custom data structure in Bitrix24.
getBy Determines how to retrieve a record when using the 'get' operation, either by ID or by applying a filter.
id The unique identifier of the Smart Process record to get, update, or delete.
filterFields A collection of filter conditions to apply when retrieving or listing records by filter, allowing complex queries on fields.
selectFields Specifies which fields to return in the response when retrieving or listing records, allowing partial data selection.

Output

JSON

  • item - The Smart Process record data returned from create, get, or update operations.
  • items - An array of Smart Process records returned from list operations.
  • success - Indicates successful deletion of a Smart Process record.
  • id - The ID of the record that was deleted.
  • error - Error message when a record is not found or an operation fails.

Dependencies

  • Bitrix24 API with appropriate API key or OAuth credentials

Troubleshooting

  • Ensure the entityTypeId is correctly specified and corresponds to an existing Smart Process type in Bitrix24.
  • When using filters, verify that field names and operations are valid and supported by the Smart Process fields.
  • Handle errors where records are not found by checking the error messages returned in the output.
  • For JSON input format, ensure the JSON is well-formed to avoid parsing errors.
  • API rate limits or connectivity issues with Bitrix24 may cause request failures; implement retries or error handling accordingly.

Links

Discussion