VOS3000 Call Forwarding Five Types: Comprehensive Unconditional NoReply Busy Period Offline
๐ What happens to incoming calls when your VOS3000 phone extension is busy, offline, or simply not answering? How can you ensure that important calls never go unanswered, even during off-hours or when the phone is unregistered? The answer lies in the five VOS3000 call forwarding types โ each designed to handle a specific call scenario with precise routing logic. ๐ฏ
๐ According to the official VOS3000 V2.1.9.07 Manual, Section 2.5.2 (Supplementary Service), VOS3000 provides five distinct call forwarding types: Unconditional (forward all calls), No Reply (forward when not answered), Busy (forward when phone is busy), Period (forward during specified time periods), and Offline (forward when phone is not online). Each type can be individually enabled and configured with a specific forwarding destination number per phone extension. ๐
๐ง All data in this guide is sourced exclusively from the official VOS3000 V2.1.9.07 Manual, Section 2.5.2 โ no fabricated values, no guesswork. For expert assistance with your VOS3000 deployment, contact us on WhatsApp at +8801911119966. ๐ก
Table of Contents
๐ What Are the VOS3000 Call Forwarding Types?
โฑ๏ธ The VOS3000 call forwarding types are five supplementary service features that redirect incoming calls to a specified destination number based on different trigger conditions. Each forwarding type operates independently and can be enabled or disabled per phone. ๐
๐ According to the official VOS3000 V2.1.9.07 Manual, Section 2.5.2 (Supplementary Service):
Forwarding Type
Manual Description
Trigger Condition
๐ Unconditional
Forward all calls to specified number
Always โ all incoming calls are forwarded immediately
โฑ๏ธ No Reply
Forward calls to specified number when the call is not answered or the phone is out of connection
Phone does not answer within timeout period
๐ Busy
Forward incoming calls when the phone is busy
Phone is already on a call or has reached line limit
๐ Period
Forward calls in specified time period
Current time falls within the configured time window
๐ก Offline
Forward calls when phone is not online
Phone is unregistered or disconnected from the softswitch
๐ก Key insight: Each forwarding type has a specific trigger condition. The VOS3000 manual provides precise descriptions for each: Unconditional forwards “all calls,” No Reply triggers when “the call is not answered or the phone is out of connection,” Busy activates “when the phone is busy,” Period works “in specified time period,” and Offline engages “when phone is not online.” These are distinct conditions โ a phone can have multiple forwarding types enabled simultaneously, each with its own destination number. ๐
๐ฏ Why VOS3000 Call Forwarding Types Matter
โ ๏ธ Without properly configured call forwarding, several critical business scenarios result in missed calls and lost revenue:
๐ Missed business opportunities: Calls to a busy or unanswered phone go nowhere โ potential customers hang up and call a competitor
๐ข After-hours coverage: Without Period forwarding, calls received outside business hours ring endlessly with no response
๐ก Unregistered phone scenarios: When a phone loses registration (power outage, network issue), without Offline forwarding, callers receive no answer or a generic error
๐ Customer satisfaction: Forwarding to a colleague, assistant, or voicemail ensures callers always reach a live person or can leave a message
๐ Business continuity: Unconditional forwarding enables seamless call redirection when an employee is on leave or working remotely from a different number
โ๏ธ VOS3000 Call Forwarding Type 1 โ Unconditional
๐ Call forwarding unconditional is the most straightforward forwarding type. According to the VOS3000 manual, it “forward all calls to specified number.” When enabled, every incoming call to the phone is immediately redirected to the configured destination number โ the phone never rings. This is the highest-priority forwarding type because it applies to all calls regardless of the phone’s state. ๐ก
Attribute
Value
๐ Type
Call forwarding unconditional
๐ Manual Description
Forward all calls to specified number
๐ฏ Trigger
All incoming calls โ unconditional, no condition check
๐ Location
Phone Management โ Supplementary service
๐ก Use cases: Employee on extended leave, temporary reassignment, or when a number should always route to a receptionist or department line. For help with unconditional forwarding setup, reach us on WhatsApp at +8801911119966. ๐ฑ
โ๏ธ VOS3000 Call Forwarding Type 2 โ No Reply
โฑ๏ธ Call forwarding no reply activates when the phone does not answer within a specified timeout period. According to the VOS3000 manual, it “forward calls to specified number when the call is not answered or the phone is out of connection.” The manual’s inclusion of “out of connection” means this type also covers scenarios where the phone is registered but unreachable due to network issues. ๐
Attribute
Value
๐ Type
Call forwarding no reply
๐ Manual Description
Forward calls to specified number when the call is not answered or the phone is out of connection
๐ฏ Trigger
No answer within ringing timeout, or phone out of connection
โฑ๏ธ Timeout Parameter
IVR_RINGING_TIMEOUT (default: 120 seconds) โ “Time for IVR Hang Up, When No Reply(seconds)”
๐ก Key detail: The no-reply timeout is governed by the system parameter IVR_RINGING_TIMEOUT (default: 120 seconds, per ยง4.3.5.3). When a call rings for this duration without answer, the call is forwarded to the specified number. For more on IVR timing parameters, see our VOS3000 IVR callback timing guide. ๐
โ๏ธ VOS3000 Call Forwarding Type 3 โ Busy
๐ Call forwarding on busy activates when the phone is already engaged on another call. According to the VOS3000 manual, it “forward incoming calls when the phone is busy.” This includes scenarios where all of the phone’s available lines are occupied โ either the phone is on a single active call (and has a line limit of 1), or the phone has reached its configured line limit with multiple simultaneous calls. ๐ก
Attribute
Value
๐ Type
Call forwarding on busy
๐ Manual Description
Forward incoming calls when the phone is busy
๐ฏ Trigger
Phone is on an active call or has reached line limit
๐ Related Setting
Line limit โ maximum number of channels for this phone, limits maximum sum of incoming and outgoing calls
๐ก Important note: The “busy” condition in VOS3000 is determined by the phone’s line limit setting. The manual states that line limit is “the maximum number of channels for this phone, which limits the maximum sum of incoming and outgoing calls processed simultaneously.” When all lines are occupied, the phone is considered “busy” and the busy forwarding rule applies. For more on phone limits, see our VOS3000 account billing guide. ๐
โ๏ธ VOS3000 Call Forwarding Type 4 โ Period
๐ Call forwarding on period is a time-based forwarding rule. According to the VOS3000 manual, it “forward calls in specified time period.” This allows calls to be automatically redirected during designated time windows โ for example, after business hours, during lunch breaks, or on weekends. Unlike the other forwarding types that respond to the phone’s state, Period forwarding is purely time-driven. ๐
Attribute
Value
๐ Type
Call forwarding on period
๐ Manual Description
Forward calls in specified time period
๐ฏ Trigger
Current time falls within the configured time window
๐ Configuration
Specify start time, end time, and optionally days of week for forwarding activation
๐ก Common period configurations: Forward to after-hours support line from 6:00 PM to 8:00 AM; forward to backup team during lunch (12:00โ1:00 PM); forward to weekend duty number on Saturday and Sunday. Period forwarding is particularly useful for businesses that have different staffing levels at different times. ๐
โ๏ธ VOS3000 Call Forwarding Type 5 โ Offline
๐ก Offline forward is specifically designed for scenarios where the phone is not registered with the softswitch. According to the VOS3000 manual, it “forward calls when phone is not online.” This covers situations where the phone device is powered off, has lost network connectivity, or has been deregistered from the VOS3000 softswitch for any reason. ๐ก๏ธ
Attribute
Value
๐ Type
Offline forward
๐ Manual Description
Forward calls when phone is not online
๐ฏ Trigger
Phone is unregistered / not online with the softswitch
โ ๏ธ Distinction from No Reply
Offline = phone not registered at all; No Reply = phone registered but not answering
๐ก Critical distinction: Offline forwarding is different from No Reply forwarding. No Reply covers phones that ARE registered but do not pick up the call (including “out of connection” scenarios where the phone is registered but unreachable). Offline forwarding covers phones that are NOT registered with the softswitch at all โ the SIP registration has expired or was never established. For help distinguishing these scenarios, reach us on WhatsApp at +8801911119966. ๐ฑ
๐ VOS3000 Call Forwarding Priority and Interaction Rules
๐ When multiple VOS3000 call forwarding types are enabled on the same phone, they interact based on priority. Understanding these priority rules is essential for correct call routing behavior: ๐ก
Priority
Forwarding Type
Behavior
๐ฅ Highest
Unconditional
If enabled, ALL calls are forwarded immediately โ no other forwarding type is evaluated
๐ฅ High
Period
If within the time period and enabled, calls are forwarded during the specified time window
๐ฅ Medium
Offline
If phone is not registered, calls are forwarded to the offline destination
4th
Busy
If phone is on a call or at line limit, incoming calls are forwarded
5th
No Reply
If phone rings but is not answered within timeout, call is forwarded
๐ Practical example: If Unconditional forwarding is enabled on a phone, it takes absolute priority โ no other forwarding type will ever be triggered because all calls are immediately redirected. This means you should NOT enable Unconditional forwarding if you also want Busy or No Reply forwarding to work. Similarly, Period forwarding overrides other conditions during its active time window. Design your forwarding strategy carefully to avoid unintended call routing. For more on call routing logic, see our VOS3000 billing system guide. ๐
๐ก๏ธ Common Call Forwarding Problems and Solutions
โ Problem 1: Call Forwarding Not Working Despite Being Enabled
๐ Symptom: A forwarding type is enabled on the phone with a destination number, but incoming calls are not being forwarded โ they continue to ring the original phone or go to a busy signal.
๐ก Cause: The forwarding type may be enabled but not activated. In VOS3000, some supplementary services require both “enable” and “activate” steps. Additionally, a higher-priority forwarding type (like Unconditional) may be intercepting the call before the intended forwarding type can trigger.
โ Solutions:
๐ Verify the forwarding type is both enabled AND activated in the phone’s supplementary service settings
๐ Check if Unconditional or Period forwarding is also enabled โ these take higher priority and may prevent other types from triggering
๐ Ensure the forwarding destination number is a valid, reachable number in the VOS3000 system
โ Problem 2: Calls Forwarded to Wrong Number
๐ Symptom: Incoming calls are being forwarded, but to an incorrect destination number.
๐ก Cause: The forwarding destination number was entered incorrectly, or the wrong forwarding type was enabled (e.g., Period forwarding with a different destination than intended).
โ Solutions:
๐ Double-check the forwarding destination number for each enabled forwarding type
๐ Verify which forwarding type is actually triggering by checking the CDR records
๐ Remember that each forwarding type has its own independent destination number โ ensure all are correctly configured
โ Problem 3: Double Billing on Forwarded Calls
๐ Symptom: CDR records show two charges for a single forwarded call โ one for the original called number and one for the forwarding destination.
๐ก Cause: Call forwarding in VOS3000 creates a second call leg from the original phone to the forwarding destination. Depending on the billing configuration, both the original call leg and the forwarding leg may be billed separately. This is expected behavior in some billing models.
โ Solutions:
๐ Review the billing rate configuration for call forwarding scenarios
๐ Check the system parameter for forwarding billing behavior
๐ฐ Configure the account’s billing rate to handle forwarded calls appropriately; see our billing overdraft prevention guide for account balance management
โ Use this checklist when deploying call forwarding in your VOS3000 system:
Check
Action
Status
๐ 1
Determine which forwarding types each phone needs (Unconditional, No Reply, Busy, Period, Offline)
โ
๐ 2
Enable and activate the appropriate forwarding types in Phone Management โ Supplementary service
โ
๐ 3
Enter the correct forwarding destination number for each enabled type
โ
๐ 4
Test each forwarding type by simulating the trigger condition (busy the phone, go offline, wait for no-reply timeout)
โ
๐ 5
Verify CDR records for forwarded calls โ confirm correct billing behavior
โ
๐ 6
Check forwarding priority โ ensure Unconditional is not interfering with other forwarding types
โ
๐ 7
Configure Forward Display Number for proper caller ID presentation on forwarded calls
โ
๐ For expert guidance on VOS3000 call forwarding configuration, reach us on WhatsApp at +8801911119966. ๐ก
โ Frequently Asked Questions
โ What are the five VOS3000 call forwarding types?
๐ The five VOS3000 call forwarding types are defined in the VOS3000 V2.1.9.07 Manual, Section 2.5.2 (Supplementary Service): (1) Unconditional โ forward all calls to specified number, (2) No Reply โ forward when not answered or phone is out of connection, (3) Busy โ forward when the phone is busy, (4) Period โ forward calls in specified time period, and (5) Offline โ forward calls when phone is not online. Each type has a different trigger condition and can be configured independently with its own destination number. ๐
โ Can I enable multiple call forwarding types on the same phone?
๐ Yes. Each of the five VOS3000 call forwarding types is an independent supplementary service that can be individually enabled or disabled on a phone. For example, you can enable both Busy forwarding (forward to colleague when on a call) and Offline forwarding (forward to voicemail when phone is not online) on the same extension. However, be aware of priority rules โ Unconditional forwarding takes absolute priority and will prevent other types from triggering. ๐ง
โ What is the difference between No Reply and Offline forwarding?
โฑ๏ธ No Reply forwarding triggers when the phone IS registered with the softswitch but does not answer the call within the ringing timeout period, or when the phone is “out of connection” (registered but unreachable). Offline forwarding triggers when the phone is NOT registered with the softswitch at all โ it is completely offline, powered off, or has lost SIP registration. These are different conditions: No Reply = registered but not answering; Offline = not registered. ๐ก
โ How does Period call forwarding work?
๐ Period forwarding is time-based โ it “forward calls in specified time period” according to the VOS3000 manual. You configure a start time and end time, and optionally specific days of the week. When the current time falls within the configured time window, incoming calls are automatically forwarded to the specified destination number. This is useful for after-hours forwarding, lunch break coverage, or weekend routing. When the time period ends, calls resume ringing the phone normally. ๐
โ Does call forwarding create double billing?
๐ฐ Call forwarding in VOS3000 creates a second call leg from the original phone to the forwarding destination number. Depending on the billing configuration, this may result in two billing entries: one for the incoming call to the original number, and one for the outgoing call from the original number to the forwarding destination. The exact billing behavior depends on the account rates and system parameters configured. Review your CDR records to understand how forwarded calls are being billed in your specific deployment. For more on billing, see our VOS3000 billing FAQ. ๐
โ Which call forwarding type has the highest priority?
๐ฅ Unconditional forwarding has the highest priority among the VOS3000 call forwarding types. When Unconditional is enabled, ALL incoming calls are immediately forwarded to the specified number โ no other forwarding type is evaluated because the call never reaches the phone. If you need other forwarding types (Busy, No Reply, Period, Offline) to also function, you must NOT enable Unconditional forwarding. The general priority order is: Unconditional > Period > Offline > Busy > No Reply. ๐
๐ Need Professional VOS3000 Setup Support?
For professional VOS3000 installations and deployment, VOS3000 Server Rental Solution:
๐ก How does your VOS3000 softswitch keep track of how many simultaneous calls each routing gateway is handling? How does it know when a gateway has reached its capacity limit and should stop receiving new calls? The answer lies in the SIP PUBLISH method โ and the timer that controls it is SS_SIP_PUBLISH_EXPIRE, the parameter that governs the VOS3000 SIP publish expire interval. ๐ฏ
๐ The SIP PUBLISH method, defined in RFC 3903, allows VOS3000 to broadcast gateway status information โ including current concurrency levels โ across the softswitch cluster. The VOS3000 SIP publish expire parameter sets how long each published status remains valid before it must be refreshed. With a default of 300 seconds (5 minutes) and a configurable range of 30 to 7200 seconds, this timer directly impacts how quickly the softswitch detects gateway state changes and enforces concurrency limits. Combined with the per-gateway Allow Publish checkbox, this creates a powerful system for automatic gateway concurrency control. โ๏ธ
๐ง All data in this guide is sourced exclusively from the official VOS3000 V2.1.9.07 Manual, Section 4.3.5.2 (Table 4-3) and the Routing Gateway Additional Settings documentation โ no fabricated values, no guesswork. For expert assistance with your VOS3000 deployment, contact us on WhatsApp at +8801911119966. ๐ก
Table of Contents
๐ What Is VOS3000 SIP Publish Expire?
โฑ๏ธ The VOS3000 SIP publish expire is the default timeout duration (in seconds) for routing gateway public status updates sent via the SIP PUBLISH method. This parameter is governed by SS_SIP_PUBLISH_EXPIRE with a default value of 300 seconds and a configurable range of 30 to 7200 seconds. ๐
๐ According to the official VOS3000 V2.1.9.07 Manual, Table 4-3:
Attribute
Value
๐ Parameter Name
SS_SIP_PUBLISH_EXPIRE
๐ข Default Value
300
๐ Range
30โ7200 seconds
๐ Description
Routing gateway public update timeout default duration
๐ก Key insight: The word “public” in the manual description refers to the broadcast nature of the PUBLISH method โ VOS3000 publicly updates the routing gateway’s status (including active call count) so that the softswitch cluster can make informed routing decisions. When the publish expire timer runs out without a refresh, the published state information is considered stale and the softswitch may lose accurate concurrency data for that gateway. ๐ก
๐ฏ Why VOS3000 SIP Publish Expire Matters
โ ๏ธ Without a properly configured publish expire timer, several critical problems can arise in your VOS3000 deployment:
๐ Stale gateway status: Too-long expire intervals mean the softswitch relies on outdated concurrency data, potentially routing calls to overloaded gateways
๐ก Excessive network overhead: Too-short expire intervals cause frequent PUBLISH messages, consuming bandwidth and processing resources across the cluster
๐ก๏ธ Concurrency overshoot: If a published state expires before a refresh arrives, the softswitch may underestimate active calls and send more traffic than the gateway can handle
๐ Routing inefficiency: Inaccurate concurrency data leads to poor call routing decisions, with traffic unevenly distributed across gateways
๐ Call quality degradation: Overloaded gateways experience audio issues, increased latency, and call drops when concurrency limits are not properly enforced
โ๏ธ How the SIP PUBLISH Method Works in VOS3000
๐ The SIP PUBLISH method (RFC 3903) is fundamentally different from REGISTER, INVITE, or other common SIP methods. While REGISTER associates an address-of-record with a Contact URI, and INVITE establishes a dialog, PUBLISH carries event state information that other entities in the network can subscribe to or reference. In VOS3000, this mechanism is used specifically for gateway concurrency reporting. ๐ก
๐ Key behavior: VOS3000 sends a PUBLISH message with the Expires header set to the value of SS_SIP_PUBLISH_EXPIRE. Before this timer expires, VOS3000 should send a refreshed PUBLISH with updated concurrency data. If the refresh does not arrive before expiry, the published state is removed, and the softswitch no longer has authoritative concurrency information for that gateway. This is why the expire interval must be carefully tuned โ too short means excessive refresh traffic; too long means stale data persists. โ๏ธ
๐ Per-Gateway Allow Publish Setting
๐ The VOS3000 SIP publish expire parameter is a global default, but the PUBLISH method is only activated on a per-gateway basis. Each routing gateway has an Allow Publish checkbox that must be explicitly enabled for that gateway to participate in the publish-based concurrency control system. ๐ ๏ธ
๐ According to the VOS3000 Routing Gateway configuration documentation:
This protocol can make routing gateway control concurrency automatically
๐ก How it works: When Allow Publish is checked for a specific routing gateway, VOS3000 uses the SIP PUBLISH method to broadcast that gateway’s status and concurrency information. This enables the softswitch to automatically track how many concurrent calls are active on the gateway and enforce call limits without manual intervention. When unchecked, VOS3000 does not publish status for that gateway, and concurrency tracking relies on other mechanisms. ๐ก
๐ Allow Publish โ Gateway Concurrency Flow
๐ Gateway Concurrency Control โ With vs. Without Allow Publish:
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ โ Allow Publish = CHECKED โ
โ โ
โ VOS3000 โโPUBLISHโโโบ Gateway Status Broadcast โ
โ โ โ
โ โโโ Active calls tracked in real-time via PUBLISH โ
โ โโโ Concurrency limit enforced automatically โ
โ โโโ New calls routed based on published capacity data โ
โ โโโ Expire timer: SS_SIP_PUBLISH_EXPIRE (300s default) โ
โ โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโค
โ โ Allow Publish = UNCHECKED โ
โ โ
โ VOS3000 โโโโโโโโโโโบ No PUBLISH for this gateway โ
โ โ โ
โ โโโ No automatic concurrency tracking via PUBLISH โ
โ โโโ Concurrency enforcement via other mechanisms only โ
โ โโโ Call limits may rely on manual configuration โ
โ โโโ Risk of over-assignment if other limits not set โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
๐ For detailed guidance on configuring routing gateways, see our VOS3000 gateway configuration and routing mapping guide. Need help setting up gateway concurrency control? Reach us on WhatsApp at +8801911119966. ๐ฑ
๐ VOS3000 SIP Publish Expire โ Range Analysis
โฑ๏ธ The configurable range for SS_SIP_PUBLISH_EXPIRE spans from 30 to 7200 seconds (2 hours). Each segment of this range has distinct implications for gateway concurrency management: ๐
Expire Value
Refresh Frequency
Data Freshness
Network Load
Best For
30s (minimum)
Every 30 seconds
๐ข Very Fresh
๐ด Higher
โก High-capacity gateways with rapid traffic changes
60s
Every minute
๐ข Fresh
๐ก Moderate
๐ Busy wholesale gateways
300s (default)
Every 5 minutes
๐ก Moderate
๐ข Low
๐ข Standard deployments with stable traffic
600s (10 min)
Every 10 minutes
๐ก Acceptable
๐ข Very Low
๐ก Low-traffic gateway links
1800s (30 min)
Every 30 minutes
๐ด Stale risk
๐ข Minimal
๐ Backup/overflow gateways
7200s (2 hr max)
Every 2 hours
๐ด Very Stale
๐ข Negligible
๐พ Dormant/archived gateways only
๐ฏ Recommendation: The default 300 seconds provides an excellent balance between data freshness and network efficiency for most deployments. Only reduce to 30-60 seconds for gateways handling high call volumes with rapidly changing concurrency. For a deeper understanding of SIP protocol behavior, see our VOS3000 SIP call flow guide. ๐
๐ Related SIP Protocol Parameters
๐ The VOS3000 SIP publish expire parameter operates alongside several other SIP parameters that affect gateway communication and call management. Understanding how they interact is essential for proper system configuration. ๐ ๏ธ
Parameter
Default
Range
Description
SS_SIP_PUBLISH_EXPIRE
300
30โ7200s
Routing gateway public update timeout default duration
SS_SIP_USER_AGENT_EXPIRE
Auto Negotiation
20โ7200s
SIP registration expiration time to other server
SS_SIP_SESSION_TTL
600
90โ7200s
SIP session timer TTL
SS_SIP_TIMEOUT_INVITE
10
1โ300s
INVITE timeout
SS_SIP_TIMEOUT_RINGING
120
1โ600s
Ringing timeout
SS_SIP_RESEND_INTERVAL
0.5,1,2,4,4,4,4,4,4,4
โ
SIP message resend interval sequence
๐ All parameters are located at: Operation management โ Softswitch management โ Additional settings โ SIP parameter. For the complete parameter reference, see our VOS3000 parameter description guide and VOS3000 system parameters reference. ๐
๐ Publish Expire vs. Registration Expire โ Key Difference
โ ๏ธ A common source of confusion is the difference between SS_SIP_PUBLISH_EXPIRE and SS_SIP_USER_AGENT_EXPIRE. Although both set expiry timers, they serve completely different purposes: ๐ฏ
Aspect
SS_SIP_PUBLISH_EXPIRE
SS_SIP_USER_AGENT_EXPIRE
๐ SIP Method
PUBLISH (gateway status broadcast)
REGISTER (outbound registration to server)
๐ข Default
300 seconds
Auto Negotiation (20โ7200s)
๐ Purpose
Gateway concurrency state validity
Outbound registration validity
๐ก Direction
Softswitch broadcasts gateway status internally
VOS3000 registers to upstream server
๐ Effect on Expiry
Stale concurrency data โ routing errors
Registration lost โ calls cannot route
๐ก Simple rule: PUBLISH expire controls how long gateway concurrency status remains valid. Registration expire controls how long VOS3000’s outbound registration to another server remains valid. They are completely independent mechanisms. For more on session management, see our VOS3000 SIP session guide. ๐ง
๐ Select the gateway that requires publish-based concurrency control
๐ง Navigate to: Additional settings โ Protocol โ SIP
โ๏ธ Check the Allow Publish checkbox โ “This protocol can make routing gateway control concurrency automatically”
๐พ Save gateway settings
Step 3: Configure Gateway Call Capacity ๐
๐ In the same Routing Gateway settings, configure:
๐ Maximum concurrent calls: Set the call capacity limit for the gateway
๐ Call limit enforcement: Ensure the concurrency limit is active
๐พ Save all gateway configuration changes
Step 4: Verify with SIP Debug ๐
๐ After configuration, verify that PUBLISH messages are being sent with the correct expire value. For comprehensive debugging techniques, see our VOS3000 SIP debug guide. ๐ง
๐ Verifying VOS3000 SIP Publish Expire Configuration:
Step 1: Open SIP debug / packet capture tool
Step 2: Filter for PUBLISH method messages
Step 3: Verify the Expires header matches your SS_SIP_PUBLISH_EXPIRE setting
Expected SIP PUBLISH message format:
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ PUBLISH sip:gateway-status@softswitch SIP/2.0 โ
โ Via: SIP/2.0/UDP vos3000-server:5060 โ
โ From: โ
โ To: โ
โ Expires: 300 โ
โ Content-Type: application/pidf+xml โ
โ โ
โ [Gateway status / concurrency data] โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ Confirm Expires value = SS_SIP_PUBLISH_EXPIRE setting
โ Confirm PUBLISH messages appear at regular intervals
โ Confirm Allow Publish gateways generate PUBLISH messages
โ Gateways without Allow Publish should NOT generate PUBLISH
๐ VOS3000 SIP Publish Expire Best Practices by Deployment
๐ฏ Different VoIP deployment scenarios require different publish expire configurations. Here are recommended settings based on the VOS3000 manual specifications and real-world deployment experience: ๐ก
Deployment Type
Recommended Publish Expire
Rationale
๐ High-volume carrier gateway (500+ CPS)
30โ60 seconds
Rapid traffic changes require fresh concurrency data; network overhead is acceptable at this scale
๐ข Wholesale VoIP (100-500 CPS)
60โ120 seconds
Moderate traffic changes; balance between data freshness and efficiency
๐ Standard enterprise gateway
300 seconds (default)
Stable traffic patterns; default provides good balance for typical deployments
Gateway is not primary route; only needs periodic status updates
๐ฅ๏ธ Multi-server cluster
60โ120 seconds
Cluster nodes need relatively fresh data for coordinated routing decisions
๐ก Important: The publish expire works together with your routing optimization configuration. Accurate concurrency data from timely PUBLISH refreshes enables the softswitch to make optimal routing decisions. Stale data can lead to over-assignment or under-utilization of gateway capacity. ๐ก
๐ก๏ธ Common VOS3000 SIP Publish Expire Problems and Solutions
โ ๏ธ Misconfigured publish expire settings can cause a range of issues in your VOS3000 deployment. Here are the most common problems and their solutions:
โ Problem 1: Gateway Overloaded Despite Concurrency Limit
๐ Symptom: A routing gateway with a configured maximum concurrent call limit continues to receive calls beyond its capacity, resulting in call quality degradation or failures.
๐ก Cause: The Allow Publish checkbox is not enabled for this gateway, so VOS3000 is not using the PUBLISH method for automatic concurrency control. Without PUBLISH, the softswitch may not have real-time visibility into the gateway’s active call count.
โ Solutions:
โ๏ธ Enable Allow Publish in the routing gateway Additional settings โ Protocol โ SIP
๐ Verify the gateway’s maximum concurrent call limit is properly configured
๐ Check SIP debug traces to confirm PUBLISH messages are being generated
โ Problem 2: Stale Concurrency Data After Publish Expire
๐ Symptom: The softswitch makes poor routing decisions, sending calls to gateways that appear to have available capacity but are actually at or near their limits.
๐ก Cause: SS_SIP_PUBLISH_EXPIRE is set too high (e.g., 1800-7200 seconds), and PUBLISH refreshes arrive so infrequently that the softswitch operates on stale concurrency data for extended periods.
โ Solutions:
โฑ๏ธ Reduce SS_SIP_PUBLISH_EXPIRE to 300 seconds (default) or lower for active gateways
๐ Monitor PUBLISH refresh frequency in SIP debug traces
๐ For high-traffic gateways, consider 60-120 second expire for fresher data
โ Problem 3: Excessive PUBLISH Network Traffic
๐ Symptom: Unusually high volume of PUBLISH messages in SIP traces, consuming network bandwidth and VOS3000 processing resources, especially in deployments with many routing gateways.
๐ก Cause: SS_SIP_PUBLISH_EXPIRE is set very low (30 seconds) across all gateways, including those with stable, low-traffic patterns that do not require frequent status updates.
โ Solutions:
๐ง Increase SS_SIP_PUBLISH_EXPIRE to 300 seconds for standard gateways
๐ Only use short expire intervals (30-60s) for high-traffic, high-CPS gateways
๐ก Consider disabling Allow Publish on dormant or very-low-traffic gateways
โ Problem 4: Cluster Routing Conflicts After Publish Timeout
๐ Symptom: In a multi-server VOS3000 cluster, different softswitch nodes have conflicting views of a gateway’s active call count, leading to simultaneous over-assignment.
๐ก Cause: PUBLISH messages expire on one node before a refresh arrives, while another node still has valid published data. This can occur if the publish expire interval is too short relative to network latency between cluster nodes.
โ Solutions:
๐ Ensure SS_SIP_PUBLISH_EXPIRE is set consistently across all cluster nodes
โฑ๏ธ Use 120-300 second expire in cluster deployments to account for inter-node latency
๐ Verify cluster network connectivity and latency between softswitch nodes
โ Use this checklist when deploying or tuning your VOS3000 SIP publish expire settings:
Check
Action
Status
๐ 1
Set SS_SIP_PUBLISH_EXPIRE to appropriate value for your deployment (30โ7200s)
โ
๐ 2
Enable Allow Publish on routing gateways that require automatic concurrency control
โ
๐ 3
Configure maximum concurrent call limits on each gateway with Allow Publish enabled
โ
๐ 4
Verify PUBLISH messages in SIP debug trace with correct Expires header value
โ
๐ 5
Confirm gateways without Allow Publish are NOT generating PUBLISH messages
โ
๐ 6
Test concurrency enforcement by generating calls up to the gateway limit
โ
๐ 7
In cluster deployments, verify SS_SIP_PUBLISH_EXPIRE is consistent across all nodes
โ
๐ 8
Monitor gateway analysis reports to validate concurrency data accuracy
โ
โ Frequently Asked Questions
โ What is the default VOS3000 SIP publish expire value?
โฑ๏ธ The default VOS3000 SIP publish expire value is 300 seconds (5 minutes), configured via the SS_SIP_PUBLISH_EXPIRE parameter. This means that routing gateway status information published via the SIP PUBLISH method remains valid for 300 seconds before requiring a refresh. The configurable range is 30โ7200 seconds. The default of 300 seconds provides a practical balance between data freshness and network efficiency for most VoIP deployments. ๐ง
โ What does the Allow Publish checkbox do in VOS3000?
โ๏ธ The Allow Publish checkbox, found under Routing Gateway โ Additional settings โ Protocol โ SIP, enables the SIP PUBLISH method for that specific routing gateway. According to the VOS3000 manual, “This protocol can make routing gateway control concurrency automatically.” When checked, VOS3000 uses the PUBLISH method to broadcast the gateway’s status and active call count, enabling automatic concurrency control. When unchecked, the gateway does not participate in PUBLISH-based status broadcasting, and concurrency tracking relies on other mechanisms. ๐ก
โ What is the difference between SS_SIP_PUBLISH_EXPIRE and SS_SIP_USER_AGENT_EXPIRE?
๐ These two parameters control different SIP method expiry timers. SS_SIP_PUBLISH_EXPIRE (default: 300s, range: 30โ7200s) controls how long a PUBLISH message’s gateway status information remains valid โ it governs concurrency data freshness. SS_SIP_USER_AGENT_EXPIRE (default: Auto Negotiation, range: 20โ7200s) controls how long VOS3000’s outbound REGISTER to another server remains valid โ it governs registration freshness. PUBLISH is about gateway status broadcasting; REGISTER is about server registration. They are completely independent mechanisms. ๐
โ Should I set the publish expire to the minimum 30 seconds for better concurrency tracking?
โก Not necessarily. While 30 seconds provides the freshest concurrency data, it also means VOS3000 sends PUBLISH refresh messages every 30 seconds for every gateway with Allow Publish enabled. In deployments with many gateways, this can generate significant network traffic. For high-volume carrier gateways where call counts change rapidly, 30-60 seconds is appropriate. For standard deployments, the default 300 seconds provides adequate data freshness with minimal overhead. Evaluate your specific traffic patterns and number of gateways before reducing the expire interval. ๐ก
โ What happens when the VOS3000 SIP publish expire timer runs out?
๐ When the publish expire timer runs out without a refresh PUBLISH being received, the published gateway status information is considered expired or stale. The softswitch no longer has authoritative, real-time concurrency data for that gateway. This can lead to routing decisions based on outdated call counts โ potentially over-assigning calls to a gateway that has reached capacity, or under-utilizing a gateway that has available capacity. This is why it is critical that PUBLISH refreshes arrive before the expire timer elapses. โฑ๏ธ
โ Does Allow Publish need to be enabled on every routing gateway?
๐ No. Allow Publish is a per-gateway setting, and you should only enable it on gateways where automatic concurrency control via the PUBLISH method is beneficial. For high-traffic, active gateways where call capacity management is critical, enabling Allow Publish provides valuable real-time concurrency tracking. For low-traffic, backup, or dormant gateways, leaving Allow Publish unchecked avoids unnecessary PUBLISH traffic while still allowing basic gateway operation. Use gateway configuration FAQ guidance for your specific setup. ๐ ๏ธ
โ Can different routing gateways have different effective publish expire values?
๐ง The SS_SIP_PUBLISH_EXPIRE parameter is a global setting โ it applies to all routing gateways that have Allow Publish enabled. There is no per-gateway override for the publish expire duration in the standard VOS3000 configuration. If you need different refresh rates for different gateways, consider the trade-off: setting the global value to the shortest required interval ensures the busiest gateways have fresh data, but may generate more refresh traffic than necessary for quieter gateways. The default 300 seconds is designed to accommodate the majority of deployment scenarios. ๐ก
๐ Related Resources
๐ Explore these related VOS3000 guides for deeper understanding of SIP protocol parameters, gateway management, and call routing optimization:
๐ Need expert help configuring VOS3000 SIP publish expire and gateway concurrency control? Contact our team on WhatsApp at +8801911119966 for personalized deployment assistance. We help VoIP operators worldwide optimize their VOS3000 softswitch configurations for maximum performance and reliability. ๐
๐ Need Professional VOS3000 Setup Support?
For professional VOS3000 installations and deployment, VOS3000 Server Rental Solution:
Welcome to the ultimate guide on VOS3000 agent account configuration and reseller authorization management. If you’re running a VoIP wholesale or retail business using VOS3000, understanding how agent accounts work is absolutely critical for scaling your operations, delegating responsibilities, and building a profitable multi-level reseller network.
The VOS3000 agent account system is one of the most powerful features in the VOS3000 softswitch platform. It allows administrators to create hierarchical account structures where parent accounts (agents) can manage their own sub-accounts, handle payments, configure gateways, and even create sub-agents โ all without needing direct admin intervention for every task.
In this comprehensive guide, we’ll walk through every aspect of the VOS3000 agent account system โ from basic setup to advanced authorization management, sub-account filtering, number section limitations, and real-world deployment scenarios. Whether you’re a system administrator, a VoIP operator, or a reseller yourself, this guide has everything you need.
A VOS3000 agent account is a specialized account type within the VOS3000 softswitch that has the authority to manage other accounts beneath it โ known as sub-accounts. Unlike ordinary accounts that simply originate or terminate calls, an agent account acts as a managerial entity that can create, modify, delete, and control its subordinate accounts.
According to the VOS3000 User Manual (Section 2.4.3, Page 22):
“Agent accounts differ from ordinary accounts in that there are accounts belonging to agent accounts. Once an account becomes an agent account, it will appear in the navigation tree.”
This means that the moment an account has sub-accounts assigned to it, VOS3000 automatically recognizes it as an agent account. The system then provides additional management capabilities and UI elements (like the navigation tree entry) that are not available for ordinary accounts.
๐ก Why VOS3000 Agent Accounts Matter for Your Business
In the VoIP industry, the VOS3000 agent account system is the backbone of reseller operations. Here’s why it matters:
๐ Delegation of Control: System admins don’t need to manage every single end-user account. Agent accounts can handle their own sub-account management.
๐ฐ Revenue Distribution: Each agent manages their own payment collection, making multi-level billing seamless.
๐ Scalability: As your business grows from 10 customers to 10,000, the agent hierarchy keeps everything organized.
๐ก๏ธ Security: Agent accounts can only manipulate their own sub-accounts, ensuring data isolation and security.
โก Efficiency: Agents can perform routine operations (adding phones, making payments) without waiting for admin approval.
The VOS3000 agent account system is specifically designed to “facilitate agent development” (VOS3000 Manual, Section 2.4.5, Page 24), meaning it provides the tools resellers need to grow their business independently while the platform maintains overall control.
โ๏ธ Agent Account vs. Ordinary Account: Key Differences
Understanding the distinction between ordinary and agent accounts in VOS3000 is fundamental to proper system configuration. Let’s examine the critical differences:
๐ Feature
๐ค Ordinary Account
๐ข VOS3000 Agent Account
Sub-Accounts
โ Cannot have sub-accounts
โ Can manage sub-accounts
Navigation Tree
โ Not visible in navigation tree
โ Appears in navigation tree
Account Management
โ Cannot add/modify/delete accounts
โ Can manage sub-accounts (with authorization)
Payment Control
โ No payment authority
โ Can process payments for sub-accounts
Gateway Management
โ No gateway access
โ Can add/modify gateways (with authorization)
Phone Card Operations
โ Cannot manage phone cards
โ Can add/delete/modify phone cards
Account Category
“Account” (non-editable)
“Agent” (non-editable)
Scope of Control
Own account only
Own account + all sub-accounts
As shown in the table above, the VOS3000 agent account transforms a simple calling account into a management powerhouse. The key insight from the VOS3000 manual (Section 2.4.2, Page 16) is that the account category field is non-editable โ it’s automatically determined by the system based on whether the account has sub-accounts or not.
โ๏ธ How VOS3000 Agent Accounts Work
The VOS3000 agent account system operates on a hierarchical principle. Let’s break down the core mechanics:
๐ Automatic Agent Promotion
One of the most important concepts in VOS3000 is that agent status is automatically assigned. When you create an account and assign sub-accounts to it (by setting the Agent ID field on those sub-accounts), the parent account automatically becomes an agent account. The VOS3000 manual (Section 2.4.2, Page 16) states:
“When an account has sub accounts, it automatically becomes an agent.”
This means you don’t need to manually flip a switch to create an agent account โ the system handles this dynamically based on the account relationships you establish.
๐ The Agent ID Field
Every account in VOS3000 has an Agent ID field. This field specifies the parent account (the agent) to which this account belongs. Key rules:
๐ The Agent ID must reference an existing account in the system
๐ The parent account must exist before you can assign it as an Agent ID
๐ An account without an Agent ID is a top-level account (or a standalone account)
๐ When an account is created by an agent, it must be designated to an agent account (VOS3000 Manual, Section 2.4.5, Page 25)
The Agent ID relationship forms the backbone of the entire VOS3000 agent account hierarchy and determines the chain of command within your reseller network.
๐ก๏ธ Scope of Manipulation
A critical security feature of the VOS3000 agent account system is that an agent account can only manipulate its own sub-accounts (VOS3000 Manual, Section 2.4.5, Page 25). This means:
๐ Agent A cannot see or modify Agent B’s sub-accounts
๐ Each agent’s scope is strictly limited to their own hierarchy
๐ Even sub-agents created by an agent fall under that agent’s control
๐ Only system administrators have access to all accounts
This design ensures complete isolation between different resellers using the same VOS3000 platform โ a fundamental requirement for multi-tenant VoIP operations.
๐ Step-by-Step: Creating a VOS3000 Agent Account
Creating a VOS3000 agent account involves several steps. Let’s walk through the complete process:
Step 1: Create the Parent Account
First, you need to create the account that will become the agent. Navigate to the Account Management section in VOS3000:
๐ฅ๏ธ Log in to VOS3000 with administrator credentials
๐ Navigate to Account Management (Section 2.4.2, Page 16)
โ Click Add to create a new account
๐ Fill in the required account details
๐พ Save the account
Step 2: Assign Sub-Accounts to the Agent
To transform the ordinary account into a VOS3000 agent account, you need to assign sub-accounts:
๐ค Create a new account (or edit an existing one)
๐ In the Agent ID field, enter the account ID of the parent account
โ The parent account must already exist in the system
๐พ Save the sub-account
๐ The parent account automatically becomes an agent account
Step 3: Verify Agent Account Status
After assigning sub-accounts, verify that the account has been promoted to agent status:
๐ Check the Account Category field โ it should now display “Agent”
๐ฒ Look for the account in the navigation tree โ it should now appear there
๐ Double-click the agent account to open the Sub Account Management interface
Step 4: Configure Authorizations
Now configure what operations the VOS3000 agent account can perform. This is covered in detail in the Authorization Management section below.
The complete workflow can be summarized in this configuration checklist:
๐ข Step
๐ Action
โ Verification
1
Create parent account
Account appears in account list
2
Create sub-account with Agent ID
Agent ID field populated correctly
3
Verify agent promotion
Category shows “Agent”, appears in navigation tree
4
Configure authorizations
Permissions enabled as needed
5
Set number section limitations
Prefix restrictions applied
6
Test agent operations
Agent can perform authorized tasks
๐ Sub-Account Management in VOS3000
Once an account becomes a VOS3000 agent account, it gains access to the Sub-Account Management interface. This is where agents can view, manage, and control all accounts under their jurisdiction.
๐ Accessing Sub-Account Management
According to the VOS3000 manual (Section 2.4.3, Page 22):
“Double-click the agent account to open ‘Sub account management’.”
This simple action opens a dedicated management interface for that specific agent’s sub-accounts. From here, the agent can perform all authorized operations on their sub-accounts.
๐ Direct vs. All Sub-Account Filter
The Sub-Account Management interface provides two important filter options (VOS3000 Manual, Section 2.4.3, Page 22):
๐ Filter
๐ Description
๐ Use Case
Direct
Shows only the immediate (first-level) sub-accounts
Quick view of directly managed accounts
All
Shows all sub-accounts including sub-sub-accounts (nested)
Complete hierarchical view of entire agent tree
The distinction between “Direct” and “All” is especially important in multi-level reseller scenarios. When an agent creates a sub-agent (who in turn has their own sub-accounts), the “Direct” filter shows only the immediate children, while “All” reveals the entire hierarchy beneath that agent.
โก Sub-Account Operations
From the Sub-Account Management interface, authorized agents can perform the following operations on their sub-accounts:
โ Add new sub-accounts โ Create new customer or sub-agent accounts
โ๏ธ Modify sub-accounts โ Update account settings, rates, and configurations
๐๏ธ Delete sub-accounts โ Remove accounts that are no longer needed
๐ Add/delete/modify phones โ Manage phone numbers for sub-accounts
๐ฐ Process payments โ Add credit/balance for sub-accounts
Each of these operations requires the corresponding authorization to be enabled for the VOS3000 agent account, which we’ll cover in the next section.
๐ VOS3000 Agent Authorization Management
Authorization management is the heart of the VOS3000 agent account system. It determines exactly what operations an agent can and cannot perform. The VOS3000 manual (Section 2.4.5, Pages 24-25) provides a comprehensive list of authorizations that can be granted to agent accounts.
๐ก๏ธ Why Authorization Management Matters
Proper authorization configuration is essential because:
๐ Security: Prevents unauthorized operations that could disrupt service or cause financial loss
๐ฏ Role-Based Access: Different agents may need different levels of control based on their business role
๐ Business Control: Administrators can limit what agents can do to maintain oversight
โ๏ธ Compliance: Ensures agents operate within the boundaries defined by the platform operator
๐ Flexibility: Authorization can be adjusted as business relationships evolve
As stated in the VOS3000 manual (Section 2.4.5, Page 24):
“This function facilitates agent development. Agent user can have agent-typed account in system. Admins can create accounts limiting rights.”
This means the system administrator retains ultimate control โ they decide which authorizations each VOS3000 agent account receives, enabling a fine-grained approach to permission management.
๐ Complete Authorization List
The following table lists all available authorizations for VOS3000 agent accounts as documented in the VOS3000 User Manual (Section 2.4.5, Pages 24-25):
๐ข #
๐ Authorization
๐ Description
โ ๏ธ Risk Level
1
Add/delete/modify account
Create new sub-accounts, remove existing ones, or modify account details
๐ด High
2
Add/delete/modify phone
Manage phone number assignments for sub-accounts
๐ก Medium
3
Add/delete/modify phone card
Manage calling card configurations for prepaid services
๐ก Medium
4
Add/delete gateway
Create or remove SIP gateways/trunk endpoints
๐ด High
5
Modify gateway information
Update gateway settings such as IP, port, codec, and protocol
๐ด High
6
Modify gateway capacity
Adjust concurrent call capacity limits on gateways
๐ก Medium
7
Payment for this account
Process payments/credit top-ups for the agent’s own account
๐ด High
8
Payment for sub accounts
Process payments/credit top-ups for all sub-accounts
๐ด High
Each authorization can be independently enabled or disabled for each VOS3000 agent account, giving administrators precise control over what each agent can do.
๐ Detailed Breakdown of Authorization Types
Let’s examine each authorization type in detail to understand exactly what they enable and when you should grant them.
1๏ธโฃ Add/Delete/Modify Account Authorization
This is the most fundamental authorization for a VOS3000 agent account. It allows the agent to:
โ Add: Create new sub-accounts under the agent’s hierarchy
๐๏ธ Delete: Remove existing sub-accounts that are no longer needed
โ๏ธ Modify: Edit sub-account settings including rates, codecs, prefixes, and more
When to grant: This authorization should be granted to any agent who needs to manage their own customer base. Without this, the agent cannot independently onboard new customers or modify existing ones.
Important note: As stated in the VOS3000 manual (Section 2.4.5, Page 25):
“Accounts created by agent must be designated to an agent account.”
This means every account created by an agent is automatically linked back to that agent โ they cannot create “orphan” accounts that exist outside the agent hierarchy.
2๏ธโฃ Add/Delete/Modify Phone Authorization
This authorization allows the VOS3000 agent account to manage phone numbers for sub-accounts:
๐ Add: Assign new phone numbers to sub-accounts
๐๏ธ Delete: Remove phone numbers from sub-accounts
โ๏ธ Modify: Update phone number settings and configurations
When to grant: Essential for agents who manage DID numbers or need to assign specific caller IDs to their sub-accounts. Particularly important for retail VoIP resellers.
โ๏ธ Modify: Update calling card rates and settings
When to grant: Only for agents who specifically operate calling card services. This authorization should be withheld from agents who don’t need calling card functionality.
4๏ธโฃ Add/Delete Gateway Authorization
Gateway management is one of the highest-risk authorizations:
๐ Add: Create new SIP gateways or trunk endpoints for sub-accounts
When to grant: Only for trusted agents who need to configure their own SIP trunks or gateway endpoints. Most resellers do not need this authorization โ the administrator typically manages gateway configurations centrally.
This authorization allows updating existing gateway settings:
๐ง IP Address: Change the gateway IP address
๐ Port: Modify the SIP signaling port
๐ต Codec: Update the supported codec list
๐ก Protocol: Change SIP protocol settings
๐ Prefix: Modify dial prefix configurations
When to grant: For agents who manage their own SIP infrastructure and need to update gateway parameters when their network changes. This is a high-risk authorization that should be carefully controlled.
6๏ธโฃ Modify Gateway Capacity Authorization
This authorization controls the ability to adjust gateway concurrent call limits:
๐ Increase capacity: Allow more simultaneous calls through a gateway
๐ Decrease capacity: Reduce the number of simultaneous calls
When to grant: Useful for agents who need to manage their own bandwidth allocation. For instance, a reseller might need to increase capacity during peak hours and reduce it during off-peak times.
7๏ธโฃ Payment for This Account Authorization
This authorization allows the VOS3000 agent account to process payments (credit top-ups) for its own account:
๐ฐ Add balance: Increase the account’s calling credit
๐ View payment history: Track all payment transactions
When to grant: This is typically granted to agents who operate on a prepaid model and need to manage their own balance. However, in most wholesale setups, the administrator manages top-ups centrally, so this authorization is often disabled.
8๏ธโฃ Payment for Sub Accounts Authorization
This is perhaps the most business-critical authorization for resellers:
๐ฐ Top up sub-accounts: Add credit to customer accounts
๐ Manage sub-account balances: Distribute credit across multiple sub-accounts
๐ Track payments: Monitor all payment activities in the sub-account hierarchy
When to grant: Essential for any VOS3000 agent account that operates as a reseller. Without this, the agent cannot manage their customers’ balances, which is a core reseller function.
The following authorization matrix shows recommended configurations for different agent types:
๐ Authorization
๐ Retail Reseller
๐ญ Wholesale Agent
๐ณ Calling Card Agent
๐ SIP Trunk Provider
Add/delete/modify account
โ
โ
โ
โ
Add/delete/modify phone
โ
โ
โ
โ
Add/delete/modify phone card
โ
โ
โ
โ
Add/delete gateway
โ
โ
โ
โ
Modify gateway information
โ
โ
โ
โ
Modify gateway capacity
โ
โ
โ
โ
Payment for this account
โ
โ
โ
โ
Payment for sub accounts
โ
โ
โ
โ
๐ต Number Section Limitation for Agent Accounts
The Number Section Limitation feature (VOS3000 Manual, Section 2.4.6, Page 26) allows administrators to restrict the phone number prefixes that a VOS3000 agent account (and its sub-accounts) can use. This is a powerful tool for controlling call routing and preventing unauthorized destination access.
๐ง How Number Section Limitation Works
Number Section Limitation works by defining allowed or blocked phone number prefixes for specific accounts:
๐ฑ Prefix-based filtering: Controls which number prefixes (e.g., country codes, area codes) the account can dial
๐ Inherited by sub-accounts: Sub-accounts inherit the limitations of their parent agent account
๐ก๏ธ Security layer: Prevents agents from routing calls to unauthorized or expensive destinations
๐ Business control: Allows platform operators to segment destination access by agent tier
The VOS3000 agent account system supports two CTD (Call Type Definition) billing models, as documented in the VOS3000 manual (Section 2.4.2, Page 16):
๐ Standard CTD Billing Model
The Standard billing model is the default and most commonly used model in VOS3000:
๐ Per-minute billing: Calls are billed based on duration
๐ Rating by destination: Different rates apply to different destinations
๐ฐ Prepaid/Postpaid: Supports both payment models
๐ CDR-based: All billing is calculated from Call Detail Records
๐ Flow CTD Billing Model
The Flow billing model is specifically designed for callback business operations (VOS3000 Manual, Section 2.4.2, Page 16):
๐ฒ Callback-oriented: Designed for callback service providers
๐ Two-leg billing: Handles the unique billing requirements of callback calls
๐ DID integration: Works with DID-based callback triggers
๐ Specialized CDR processing: Different CDR handling for callback scenarios
๐ Feature
๐ Standard Model
๐ Flow Model
Primary Use Case
Standard VoIP calling
Callback business
Billing Method
Per-minute by destination
Two-leg callback billing
CDR Processing
Single CDR per call
Separate CDRs for each leg
Complexity
Simple
Moderate
Recommendation
Default choice for most deployments
Only for callback operations
When configuring a VOS3000 agent account, choose the Standard model unless you specifically operate a callback business. The Flow model introduces additional complexity that is unnecessary for standard wholesale or retail VoIP operations.
๐๏ธ Multi-Level Reseller Hierarchy
One of the most powerful aspects of the VOS3000 agent account system is the ability to create multi-level reseller hierarchies. The VOS3000 manual (Section 2.4.5, Page 25) confirms that “Agent can create sub-accounts for sub-agents”, enabling a tree-like organizational structure.
๐ณ Understanding the Hierarchy Structure
In a VOS3000 deployment, the account hierarchy typically looks like this:
๐ข System Administrator (Admin)
โโโ ๐ญ Master Agent (VOS3000 Agent Account - Level 1)
โ โโโ ๐ Sub-Agent A (VOS3000 Agent Account - Level 2)
โ โ โโโ ๐ค End Customer 1
โ โ โโโ ๐ค End Customer 2
โ โ โโโ ๐ค End Customer 3
โ โโโ ๐ Sub-Agent B (VOS3000 Agent Account - Level 2)
โ โ โโโ ๐ค End Customer 4
โ โ โโโ ๐ Sub-Sub-Agent (Level 3)
โ โ โโโ ๐ค End Customer 5
โ โ โโโ ๐ค End Customer 6
โ โโโ ๐ค Direct Customer 1
โโโ ๐ญ Master Agent 2 (VOS3000 Agent Account - Level 1)
โ โโโ ๐ค Direct Customer 7
โ โโโ ๐ค Direct Customer 8
โโโ ๐ค Standalone Customer (No agent hierarchy)
๐ Key Hierarchy Rules
The VOS3000 agent account hierarchy follows strict rules that maintain order and security:
๐ Agent ID Chain: Every account (except top-level) must have an Agent ID pointing to its parent
๐ Scope Limitation: An agent can only manipulate accounts within its own hierarchy
๐ Authorization Inheritance: Sub-agents can only have authorizations that are a subset of their parent’s authorizations
๐ Mandatory Designation: Accounts created by agents must be designated to an agent account
๐ฒ Navigation Tree: Each agent account appears in the navigation tree with its sub-accounts organized beneath it
๐ Real-World Hierarchy Example
Consider a VoIP operator based in Bangladesh who serves the South Asian market. Their VOS3000 agent account hierarchy might look like this:
๐ข Level
๐ Account Name
๐ Agent ID
๐ Category
๐ Key Authorizations
Admin
System Admin
N/A
Admin
All authorizations
Level 1
BD-Wholesale-Agent
Admin
Agent
All except gateway management
Level 2
Dhaka-Retail-Sub
BD-Wholesale-Agent
Agent
Account, Phone, Payment (sub)
Level 3
Customer-001
Dhaka-Retail-Sub
Account
N/A (end user)
This hierarchical structure enables each level to operate independently within their authorized scope while maintaining overall system integrity.
๐ฒ Agent Account Navigation Tree
A key visual indicator of a VOS3000 agent account is its appearance in the navigation tree. The VOS3000 manual (Section 2.4.3, Page 22) explicitly states that once an account becomes an agent, “it will appear in the navigation tree.”
๐ฅ๏ธ Navigation Tree Features
The navigation tree provides several important capabilities:
๐ Hierarchical View: Visual representation of the agent-sub-account relationship
๐ฑ๏ธ Quick Access: Double-click an agent account to open Sub-Account Management
๐ Filter Options: Toggle between “Direct” and “All” views for sub-account display
๐ Real-time Updates: The tree updates dynamically as sub-accounts are added or removed
๐ก Using the Navigation Tree Effectively
For administrators managing large numbers of VOS3000 agent accounts, the navigation tree is an essential tool. Here are some tips:
๐ท๏ธ Use descriptive account names: Name agent accounts clearly to identify them in the tree (e.g., “Agent-BD-Wholesale” instead of “A001”)
๐ Use the “Direct” filter for quick access: When you only need to work with immediate sub-accounts, the “Direct” filter reduces visual clutter
๐ Use “All” for audit purposes: When auditing an agent’s entire hierarchy, switch to “All” to see the complete sub-account tree
๐ Keep hierarchy depth reasonable: While VOS3000 supports multi-level hierarchies, keeping it to 2-3 levels makes the navigation tree more manageable
โ Best Practices for VOS3000 Agent Account Management
Based on extensive experience with VOS3000 deployments, here are the best practices for managing VOS3000 agent accounts effectively:
๐ก๏ธ Security Best Practices
๐ Principle of Least Privilege: Only grant the minimum authorizations an agent needs to perform their business functions. Don’t give gateway management access to retail resellers.
๐ Regular Authorization Audits: Periodically review agent authorizations to ensure they still align with business needs. Remove any authorizations that are no longer required.
๐ฑ Apply Number Section Limitations: Always configure prefix restrictions for agents to prevent unauthorized destination routing.
๐ Monitor Payment Activities: Keep a close eye on payment authorizations, especially for high-volume agents. Consider disabling “Payment for this account” for agents who should only process sub-account payments.
๐ Use Strong Passwords: Ensure all agent accounts use strong, unique passwords and change them regularly.
โ๏ธ Operational Best Practices
๐ Document Your Hierarchy: Maintain a clear diagram of your agent hierarchy. This helps with troubleshooting and onboarding new team members.
๐ท๏ธ Naming Conventions: Use consistent naming conventions for agent accounts. For example: “[Region]-[Type]-[Name]” like “BD-Wholesale-AcmeTel”.
๐ Regular Balance Reviews: Monitor agent account balances to ensure they have sufficient credit for their operations. Set up alerts for low-balance situations.
๐ Test Before Deployment: Always test new agent configurations in a non-production environment before deploying to your live system.
๐ Backup Configurations: Regularly backup your VOS3000 configuration, including agent account settings and authorizations.
๐ฐ Business Best Practices
๐ Tier-Based Authorization: Create different authorization profiles for different agent tiers (e.g., Silver, Gold, Platinum) with progressively more capabilities.
๐ Sub-Agent Approval Process: Implement an approval process before allowing agents to create sub-agents, preventing uncontrolled hierarchy growth.
๐ก๏ธ Prepaid Vendor Routing: Configure call routing to only pass calls to vendors with positive balance. Learn more in our article on prepaid vendor call routing in VOS3000.
โ ๏ธ Common Mistakes and How to Avoid Them
When working with VOS3000 agent accounts, administrators often make these common mistakes:
โ Mistake 1: Granting All Authorizations by Default
One of the most dangerous mistakes is giving every agent all available authorizations. This creates unnecessary security risks and can lead to accidental misconfigurations.
Solution: Follow the principle of least privilege. Start with minimal authorizations and add more only when there’s a documented business need.
โ Mistake 2: Not Using Number Section Limitations
Without Number Section Limitations, agents can route calls to any destination, potentially resulting in unexpected costs or fraud.
Solution: Always configure Number Section Limitations for every VOS3000 agent account. Review and update them regularly. For fraud prevention, also consider the VOS3000 extended firewall configuration.
โ Mistake 3: Creating Overly Deep Hierarchies
While VOS3000 supports multi-level agent hierarchies, creating too many levels makes management complex and can impact system performance.
Solution: Limit your hierarchy to 2-3 levels. If you need more levels, consider flattening the structure by creating separate top-level agents instead.
โ Mistake 4: Ignoring the “Direct” vs. “All” Filter
Many administrators don’t realize the importance of the “Direct” and “All” filter in Sub-Account Management. Using the wrong filter can lead to confusion about the scope of an agent’s hierarchy.
Solution: Use “Direct” for day-to-day management and “All” for auditing and comprehensive reviews.
โ Mistake 5: Not Setting Agent ID Correctly
Setting the wrong Agent ID can break the hierarchy chain and lead to accounts being managed by the wrong agent.
Solution: Always double-check the Agent ID field when creating sub-accounts. The parent account must exist before you can reference it as an Agent ID. Remember: “The Account id of its parent account. Parent account must exist” (VOS3000 Manual, Section 2.4.2, Page 16).
โ Mistake 6: Choosing the Wrong CTD Billing Model
Selecting the Flow billing model when you’re not running a callback business introduces unnecessary complexity.
Solution: Use the Standard CTD billing model unless you specifically operate callback services.
๐ง Troubleshooting Agent Account Issues
When issues arise with your VOS3000 agent account setup, here are the most common problems and their solutions:
โ ๏ธ Problem
๐ Likely Cause
โ Solution
Account doesn’t appear in navigation tree
Account has no sub-accounts assigned
Create at least one sub-account with this account as Agent ID
Agent cannot add sub-accounts
“Add/delete/modify account” authorization not granted
Enable the account management authorization in Authorization Management
Agent cannot process payments
Payment authorization not enabled
Enable “Payment for sub accounts” and/or “Payment for this account”
Sub-account shows wrong agent
Agent ID was set incorrectly during creation
Modify the sub-account and correct the Agent ID field
Agent can see other agents’ sub-accounts
System configuration issue
Verify account scope settings; agent should only manipulate its own sub-accounts
Account category won’t change to “Agent”
No sub-accounts assigned yet
Account category is auto-determined; assign sub-accounts to promote to Agent
Q1: How do I convert an ordinary account to a VOS3000 agent account?
A: You don’t need to manually convert an account. In VOS3000, agent status is automatically assigned when an account has sub-accounts. Simply create a sub-account and set its Agent ID to the ordinary account’s ID. The ordinary account will automatically become a VOS3000 agent account and appear in the navigation tree. As the manual states (Section 2.4.2, Page 16): “When an account has sub accounts, it automatically becomes an agent.”
Q2: Can a VOS3000 agent account create sub-agents (agents under agents)?
A: Yes! The VOS3000 manual (Section 2.4.5, Page 25) explicitly states that “Agent can create sub-accounts for sub-agents.” This means an agent can create sub-accounts that are themselves agents, building a multi-level reseller hierarchy. Each sub-agent can then manage their own set of sub-accounts, enabling complex business structures.
Q3: What happens if I delete a VOS3000 agent account that has sub-accounts?
A: Deleting a VOS3000 agent account that has active sub-accounts requires careful handling. You should first reassign or delete all sub-accounts before removing the parent agent account. Always check the “All” filter in Sub-Account Management to see the complete hierarchy before proceeding with deletion. It’s recommended to back up your configuration before making such changes.
Q4: Can I restrict an agent to only certain call destinations?
A: Absolutely. Use the Number Section Limitation feature (VOS3000 Manual, Section 2.4.6, Page 26) to restrict the phone prefixes that an agent’s sub-accounts can dial. This is essential for preventing agents from routing calls to expensive or unauthorized destinations. Each agent can have different prefix restrictions based on their business agreement.
Q5: What is the difference between “Direct” and “All” sub-account filters?
A: The “Direct” filter shows only the immediate (first-level) sub-accounts directly under the VOS3000 agent account. The “All” filter shows the entire hierarchy, including sub-sub-accounts and sub-agents’ sub-accounts. Use “Direct” for day-to-day management and “All” for comprehensive auditing. This feature is documented in Section 2.4.3, Page 22 of the VOS3000 manual.
Q6: Should I use the Standard or Flow CTD billing model for my agent account?
A: Use the Standard CTD billing model for regular VoIP calling (wholesale or retail). Use the Flow model only if you specifically operate a callback business. The Flow model is designed for two-leg callback billing scenarios and introduces unnecessary complexity for standard operations. The VOS3000 manual (Section 2.4.2, Page 16) confirms that the Flow model is specifically “for callback business.”
Q7: Can an agent account modify another agent’s sub-accounts?
A: No. A fundamental security principle of the VOS3000 agent account system is that “Agent account can only manipulate its sub accounts” (VOS3000 Manual, Section 2.4.5, Page 25). Agent A cannot see, modify, or interact with Agent B’s sub-accounts. This isolation ensures that different resellers on the same platform operate independently and securely.
Q8: How do I configure gateway access for a VOS3000 agent account?
A: Gateway access requires three authorizations to be enabled: “Add/delete gateway,” “Modify gateway information,” and “Modify gateway capacity.” Enable these authorizations only for agents who need to manage their own SIP infrastructure. For most retail resellers, gateway management should remain with the system administrator. Only grant gateway authorizations to trusted wholesale or SIP trunk provider agents.
๐ Related Resources
Expand your VOS3000 knowledge with these related guides from our blog:
Need help setting up your VOS3000 agent account system or configuring reseller authorization management? Our team of VOS3000 experts is ready to assist you with:
๐ง Agent Account Setup: Complete configuration of your agent hierarchy and authorization structure
๐ Security Hardening: Implement best-practice authorization controls and number section limitations
๐ Billing Configuration: Set up CTD billing models and rate cards for your agent network
๐ก๏ธ Fraud Prevention: Configure firewall rules and monitoring to protect your platform
๐ Migration Support: Migrate existing accounts to a proper agent hierarchy
Whether you’re setting up your first VOS3000 agent account or managing a complex multi-level reseller network, we’re here to help. Don’t let configuration challenges slow down your business โ reach out today!
๐ This guide is based on the VOS3000 User Manual V2.1.9.07. All page references and feature descriptions are sourced from the official documentation. For the latest software updates, visit vos3000.com/downloads.php.
Published on multahost.com/blog โ Your trusted source for VOS3000 tutorials, configuration guides, and VoIP business insights. Need expert help? Contact us on WhatsApp at +8801911119966.
๐ Need Professional VOS3000 Setup Support?
For professional VOS3000 installations and deployment, VOS3000 Server Rental Solution:
VOS3000 Time-Based Routing: Work Calendar and Period Rate Setup
Implementing VOS3000 time-based routing is one of the most powerful strategies for maximizing profit in a wholesale VoIP operation. While standard LCR routing selects gateways based on static cost priorities, this time-based approach adds a critical dimension: the ability to automatically shift traffic between vendors and rate tables based on the time of day, day of the week, and whether the day is a working day or a holiday. This means you can route calls through the cheapest available vendor during off-peak hours, switch to higher-quality providers during peak business hours, and apply entirely different rate structures on weekends and holidays โ all without any manual intervention.
Many VOS3000 operators leave significant money on the table because they rely solely on static LCR routing and never configure time-based routing. Vendors frequently offer different rates for peak and off-peak hours, and failing to take advantage of these rate differences means you are overpaying for termination during low-cost periods. This guide walks you through the complete VOS3000 time-based routing configuration process, covering Work Calendar setup (VOS3000 Manual Section 2.12.4), Package Period Rate Management (VOS3000 Manual Section 2.3.2), and the practical integration of both features to create a dynamic routing strategy that adapts to time-based cost fluctuations. For professional assistance with your routing setup, contact us on WhatsApp at +8801911119966.
Table of Contents
Why VOS3000 Time-Based Routing Matters for VoIP Profitability
Understanding why VOS3000 time-based routing is essential requires looking at how VoIP termination costs actually work in the real world. Most carriers and termination providers offer different rates depending on the time of day. Peak hours typically have higher termination costs because network congestion is greater and demand is higher. Off-peak hours, usually nighttime and weekends, have significantly lower rates because network capacity is underutilized. A wholesale VoIP operator who routes all traffic through the same gateway with the same rate table regardless of time is effectively paying peak rates 24 hours a day.
The financial impact of this oversight can be enormous. Consider a VoIP operation handling 500,000 minutes per day. If the difference between peak and off-peak rates is just $0.002 per minute, and 40% of your traffic falls in off-peak hours, you are losing $400 per day or $12,000 per month by not implementing time-based routing. Over a year, that amounts to $146,000 in lost profit โ all because you did not configure time-based routing properly.
๐ Scenario
๐ฐ Daily Savings
๐ฐ Monthly Savings
๐ฐ Annual Savings
100K min/day, $0.002 diff
$80
$2,400
$29,200
500K min/day, $0.002 diff
$400
$12,000
$146,000
1M min/day, $0.002 diff
$800
$24,000
$292,000
1M min/day, $0.005 diff
$2,000
$60,000
$730,000
How VOS3000 Time-Based Routing Differs from Simple LCR
It is important to understand the distinction between standard LCR routing and VOS3000 time-based routing. Our VOS3000 LCR routing guide covers the fundamentals of least cost routing, which selects gateways based on static priorities and prefix matching. LCR routing always routes the same way regardless of when the call arrives. VOS3000 time-based routing adds a time dimension to this decision process, allowing different routing and billing rules to apply during different time periods.
Think of it this way: LCR routing answers the question “Which gateway is cheapest for this destination?” while VOS3000 time-based routing answers the question “Which gateway is cheapest for this destination at this specific time?” The combination of LCR and time-based routing gives you the most sophisticated routing strategy possible in VOS3000.
โ๏ธ Feature
๐ LCR Routing Only
๐ VOS3000 Time-Based Routing
Gateway selection
Static priority-based
Dynamic, time-dependent
Rate table applied
Single rate table always
Different rate tables by time
Weekend handling
Same as weekday
Different routing and rates
Holiday handling
Same as any day
Custom holiday rates
Cost optimization
Lowest static cost
Lowest cost per time period
Manual intervention
Required for rate changes
Fully automatic switching
Profit potential
Good
Maximum
Understanding the VOS3000 Work Calendar System
The Work Calendar is the foundation of VOS3000 time-based routing. It defines what constitutes a working day, a non-working day, working hours, and non-working hours. These definitions are then used by the Package Period Rate system to determine which rate table and routing rules apply at any given moment. The Work Calendar is configured in the VOS3000 web interface under Navigation > System management > Work calendar (VOS3000 Manual Section 2.12.4, Page 174).
The Work Calendar system in VOS3000 is surprisingly powerful. It does not simply distinguish between “day” and “night” โ it allows you to define complex schedules that account for different working hours on different days of the week, designated holidays, and special non-working days. This granularity is what makes time-based routing so effective for wholesale VoIP operations that need to adapt to carrier rate schedules.
Work Calendar Configuration Fields
When you create a new Work Calendar entry, you need to understand each configuration field and how it affects your routing. Here is a detailed breakdown of the Work Calendar settings as documented in VOS3000 Manual Section 2.12.4 (Page 174-176):
Calendar Name: A descriptive name for the calendar. Choose a name that clearly indicates its purpose, such as “BD_Wholesale_Schedule” for a Bangladesh wholesale operation or “UK_Business_Hours” for UK-oriented traffic. The calendar name is referenced by other VOS3000 modules including Package Period Rate and account settings.
Working Day: Specify which days of the week are considered working days. Typically Monday through Friday are working days, while Saturday and Sunday are non-working days. However, in some regions, the work week differs, and VOS3000 allows you to configure any combination of days as working or non-working.
Working Hours: Define the start and end times for working hours on working days. For example, 08:00 to 18:00 means that calls between 8 AM and 6 PM on working days use the working-hour rate table and routing rules. The time format is 24-hour (HH:MM).
Non-Working Hours: The period outside the defined working hours on working days, plus all hours on non-working days. Non-working hours automatically use different rate tables and potentially different gateway priorities.
Holiday Settings: Designate specific dates as holidays, which are treated as non-working days regardless of which day of the week they fall on. This is essential for applying special holiday rates.
โ๏ธ Field
๐ Description
๐ก Example Value
๐ฏ Routing Impact
Calendar Name
Identifier for the calendar
BD_Wholesale_Schedule
Referenced by period rates and accounts
Working Days
Days classified as working
Mon-Fri
Applies working hour rates
Working Hours Start
Beginning of working period
08:00
Switches to daytime rate table
Working Hours End
End of working period
18:00
Switches to nighttime rate table
Holidays
Designated non-working dates
2026-01-01, 2026-03-26
Applies non-working day rates
Step-by-Step Work Calendar Configuration for VOS3000 Time-Based Routing
Now let us walk through the actual process of creating and configuring a Work Calendar for VOS3000 time-based routing. This step-by-step guide follows the interface described in VOS3000 Manual Section 2.12.4 (Page 174-176).
Step 1: Access the Work Calendar Interface
Log in to the VOS3000 web management interface with an administrator account. Navigate to Navigation > System management > Work calendar. The Work Calendar list page displays all existing calendars. From here, you can add, modify, or delete calendar entries.
To create a new calendar, click the Add button. A new calendar configuration form will appear with the fields described above.
Step 2: Define Calendar Name and Working Days
Enter a descriptive Calendar Name that reflects the purpose of this calendar. For time-based routing purposes, use names that clearly indicate the schedule type and target market. Examples include:
BD_PeakOffPeak: For Bangladesh traffic with peak/off-peak rate switching
UK_BusinessHours: For UK-destined traffic following UK business hours
Global_247_Weekend: For a global operation that only differentiates weekday vs. weekend
Holiday_Special_2026: For a calendar specifically designed for holiday rate management
Select the Working Days checkboxes to indicate which days of the week are working days. In most wholesale VoIP scenarios, Monday through Friday are working days because carrier rate structures typically differentiate between weekday and weekend rates.
Step 3: Set Working and Non-Working Hours
Define the Working Hours start and end times. The most common configuration for time-based routing is 08:00 to 18:00, which aligns with typical carrier peak-hour billing periods. However, you should check your vendor rate agreements to determine their exact peak and off-peak definitions.
Some important considerations when setting working hours:
Match vendor definitions: Your working hours must align with when your vendors charge peak rates. If a vendor defines peak hours as 09:00-21:00, set your working hours accordingly to avoid paying peak rates while applying off-peak rates to your customers.
Time zone awareness: Working hours should correspond to the time zone of your vendor or destination, not necessarily your local time zone. If you route traffic to the US but operate from Asia, your working hours should reflect US business hours.
Multiple calendars: Create separate calendars for different destination regions if they have different peak-hour definitions. You can then assign the appropriate calendar to each account or rate configuration.
Step 4: Configure Holiday Dates
Add specific dates as holidays in the Work Calendar. Holidays are treated as non-working days regardless of the day of the week. For time-based routing, holidays are important because many carriers offer special low rates on public holidays, similar to weekend rates.
To add a holiday, specify the date in the holiday list within the calendar configuration. You can add as many holidays as needed. Common holidays to include for Bangladesh-destined traffic include:
March 26 โ Independence Day
December 16 โ Victory Day
Eid ul-Fitr and Eid ul-Adha (variable dates)
January 1 โ New Year’s Day
For international operations, include the public holidays of your primary destination countries. Remember to update holiday dates annually as some holidays change each year.
Step 5: Save and Verify the Calendar
After configuring all fields, click Save to create the calendar. Verify the calendar appears in the Work Calendar list with the correct configuration. The calendar is now ready to be referenced by Package Period Rate configurations and account settings.
Configuring Package Period Rate Management for VOS3000 Time-Based Routing
The Work Calendar defines when different time periods occur, but it is the Package Period Rate Management that determines what actually happens during those periods. This is where you bind specific rate tables to working hours and non-working hours, creating the actual time-dependent billing and routing behavior. Navigate to Rate Management > Package Period Rate Management (VOS3000 Manual Section 2.3.2, Page 10-12).
Package Period Rate Management is the engine that drives time-based routing in VOS3000. Without it, the Work Calendar simply categorizes time periods but does not change any routing or billing behavior. The Package Period Rate configuration links a calendar to specific rate tables, ensuring that the correct rates are applied at the correct times automatically.
Package Period Rate Configuration Fields
When you create a Package Period Rate entry, you need to configure the following fields as described in VOS3000 Manual Section 2.3.2 (Page 10-12):
Period Rate Name: A descriptive name for this period rate configuration. Use names that clearly describe the rate switching behavior, such as “BD_DayNight_Switch” or “UK_PeakOffPeak_Rate”.
Work Calendar: Select the Work Calendar that defines the time periods for this configuration. The calendar determines which hours are working hours and which are non-working hours.
Working Hours Rate Table: Select the rate table that applies during working hours as defined by the selected calendar. This is typically your peak-hour rate table with higher rates.
Non-Working Hours Rate Table: Select the rate table that applies during non-working hours. This is typically your off-peak rate table with lower rates.
โ๏ธ Field
๐ Description
๐ฏ Purpose in Time-Based Routing
Period Rate Name
Identifier for the configuration
Links to account and rate group settings
Work Calendar
Reference to calendar definition
Determines when each period starts/ends
Working Hours Rate Table
Rate table for peak hours
Higher sell rates during business hours
Non-Working Hours Rate Table
Rate table for off-peak hours
Lower sell rates during nights/weekends
Step-by-Step Package Period Rate Configuration
Follow these steps to configure Package Period Rate Management for VOS3000 time-based routing:
Step 1: Navigate to Rate Management > Package Period Rate Management in the VOS3000 web interface.
Step 2: Click Add to create a new Package Period Rate entry.
Step 3: Enter the Period Rate Name. Use a descriptive name that indicates the routing purpose, such as “BD_Wholesale_DayNight”.
Step 4: Select the Work Calendar from the dropdown list. This should be the calendar you created earlier that defines the working and non-working hours for your target market.
Step 5: Select the Working Hours Rate Table from the dropdown. This rate table should contain your peak-hour selling rates. These rates are typically higher because vendor costs are higher during peak hours, and you need to maintain your margin.
Step 6: Select the Non-Working Hours Rate Table from the dropdown. This rate table should contain your off-peak selling rates. These can be lower while still maintaining profit margins because vendor costs are lower during off-peak hours.
Step 7: Click Save to create the Package Period Rate configuration.
After saving, the period rate configuration will automatically switch between the two rate tables based on the Work Calendar schedule. No manual intervention is required โ the system handles the switching seamlessly.
Binding Rate Tables for Daytime vs. Nighttime in VOS3000 Time-Based Routing
Creating effective rate table bindings is where time-based routing translates from configuration into actual financial results. The rate tables you bind to working and non-working hours determine exactly how much you charge customers during each period, directly affecting your profit margins.
Before configuring Package Period Rate bindings, you need to have both rate tables already created in Rate Management > Rate Table Management (VOS3000 Manual Section 2.2.2). Each rate table must contain rate entries for all the prefixes you plan to bill. For a comprehensive understanding of rate table setup, refer to our VOS3000 billing system guide.
Designing Daytime and Nighttime Rate Tables
The key principle for designing rate tables for this routing method is that each rate table must cover the same set of prefixes but with different rate values. The daytime rate table has higher rates that account for peak vendor costs plus your desired margin. The nighttime rate table has lower rates that reflect reduced vendor costs while still maintaining acceptable margins.
๐ข Prefix
๐ Destination
โ๏ธ Day Rate (08:00-18:00)
๐ Night Rate (18:00-08:00)
๐ฐ Rate Difference
88017
BD Grameenphone
$0.012/min
$0.008/min
33% lower
88018
BD Robi Mobile
$0.012/min
$0.008/min
33% lower
88019
BD Banglalink
$0.013/min
$0.009/min
31% lower
8802
BD Landline
$0.010/min
$0.005/min
50% lower
44
UK Landline
$0.008/min
$0.004/min
50% lower
1
USA/Canada
$0.005/min
$0.003/min
40% lower
Vendor Rate Table Considerations
While most operators focus on customer-facing sell rates when setting up time-based routing, you should also configure rate switching on the vendor (buy) side if your vendors offer different rates for peak and off-peak periods. This ensures that VOS3000 accurately calculates your margins in real time and can make better routing decisions.
To configure vendor-side period rates, create separate buy rate tables for peak and off-peak hours, then create a Package Period Rate configuration that binds these rate tables to the same Work Calendar. Assign this period rate configuration to your vendor accounts. When VOS3000 time-based routing switches the buy rate table at 18:00, the system immediately starts using the lower off-peak rates for cost calculations.
Practical Use Cases for VOS3000 Time-Based Routing
Understanding the configuration steps is important, but seeing how time-based routing applies to real-world scenarios helps you design the most effective routing strategy for your specific business. Here are three practical use cases that demonstrate the power and flexibility of time-based routing.
Use Case 1: Wholesale Traffic Day/Night Shifting
A wholesale VoIP operator routes traffic to Bangladesh, India, and the UK. Their vendors offer significantly different rates for peak and off-peak hours. During peak hours (08:00-18:00), VendorA offers the best rates for Bangladesh at $0.008/min, while VendorB is cheaper for UK traffic at $0.006/min. During off-peak hours, VendorC offers much lower rates across all destinations โ $0.004/min for Bangladesh and $0.003/min for the UK. However, VendorC has limited capacity and lower ASR during peak hours.
Without time-based routing, the operator would need to manually switch gateway priorities twice a day, which is error-prone and impractical. With time-based routing configured, the system automatically routes through VendorA and VendorB during peak hours and switches to VendorC during off-peak hours. This can save the operator thousands of dollars per month while maintaining optimal call quality during peak hours.
๐ Time Period
๐ข BD Gateway
๐ข UK Gateway
๐ฐ BD Rate
๐ฐ UK Rate
08:00-18:00 (Peak)
VendorA (Priority 1)
VendorB (Priority 1)
$0.008/min
$0.006/min
18:00-22:00 (Shoulder)
VendorC (Priority 1)
VendorC (Priority 1)
$0.005/min
$0.004/min
22:00-08:00 (Off-Peak)
VendorC (Priority 1)
VendorC (Priority 1)
$0.004/min
$0.003/min
Use Case 2: Weekend and Holiday Routing
Many carriers treat weekends and public holidays as extended off-peak periods, offering the same low rates as overnight hours. A VoIP operator who does not implement VOS3000 time-based routing for weekends is paying peak rates on Saturday and Sunday even though vendors charge off-peak rates. With the Work Calendar correctly defining Saturday and Sunday as non-working days, and holidays configured in the holiday list, VOS3000 automatically applies the non-working hours rate table for the entire weekend and on designated holidays.
This is especially valuable for operators handling call center traffic, which often has reduced or zero volume on weekends. By applying lower sell rates on weekends (matching the lower vendor costs), you can attract more weekend traffic from price-sensitive customers while still maintaining healthy margins.
Use Case 3: Multi-Timezone Routing
For operators routing traffic to multiple countries across different time zones, VOS3000 time-based routing becomes even more critical. When it is peak hours in Bangladesh (GMT+6), it might be off-peak in the UK (GMT+0) and late night in the US (GMT-5). A single Work Calendar cannot accurately represent peak hours for all destinations simultaneously.
The solution is to create multiple Work Calendars, each aligned to a specific destination’s time zone. Then create separate Package Period Rate configurations for each destination group. Assign the appropriate period rate to each customer account or rate group based on the destinations they call most frequently. While this requires more initial setup, the resulting routing precision can significantly increase profitability for multi-region operations.
Integrating Work Calendar with Account Settings in VOS3000 Time-Based Routing
The Work Calendar does not operate in isolation โ it integrates with several other VOS3000 modules to deliver complete VOS3000 time-based routing functionality. One of the most important integrations is with the account settings, where you can bind a Work Calendar to individual accounts for customized time-based behavior.
Account-Level Calendar Binding
In the account configuration (Operation Management > Account Operation), each account can be associated with a specific Work Calendar. This association affects how time-based routing behaves for that particular account. When an account has a Work Calendar assigned, the system uses that calendar’s definitions to determine whether the current time falls in working or non-working hours for rate and routing decisions specific to that account.
This is particularly useful when you have customers in different time zones. A customer based in the UK should have their account bound to a UK Work Calendar, while a customer in Bangladesh should use a BD Work Calendar. This ensures that each customer’s rates and routing are aligned with their local business hours, not yours.
Suppressing All Duration Too Long Alarm
An often-overlooked feature that integrates with the Work Calendar is the account setting “Suppressing all duration too long alarm” (VOS3000 Manual Section 2.5.2.3). This setting, when enabled for an account, suppresses alarm notifications for calls that exceed the configured maximum duration threshold. The relevance to VOS3000 time-based routing is that during non-working hours, long-duration calls are more common (especially for international traffic where people have extended conversations during off-peak rate periods).
Without this suppression, your alarm system would generate excessive notifications during nighttime and weekend hours, flooding your monitoring system with false alerts. By binding the Work Calendar to the account and enabling duration alarm suppression, VOS3000 can intelligently manage alarms based on time periods, reducing noise during expected long-call periods while maintaining alert sensitivity during working hours when unexpectedly long calls may indicate fraud or technical issues.
๐ง Feature
๐ Description
๐ฏ VOS3000 Time-Based Routing Impact
Account Calendar Binding
Links account to a Work Calendar
Per-account time-based rate switching
Duration Alarm Suppression
Suppresses long-call alarms
Reduces false alerts during off-peak
Period Rate Assignment
Binds period rate to account
Automatic rate table switching per account
Rate Group Authorization
Controls which rates accounts can use
Limits time-based rates to authorized accounts
VOS3000 Time-Based Routing and Gateway Priority Integration
While the Package Period Rate system handles rate table switching, the actual call routing (which gateway the call is sent through) is controlled by gateway priorities in the routing gateway configuration. For a complete time-based routing setup, you need to understand how rate switching interacts with gateway priority settings.
There are two primary approaches to implementing time-based gateway switching in VOS3000:
Approach 1: Period Rate with Fixed Gateway Priorities
In this approach, gateway priorities remain static, but the rate table changes based on time. This means that the same gateway is always used for a given prefix regardless of time, but the billing rate applied to the call changes. This is the simpler approach and works well when your vendor offers different rates for peak and off-peak but routes through the same gateway.
The advantage of this approach is simplicity โ you only need to configure the Package Period Rate, and the gateway configuration remains unchanged. The disadvantage is that you cannot route calls through different gateways based on time; you can only change the billing rates.
Approach 2: Period Rate with Dynamic Gateway Priorities
For more advanced VOS3000 time-based routing, you can combine period rates with different gateway priority configurations. This approach involves creating separate routing gateway entries with different priorities for working and non-working hours. While VOS3000 does not natively switch gateway priorities based on the Work Calendar directly, you can achieve similar results by:
Creating multiple rate groups โ one for peak hours with the peak-hour vendor as the preferred gateway, and one for off-peak hours with the off-peak vendor as preferred
Using the Package Period Rate to switch between these rate groups based on the Work Calendar
Configuring account settings to use the appropriate rate group based on the period
This approach requires more configuration but provides the most flexible and profitable time-based routing setup. The key insight is that when the period rate switches the rate table, the rate table can be associated with different gateway priority configurations, effectively changing which gateway handles the call.
For help setting up this advanced configuration, contact our VOS3000 specialists on WhatsApp at +8801911119966.
๐ฏ Approach
โ๏ธ Configuration Complexity
โ Advantages
โ ๏ธ Limitations
Fixed Gateway + Period Rates
Low
Simple setup, reliable
Cannot switch gateways by time
Dynamic Gateway + Period Rates
Medium-High
Full time-based routing control
Requires more configuration effort
Common VOS3000 Time-Based Routing Configuration Mistakes
Even experienced VOS3000 operators make mistakes when configuring time-based routing. These errors can result in incorrect billing, lost revenue, or routing failures. Here are the most common pitfalls and how to avoid them.
Mistake 1: Mismatched Working Hours Between Calendar and Vendor Definitions
If your Work Calendar defines working hours as 08:00-18:00, but your vendor defines peak hours as 09:00-21:00, you will be applying off-peak sell rates during the vendor’s peak period from 18:00-21:00. This means you are selling at off-peak rates but paying peak vendor costs, which erodes your margin or even causes losses. Always verify that your Work Calendar working hours match your vendor’s peak-hour definitions exactly.
Mistake 2: Incomplete Rate Tables
Both the working hours and non-working hours rate tables must contain rate entries for all prefixes that your customers might dial. If the daytime rate table has an entry for prefix 88017 but the nighttime rate table does not, calls to 88017 during nighttime hours will either fail to bill correctly or use a default rate that may be incorrect. Always ensure both rate tables have complete and matching prefix coverage.
Mistake 3: Forgetting to Update Holiday Dates
Holiday dates change every year, and some holidays (like Eid) move based on the lunar calendar. If you configure holidays in your Work Calendar but never update them, your time-based routing will treat old holidays as non-working days while actual holidays pass unrecognized. Set a recurring reminder to update holiday dates at the beginning of each year.
Mistake 4: Not Testing Time-Based Rate Switching
After configuring VOS3000 time-based routing, many operators fail to verify that the rate switching actually works. The result can be that rates never switch, or they switch at the wrong times. Always test by making test calls just before and after the working hours boundary and verifying in the CDR that the correct rate table was applied.
After configuring your Work Calendar and Package Period Rate, you must verify that VOS3000 time-based routing is working correctly. Verification involves both immediate testing and ongoing monitoring.
Immediate Verification Steps
Step 1: Check Calendar Status. Navigate to System Management > Work Calendar and verify your calendar appears in the list with the correct working days and hours. Click on the calendar to review all settings including holiday dates.
Step 2: Verify Period Rate Configuration. Navigate to Rate Management > Package Period Rate Management and confirm that your period rate entry shows the correct Work Calendar, working hours rate table, and non-working hours rate table.
Step 3: Make Test Calls. Make test calls during both working and non-working hours. After each test call, check the CDR record to verify that the correct rate table was applied. The CDR should show the rate from the working hours table during the day and the rate from the non-working hours table at night.
Step 4: Test Boundary Conditions. Make test calls at the exact boundary between working and non-working hours (for example, at 17:59 and 18:01) to verify that the rate switch happens at the correct time. This is where timing errors are most likely to appear.
Ongoing Monitoring for VOS3000 Time-Based Routing
Regular monitoring ensures that your VOS3000 time-based routing continues to function correctly over time. Key monitoring activities include:
Weekly CDR review: Sample CDRs from both working and non-working hours to confirm rate tables are switching correctly
Margin analysis: Compare working hours margins against non-working hours margins to verify that your time-based pricing is generating the expected profitability improvement
Gateway utilization reports: Monitor whether traffic distribution between gateways changes between working and non-working hours as expected
Holiday verification: Before each holiday, verify that the date is correctly configured in the Work Calendar
Once you have the basic time-based routing configuration working, several advanced techniques can further optimize your routing strategy and increase profitability.
Multiple Period Rate Configurations
VOS3000 allows you to create multiple Package Period Rate configurations, each with a different Work Calendar and different rate table bindings. This is essential for operations that serve customers across multiple time zones or with different pricing agreements. For example, you might have one period rate configuration for retail customers (who get a small off-peak discount) and another for wholesale customers (who get a larger off-peak discount).
Each period rate configuration is assigned to specific accounts or rate groups, ensuring that the correct time-based billing behavior applies to each customer segment.
Combining Time-Based Routing with Prefix-Based Rate Optimization
The most powerful routing strategies combine VOS3000 time-based routing with prefix-based rate optimization. For detailed prefix configuration, see our VOS3000 prefix settings guide. By having different rate tables for different prefix groups AND different time periods, you create a multi-dimensional pricing matrix that maximizes margin across every combination of destination and time.
For example, you might have four rate tables for Bangladesh mobile traffic:
BD_Mobile_Peak_Workday: Highest rates for weekday peak hours
BD_Mobile_OffPeak_Workday: Medium rates for weekday off-peak hours
BD_Mobile_Peak_Weekend: Lower rates for weekend daytime
BD_Mobile_OffPeak_Weekend: Lowest rates for weekend nighttime
By combining multiple Work Calendars and Package Period Rate configurations, you can implement this level of granular pricing control within VOS3000.
Using VOS3000 System Parameters to Support Time-Based Routing
Several VOS3000 system parameters affect how time-based routing behaves. Understanding these parameters helps you fine-tune the routing behavior:
SERVER_WORK_CALENDAR_ENABLED: This system parameter must be enabled for Work Calendar functionality to work. If this parameter is disabled, all time-based routing features are inactive regardless of your calendar configuration.
SERVER_PERIOD_RATE_ENABLED: This parameter must be enabled for Package Period Rate functionality to work. Without it, rate tables will not switch based on time periods.
Check these parameters in System Management > System Parameter (VOS3000 Manual Section 4.3) to ensure they are set correctly. If time-based routing is not working after configuration, these system parameters are the first thing to check.
Use this checklist to ensure you have completed all necessary steps for a fully functional VOS3000 time-based routing setup. Follow each step in order and verify the result before proceeding to the next step.
Create Work Calendar โ Define calendar name, working days, working hours, and holidays in System Management > Work Calendar
Create Daytime Rate Table โ Build a complete rate table with peak-hour rates for all prefixes in Rate Management > Rate Table Management
Create Nighttime Rate Table โ Build a matching rate table with off-peak rates for the same prefixes
Create Package Period Rate โ Bind the calendar and both rate tables in Rate Management > Package Period Rate Management
Enable System Parameters โ Verify SERVER_WORK_CALENDAR_ENABLED and SERVER_PERIOD_RATE_ENABLED are set to 1
Bind Calendar to Accounts โ Assign the Work Calendar to customer and vendor accounts that should use time-based routing
Assign Period Rate to Rate Groups โ Link the Package Period Rate to the appropriate rate groups
Test Rate Switching โ Make test calls during working and non-working hours and verify CDR rates
Test Boundary Conditions โ Verify rate switching happens at the exact configured time boundaries
Set Up Monitoring โ Establish regular CDR review and margin analysis procedures
Document Configuration โ Record all calendar and period rate settings for future reference
Schedule Annual Holiday Updates โ Set reminders to update holiday dates each year
Frequently Asked Questions About VOS3000 Time-Based Routing
โ What is VOS3000 time-based routing and how does it work?
VOS3000 time-based routing is a feature that automatically switches rate tables and routing behavior based on the time of day, day of the week, and calendar dates. It works through two integrated components: the Work Calendar (which defines working hours, non-working hours, and holidays) and the Package Period Rate (which binds different rate tables to each time period). When the current time falls within working hours as defined by the calendar, VOS3000 applies the working hours rate table. When it falls outside working hours, the non-working hours rate table is applied automatically.
โ How is VOS3000 time-based routing different from standard LCR routing?
Standard LCR routing uses static gateway priorities and rate tables that do not change based on time. VOS3000 time-based routing adds a time dimension, allowing different rate tables and potentially different routing priorities during different time periods. With LCR alone, the cheapest gateway for a destination is always used. With time-based routing, a different gateway may be cheapest at different times of day, and VOS3000 automatically adapts. The combination of LCR and time-based routing provides the most profitable routing strategy possible.
โ Can I use multiple Work Calendars for different time zones in VOS3000 time-based routing?
Yes. You can create multiple Work Calendars in VOS3000, each aligned to a different time zone’s peak and off-peak hours. Each calendar is then assigned to the appropriate accounts or rate groups based on the destinations they serve. This is the recommended approach for operators routing traffic to multiple countries across different time zones, as it ensures that rate switching happens at the correct local time for each destination.
โ Do I need to manually switch rate tables when using VOS3000 time-based routing?
No. The entire purpose of VOS3000 time-based routing is to automate rate table switching. Once you configure the Work Calendar and Package Period Rate correctly, VOS3000 automatically switches between the working hours and non-working hours rate tables at the boundaries defined in the calendar. No manual intervention is required, which eliminates the risk of forgetting to switch rates and the operational overhead of manual changes.
โ What happens if I do not bind a Work Calendar to an account?
If an account does not have a Work Calendar assigned, VOS3000 time-based routing will not apply to that account. The account will use its default rate table at all times, regardless of the time of day or day of the week. This means no rate switching occurs, and the account effectively operates with static LCR routing only. To enable time-based routing for an account, you must both create the Package Period Rate configuration and bind the appropriate calendar and period rate to the account.
โ How do I verify that VOS3000 time-based routing is switching rates correctly?
The most reliable verification method is to make test calls during both working and non-working hours, then check the CDR records for each call. The CDR will show which rate was applied to the call. If the working hours rate was applied during the day and the non-working hours rate was applied at night, your configuration is working correctly. Also test at the exact boundary times (for example, at 17:59 and 18:01) to confirm the switch happens at the right moment.
โ Can VOS3000 time-based routing handle different rates for weekends and holidays?
Yes. The Work Calendar distinguishes between working days and non-working days (which include weekends and designated holidays). Non-working days use the non-working hours rate table for the entire day, not just during nighttime. This means weekends and holidays automatically receive the lower off-peak rates all day long, which aligns with how most carriers price their services. You can add specific holiday dates to the calendar each year to ensure correct holiday rate application.
โ What system parameters must be enabled for VOS3000 time-based routing to work?
Two system parameters must be enabled: SERVER_WORK_CALENDAR_ENABLED (must be set to 1) enables the Work Calendar feature, and SERVER_PERIOD_RATE_ENABLED (must be set to 1) enables the Package Period Rate switching feature. If either of these parameters is disabled, the corresponding time-based routing functionality will not work, regardless of your calendar and period rate configuration. Verify these parameters in System Management > System Parameter (VOS3000 Manual Section 4.3).
Configure VOS3000 Time-Based Routing with Expert Help
Setting up VOS3000 time-based routing correctly can transform your VoIP business from one that pays static peak rates around the clock to one that dynamically optimizes costs based on time. The financial impact of proper time-based routing configuration is significant โ many operators report 15-30% reduction in termination costs after implementing day/night rate switching and weekend routing. However, the configuration requires careful attention to detail, from matching working hours to vendor definitions to ensuring complete prefix coverage in both rate tables.
Our VOS3000 specialists have helped operators worldwide implement and optimize time-based routing configurations. Whether you need help with initial Work Calendar setup, Package Period Rate configuration, advanced multi-timezone routing strategies, or troubleshooting an existing configuration that is not switching rates correctly, we are here to help.
๐ฑ Contact us on WhatsApp: +8801911119966
We offer complete VOS3000 time-based routing configuration services, including Work Calendar creation, rate table design, period rate binding, account integration, testing, and documentation. Let us help you unlock the full profit potential of time-based routing in your VOS3000 operation.
๐ Need Professional VOS3000 Setup Support?
For professional VOS3000 installations and deployment, VOS3000 Server Rental Solution: