Key concepts
Shared vocabulary for NumberForge Configuration, Phone Assistant, Flow, and save-time automation.
Validation results
Section titled “Validation results”| Status | Meaning |
|---|---|
| Valid | Parsed and valid for its region. Formatting and enrichment can run. |
| Invalid | Not a valid number for the inferred or selected country. |
| Needs region | Local-format input (no leading +) with no country context. Requires a default country in setup, a country field on the record, or user selection in Phone Assistant. |
| Empty | No input (primarily in Flow). |
Phone Assistant groups records into Valid, Invalid, and Needs region. Field rules can persist the same values to mapped fields on save.
Save formats
Section titled “Save formats”When formatting is enabled, valid numbers are rewritten to a chosen style:
| Format | Example | Typical use |
|---|---|---|
| E164 | +16502530000 | Storage, integrations |
| International | +1 650-253-0000 | Display with country code |
| National | (650) 253-0000 | Local display |
| RFC3966 | tel:+1-650-253-0000 | tel: links |
Org default: General setup. Per-rule override on each field rule. Formatting applies to valid numbers only.
Default country (region)
Section titled “Default country (region)”International numbers (+…) carry their own country. Local numbers need a default country code (for example US, IT).
Resolution order:
- Org default in NumberForge Configuration (none, fixed country, or organization locale)
- Field rule region strategy (inherit org, fixed country, country field, or none)
- Per-row country in Phone Assistant (
Needs region) - Optional Default Region on Flow actions (falls back to org default)
Validation mode
Section titled “Validation mode”| Mode | Behavior |
|---|---|
| Write outputs | Write status and/or flag to mapped fields; save continues unless another rule blocks. |
| Block save | Reject the transaction when this rule fails. |
Write outputs requires at least one mapped output: status field, flag field, or both.
Run scope
Section titled “Run scope”| Scope | Runs on |
|---|---|
| Create | Insert |
| Update | Update |
| Both | Insert and update (default) |
Enrichment
Section titled “Enrichment”Optional on field rules and NF Process Phone:
- Carrier: safe display name (default) or original mapped name
- Geocoding: offline place description
- Time zone: first resolved zone when available
Data is bundled in the package, not fetched live from the web.
Choosing a surface
Section titled “Choosing a surface”| Goal | Surface |
|---|---|
| Process phones on every save for configured objects | Saving a rule |
| On-page triage on saved records and country pickers | Phone Assistant |
| Flow-driven or integration logic | Flow actions |
| Custom Apex | NF API Reference |