The HLR (Home Location Register) requests let you check whether a phone number is active and which network it belongs to — before sending an SMS. To send HLR requests through Gatum, you need to set up three things: a dedicated route, a cost price for your aggregator, and a price for your client.
Make sure you have an aggregator that can accept and process HLR requests. Without a vendor on your side, the setup below won't work.
Go to Current Traffic → Routing → General Routes.
Click Create:
In the window that opens, fill in the standard route fields, and make sure to set Type to HLR:
|
Field |
Description |
|
Destination |
The country or network for this route |
|
Pools |
The pool used to send HLR traffic |
|
Type |
Must be set to HLR |
|
Priority |
Route priority — lower number means higher priority |
|
Sender (optional) |
Restrict this route to a specific sender |
|
Phone (optional) |
Restrict this route to a specific phone number |
|
Part Text (optional) |
Restrict this route by message content |
|
Ignore Case (optional) |
Ignore case when matching sender or text |
|
Sender type (optional) |
Restrict to a specific sender type |
|
Comments (optional) |
Internal notes for this route |
Click Create.
Go to Current Traffic → Routing → Source Prices.
Click Create a price:
In the window that opens, fill in the standard price fields, and make sure to set SMS type to HLR:
|
Field |
Description |
|
Aggregator |
The aggregator that will process HLR requests |
|
Destination |
The country or network this price applies to |
|
Price |
Cost per HLR request |
|
SMS type |
Must be set to HLR |
|
Type (optional) |
Aggregator type |
|
Sender type (optional) |
Restrict to a specific sender type |
|
Billing (optional) |
Billing method (e.g. by sent) |
|
Traffic type (optional) |
Traffic type for this price |
|
Comments (optional) |
Internal notes |
Click Create a Cost price.
Go to Profiles → Clients.
Click on the client's name.
In the Prices block, click Create:
In the window that opens, fill in the standard price fields, and make sure to set the SMS type to HLR:
|
Field |
Description |
|
SMS type |
Must be set to HLR |
|
Billing (optional) |
Billing method (e.g. by sent) |
|
Destination |
The country or network this price applies to |
|
Price |
Price per HLR request charged to the client |
|
Sell to Negative (optional) |
Allow requests even if the client's balance is negative |
|
Specific Routing (optional) |
Use a specific route for this price |
|
Features (optional) |
Additional routing features |
Click Create.
Once all three steps are complete, your clients will be able to send HLR requests through the platform.
