The Workflow Library

Library / Data quality / data-quality-029

Cross-field consistency check: phone country code vs. address country

Data qualityContactData Hub ProfessionalAdvanced~40 min to buildFull spec

Outcome. Contacts whose phone number's country calling code clearly disagrees with their stated address country are flagged for a look, catching mismatched or copy-pasted contact records before a call goes to the wrong country's sales rep or time zone.

Workflow map Enrollment, branches and actions at a glance data-quality-029
flowchart TD
    A[Phone number and Country/Region known] --> B[Custom code: extract calling code, compare to country table]
    B --> C{Result}
    C -->|match| D[Status: Consistent]
    C -->|ambiguous| E[Status: Ambiguous - shared calling code]
    C -->|mismatch| F[Status: Mismatch - needs review]
    F --> G[Create task]
action or delay branch public on every spec, paid or not

When to use it, when not to

  • UseUse it once phone numbers and country values are already reasonably normalized, see data-quality-003 for phone format and data-quality-004 for country normalization. A consistency check built on messy inputs on both sides mostly produces noise.
  • UseUse it as a light sanity check, not a hard rule. A contact can legitimately carry a phone number from a country other than where they currently live, an expat, or a second office line.
  • SkipDo not use it on portals where Country or Phone number is rarely populated; a check that can only run on a small fraction of records is not worth the build effort yet.
  • SkipDo not use it expecting precise country detection from a phone number alone. Several countries share the same calling code, for example the North American Numbering Plan covers the United States, Canada, and a number of Caribbean nations all under +1, so this fiche treats those as ambiguous rather than a firm mismatch.
The preview ends here. Six sections are in the library. counted, not blurred
PrerequisitesEvery property with its label, internal name, type and options, plus the assets the workflow needs before you start.4 items
EnrollmentThe trigger, the criteria exactly as they are ticked in the UI, the re-enrollment rule and the suppression list.4 parts
StepsEach action in order with its parameters, its branches and its delays, written as you tick them.6 numbered actions
Known pitfallsTraps seen in production, each with what breaks and what to do instead.4 pitfalls
Test plan, variants and build specHow to prove it works in a test portal, where to look when it does not, the variants for other objects or tiers, and the YAML build spec.3 variants, 3 sections
FilesThe properties JSON creates the fields in one API call, the workflow JSON documents the build, and the custom coded action ships as a ready-to-paste .js file.PDF, Markdown, JSON, code
Install1 click. The installer creates the properties this spec declares and the workflow itself, switched off, then opens a task for the prerequisites that are assets rather than properties, such as a team, a static list or a marketing email. What it created is listed on the install page.1 click, switched off
Unlock the full library, 149 EUR

or the data quality pack, 39 EUR

One-time, excl. VAT. 30-day refund, no questions asked. Founding prices until 31 October, then 199 and 59 EUR. Includes every spec added later, up to the full 500, and the one-click installer on the full library. Building on client portals? The agency licence at 449 EUR covers unlimited client portals.