VOS3000 Toll-Free E164 Billing Complete Free Number Configuration
Understanding VOS3000 toll-free E164 billing is essential for any VoIP operator who needs to route emergency and toll-free calls without applying charges. The SERVER_BILLING_FREE_E164S parameter in VOS3000 allows administrators to designate specific E164 numbers or wildcard patterns that incur zero billing cost, ensuring compliance with regulatory requirements and proper handling of free-call destinations. Need help configuring this? Contact us on WhatsApp: +8801911119966.
Toll-free numbers such as 1-800 series in North America, 0800 in Europe, and emergency numbers like 911 or 112 must never be billed to the caller. VOS3000 provides a dedicated configuration mechanism to handle these scenarios cleanly within the billing engine, preventing accidental rating of calls that should always remain free.
Table of Contents
VOS3000 Toll-Free E164 Billing Parameter Overview
The SERVER_BILLING_FREE_E164S parameter is defined in the VOS3000 server billing configuration file. It accepts a comma-separated list of E164 number patterns. When an outbound call matches any pattern in this list, the billing engine skips the rating process entirely for that call leg, resulting in a zero-charge record. This is documented in section ยง4.3.5.1 of the VOS3000 administration manual.
| ๐ Parameter | ๐ Value |
|---|---|
| Parameter Name | SERVER_BILLING_FREE_E164S |
| Configuration File | mbx2008.conf or server billing config |
| Data Type | Comma-separated E164 patterns |
| Default Value | Empty (no free numbers defined) |
| Wildcard Support | Yes (asterisk * for prefix matching) |
| Manual Section | ยง4.3.5.1 |
Configuration Syntax for Free E164 Numbers
Setting up VOS3000 toll-free E164 billing requires editing the server configuration and specifying number patterns. Each entry can be an exact E164 number or a wildcard pattern using the asterisk character to match any suffix.
| ๐ Syntax Element | ๐ Description | ๐ Example |
|---|---|---|
| Exact Number | Matches one specific E164 | 18001234567 |
| Prefix Wildcard | Matches all numbers starting with prefix | 1800* |
| Multiple Entries | Comma-separated list | 1800*,0800*,911 |
| Emergency Numbers | Short-code emergency services | 911,112,999 |
Common Toll-Free Number Patterns by Region
Different regions use different toll-free number ranges. The following table shows the most common patterns you should configure for VOS3000 toll-free E164 billing depending on your deployment region. For expert assistance with regional configurations, message us on WhatsApp: +8801911119966.
| ๐ Region | ๐ Toll-Free Prefix | ๐ E164 Pattern | ๐ Emergency |
|---|---|---|---|
| North America | 1-800/888/877/866 | 1800*,1888*,1877*,1866* | 911 |
| United Kingdom | 0800/0808 | 44800*,44808* | 999,112 |
| Europe (General) | 00800 (ITU UIFN) | 800* | 112 |
| Australia | 1800/13/1300 | 611800*,6113*,611300* | 000,112 |
| Bangladesh | N/A (operator-specific) | Custom patterns | 999 |
Wildcard Support and Pattern Matching
The VOS3000 toll-free E164 billing system uses simple wildcard matching where an asterisk (*) at the end of a pattern matches any number of trailing digits. This is crucial for covering entire toll-free ranges without listing every individual number. The matching logic evaluates patterns from left to right and applies the first match found.
| ๐ Pattern | ๐ Matches | ๐ Does Not Match |
|---|---|---|
| 1800* | 18001234567, 18009876543 | 1801234567, 18881234567 |
| 911 | 911 only | 9110, 1911 |
| 44800* | 44800123456, 44800123 | 44201234567 |
| 800* | 8001234567, 8000012345 | 8012345678 |
Step-by-Step Configuration Procedure
Follow these steps to configure SERVER_BILLING_FREE_E164S on your VOS3000 server. Always back up your configuration before making changes โ refer to our backup and restore guide for detailed instructions.
| ๐ Step | ๐ Action | ๐ Command or Detail |
|---|---|---|
| 1 | Backup current config | cp mbx2008.conf mbx2008.conf.bak |
| 2 | Open configuration file | vi /etc/vos3000/mbx2008.conf |
| 3 | Add FREE_E164S parameter | SERVER_BILLING_FREE_E164S=1800*,911,112,0800* |
| 4 | Save and close file | :wq in vi |
| 5 | Restart VOS3000 services | service vos3000 restart |
| 6 | Verify with test call | Place a call to a toll-free number and check CDR |
Use Cases for Free Number Billing Exemption
The VOS3000 toll-free E164 billing exemption serves several critical use cases in production VoIP environments. Understanding when and why to apply these configurations helps operators maintain both regulatory compliance and billing accuracy.
| ๐ Use Case | ๐ Description | ๐ Example Numbers |
|---|---|---|
| Emergency Services | Must never be billed per regulation | 911, 112, 999, 000 |
| Toll-Free Hotlines | Business 800 numbers that absorb cost | 1800*, 1888*, 0800* |
| Customer Support Lines | Internal no-charge support numbers | Custom operator prefixes |
| Interconnect Testing | Test numbers for route verification | Operator-assigned test E164s |
| Helpline Services | Crisis hotlines, poison control, etc. | Region-specific helpline E164s |
| Internal Extensions | On-net calls between PBX users | Internal dial plan patterns |
FREE_E164S vs Standard Billing Comparison
It is important to understand how VOS3000 toll-free E164 billing differs from standard call rating. When a number matches the FREE_E164S list, the billing engine produces a CDR with a zero charge rather than applying the normal rate table lookup. The call still generates a record for tracking purposes, but the financial amount is always zero.
| ๐ Aspect | ๐ Standard Billing | ๐ FREE_E164S |
|---|---|---|
| Rate Table Lookup | Yes | Skipped |
| CDR Generated | Yes (with charges) | Yes (zero charge) |
| Billing Amount | Per rate table | Always 0.00 |
| Call Tracking | Full tracking | Full tracking (zero cost) |
| Database Impact | Normal | Normal (CDR still written) |
Troubleshooting Common Configuration Issues
When VOS3000 toll-free E164 billing is not working as expected, several common issues may be the cause. Verify that the E164 patterns in your configuration match the actual called number format โ remember that numbers must be in E164 international format without plus signs or spaces. Also ensure the VOS3000 service was restarted after configuration changes. For deeper billing diagnostics, see our VOS3000 billing system guide.
| ๐ Problem | ๐ Likely Cause | ๐ Solution |
|---|---|---|
| Toll-free calls still billed | Pattern not matching E164 format | Verify number format in CDR |
| Config not taking effect | Service not restarted | Restart vos3000 service |
| Wildcard matching too broad | Prefix too short (e.g., 1*) | Use more specific prefixes |
| Some free calls still rated | Missing pattern from list | Add all required patterns |
Related Resources
- ๐ VOS3000 Rate Table
- ๐ How to Backup and Restore VOS3000 MySQL Database
- ๐ VOS3000 Dial Plan
- ๐ฅ VOS3000 Official Downloads and Documentation
Frequently Asked Questions About VOS3000 Toll-Free E164 Billing
What is SERVER_BILLING_FREE_E164S in VOS3000?
SERVER_BILLING_FREE_E164S is a VOS3000 server configuration parameter that defines a list of E164 numbers or wildcard patterns for which no billing charges are applied. When a called number matches any pattern in this list, the billing engine bypasses rate table lookup and assigns a zero charge to the call. This parameter is essential for handling toll-free numbers, emergency services, and any call destinations that must remain free of charge for regulatory or business reasons.
How do I add multiple toll-free number ranges to VOS3000?
You can add multiple toll-free number ranges by specifying comma-separated E164 patterns in the SERVER_BILLING_FREE_E164S parameter value. For example, setting it to 1800*,1888*,0800*,911,112 will exempt all calls starting with 1800, 1888, 0800 as well as the exact emergency numbers 911 and 112 from billing. Each pattern is evaluated independently, and wildcard patterns using the asterisk character allow you to cover entire number ranges efficiently.
Does FREE_E164S still generate CDR records?
Yes, calls matching the FREE_E164S list still generate CDR records in VOS3000. The difference is that these CDR records will have a zero billing amount. This behavior allows operators to maintain full call tracking and reporting for toll-free and emergency calls while ensuring no charges are applied. If you need calls that generate no CDR at all, you should use the SERVER_BILLING_NO_CDR_E164S parameter instead, which skips CDR creation entirely.
Can I use wildcard patterns for toll-free number matching?
Yes, VOS3000 supports wildcard patterns using the asterisk character in the SERVER_BILLING_FREE_E164S configuration. The asterisk matches any number of trailing digits, allowing you to cover entire toll-free number ranges with a single entry. For example, 1800* matches any number beginning with 1800 followed by any additional digits, effectively covering the entire North American 1-800 toll-free range.
What happens if a number matches both a rate table and FREE_E164S?
When a called number matches the FREE_E164S list, the VOS3000 billing engine prioritizes the free number designation over the rate table. This means the call will be billed at zero regardless of what the rate table would normally return. The FREE_E164S check occurs before rate table lookup in the billing pipeline, ensuring that toll-free and emergency numbers are never accidentally charged even if they also exist in a rate table.
How do I verify my toll-free billing configuration is working?
To verify your VOS3000 toll-free E164 billing configuration, place a test call to a number that should match your FREE_E164S patterns and then check the generated CDR record. The CDR should show the call with a billing amount of zero. You can use the VOS3000 monitoring tools to inspect recent CDRs โ refer to our VOS3000 monitoring guide for detailed steps. If the call still shows a charge, verify your pattern format matches the E164 format used in the CDR.
Get Professional Help with VOS3000 Toll-Free E164 Billing
Configuring VOS3000 toll-free E164 billing correctly is critical for both regulatory compliance and accurate call accounting. Misconfigured free number lists can lead to unexpected charges on emergency calls or toll-free destinations, creating serious compliance and customer satisfaction issues. Our team of VOS3000 specialists can help you design and implement the optimal free number configuration for your deployment.
Contact us on WhatsApp: +8801911119966
Whether you need help with initial setup, troubleshooting existing configurations, or optimizing your billing parameters for multi-region deployments, we provide expert assistance. Reach out today at +8801911119966 and let us ensure your VOS3000 system handles toll-free and emergency calls exactly as it should.
๐ Need Professional VOS3000 Setup Support?
For professional VOS3000 installations and deployment, VOS3000 Server Rental Solution:
๐ฑ WhatsApp: +8801911119966
๐ Website: www.vos3000.com
๐ Blog: multahost.com/blog
๐ฅ Downloads: VOS3000 Downloads
 | | |
