All topics
Get started8Account, team & permissions44Units & fields70Records, views & tasks39WhatsApp & Cortex Chat68Email & social27Lead ads & distribution38Automations52Documents & quotes32Dashboards40Cortex AI18Developers & API12
Help Center·448 guidesAll topicsContact support

Prevent duplicate clients with Deduplication Control

Each unit has a rule that decides what happens when a client who already exists arrives again: a new record with a flag, a merge into the old record, a mirror of the chats, or a note on it.

7 min

Deduplication control is a paid add-on that shows with an Add-on badge in permissions, and its screen may not show in every account.

Before you start · for owners
The permission to edit deduplication rules
  • You need: The permission to edit deduplication rules

Steps

1
Open Settings → Deduplication Control and press Edit next to the unit.
2
In Match keys, choose the fields to match on, such as the WhatsApp number and the email.
3
In Match when, choose Any key matches (one matching field is enough) or All keys match (they must all match).
4
In When a duplicate is detected, choose the mode from the table below.
5
In Comment mode, choose where the note goes in Post the note on.
6
Press Save rule.

When does the rule run?

On every way a record is created: incoming chats, the web and mobile apps, adding a row in a table or Kanban, public forms, automations, the assistant, and the API.

The only exception: using Duplicate on a record by hand. The copy is always created, and only a duplicate warning shows.

How are numbers and emails normalized before they’re compared? See How does Corteksa know a client is a duplicate? Matching fields and normalization.

How do you see duplicates?

  • A Possible duplicate flag on the record and in the table, with the matching records. It shows only to the owner and to roles with the permission to see duplicate warnings.
  • Every decision is written in the change log with its reason: merged, created and flagged, or created as new.
  • When records are merged, the message “Merged into an existing record” shows.

Paths with their own rules

Lead ad forms have their own duplicate policy in the form’s setup. And import has an option to update the records that match on one field, and uses the same normalization.

At a glance

Mode
What happens when an existing client arrives
Details
Off
Nothing; a normal record is created
—
Separate + Flag
A new record is created and linked to the matching records as a duplicate
Unify
No record is created. Only the empty fields in the old record are filled in
Mirror
A record is created, and the chat shows in every matching record
Comment
A record is created, and a system note is written on the original record

If something goes wrong

What you see
Why
What to do
The duplicate flag doesn’t show
Your role doesn’t have the permission to see duplicate warnings.
Ask the owner for it.
Two records were created despite the rule
The rule is set to Off, the matching value is empty, or the record was duplicated by hand.
Check the settings and the Match keys.
The rule suddenly stopped
All of its match keys were deleted.
Choose new Match keys and save.

A real example

Basma Clinics
The situation

A patient messages from their number, then books through the website form, so they show up twice.

What they did
  1. A rule on the “Patients” unit: match on the WhatsApp number or the email, in Unify mode.
The result

All of the patient’s data is gathered in one record, and nothing a teammate wrote is replaced.

A made-up company, to show the idea. The numbers are rounded.

Good to know

If all the match keys are deleted, the rule stops on its own and the unit works as if it were set to Off. If only some are deleted, it carries on with the rest.
Moving a record to another unit removes its duplicate links in the old unit.
Empty values never match.
Did this guide solve it?
If not, we’ll ask what was missing.
Open in Corteksa
Did this guide solve it?

We read every answer. To get a reply, use Contact support.