One phone number, however it was typed

Every phone number collapses to one canonical 10-digit key so matching, deduplication and inbound routing all agree.

What it is

A single normalisation function used by contact matching, inbound routing, call records, callback episodes and duplicate detection. It strips non-digits and a leading North-American country code, and comparison requires at least seven digits.

Also called: duplicate contact from a phone number · number format · +1 vs 10 digits

See it
One phone number, however it was typed
Area
Operations
Group
Contact management
System
Contacts
Solves
3 named problems
01normalizePhone strips non-digits and a leading '1' on an 11-digit number
02phonesMatch compares two normalised values and refuses anything under 7 digits
03The webhook converts back to E.164 only at dial time
Not a screen — show it as a diagram: three input formats collapsing to one key that joins contact, message, call and episode. Sample data — no customer information appears here.
How it works
  1. 1normalizePhone strips non-digits and a leading '1' on an 11-digit number
  2. 2phonesMatch compares two normalised values and refuses anything under 7 digits
  3. 3The webhook converts back to E.164 only at dial time
Why we built it

The same customer was being stored twice because their number arrived from one system as ten digits and from another as eleven with the country code on the front — close enough to look identical to a human, different enough that nothing matched them. Trimming to the last seven digits would have fixed that and introduced a worse bug, merging two different people who share the last seven digits in different area codes. Every number now collapses to one canonical key, so matching, de-duplication and routing an incoming call all agree on who it is.

The problem
  • Duplicate contacts created by number formatting
  • Inbound messages failing to match a known contact
  • Dial failures from a non-E.164 number
Sound familiar?
What you get
One person, one record, whichever system created them
Inbound texts and calls attach to the right contact

See it on your own jobs

Twenty minutes, your numbers, no slide deck. We’ll build one of your real buildings in front of you and send you the estimate link at the end — yours to keep either way.

or keep browsing features →