VOS3000 SIP Authentication Retry, VOS3000 SIP Early Hangup, VOS3000 SIP Session Timer Refresh, VOS3000 Non-Timer Endpoint Safety, VOS3000 SIP NAT Keepalive, VOS3000 SIP Resend Interval, VOS3000 SIP INVITE Timeout, VOS3000 SIP Call Progress Timeout, VOS3000 SIP Outbound Registration Parameters, VOS3000 SIP Privacy Header, VOS3000 SIP Routing Gateway Contact, VOS3000 SIP Publish Expire, VOS3000 SIP Display From, VOS3000 SIP Send Unregister

VOS3000 SIP Routing Gateway Contact: Essential INVITE Header Guide

VOS3000 SIP Routing Gateway Contact: Essential INVITE Header Guide

๐Ÿ“ž When VOS3000 sends a SIP INVITE to a routing gateway, which header determines the callee number? Is it the To header, the Request-Line, or the Contact header? The answer depends on a critical โ€” yet often overlooked โ€” parameter: SS_SIP_ROUTING_GATEWAY_INVITE_USE_CONTACT, which governs the VOS3000 SIP routing gateway contact behavior for outbound INVITE messages. ๐ŸŽฏ

๐Ÿ”„ By default, this parameter is set to Off, meaning VOS3000 uses the standard SIP convention where the callee number is taken from the To header. But when enabled (On), VOS3000 extracts the callee number from the request-line of the INVITE and preserves the original number in the To field. This subtle change has a significant impact on how calls are routed through your VoIP softswitch โ€” especially when interfacing with gateways that rely on the Contact header or request-line for number identification. ๐Ÿ”ง

๐Ÿ“ก This guide covers everything you need to know about the VOS3000 SIP routing gateway contact setting โ€” from the core parameter SS_SIP_ROUTING_GATEWAY_INVITE_USE_CONTACT to the related per-gateway SIP settings (Reply address, Request address, Peer number information) and Mapping Gateway callee/caller field selection. All data is sourced exclusively from the official VOS3000 V2.1.9.07 Manual, Section 4.3.5.2 (Table 4-3). For expert assistance, contact us on WhatsApp at +8801911119966. ๐Ÿ’ก

Table of Contents

๐Ÿ” What Is VOS3000 SIP Routing Gateway Contact?

๐Ÿ“ž The VOS3000 SIP routing gateway contact parameter controls how VOS3000 constructs the SIP INVITE message when sending calls to a routing gateway. Specifically, it determines whether the callee number should be extracted from the request-line and whether the original number should be preserved in the To field. ๐Ÿ“‹

๐Ÿ“Œ According to the official VOS3000 V2.1.9.07 Manual, Table 4-3:

AttributeValue
๐Ÿ“Œ Parameter NameSS_SIP_ROUTING_GATEWAY_INVITE_USE_CONTACT
๐Ÿ”ข Default ValueOff
๐Ÿ“ DescriptionUse number from request-line as callee and keep original number in To field when send invite to callee
๐Ÿ”€ OptionsOn / Off
๐Ÿ“ NavigationOperation management โ†’ Softswitch management โ†’ Additional settings โ†’ SIP parameter

๐Ÿ’ก Key insight: When this parameter is set to Off (default), VOS3000 follows the standard SIP RFC 3261 convention โ€” the callee number in the INVITE is determined by the To header, and the request-line matches. When set to On, VOS3000 extracts the callee number from the request-line of the incoming SIP message and uses that for routing, while keeping the original number in the To field of the outbound INVITE. This is essential when upstream gateways manipulate the request-line during transit. ๐Ÿ“ก

๐ŸŽฏ Why VOS3000 SIP Routing Gateway Contact Matters

โš ๏ธ Understanding and correctly configuring this parameter is critical for several reasons:

  • ๐Ÿ“ž Number routing accuracy: If the callee number source does not match what the downstream gateway expects, calls may be routed to the wrong destination or rejected entirely
  • ๐Ÿ”„ To field preservation: Enabling this setting preserves the original dialed number in the To field, which is essential for billing, CDR accuracy, and troubleshooting
  • ๐Ÿ”— Gateway compatibility: Some SIP gateways and carrier equipment extract the callee number from the request-line rather than the To header โ€” this parameter ensures compatibility
  • ๐Ÿ“Š Call flow integrity: Mismatched headers can cause call failures, one-way audio, or incorrect number display on the receiving end
  • ๐Ÿ›ก๏ธ Interoperability: Different vendors implement SIP differently; this parameter gives you the flexibility to adapt VOS3000 to various gateway behaviors

โš™๏ธ How SS_SIP_ROUTING_GATEWAY_INVITE_USE_CONTACT Works

๐Ÿ”„ To understand this parameter, you need to see how the SIP INVITE message changes based on the setting. Here is a text-based comparison of the two modes: ๐Ÿ“ก

๐Ÿ“‹ SIP INVITE Message Structure โ€” SS_SIP_ROUTING_GATEWAY_INVITE_USE_CONTACT:

โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”
โฌ‡๏ธ Mode: OFF (Default)
โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”

INVITE sip:[email protected] SIP/2.0     โ† Request-Line
Via: SIP/2.0/UDP 10.0.0.1:5060
From: "Caller" <sip:[email protected]>;tag=abc
To: <sip:[email protected]>             โ† Callee = To header
Contact: <sip:[email protected]:5060>
Content-Type: application/sdp

๐Ÿ“Œ Result: Callee number = 8801234567 (from To header)
   Request-Line and To header contain the SAME number

โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”
โฌ‡๏ธ Mode: ON
โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”

INVITE sip:[email protected] SIP/2.0     โ† Request-Line (used for routing)
Via: SIP/2.0/UDP 10.0.0.1:5060
From: "Caller" <sip:[email protected]>;tag=abc
To: <sip:[email protected]>         โ† Original number PRESERVED
Contact: <sip:[email protected]:5060>
Content-Type: application/sdp

๐Ÿ“Œ Result: Callee number = 8801234567 (from Request-Line)
   To field keeps the ORIGINAL number (before any manipulation)

๐Ÿ“Š Critical distinction: When the parameter is On, the request-line contains the number that VOS3000 uses for actual routing (the callee number), while the To header retains the original dialed number before any prefix manipulation or routing transformation. This is extremely useful when VOS3000 applies prefix conversion rules โ€” the gateway receives the routing number in the request-line but the original number remains in the To field for reference. ๐ŸŽฏ

๐Ÿ“‹ Per-Gateway SIP Settings: Reply Address and Request Address

๐Ÿ”— Beyond the global SS_SIP_ROUTING_GATEWAY_INVITE_USE_CONTACT parameter, VOS3000 provides per-gateway SIP settings that control how reply and request signals are addressed. These settings are configured at the individual gateway level under Routing Gateway โ†’ Additional settings โ†’ Protocol โ†’ SIP. ๐Ÿ› ๏ธ

๐Ÿ“จ Reply Address: Where to Send Reply Signal

๐Ÿ“ฌ The Reply address setting determines where VOS3000 sends the reply signal after receiving a SIP request from the gateway. This is critical for ensuring SIP responses (such as 200 OK, 180 Ringing) reach the correct destination. ๐Ÿ“ก

OptionDescriptionRecommendation
๐ŸŸข SocketSend reply to the source IP and port from which the SIP request was receivedโœ… Recommended โ€” most reliable for NAT traversal
๐Ÿ”ต Via portSend reply to the port specified in the Via headerโš ๏ธ Use when gateway requires Via-based routing
๐ŸŸก ViaSend reply to the address and port in the Via headerโš ๏ธ Standard SIP behavior per RFC 3261

๐Ÿ’ก Best practice: The Socket option is recommended for the Reply address because it ensures SIP responses are sent back to the actual source of the request, which is critical for NAT traversal scenarios. For a deeper understanding of SIP signal flow, see our VOS3000 SIP call flow guide. ๐Ÿ“–

๐Ÿ“ค Request Address: Where to Send Request Signal

๐Ÿ“จ The Request address setting determines where VOS3000 sends the request signal after a call is established. This setting directly relates to the VOS3000 SIP routing gateway contact concept because it controls whether VOS3000 uses the Contact header or socket information for subsequent requests. ๐Ÿ”ง

OptionDescriptionRecommendation
๐ŸŸข SocketSend request to the source IP and port from which the SIP request was receivedโœ… Recommended โ€” most reliable
๐Ÿ”ต Contact PortSend request to the port specified in the Contact headerโš ๏ธ Use when gateway advertises a specific Contact port
๐ŸŸก ContactSend request to the full address in the Contact headerโš ๏ธ Standard SIP per RFC 3261

๐Ÿ”ง How this relates to the Contact header: The Request address setting determines how VOS3000 uses the Contact header for subsequent in-dialog requests (such as re-INVITE or BYE). When set to Contact, VOS3000 follows the SIP standard and sends requests to the URI in the Contact header. When set to Socket, VOS3000 uses the source socket address instead โ€” which can be more reliable in NAT scenarios. This is especially important when combined with SS_SIP_ROUTING_GATEWAY_INVITE_USE_CONTACT. ๐Ÿ“ก

๐Ÿ‘ค Peer Number Information: Caller Selection Mode

๐Ÿ“‹ The Peer number information setting in the Routing Gateway SIP configuration determines how VOS3000 selects the caller number from incoming SIP signals. This works in conjunction with the Contact and request-line settings to ensure proper number identification for both caller and callee. ๐ŸŽฏ

๐Ÿ“ž For complete gateway configuration details, see our VOS3000 gateway configuration routing mapping guide. ๐Ÿ”ง

๐Ÿ—บ๏ธ Mapping Gateway SIP Settings: Callee and Caller Field Selection

๐Ÿ”„ While the Routing Gateway settings control how VOS3000 sends INVITE messages, the Mapping Gateway settings control how VOS3000 receives and interprets incoming SIP signals. These are configured at Mapping Gateway โ†’ Additional settings โ†’ Protocol โ†’ SIP. ๐Ÿ“ก

๐Ÿ“ž Callee Number Field Selection

๐ŸŽฏ The Mapping Gateway provides a setting to determine which SIP field VOS3000 uses to extract the callee number from incoming INVITE messages. This is the inbound counterpart to SS_SIP_ROUTING_GATEWAY_INVITE_USE_CONTACT: ๐Ÿ“‹

Callee Source FieldDescriptionWhen to Use
๐Ÿ“ฉ ToExtract callee number from the SIP To headerโœ… Default โ€” standard SIP behavior, use when gateways follow RFC 3261
๐Ÿ“จ Request-LineExtract callee number from the SIP Request-Lineโš ๏ธ Use when upstream gateway modifies the request-line with the routing number

๐Ÿ’ก Critical relationship: The Mapping Gateway callee setting (To vs Request-Line) is the receiving side of the same concept that SS_SIP_ROUTING_GATEWAY_INVITE_USE_CONTACT handles on the sending side. If an upstream system sends INVITE messages where the request-line contains the routing number (different from the To header), you must configure the Mapping Gateway to extract the callee from the Request-Line. Similarly, if your downstream gateway expects the callee in the request-line, enable SS_SIP_ROUTING_GATEWAY_INVITE_USE_CONTACT. ๐Ÿ”„

๐Ÿ“ž Caller Number Field Selection

๐Ÿ‘ค The Mapping Gateway also provides settings for extracting the caller number from incoming SIP signals: ๐Ÿ“‹

Caller Source FieldDescriptionWhen to Use
๐Ÿ“ฉ FromExtract caller number from the SIP From headerโœ… Default โ€” standard SIP behavior
๐Ÿ†” Remote-Party-IDExtract caller number from the Remote-Party-ID headerโš ๏ธ Use when upstream gateway sends caller ID in RPID header
๐Ÿ–ฅ๏ธ DisplayExtract caller number from the Display name portion of the From headerโš ๏ธ Use when caller ID is in the display name, not the URI

๐Ÿ“ž Practical tip: When connecting to carrier gateways that manipulate caller ID through P-Asserted-Identity or Remote-Party-ID headers, configure the Mapping Gateway caller field accordingly. For more on caller ID management, see our VOS3000 callee rewrite rule and prefix conversion guide. ๐Ÿ”ง

๐Ÿ”„ VOS3000 SIP Routing Gateway Contact: Complete Signal Flow

๐Ÿ“Š To fully understand how SS_SIP_ROUTING_GATEWAY_INVITE_USE_CONTACT interacts with per-gateway settings, here is a complete signal flow diagram: ๐Ÿ“ก

๐Ÿ”„ VOS3000 SIP Routing Gateway Contact โ€” Complete Signal Flow:

โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”         โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”         โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
โ”‚  Calling      โ”‚  SIP    โ”‚   VOS3000    โ”‚  SIP    โ”‚  Routing     โ”‚
โ”‚  Endpoint     โ”‚ INVITE  โ”‚  Softswitch  โ”‚ INVITE  โ”‚  Gateway     โ”‚
โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜         โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜         โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜
       โ”‚                        โ”‚                         โ”‚
       โ”‚โ”€โ”€โ”€ INVITE โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ–บโ”‚                         โ”‚
       โ”‚   To: 8801234567       โ”‚                         โ”‚
       โ”‚   From: 8801999888     โ”‚                         โ”‚
       โ”‚                        โ”‚                         โ”‚
       โ”‚   ๐Ÿ“‹ Mapping Gateway:  โ”‚                         โ”‚
       โ”‚   Callee from: To/     โ”‚                         โ”‚
       โ”‚   Request-Line         โ”‚                         โ”‚
       โ”‚   Caller from: From/   โ”‚                         โ”‚
       โ”‚   RPID/Display         โ”‚                         โ”‚
       โ”‚                        โ”‚                         โ”‚
       โ”‚                        โ”‚ ๐Ÿ“ค SS_SIP_ROUTING_      โ”‚
       โ”‚                        โ”‚ GATEWAY_INVITE_USE_     โ”‚
       โ”‚                        โ”‚ CONTACT = ?             โ”‚
       โ”‚                        โ”‚                         โ”‚
       โ”‚                        โ”‚โ”€โ”€โ”€ INVITE โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ–บโ”‚
       โ”‚                        โ”‚   โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”  โ”‚
       โ”‚                        โ”‚   โ”‚ OFF (default):   โ”‚  โ”‚
       โ”‚                        โ”‚   โ”‚ Request-Line:    โ”‚  โ”‚
       โ”‚                        โ”‚   โ”‚   8801234567     โ”‚  โ”‚
       โ”‚                        โ”‚   โ”‚ To: 8801234567   โ”‚  โ”‚
       โ”‚                        โ”‚   โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜  โ”‚
       โ”‚                        โ”‚   โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”  โ”‚
       โ”‚                        โ”‚   โ”‚ ON:              โ”‚  โ”‚
       โ”‚                        โ”‚   โ”‚ Request-Line:    โ”‚  โ”‚
       โ”‚                        โ”‚   โ”‚   8801234567     โ”‚  โ”‚
       โ”‚                        โ”‚   โ”‚ To: ORIGINAL     โ”‚  โ”‚
       โ”‚                        โ”‚   โ”‚   (preserved)    โ”‚  โ”‚
       โ”‚                        โ”‚   โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜  โ”‚
       โ”‚                        โ”‚                         โ”‚
       โ”‚                        โ”‚ ๐Ÿ“จ Reply address:       โ”‚
       โ”‚                        โ”‚   Socket / Via port / Viaโ”‚
       โ”‚                        โ”‚ ๐Ÿ“ค Request address:     โ”‚
       โ”‚                        โ”‚   Socket / Contact Port โ”‚
       โ”‚                        โ”‚   / Contact             โ”‚
       โ”‚                        โ”‚                         โ”‚
       โ”‚โ—„โ”€โ”€ 200 OK โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”‚โ—„โ”€โ”€ 200 OK โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”‚
       โ”‚                        โ”‚                         โ”‚
       โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ดโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜

๐ŸŽฏ Key takeaway: The Mapping Gateway settings control what VOS3000 reads from incoming INVITE messages, while SS_SIP_ROUTING_GATEWAY_INVITE_USE_CONTACT and the per-gateway Reply/Request address settings control what VOS3000 writes into outgoing INVITE messages. For a comprehensive understanding of SIP session management, see our VOS3000 SIP session guide. ๐Ÿ“–

โš™๏ธ Step-by-Step VOS3000 SIP Routing Gateway Contact Configuration

๐Ÿ”ง Follow these steps to configure the VOS3000 SIP routing gateway contact and related settings on your system:

Step 1: Configure Global SS_SIP_ROUTING_GATEWAY_INVITE_USE_CONTACT ๐Ÿ“‹

  1. ๐Ÿ” Log in to VOS3000 Client with administrator credentials
  2. ๐Ÿ“Œ Navigate: Operation management โ†’ Softswitch management โ†’ Additional settings โ†’ SIP parameter
  3. ๐Ÿ” Locate SS_SIP_ROUTING_GATEWAY_INVITE_USE_CONTACT in the parameter list
  4. โœ๏ธ Set the value:
    • ๐ŸŸข Off (default) โ€” Standard SIP behavior; callee from To header
    • ๐Ÿ”ต On โ€” Use request-line number as callee; preserve original in To field
  5. ๐Ÿ’พ Save and apply the changes

Step 2: Configure Routing Gateway SIP Settings ๐Ÿ“ก

  1. ๐Ÿ“Œ Navigate: Operation management โ†’ Softswitch management โ†’ Routing gateway
  2. ๐Ÿ” Select the target routing gateway
  3. ๐Ÿ”ง Go to Additional settings โ†’ Protocol โ†’ SIP
  4. โš™๏ธ Configure the following settings:
    • ๐Ÿ“ฌ Reply address: Socket (recommended) / Via port / Via
    • ๐Ÿ“ค Request address: Socket (recommended) / Contact Port / Contact
    • ๐Ÿ‘ค Peer number information: Set caller number selection mode
  5. ๐Ÿ’พ Save gateway settings

Step 3: Configure Mapping Gateway SIP Settings ๐Ÿ—บ๏ธ

  1. ๐Ÿ“Œ Navigate: Operation management โ†’ Softswitch management โ†’ Mapping gateway
  2. ๐Ÿ” Select the target mapping gateway
  3. ๐Ÿ”ง Go to Additional settings โ†’ Protocol โ†’ SIP
  4. โš™๏ธ Configure the following settings:
    • ๐Ÿ“ž Callee: To / Request-Line โ€” determines which field VOS3000 reads for the callee number
    • ๐Ÿ‘ค Caller: From / Remote-Party-ID / Display โ€” determines which field VOS3000 reads for the caller number
  5. ๐Ÿ’พ Save mapping gateway settings

Step 4: Verify with SIP Debug ๐Ÿ”

๐Ÿ“ After configuration, verify the Contact header behavior by monitoring the SIP INVITE flow. Use the SIP debug tools to confirm that the request-line and To header are populated correctly. For comprehensive debugging techniques, see our VOS3000 SIP debug guide. ๐Ÿ”ง

๐Ÿ“Š VOS3000 SIP Routing Gateway Contact: When to Enable vs. Disable

๐ŸŽฏ The decision to enable or disable SS_SIP_ROUTING_GATEWAY_INVITE_USE_CONTACT depends on your specific gateway interoperability requirements. Here is a detailed comparison: ๐Ÿ’ก

AspectOff (Default)On
๐Ÿ“Œ Callee Number SourceTo headerRequest-Line
๐Ÿ”„ To Field ContentSame as request-line calleeOriginal number (preserved)
๐Ÿ“ž Request-LineMatches To headerContains routing number
๐Ÿ›ก๏ธ RFC 3261 Complianceโœ… Full complianceโš ๏ธ Modified behavior
๐Ÿ”ง Best ForStandard SIP gateways, carriers that follow RFC 3261Gateways that read callee from request-line, prefix conversion scenarios
๐Ÿ“Š Billing ImpactCDR shows final routing numberCDR can preserve original dialed number
๐Ÿ”— CompatibilityBroad โ€” works with most gatewaysSpecific โ€” needed for certain gateway types

๐Ÿ’ก Decision rule: Keep the default Off unless you encounter a specific gateway that routes based on the request-line callee number instead of the To header. Most modern SIP gateways follow RFC 3261 and use the To header. However, some legacy systems or carrier equipment may depend on the request-line โ€” in those cases, enable the parameter to On. For help identifying which mode your gateway requires, contact us on WhatsApp at +8801911119966. ๐Ÿ“ž

๐Ÿ“‹ VOS3000 SIP Routing Gateway Contact: Complete Gateway Settings Reference

๐Ÿ“Š Here is the complete reference for all per-gateway SIP settings related to the VOS3000 SIP routing gateway contact configuration: ๐Ÿ“–

SettingLocationOptionsRecommended
๐Ÿ“ฌ Reply addressRouting Gateway โ†’ Protocol โ†’ SIPSocket / Via port / Viaโœ… Socket
๐Ÿ“ค Request addressRouting Gateway โ†’ Protocol โ†’ SIPSocket / Contact Port / Contactโœ… Socket
๐Ÿ‘ค Peer number infoRouting Gateway โ†’ Protocol โ†’ SIPCaller selection modeDepends on gateway
๐Ÿ“ž Callee fieldMapping Gateway โ†’ Protocol โ†’ SIPTo / Request-LineTo (default)
๐Ÿ‘ค Caller fieldMapping Gateway โ†’ Protocol โ†’ SIPFrom / Remote-Party-ID / DisplayFrom (default)

๐Ÿ”ง For complete documentation on all SIP parameters, see our VOS3000 parameter description reference. ๐Ÿ“–

๐Ÿ“Š Deployment Best Practices by Gateway Type

๐ŸŽฏ Different gateway types require different configurations for the VOS3000 SIP routing gateway contact settings. Here are recommended configurations based on common deployment scenarios: ๐Ÿ’ก

Gateway TypeSS_SIP_ROUTING_GATEWAY_INVITE_USE_CONTACTCallee Field (Mapping)Reply / Request Address
๐Ÿข Standard SIP carrierOff (default)ToSocket / Socket
๐Ÿ”„ Legacy gateway (request-line routing)OnRequest-LineSocket / Socket
๐Ÿ“ž PSTN gateway (prefix conversion)OnRequest-LineSocket / Contact
๐Ÿ“ก NAT-traversed gatewayOff (default)ToSocket / Socket
๐ŸŒ Wholesale carrier (multiple prefixes)OnRequest-LineSocket / Contact

๐Ÿ’ก Key pattern: Enable SS_SIP_ROUTING_GATEWAY_INVITE_USE_CONTACT (On) when your gateway performs prefix conversion and you need the original number preserved in the To field while the routing number goes in the request-line. For more on prefix conversion, see our VOS3000 routing optimization guide. ๐Ÿ”ง

๐Ÿ›ก๏ธ Common VOS3000 SIP Routing Gateway Contact Problems and Solutions

โš ๏ธ Misconfigured Contact header settings can cause a range of call routing issues. Here are the most common problems and their solutions:

โŒ Problem 1: Calls Routed to Wrong Number After Prefix Conversion

๐Ÿ” Symptom: VOS3000 applies a prefix conversion rule, but the downstream gateway still routes the call using the original number instead of the converted number.

๐Ÿ’ก Cause: SS_SIP_ROUTING_GATEWAY_INVITE_USE_CONTACT is set to Off, so both the request-line and To header contain the original number. The gateway reads the To header and ignores the prefix conversion.

โœ… Solutions:

  • ๐Ÿ”ง Enable SS_SIP_ROUTING_GATEWAY_INVITE_USE_CONTACT to On
  • ๐Ÿ“ž This puts the converted (routing) number in the request-line while preserving the original in the To field
  • ๐Ÿ“Š Verify with SIP debug that the request-line contains the correct routing number

โŒ Problem 2: Gateway Rejects INVITE โ€” 404 Not Found

๐Ÿ” Symptom: Downstream gateway returns 404 Not Found for calls that should be routable, even though the callee number exists in the gateway’s routing table.

๐Ÿ’ก Cause: The gateway extracts the callee number from a different header than what VOS3000 is populating. For example, the gateway reads the request-line but VOS3000 is only populating the To header (parameter set to Off).

โœ… Solutions:

  • ๐Ÿ”ง Confirm which SIP field the downstream gateway uses for callee identification
  • ๐Ÿ“‹ If the gateway reads the request-line, enable SS_SIP_ROUTING_GATEWAY_INVITE_USE_CONTACT
  • ๐Ÿ“ก Check the gateway documentation or contact the carrier for their header requirements

โŒ Problem 3: CDR Shows Incorrect Original Number

๐Ÿ” Symptom: Call Detail Records show the routing number (with prefix) instead of the original dialed number, making billing reconciliation difficult.

๐Ÿ’ก Cause: SS_SIP_ROUTING_GATEWAY_INVITE_USE_CONTACT is Off, so the To header always contains the same number as the request-line โ€” no original number is preserved.

โœ… Solutions:

  • ๐Ÿ”„ Enable SS_SIP_ROUTING_GATEWAY_INVITE_USE_CONTACT to On โ€” this preserves the original number in the To field
  • ๐Ÿ“Š CDR systems can then read the original number from the To field for billing accuracy
  • ๐Ÿ“ž For billing system configuration, see our VOS3000 billing system guide

โŒ Problem 4: One-Way Audio After Enabling Contact Header Routing

๐Ÿ” Symptom: After enabling SS_SIP_ROUTING_GATEWAY_INVITE_USE_CONTACT, calls connect but audio only flows in one direction.

๐Ÿ’ก Cause: The Request address setting is configured to use Contact or Contact Port, and the Contact header in the gateway’s 200 OK response points to an incorrect or unreachable address.

โœ… Solutions:

  • ๐Ÿ”ง Change the Request address to Socket โ€” this ensures subsequent requests go to the actual source IP:port
  • ๐Ÿ“ก Verify the Contact header in the gateway’s responses using SIP debug
  • ๐Ÿ› ๏ธ If the gateway is behind NAT, Socket-based routing is more reliable than Contact-based routing
  • ๐Ÿ” For detailed troubleshooting steps, see our VOS3000 troubleshooting guide

๐Ÿ’ก VOS3000 SIP Routing Gateway Contact Configuration Checklist

โœ… Use this checklist when deploying or tuning your VOS3000 SIP routing gateway contact settings:

CheckActionStatus
๐Ÿ“Œ 1Determine if downstream gateway reads callee from To or Request-Lineโ˜
๐Ÿ“Œ 2Set SS_SIP_ROUTING_GATEWAY_INVITE_USE_CONTACT to On if gateway uses Request-Lineโ˜
๐Ÿ“Œ 3Configure Routing Gateway Reply address (Socket recommended)โ˜
๐Ÿ“Œ 4Configure Routing Gateway Request address (Socket recommended for NAT)โ˜
๐Ÿ“Œ 5Configure Mapping Gateway Callee field (To or Request-Line)โ˜
๐Ÿ“Œ 6Configure Mapping Gateway Caller field (From, Remote-Party-ID, or Display)โ˜
๐Ÿ“Œ 7Test with SIP debug โ€” verify INVITE header fields match expected valuesโ˜
๐Ÿ“Œ 8Verify CDR records show correct callee number for billingโ˜

๐Ÿ“ž Need help configuring your gateway Contact header settings? Contact our VOS3000 experts on WhatsApp at +8801911119966 for personalized assistance. ๐Ÿ”ง

โ“ Frequently Asked Questions

โ“ What is SS_SIP_ROUTING_GATEWAY_INVITE_USE_CONTACT in VOS3000?

๐Ÿ“‹ SS_SIP_ROUTING_GATEWAY_INVITE_USE_CONTACT is a VOS3000 SIP parameter that controls how the callee number is placed in outbound INVITE messages to routing gateways. When set to Off (default), VOS3000 follows standard SIP behavior where the To header and request-line contain the same callee number. When set to On, VOS3000 uses the number from the request-line as the callee for routing and keeps the original number in the To field. This is essential for gateways that read the callee from the request-line rather than the To header. ๐Ÿ”ง

โ“ When should I enable VOS3000 SIP routing gateway contact?

๐Ÿ”„ Enable SS_SIP_ROUTING_GATEWAY_INVITE_USE_CONTACT (On) when your downstream routing gateway extracts the callee number from the SIP request-line instead of the To header. This is common with legacy PSTN gateways, gateways that perform number manipulation, and carrier equipment that routes based on the INVITE request-line. You should also enable it when you apply prefix conversion rules and need the original dialed number preserved in the To field for billing and CDR accuracy. ๐Ÿ“ก

โ“ What is the difference between the Routing Gateway Contact setting and the Mapping Gateway Callee field?

๐Ÿ“Š These settings control opposite directions of SIP signaling. SS_SIP_ROUTING_GATEWAY_INVITE_USE_CONTACT (Routing Gateway) controls what VOS3000 writes into outbound INVITE messages โ€” it determines whether the callee comes from the request-line and whether the To field preserves the original number. The Mapping Gateway Callee field (To / Request-Line) controls what VOS3000 reads from inbound INVITE messages โ€” it determines which SIP field VOS3000 uses to extract the callee number from incoming calls. They work together to ensure proper number handling in both directions. ๐Ÿ”„

โ“ What does the Reply address Socket setting do in VOS3000?

๐Ÿ“ฌ The Reply address setting in the Routing Gateway SIP configuration determines where VOS3000 sends SIP response messages (such as 200 OK, 180 Ringing, 403 Forbidden) after receiving a request from the gateway. When set to Socket (recommended), VOS3000 sends replies to the source IP address and port of the incoming SIP request. When set to Via, it uses the address in the Via header. When set to Via port, it uses the port from the Via header. The Socket option is most reliable for NAT traversal scenarios. ๐Ÿ›ก๏ธ

โ“ How does the Request address setting relate to the Contact header?

๐Ÿ“ค The Request address setting controls where VOS3000 sends in-dialog SIP requests (like re-INVITE or BYE) after call establishment. When set to Contact, VOS3000 sends requests to the full URI in the Contact header of the gateway’s response. When set to Contact Port, it uses only the port from the Contact header. When set to Socket (recommended), it sends to the source IP:port of the received signal. This is closely related to the VOS3000 SIP routing gateway contact behavior because it determines how the Contact header is used for subsequent signaling. ๐Ÿ”ง

โ“ Can I configure SS_SIP_ROUTING_GATEWAY_INVITE_USE_CONTACT per gateway?

โš™๏ธ The SS_SIP_ROUTING_GATEWAY_INVITE_USE_CONTACT parameter is a global SIP parameter configured at the system level under Operation management โ†’ Softswitch management โ†’ Additional settings โ†’ SIP parameter. However, the related per-gateway settings (Reply address, Request address, Peer number information for Routing Gateways; Callee and Caller field selection for Mapping Gateways) are configured at the individual gateway level. This means the base Contact header behavior is global, but the specific address routing and field selection can be customized per gateway. For system-level parameter documentation, see VOS3000 system parameters. ๐Ÿ“–

โ“ What happens to the To field when VOS3000 SIP routing gateway contact is enabled?

๐Ÿ“ž When SS_SIP_ROUTING_GATEWAY_INVITE_USE_CONTACT is set to On, VOS3000 preserves the original callee number in the To field of the outbound INVITE. The request-line contains the number that VOS3000 uses for actual routing (which may include prefix modifications or routing transformations), while the To field retains the original dialed number before any manipulation. This dual-number approach ensures that downstream gateways can route using the request-line number while billing and CDR systems can reference the original number from the To field. ๐ŸŽฏ

๐Ÿ”— Explore these related VOS3000 guides for deeper understanding:


๐Ÿ“ž Need Professional VOS3000 Setup Support?

For professional VOS3000 installations and deployment, VOS3000 Server Rental Solution:

๐Ÿ“ฑ WhatsApp: +8801911119966
๐ŸŒ Website: www.vos3000.com
๐ŸŒ Blog: multahost.com/blog
๐Ÿ“ฅ Downloads: VOS3000 Downloads


VOS3000 SIP Authentication Retry, VOS3000 SIP Early Hangup, VOS3000 SIP Session Timer Refresh, VOS3000 Non-Timer Endpoint Safety, VOS3000 SIP NAT Keepalive, VOS3000 SIP Resend Interval, VOS3000 SIP INVITE Timeout, VOS3000 SIP Call Progress Timeout, VOS3000 SIP Outbound Registration Parameters, VOS3000 SIP Privacy Header, VOS3000 SIP Routing Gateway Contact, VOS3000 SIP Publish Expire, VOS3000 SIP Display From, VOS3000 SIP Send UnregisterVOS3000 SIP Authentication Retry, VOS3000 SIP Early Hangup, VOS3000 SIP Session Timer Refresh, VOS3000 Non-Timer Endpoint Safety, VOS3000 SIP NAT Keepalive, VOS3000 SIP Resend Interval, VOS3000 SIP INVITE Timeout, VOS3000 SIP Call Progress Timeout, VOS3000 SIP Outbound Registration Parameters, VOS3000 SIP Privacy Header, VOS3000 SIP Routing Gateway Contact, VOS3000 SIP Publish Expire, VOS3000 SIP Display From, VOS3000 SIP Send UnregisterVOS3000 SIP Authentication Retry, VOS3000 SIP Early Hangup, VOS3000 SIP Session Timer Refresh, VOS3000 Non-Timer Endpoint Safety, VOS3000 SIP NAT Keepalive, VOS3000 SIP Resend Interval, VOS3000 SIP INVITE Timeout, VOS3000 SIP Call Progress Timeout, VOS3000 SIP Outbound Registration Parameters, VOS3000 SIP Privacy Header, VOS3000 SIP Routing Gateway Contact, VOS3000 SIP Publish Expire, VOS3000 SIP Display From, VOS3000 SIP Send Unregister
VOS3000 SIP Authentication Retry, VOS3000 SIP Early Hangup, VOS3000 SIP Session Timer Refresh, VOS3000 Non-Timer Endpoint Safety, VOS3000 SIP NAT Keepalive, VOS3000 SIP Resend Interval, VOS3000 SIP INVITE Timeout, VOS3000 SIP Call Progress Timeout, VOS3000 SIP Outbound Registration Parameters, VOS3000 SIP Privacy Header, VOS3000 SIP Routing Gateway Contact, VOS3000 SIP Publish Expire, VOS3000 SIP Display From, VOS3000 SIP Send Unregister

VOS3000 SIP Outbound Registration Parameters: Expiry and Retry Delay Easy Guide

VOS3000 SIP Outbound Registration Parameters: Expiry and Retry Delay Guide

โฑ๏ธ Two parameters control the entire lifecycle of VOS3000’s outbound SIP registration: SS_SIP_USER_AGENT_EXPIRE determines how long your registration stays valid, and SS_SIP_USER_AGENT_RETRY_DELAY determines how quickly VOS3000 recovers when registration fails. Together, these VOS3000 SIP outbound registration parameters govern whether your SIP trunks stay connected or silently go offline โ€” and most operators never realize the connection until calls start failing. ๐Ÿ“‰

๐Ÿ”ง When VOS3000 registers outbound to another server (a wholesale carrier, upstream provider, or peer softswitch), the registration expiry controls how often VOS3000 must refresh its registration, while the retry delay controls recovery timing when things go wrong. Set the expiry too long behind NAT and your pinhole closes, killing inbound calls silently. Set the retry delay too low and you flood the upstream server with registration attempts. Set it too high and your trunk stays down for minutes when it could have recovered in seconds. โš–๏ธ

๐Ÿ“ž This guide covers both parameters in detail โ€” from the Auto Negotiation behavior of SS_SIP_USER_AGENT_EXPIRE (default: Auto, range: 20โ€“7200 seconds) to the failover timing of SS_SIP_USER_AGENT_RETRY_DELAY (default: 60 seconds, range: 30โ€“600 seconds) โ€” plus the companion parameters for clean disconnection, privacy, and endpoint-side registration handling. All data is sourced exclusively from the official VOS3000 V2.1.9.07 Manual, Section 4.3.5.2 (Tables 4-3 and 4-4). For expert assistance, contact us on WhatsApp at +8801911119966. ๐Ÿ’ก

Table of Contents

๐Ÿ” What Are the VOS3000 SIP Outbound Registration Parameters?

๐Ÿ“ก The VOS3000 SIP outbound registration parameters control how VOS3000 registers to external SIP servers. When VOS3000 acts as a SIP User Agent and registers to another server, two timing parameters govern the complete registration lifecycle: ๐Ÿ“‹

ParameterDefaultRangePurpose
๐Ÿ“Œ SS_SIP_USER_AGENT_EXPIREAuto Negotiation20โ€“7200 secondsSIP Registration Expiration Time to Other Server
๐Ÿ”„ SS_SIP_USER_AGENT_RETRY_DELAY6030โ€“600 secondsResend Interval for SIP Registration when Failed

๐Ÿ“ Both parameters are located at: Navigation โ†’ Operation management โ†’ Softswitch management โ†’ Additional settings โ†’ SIP parameter

๐Ÿ”‘ Critical distinction: These parameters only apply to VOS3000’s outbound SIP registration โ€” when VOS3000 registers to another server. They do not control how VOS3000 handles inbound registrations from your own endpoints. For inbound registration handling, see VOS3000 SIP registration configuration. ๐Ÿ“ก

โฑ๏ธ SS_SIP_USER_AGENT_EXPIRE โ€” Registration Expiry

๐Ÿ“ก The SS_SIP_USER_AGENT_EXPIRE parameter controls the SIP registration expiration time when VOS3000 registers to other servers. With a default of Auto Negotiation and a configurable range of 20โ€“7200 seconds, this setting is one of the most important parameters for maintaining stable outbound SIP trunking. Too short, and you flood the remote server with REGISTER messages. Too long, and NAT firewalls close the pinhole before re-registration occurs. โš–๏ธ

AttributeValue
๐Ÿ“Œ Parameter NameSS_SIP_USER_AGENT_EXPIRE
๐Ÿ”ข Default ValueAuto Negotiation
๐Ÿ“ Range20โ€“7200 seconds
๐Ÿ“ DescriptionSIP Registration Expiration Time to Other Server
๐Ÿ“ NavigationOperation management โ†’ Softswitch management โ†’ Additional settings โ†’ SIP parameter

๐Ÿ”„ Auto Negotiation vs. Fixed Expiry โ€” How It Works

โš™๏ธ The default “Auto Negotiation” mode follows a simple but effective principle: let the remote server decide. Here is how the negotiation process works: ๐Ÿ“ก

๐Ÿ“ก VOS3000 SIP Registration Expiry โ€” Auto Negotiation Flow:

VOS3000 โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€ Remote SIP Server
   โ”‚                                       โ”‚
   โ”‚โ”€โ”€โ”€โ”€ REGISTER (Contact: expires=X) โ”€โ”€โ–บโ”‚
   โ”‚                                       โ”‚
   โ”‚โ—„โ”€โ”€โ”€ 200 OK (Contact: expires=Y) โ”€โ”€โ”€โ”€โ”€โ”‚
   โ”‚                                       โ”‚
   โ”‚  โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”  โ”‚
   โ”‚  โ”‚ Auto Negotiation Mode:          โ”‚  โ”‚
   โ”‚  โ”‚ โ€ข VOS3000 sends requested       โ”‚  โ”‚
   โ”‚  โ”‚   expiry (X) in REGISTER        โ”‚  โ”‚
   โ”‚  โ”‚ โ€ข Remote server responds with   โ”‚  โ”‚
   โ”‚  โ”‚   accepted expiry (Y) in 200 OK โ”‚  โ”‚
   โ”‚  โ”‚ โ€ข VOS3000 uses Y as the         โ”‚  โ”‚
   โ”‚  โ”‚   effective registration expiry โ”‚  โ”‚
   โ”‚  โ”‚ โ€ข Re-registration before Y      โ”‚  โ”‚
   โ”‚  โ”‚   seconds elapse                โ”‚  โ”‚
   โ”‚  โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜  โ”‚
   โ”‚                                       โ”‚
   โ”‚  โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”  โ”‚
   โ”‚  โ”‚ Fixed Expiry Mode:              โ”‚  โ”‚
   โ”‚  โ”‚ โ€ข VOS3000 forces specified      โ”‚  โ”‚
   โ”‚  โ”‚   value (e.g., 300 seconds)     โ”‚  โ”‚
   โ”‚  โ”‚ โ€ข VOS3000 re-registers at       โ”‚  โ”‚
   โ”‚  โ”‚   ~50% of configured expiry     โ”‚  โ”‚
   โ”‚  โ”‚   to prevent lapses             โ”‚  โ”‚
   โ”‚  โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜  โ”‚
Expiry ModeWho Decides ExpiryBest ForRisk
๐Ÿค Auto NegotiationRemote server (200 OK)General use, unknown providersโš ๏ธ NAT pinhole may close if server proposes long expiry
๐Ÿ“Œ Fixed Value (e.g., 300s)VOS3000 (you control it)NAT environments, predictable timingโš ๏ธ Value may conflict with remote server’s minimum/maximum

๐Ÿ’ก NAT pro tip: If VOS3000 is behind a NAT firewall and registering to an external server, always set a fixed registration expiry of 120โ€“300 seconds rather than using Auto Negotiation. If the remote server proposes a long expiry (e.g., 3600 seconds), your NAT mapping may expire before the next re-registration, silently breaking inbound calls. This is the single most common cause of “my trunk works for a while and then stops” complaints. ๐Ÿ”ง

๐Ÿ”„ SS_SIP_USER_AGENT_RETRY_DELAY โ€” Registration Failure Retry

โฑ๏ธ When an outbound registration fails (e.g., the remote server returns 403 Forbidden, 401 Unauthorized, or is simply unreachable), VOS3000 waits SS_SIP_USER_AGENT_RETRY_DELAY seconds before attempting to re-register. The default is 60 seconds with a range of 30โ€“600 seconds. ๐Ÿ”

AttributeValue
๐Ÿ“Œ Parameter NameSS_SIP_USER_AGENT_RETRY_DELAY
๐Ÿ”ข Default Value60
๐Ÿ“ Range30โ€“600 seconds
๐Ÿ“ DescriptionResend Interval for SIP Registration when Failed
๐Ÿ“ NavigationOperation management โ†’ Softswitch management โ†’ Additional settings โ†’ SIP parameter

๐Ÿ“Š Key behavior: VOS3000 does not implement exponential backoff for registration retries. Each failed attempt waits the same fixed SS_SIP_USER_AGENT_RETRY_DELAY interval before retrying. This means if you set the delay to 60 seconds, VOS3000 will attempt re-registration every 60 seconds consistently until the registration succeeds. โฑ๏ธ

๐Ÿ”„ Retry Delay vs. Registration Expiry โ€” Key Difference

โš ๏ธ A common source of confusion is the difference between these two parameters: ๐ŸŽฏ

AspectSS_SIP_USER_AGENT_RETRY_DELAYSS_SIP_USER_AGENT_EXPIRE
๐Ÿ“Œ PurposeWait time after registration failureRegistration validity duration on success
๐Ÿ”ข Default60 secondsAuto Negotiation (20โ€“7200s)
๐Ÿ”„ Triggered WhenRegistration FAILS (timeout, 403, 503, etc.)Registration SUCCEEDS (200 OK received)
๐Ÿ“Š EffectDetermines re-registration attempt intervalDetermines when VOS3000 refreshes a valid registration

๐Ÿ’ก Simple rule: Retry delay governs “how long to wait before trying again after failure.” Expiry governs “how long my successful registration remains valid before I need to refresh it.” For more on the expiry parameter, see our outbound registration SIP guide. ๐Ÿ“ก

๐Ÿ“‹ Companion User Agent Registration Parameters

๐Ÿ”— The expiry and retry delay do not work alone. Two additional parameters control the unregistration and privacy behavior of outbound registrations: ๐Ÿ›ก๏ธ

ParameterDefaultOptionsDescription
๐Ÿ“ค SS_SIP_USER_AGENT_SEND_UNREGISTEROnOn / OffSend Cancel Register Message on restart/shutdown
๐Ÿ”’ SS_SIP_USER_AGENT_PRIVACYIgnoreIgnore / Id / NonePrivacy Setting for Register User

๐Ÿ”Œ SS_SIP_USER_AGENT_SEND_UNREGISTER: When this parameter is On (the default), VOS3000 sends a SIP REGISTER with Expires: 0 to the remote server when the registration is removed or the system shuts down. This cleanly de-registers VOS3000, freeing resources on both sides. Keep this On โ€” disabling it means the remote server retains the registration until it naturally expires, which can cause the remote server to route calls to a VOS3000 that is no longer available. For more on how authentication interacts with registration, see our VOS3000 SIP authentication guide. ๐Ÿ”

๐Ÿ›ก๏ธ SS_SIP_USER_AGENT_PRIVACY: Controls how the SIP Privacy header is included in outbound REGISTER messages. The default Ignore means VOS3000 does not include any Privacy header. Id includes “Privacy: id” to request identity privacy. None includes “Privacy: none” to explicitly request no privacy handling. ๐Ÿ”’

๐Ÿ“ก Endpoint Registration Expiry โ€” The Other Side of the Coin

๐Ÿ”„ While SS_SIP_USER_AGENT_EXPIRE controls how VOS3000 registers to other servers, the endpoint registration parameters control how external devices register to VOS3000. Understanding the difference is critical for proper VOS3000 SIP outbound registration parameters management. โš–๏ธ

AspectUser Agent Expiry (Outbound)Endpoint Expiry (Inbound)
๐Ÿ“Œ ParameterSS_SIP_USER_AGENT_EXPIRESS_ENDPOINT_EXPIRE / SS_ENDPOINT_NAT_EXPIRE
๐Ÿ“ก DirectionVOS3000 โ†’ Other ServerDevice โ†’ VOS3000
๐Ÿ”ข DefaultAuto Negotiation300 / 3600 (NAT: 300)
โš ๏ธ Failure ImpactOutbound/inbound calls via that trunk failDevice appears unregistered, cannot receive calls

๐Ÿ’ก Rule of thumb: If VOS3000 is registering to someone else, think SS_SIP_USER_AGENT_EXPIRE. If someone is registering to VOS3000, think SS_ENDPOINT_EXPIRE. For detailed coverage of endpoint-side registration, see our registration flood protection guide. ๐ŸŒ

๐Ÿ” System-Level Endpoint Retry Parameters

๐Ÿ“Š While SS_SIP_USER_AGENT_RETRY_DELAY controls VOS3000’s outbound registration retries, VOS3000 also provides system-level parameters that govern inbound terminal registration failure handling: ๐Ÿ“‹

ParameterDefaultDescription
SS_ENDPOINT_REGISTER_RETRY6Max retry times when terminal registration
SS_ENDPOINT_REGISTER_SUSPEND180Disable duration after exceeding retry times
SS_ENDPOINT_REGISTER_REPLACEOnAllow replace current registered users

๐Ÿ“ž For detailed configuration of endpoint registration behavior and suspension, see our VOS3000 authentication suspend guide. For system-level parameter documentation, refer to VOS3000 system parameters. ๐Ÿ“–

๐Ÿ”„ VOS3000 SIP Outbound Registration and Server Redundancy

๐Ÿ–ฅ๏ธ One of the most critical applications of the VOS3000 SIP outbound registration parameters is in server redundancy and failover scenarios. When VOS3000 is configured to register with an upstream SIP proxy and that proxy becomes unavailable, the retry delay determines how quickly VOS3000 attempts to re-establish the registration โ€” which directly impacts your call routing availability. ๐ŸŒ

๐Ÿ“ก Failover Timing Analysis

โฑ๏ธ Consider a scenario where VOS3000 is registered to a primary SIP trunk and the upstream server goes down. Here is how the retry delay affects recovery time: ๐Ÿ“Š

Retry DelayFirst Retry AfterMax Downtime (5 retries)Network LoadBest For
30s (minimum)30 seconds~2.5 minutes๐Ÿ”ด Higherโšก Mission-critical trunks
60s (default)60 seconds~5 minutes๐ŸŸก Moderate๐Ÿ“Š Standard deployments
120s120 seconds~10 minutes๐ŸŸข Lower๐Ÿข Stable enterprise links
300s5 minutes~25 minutes๐ŸŸข Very Low๐Ÿ“ก Backup trunks only

๐ŸŽฏ Failover strategy: For primary SIP trunks where call availability is critical, use the minimum 30-second retry delay. For backup or secondary trunks, a longer delay (120-300 seconds) reduces unnecessary network traffic. For a complete failover setup guide, see our VOS3000 vendor failover setup. ๐Ÿ›ก๏ธ

๐Ÿ”ง Step-by-Step VOS3000 SIP Outbound Registration Configuration

โš™๏ธ Follow these steps to configure both outbound registration parameters and their companions:

Step 1: Configure Global SS_SIP_USER_AGENT_EXPIRE ๐Ÿ“‹

  1. ๐Ÿ” Log in to VOS3000 Client
  2. ๐Ÿ“Œ Navigate: Operation management โ†’ Softswitch management โ†’ Additional settings โ†’ SIP parameter
  3. ๐Ÿ” Locate SS_SIP_USER_AGENT_EXPIRE in the parameter list
  4. โœ๏ธ Choose Auto Negotiation (default) or set a specific value between 20โ€“7200 seconds
  5. ๐Ÿ’พ Save and apply the changes

Step 2: Configure SS_SIP_USER_AGENT_RETRY_DELAY ๐Ÿ”„

  1. ๐Ÿ“Œ In the same SIP parameter section, locate SS_SIP_USER_AGENT_RETRY_DELAY
  2. โœ๏ธ Set the desired value (range: 30โ€“600 seconds, default: 60)
  3. ๐Ÿ’พ Save changes

Step 3: Configure Companion Parameters ๐Ÿ”—

  1. ๐Ÿ” Verify SS_SIP_USER_AGENT_SEND_UNREGISTER is On (default) for clean disconnection
  2. ๐Ÿ” Set SS_SIP_USER_AGENT_PRIVACY to Ignore (default) unless provider requires a specific privacy header
  3. ๐Ÿ’พ Save all changes

Step 4: Configure Per-Registration Settings ๐Ÿ–ฅ๏ธ

  1. ๐Ÿ“Œ Navigate to the outbound registration management page
  2. ๐Ÿ” Select the registration entry for your upstream provider
  3. โœ๏ธ Configure Register period โ€” choose Auto negotiation or a specific value
  4. ๐Ÿ”Œ Set the Signaling port of the remote registration server
  5. ๐ŸŒ Enter the SIP proxy address
  6. ๐Ÿ’พ Save the registration settings

Step 5: Verify Registration with SIP Debug ๐Ÿ”

๐Ÿ“ After configuration, verify the registration is working correctly. For comprehensive debugging instructions, see our VOS3000 troubleshooting guide. ๐Ÿ”ง

๐Ÿ“Š VOS3000 SIP Outbound Registration Best Practices by Scenario

๐ŸŽฏ Different deployment scenarios require different registration expiry and retry delay combinations. Here are our recommendations: ๐Ÿ’ก

ScenarioExpiryRetry DelayRationale
๐ŸŒ NAT environment120โ€“300 seconds30โ€“60 secondsShort enough to keep NAT pinhole open; long enough to avoid flooding
๐Ÿข Same LAN / data center600โ€“3600 seconds60 secondsNo NAT concerns; longer expiry reduces REGISTER traffic
๐Ÿ“ก Wholesale carrier trunkAuto Negotiation60 secondsLet the carrier decide; they know their requirements best
๐Ÿ›ก๏ธ Unstable network link60โ€“120 seconds30 secondsFast recovery; short retry delay for quick re-registration after link recovery
๐Ÿ”Œ Multiple trunks to same provider300โ€“600 seconds60 secondsModerate expiry; avoid all trunks re-registering simultaneously
๐Ÿ”„ Primary SIP trunk (carrier)120โ€“300 seconds30โ€“45 secondsFast recovery needed; minimize call disruption on primary routes

๐Ÿ›ก๏ธ Common VOS3000 SIP Outbound Registration Problems and Solutions

โš ๏ธ Misconfigured outbound registration parameters cause a range of issues. Here are the most common problems and their solutions:

โŒ Problem 1: Trunk Works Then Silently Stops Receiving Calls

๐Ÿ” Symptom: Outbound calls work fine, but inbound calls via the trunk start failing after some time (typically 5โ€“30 minutes after registration).

๐Ÿ’ก Cause: VOS3000 is behind NAT and the registration expiry is too long. The NAT firewall closes the UDP pinhole before VOS3000 re-registers. ๐ŸŒ

โœ… Solutions:

  • ๐Ÿ”ง Change SS_SIP_USER_AGENT_EXPIRE from Auto Negotiation to a fixed value of 120โ€“300 seconds
  • ๐Ÿ“ก Verify NAT keep-alive is enabled โ€” see our SIP session guide for session timer settings
  • ๐Ÿ” Check SIP debug to confirm re-registration occurs before the NAT mapping expires

โŒ Problem 2: Excessive REGISTER Messages Flooding the Network

๐Ÿ” Symptom: SIP traces show VOS3000 sending REGISTER messages every few seconds, even when the registration is successful.

๐Ÿ’ก Cause: SS_SIP_USER_AGENT_EXPIRE is set to a very low value (e.g., 20 seconds), causing VOS3000 to re-register extremely frequently. ๐Ÿ“Š

โœ… Solutions:

  • โฑ๏ธ Increase SS_SIP_USER_AGENT_EXPIRE to at least 120 seconds
  • ๐Ÿ“‹ Check if Auto Negotiation is resulting in a very short server-proposed expiry
  • ๐Ÿ”„ If the provider requires short expiry, verify SS_SIP_USER_AGENT_RETRY_DELAY is not adding unnecessary re-registration attempts

โŒ Problem 3: Registration Fails and Never Recovers

๐Ÿ” Symptom: After a network outage or server restart, VOS3000 does not re-register to the remote server.

๐Ÿ’ก Cause: SS_SIP_USER_AGENT_RETRY_DELAY may be set too high, or the authentication credentials may be wrong. ๐Ÿ”

โœ… Solutions:

  • ๐Ÿ”„ Set SS_SIP_USER_AGENT_RETRY_DELAY to 60 seconds for reasonable retry timing
  • ๐Ÿ” Verify SIP authentication credentials are correct โ€” see our SIP authentication guide
  • ๐Ÿ“‹ Check if the remote server has blocked your IP due to excessive registration failures

โŒ Problem 4: Registration Flooding โ€” Upstream Server Blocks VOS3000

๐Ÿ” Symptom: Upstream carrier reports excessive registration requests from your VOS3000; possibly blocks your IP or suspends your trunk.

๐Ÿ’ก Cause: SS_SIP_USER_AGENT_RETRY_DELAY is set too low (30 seconds) and the upstream server is experiencing transient issues, causing VOS3000 to send a REGISTER every 30 seconds continuously.

โœ… Solutions:

  • ๐Ÿ”ง Increase SS_SIP_USER_AGENT_RETRY_DELAY to 60โ€“120 seconds
  • ๐Ÿ“ž Contact the upstream carrier to understand their registration rate limits
  • ๐Ÿ“Š Monitor registration attempt frequency in VOS3000 logs

๐Ÿ“‹ Complete VOS3000 Registration Parameter Quick Reference

๐Ÿ“Š Here is the complete reference for all parameters that govern SIP registration behavior in VOS3000 โ€” both outbound (User Agent) and inbound (Endpoint): ๐Ÿ“‹

ParameterDefaultDirectionFunction
๐Ÿ“Œ SS_SIP_USER_AGENT_EXPIREAuto (20โ€“7200s)OutboundRegistration expiry to other server
๐Ÿ”„ SS_SIP_USER_AGENT_RETRY_DELAY60s (30โ€“600s)OutboundWait time before re-registering after failure
๐Ÿ“ค SS_SIP_USER_AGENT_SEND_UNREGISTEROnOutboundSend cancel register on restart
๐Ÿ”’ SS_SIP_USER_AGENT_PRIVACYIgnoreOutboundPrivacy setting for register user
๐Ÿ–ฅ๏ธ SS_ENDPOINT_EXPIRE300 / 3600InboundTerminal registration expiry time
๐ŸŒ SS_ENDPOINT_NAT_EXPIRE300InboundTerminal registration expiry time (NAT)
๐Ÿ” SS_ENDPOINT_REGISTER_RETRY6InboundMax retry times for terminal registration
โธ๏ธ SS_ENDPOINT_REGISTER_SUSPEND180sInboundDisable duration after exceeding retries

๐Ÿ”ง For complete documentation on all SIP parameters, see our VOS3000 parameter description reference. ๐Ÿ“–

๐Ÿ’ก VOS3000 SIP Outbound Registration Configuration Checklist

โœ… Use this checklist when deploying or tuning your VOS3000 SIP outbound registration parameters:

CheckActionStatus
๐Ÿ“Œ 1Set SS_SIP_USER_AGENT_EXPIRE โ€” Auto Negotiation or fixed value (120โ€“300s for NAT)โ˜
๐Ÿ“Œ 2Set SS_SIP_USER_AGENT_RETRY_DELAY โ€” 60s default, 30โ€“45s for primary trunksโ˜
๐Ÿ“Œ 3Verify SS_SIP_USER_AGENT_SEND_UNREGISTER is On for clean restart behaviorโ˜
๐Ÿ“Œ 4Configure backup vendor gateways for failover during retry periodsโ˜
๐Ÿ“Œ 5Test registration failover by temporarily disabling upstream serverโ˜
๐Ÿ“Œ 6Monitor SIP debug trace to confirm retry delay matches configured valueโ˜
๐Ÿ“Œ 7Verify authentication user credentials in gateway configurationโ˜

โ“ Frequently Asked Questions

โ“ What are the VOS3000 SIP outbound registration parameters?

๐Ÿ“ก The VOS3000 SIP outbound registration parameters are SS_SIP_USER_AGENT_EXPIRE (default: Auto Negotiation, range: 20โ€“7200 seconds) and SS_SIP_USER_AGENT_RETRY_DELAY (default: 60 seconds, range: 30โ€“600 seconds). The expiry parameter controls how long a successful registration remains valid, while the retry delay controls how long VOS3000 waits before re-registering after a failure. Together, they govern the complete lifecycle of VOS3000’s outbound SIP registration to other servers. ๐Ÿ”ง

โ“ Should I use Auto Negotiation or a fixed registration expiry?

โš–๏ธ Use Auto Negotiation when VOS3000 is in the same data center as the remote server (no NAT) and you want maximum compatibility. Use a fixed value of 120โ€“300 seconds when VOS3000 is behind a NAT firewall โ€” this is critical because Auto Negotiation may result in a long expiry (e.g., 3600 seconds) that allows the NAT mapping to expire before the next re-registration, silently breaking inbound calls. ๐Ÿ”ง

โšก For primary SIP trunks where call availability is critical, use 30โ€“45 seconds. This provides fast recovery after server outages. For backup or secondary trunks, a longer delay of 120โ€“300 seconds reduces unnecessary network traffic. The default 60 seconds is a reasonable balance for standard deployments. โฑ๏ธ

โ“ What happens when the retry delay expires?

๐Ÿ”„ When the retry delay timer expires, VOS3000 sends a new SIP REGISTER request to the upstream server. If the registration succeeds (200 OK), normal operation resumes. If it fails again, the retry delay timer starts again and VOS3000 will retry after the same fixed interval. This continues until the registration succeeds. โš™๏ธ

๐Ÿ“ž Need Expert Help with VOS3000 SIP Outbound Registration?

๐Ÿ”ง Configuring the VOS3000 SIP outbound registration parameters correctly is essential for maintaining stable SIP trunking, fast failover recovery, and reliable inbound call delivery. Whether you need help with NAT-friendly registration expiry tuning, retry delay optimization, or troubleshooting registration failures, our team is ready to assist. ๐Ÿ›ก๏ธ

๐Ÿ’ฌ WhatsApp: +8801911119966 | ๐Ÿ“ž Phone: +8801911119966


๐Ÿ“ž Need Professional VOS3000 Setup Support?

For professional VOS3000 installations and deployment, VOS3000 Server Rental Solution:

๐Ÿ“ฑ WhatsApp: +8801911119966
๐ŸŒ Website: www.vos3000.com
๐ŸŒ Blog: multahost.com/blog
๐Ÿ“ฅ Downloads: VOS3000 Downloads


VOS3000 SIP Authentication Retry, VOS3000 SIP Early Hangup, VOS3000 SIP Session Timer Refresh, VOS3000 Non-Timer Endpoint Safety, VOS3000 SIP NAT Keepalive, VOS3000 SIP Resend Interval, VOS3000 SIP INVITE Timeout, VOS3000 SIP Call Progress Timeout, VOS3000 SIP Outbound Registration Parameters, VOS3000 SIP Privacy Header, VOS3000 SIP Routing Gateway Contact, VOS3000 SIP Publish Expire, VOS3000 SIP Display From, VOS3000 SIP Send UnregisterVOS3000 SIP Authentication Retry, VOS3000 SIP Early Hangup, VOS3000 SIP Session Timer Refresh, VOS3000 Non-Timer Endpoint Safety, VOS3000 SIP NAT Keepalive, VOS3000 SIP Resend Interval, VOS3000 SIP INVITE Timeout, VOS3000 SIP Call Progress Timeout, VOS3000 SIP Outbound Registration Parameters, VOS3000 SIP Privacy Header, VOS3000 SIP Routing Gateway Contact, VOS3000 SIP Publish Expire, VOS3000 SIP Display From, VOS3000 SIP Send UnregisterVOS3000 SIP Authentication Retry, VOS3000 SIP Early Hangup, VOS3000 SIP Session Timer Refresh, VOS3000 Non-Timer Endpoint Safety, VOS3000 SIP NAT Keepalive, VOS3000 SIP Resend Interval, VOS3000 SIP INVITE Timeout, VOS3000 SIP Call Progress Timeout, VOS3000 SIP Outbound Registration Parameters, VOS3000 SIP Privacy Header, VOS3000 SIP Routing Gateway Contact, VOS3000 SIP Publish Expire, VOS3000 SIP Display From, VOS3000 SIP Send Unregister