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