HLR Status Property
Track the detailed reachability status of contact phone numbers
Overview
Section titled “Overview”Clean Dial’s HLR Status property automatically tracks the real-time reachability status of each contact’s phone number. Unlike simple valid/invalid flags, this property provides detailed network status codes, allowing for smarter segmentation (e.g., distinguishing between disconnected numbers and those that are just temporarily unreachable).
HLR Status Custom Property
How It Works
Section titled “How It Works”When contacts pass through a Clean Dial HLR Lookup workflow action, the system:
- Queries the global mobile network for the number’s status
- Maps the network response to a standardized status code
- Updates the HLR Status dropdown property on the contact record
Property Values
Section titled “Property Values”The hlr_status property is a dropdown select with the following options:
| Value | Meaning | Actionable Advice |
|---|---|---|
| LIVE | The number is active, registered, and reachable. | Safe to call or text. |
| DEAD | The number is confirmed invalid or disconnected. | Remove from lists to save money. |
| ABSENT_SUBSCRIBER | The number is valid, but the device is off/out of coverage. | Retry later; do not delete. |
| NO_TELESERVICE_PROVISIONED | The number exists but cannot receive SMS/Calls. | Do not use for SMS marketing. |
| NO_COVERAGE | Status could not be determined due to network coverage. | Try again later. |
| UNKNOWN | The network returned an inconclusive response. | Treat with caution. |
Setting Up the Custom Property
Section titled “Setting Up the Custom Property”To view HLR status on your contact records:
- Navigate to CRM > Contacts
- Select any contact record
- Go to the Key Information section
- Click Actions > Customize Properties
- Search for “HLR Status”
- Add the property to your view
Use Cases
Section titled “Use Cases”Smart List Cleaning - Create a list of contacts where HLR Status is DEAD and bulk delete them to maintain hygiene.
Retry Logic - Build a workflow that waits 24 hours and retries contacts with HLR Status ABSENT_SUBSCRIBER.
SMS Protection - Suppress SMS sends to contacts with NO_TELESERVICE_PROVISIONED to prevent delivery fees on messages that can’t be delivered.
Technical Details
Section titled “Technical Details”- Property Name:
hlr_status - Property Type: Dropdown Select (Enumeration)
- Scope: Contact records
- Updates: Automatic via HLR Lookup action