Preferences
Phone number
Configure the variable that contains the phone number that will be analyzed.
Usually, the variable “source_phone” from the Incoming Message is used as the input variable, but any other variable that contains a phone number can be used.
The “source_phone” variable can be defined for SMS and/or WhatsApp channels in the initial step of the flow.
Preferences
Phone Number
Configure the variable containing the phone number that will be analyzed.
Usually, the variable source_phone from the Incoming Message is used as the input variable, but any other variable that contains a phone number can be used.
The source_phone variable can be defined for SMS and/or WhatsApp channels in the initial step of the flow.
Variables
There are two sets of variables that can be used to route the call in Studio. Use them to fill in the relevant Variables fields:
- Phone validation insights
- SHAKEN/STIR call attestation (Voice only — not applicable for SMS/WhatsApp)
Validation Insight | Description | Value type | Value ranges |
|---|---|---|---|
VOIP | Illustrates if this phone number is a Voice Over Internet Protocol (VOIP) or a digital phone number. | String |
|
Risky | Points out if this phone number is associated with fraudulent activity, scams, fake accounts, or other suspicious behavior. | String |
|
Valid | Indicates if the phone number is considered valid based on the assigned phone numbers available to carriers in the contact's country. | Boolean |
|
Active | Reveals if this phone number is a live phone number that is currently active. | String |
|
Leaked | Indicates whether this phone number has recently been exposed in an online database breach or compromise | Boolean |
|
Status | The phone validation status as a result of the Fraud Score. | String | "SAFE" |
Carrier | The carrier this phone number has been assigned to, or "N/A" if unknown. | String |
|
Country | Indicates the 2-character country code associated with this phone number. | String |
|
Spammer | Identifies if the phone number has recently been reported for spam or harassing calls/texts. | Boolean |
|
Pre Paid | Indicates if this phone number is associated with a prepaid service plan. | String |
|
Line Type | The type of line this phone number is associated with (Toll-Free, Wireless, Landline, Satellite, VOIP, Premium Rate, Pager, etc...) or "N/A" if unknown. | String |
|
Fraud Score | The risk score. It measures how likely a phone number is to be fraudulent. | Integer | Percentage from 0 to 100 with no decimal numbers
|
Recent Abuse | Details whether this phone number has been associated with recent or ongoing fraud. | String |
|
Validations (last 24h) | Counts how many times Phone Validation was triggered for this number in the past 24 hours. Particularly useful for detecting fraud risk when there is an unusual number of interactions. | Integer | "15" |
Name | Owner's name linked to the phone number via reverse lookup. Helps confirm a user is who they claim to be. Coverage is strongest in the US and Canada. | String | Free-text name, or "" / N/A if no match found |
City | City associated with the phone number's registered location. Useful for cross-checking against user-supplied location data or billing address. | String | City name string, or "" if unavailable |
Region | State or region tied to the phone number's registered location. Supports geo-filtering and consistency checks against other user-provided data. | String | Region / state name string, or "" if unavailable |
Zip-code | Postal code associated with the phone number's registered location. Enables precise address validation and fraud geo-filtering. | String | Postal code string (format varies by country), or "" if unavailable |
Timezone | IANA timezone derived from the phone number's registered location. Can be used to detect mismatches between the device timezone and the number's origin. | String | IANA tz string (e.g. America/Los_Angeles), or "" if unavailable |
Do not call | Indicates whether the number appears on a Do Not Call registry. Critical for outbound calling and SMS compliance to avoid regulatory penalties. | Boolean |
|
TCPA blacklist | Flags numbers blacklisted under TCPA (US Telephone Consumer Protection Act). Contacting blacklisted numbers can expose the business to significant legal liability. | Boolean |
|
Note: Unlike in Voice, SHAKEN/STIR call attestation for spoofing detection is not applicable.
Updated 8 days ago