Help Center

Setup and usage guide for the deal deduplication widget for Kommo CRM

1. Installation

  1. Go to Settings → Integrations in your Kommo account.
  2. Find the «Deal Duplicates by VentasBoost» widget in the marketplace.
  3. Click Install and grant the requested permissions (OAuth authorization).
  4. Once installed, the widget will appear in the left panel of the deal card.
On first install, the widget automatically sends your account data to the server. If the settings were not saved, open the widget settings and click Save.

2. Initial Data Collection

After installation, the widget begins collecting fingerprints of your existing deals. This is required for finding duplicates.

We recommend creating your deduplication rules within the first 7 days while the free trial is active.

3. Creating Rules

Rules define which deals are considered duplicates and what happens to them. You can create multiple rules for different pipelines and scenarios.

Rule Name

Give the rule a descriptive name, for example: «Duplicates in main pipeline» or «Repeat inquiries».

Enabled / Disabled

Each rule can be temporarily disabled without deleting it. Disabled rules are not applied when checking new deals.

Action on Duplicate Detection

Pipeline

Select the pipeline where the rule will apply. The rule only affects deals within the chosen pipeline.

Duplicate Search Criteria

Specify the data used to determine a match:

Merge Method

Creation Date Filter

Limit the duplicate search to deals created within a specific period (e.g. the last 30 days).

Exclusion Field

Specify a deal field that, when filled in, excludes the deal from duplicate checks. For example, if the «VIP» field is filled, the deal will not be merged.

4. Main Lead

During a merge, one deal becomes the «main lead» (it stays) and the other becomes the «duplicate» (it gets absorbed). Criteria for selecting the main lead:

  1. Earliest creation date — the older deal is kept as the main lead.
  2. Latest creation date — the newer deal is kept as the main lead.
  3. Highest budget — the deal with the larger amount stays.
  4. Most tasks — the deal with more activity stays.
  5. Furthest along the pipeline — the deal at a later stage stays.

5. Field Mapping

Configure how data is combined during a merge:

6. Post-Merge Actions

Task Transfer

All incomplete tasks from the duplicate are moved to the main lead.

Note Transfer

Notes from the duplicate are added to the main lead with a source label.

Deferred Merge

If a deal is in a stage with Digital Pipeline automation, the merge is postponed by a set delay to avoid interrupting automated actions.

Use deferred merge if you have Digital Pipeline triggers configured on early pipeline stages.

7. Rule Priority

When multiple rules exist, they are checked from top to bottom. The first matching rule is applied to the deal.

8. Batch Analysis

Batch analysis scans your entire deal database for duplicates using the active rules.

  1. Open the widget settings.
  2. Click «Run Batch Analysis».
  3. Monitor the progress in real time.
Batch analysis processes a large volume of data. For accounts with more than 10,000 deals, the process may take several hours. Do not close the tab until it finishes.

9. Pricing

FREE

$0
  • 1 deduplication rule
  • 1 pipeline
  • Criteria: primary contact
  • No batch analysis

PRO

$35 / mo
  • Unlimited rules
  • All pipelines
  • All search criteria
  • Batch analysis
  • Priority support

MAX

$69 / mo
  • Everything in PRO
  • Deal fields as criteria
  • Exclusion field
  • Deferred merge
  • Field concatenation

Enterprise

Contact us
  • Everything in MAX
  • Custom configuration
  • Dedicated support
  • SLA

Annual subscription: ~17% discount (PRO — $350/year, MAX — $690/year).

10. Subscription Management

Payments are processed through Stripe, a secure international payment service.

  1. Open the widget settings and go to the «Subscription» section.
  2. Choose a plan and billing period (monthly or annual).
  3. Click «Pay» — you will be redirected to the Stripe Checkout page.
  4. After payment, the plan is activated automatically.

Managing Your Subscription

To change your payment method, cancel your subscription, or view invoices, click «Manage Subscription» in the widget settings. You will be redirected to the Stripe Customer Portal.

11. FAQ

The widget does not find duplicates
Make sure the rule is enabled and the correct pipeline is selected. Verify that the search criteria match the contact data (phone and email must be filled in).
Deals are being merged when they should not be
Check your search criteria. Different clients may share the same phone number or email. Use the exclusion field to protect important deals.
Batch analysis has stopped
The analysis may pause when Kommo API rate limits are reached. It will resume automatically. Do not start another analysis.
How do I undo a merge?
There is no automatic way to split deals back apart. However, all data from the duplicate (notes, tasks, contacts) is transferred to the main lead, so no information is lost.
The widget stopped working after the trial ended
The free trial lasts 7 days. After it expires, the FREE plan with limited features is available, or you can subscribe to a paid plan.
How do I contact support?
Email us at sales@ventas-boost.com and include your Kommo account domain.