ZERVIXO

A WhatsApp contact gets linked to an existing customer or lead automatically

How Communication Hub recognizes a new WhatsApp contact by matching their phone number against existing customer and lead records.

Reading time: 2 min · Updated 2026-11-21

What this page is for

Automatically links a new WhatsApp contact to an existing customer or lead record by matching their phone number, with no manual step.

Who can access this

Any user with the "View the communication inbox" permission.

Required permission

communication_hub.inbox.view

Workflow

  1. A customer sends their first message to a connected WhatsApp number.
  2. The system compares the last 8 digits of their phone number against existing customer records, then lead records -- regardless of whether either side stores a leading 0 or a full country code.
  3. If exactly one record matches, the contact is linked to it automatically and customer context appears next to the conversation.
  4. If nothing matches, a new lead is created automatically and linked.

Practical scenario

An existing customer, whose record has a phone number starting with a leading 0 (like 05xxxxxxxx), messages the company's WhatsApp number for the first time from that same number but in international format (966xxxxxxxxx): Communication Hub recognizes the last 8 digits match and links the conversation to that customer record automatically. But if that same number happens to be recorded on more than one customer record by mistake, the system deliberately leaves the contact unlinked rather than guessing -- which is exactly what happened in a real test environment where one phone number was duplicated across two different customer records.

Common errors and how to resolve them

  • No customer context appears next to the conversation — Means the number either matched no customer/lead record, or matched more than one and was deliberately left unlinked to avoid a wrong guess. There is currently no manual-linking tool in the Communication Hub interface or on the customer/lead screen -- the real fix is correcting the duplicate data on the customer records themselves (e.g. consolidating the repeated number onto one record).
  • Two different customers get wrongly linked to the same conversation — Not structurally possible -- the contact's display name is only ever used to show it; the actual linking relies exclusively on the phone number.

Frequently asked questions

Is the customer's name used in the matching?

Not at all -- the name is only ever used to display the contact; the actual matching and linking rely exclusively on the phone number.

Try Zervixo free for 14 days

No credit card required, cancel anytime.

Start your trial

Related guides