Bitrix24Install

Overview

The node integrates with the Bitrix24 CRM and business platform, specifically providing functionality to merge duplicate entities within the CRM. The "Merge Duplicates" operation under the "Duplicate" resource allows users to consolidate duplicate records of a specified entity type (such as Leads, Deals, Contacts, or Companies) by merging them into a single record.

This is beneficial in scenarios where data cleanliness and deduplication are critical, such as maintaining accurate customer databases, avoiding redundant communications, and ensuring consistent reporting. For example, if multiple contact entries exist for the same person, this node can merge those duplicates into one unified contact record.

Properties

Output

The node outputs JSON data representing the result of the merge operation. This typically includes details about the merged entity, confirmation of success, or error information if the merge failed.

If an error occurs during execution and the node is configured to continue on failure, the output JSON will contain an error field with the error message, along with the resource name and a timestamp.

No binary data output is indicated for this operation.

Dependencies

• Requires connection to a Bitrix24 account via one of the supported authentication methods (OAuth2, webhook URL, or API key).
• The node depends on Bitrix24's API endpoints to perform duplicate detection and merging.
• Proper API credentials or tokens must be configured in n8n for authentication.
• Network access to Bitrix24 services is necessary.

Troubleshooting

• Common Issues:

  • Invalid or expired authentication credentials may cause authorization failures.
  • Providing an incorrect or non-existent Entity ID will result in errors or no action.
  • Insufficient permissions in Bitrix24 to perform merge operations can cause failures.
  • Network connectivity issues may prevent API calls from succeeding.

• Error Messages:

  • Errors returned from Bitrix24 API will be included in the output JSON under the error field if "Continue On Fail" is enabled.
  • Typical messages might include authentication errors, invalid parameters, or permission denials.

• Resolution Tips:

  • Verify that the authentication method and credentials are correctly set up and valid.
  • Confirm the Entity ID exists and corresponds to the selected Entity Type.
  • Ensure the Bitrix24 user has adequate permissions to merge duplicates.
  • Check network connectivity and firewall settings.

Links and References

• Bitrix24 Official API Documentation
• Bitrix24 CRM Duplicate Management
• n8n Documentation