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 Display From: Important E164 Caller Configuration

VOS3000 SIP Display From: Important E164 Caller Configuration

๐Ÿ“ž When a SIP INVITE leaves your VOS3000 softswitch, the From header carries the caller’s identity โ€” but what exactly appears in that header? Is it the raw E164 number? The display name? Or something else entirely? The answer depends on a critical parameter: SS_SIP_E164_DISPLAY_FROM, which governs the VOS3000 SIP display from mode and determines how caller information is presented in the From header of every SIP signal your softswitch sends. ๐ŸŽฏ

๐Ÿ“ก The From header is one of the most fundamental elements in SIP signaling. It tells the receiving server who is calling. But in real-world VoIP deployments, the “caller” can be represented in multiple ways โ€” as a plain number, with a display name, in E164 international format, or even with a domain name. Getting the VOS3000 SIP display from configuration right is essential for caller ID presentation, carrier interoperability, and regulatory compliance with number formatting standards. This guide covers the SS_SIP_E164_DISPLAY_FROM parameter (default: Ignore), per-gateway display settings, mapping gateway caller number extraction, and the relationship with privacy headers like P-Asserted-Identity and P-Preferred-Identity. ๐Ÿ”ง

๐Ÿ’ก 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) โ€” 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 Display From?

๐Ÿ“‹ The VOS3000 SIP display from is the mode that controls how VOS3000 populates the display information in the SIP From header. This is governed by the parameter SS_SIP_E164_DISPLAY_FROM, which has a default value of Ignore and offers multiple display mode options. ๐Ÿ“ก

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

AttributeValue
๐Ÿ“Œ Parameter NameSS_SIP_E164_DISPLAY_FROM
๐Ÿ”ข Default ValueIgnore
๐Ÿ“ DescriptionMode of SIP display information
โš™๏ธ OptionsIgnore / other display modes
๐Ÿ“ NavigationOperation management โ†’ Softswitch management โ†’ Additional settings โ†’ SIP parameter

๐Ÿ’ก Key insight: When set to Ignore, VOS3000 does not modify the display information in the From header โ€” it passes the caller information as-is from the original signaling. When a specific display mode is selected, VOS3000 formats the From header according to the E164 standard, ensuring consistent international number formatting across all outbound calls. This is especially important for carriers that require E164-compliant caller numbers. ๐Ÿ“ž

๐ŸŽฏ Why VOS3000 SIP Display From Matters

โš ๏ธ Misconfigured display information in the From header can cause several critical issues:

  • ๐Ÿ“ž Caller ID failure: Some carriers reject calls where the From header does not contain a properly formatted E164 number, resulting in 403 Forbidden or 484 Number Incomplete responses
  • ๐ŸŒ Interoperability problems: Different SIP equipment expects different formats โ€” some require display names, others require E164 numbers only
  • ๐Ÿ”’ Privacy conflicts: Incorrect display modes may expose caller numbers that should be hidden by privacy settings
  • ๐Ÿ“Š Billing discrepancies: CDR records may not match the actual caller numbers presented in signaling, causing reconciliation issues
  • ๐Ÿ›ก๏ธ Regulatory compliance: Some jurisdictions require caller numbers in E164 international format (+CC.NDC.SN) for emergency services and lawful interception

โš™๏ธ Understanding the SIP From Header Structure

๐Ÿ“ก Before diving into the configuration, it is essential to understand the structure of the SIP From header and where the VOS3000 SIP display from parameter exerts its influence. Here is the anatomy of a SIP From header: ๐Ÿ”

๐Ÿ“ž SIP From Header Anatomy:

From: "Display Name" <sip:number@domain>;tag=abc123
      โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€   โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€   โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€
      โ”‚             โ”‚                      โ”‚
      โ”‚             โ”‚                      โ””โ”€โ”€ Tag (dialog identifier)
      โ”‚             โ”‚
      โ”‚             โ””โ”€โ”€ URI (number + domain)
      โ”‚                  โ”œโ”€โ”€ number: caller number (E164 format)
      โ”‚                  โ””โ”€โ”€ domain: server IP or domain name
      โ”‚
      โ””โ”€โ”€ Display Name (what appears on phone screen)
          โ””โ”€โ”€ SS_SIP_E164_DISPLAY_FROM controls THIS part

Examples:
  Ignore mode:     From: <sip:[email protected]>;tag=x1
  E164 mode:       From: "+8801911119966" <sip:[email protected]>;tag=x1
  Display mode:    From: "John" <sip:[email protected]>;tag=x1

๐Ÿ”ง The critical distinction: The SS_SIP_E164_DISPLAY_FROM parameter specifically controls the display information portion of the From header โ€” not the SIP URI itself. When set to Ignore, VOS3000 leaves the display name empty or unchanged. When set to a display mode, it populates the display portion with the E164-formatted number. For more on SIP signaling fundamentals, see our VOS3000 SIP call flow guide. ๐Ÿ“–

๐Ÿ“‹ SS_SIP_E164_DISPLAY_FROM Display Modes

๐Ÿ”€ The VOS3000 SIP display from parameter offers different modes that determine how the display information appears in the From header. Here is a detailed comparison: ๐Ÿ“Š

Display ModeFrom Header FormatUse CaseCarrier Compatibility
Ignore (Default)From: <sip:number@domain>Pass-through; no display name modification๐ŸŸข Broad compatibility
E164 DisplayFrom: “+CC.NDC.SN” <sip:+CC.NDC.SN@domain>International format required by carrier๐ŸŸก Carrier-specific
Number DisplayFrom: “number” <sip:number@domain>Display name set to caller number๐ŸŸข Good compatibility

๐Ÿ“Œ When to use Ignore vs. E164 display: The default Ignore mode works well for most deployments where carriers do not enforce strict From header formatting. However, if your upstream carrier requires E164-formatted numbers in both the display name and URI of the From header, you must change SS_SIP_E164_DISPLAY_FROM from Ignore to the appropriate display mode. For more on carrier requirements, see our VOS3000 caller ID management guide. ๐Ÿ“ž

๐Ÿ”— Per-Gateway SIP Settings for From Header

๐Ÿ–ฅ๏ธ Beyond the global SS_SIP_E164_DISPLAY_FROM parameter, VOS3000 provides per-gateway SIP settings that further control the From header behavior. These settings are configured in the Routing Gateway > Additional settings > Protocol > SIP section and allow fine-grained control over how each gateway presents caller information. ๐Ÿ”ง

SettingFunctionImpact on From Header
Enable local domain nameChange the IP corresponding to the “From” field in signaling to SS_LOCAL_IP_DOMAIN domainReplaces the IP address in the From URI domain part with the configured local domain name
Peer number informationSet select mode to SIP signal’s callerDetermines how VOS3000 extracts the peer (callee/caller) number from SIP signaling

๐Ÿ’ก Enable local domain name is particularly important when your VOS3000 server has a public domain name but communicates using a private IP address internally. By enabling this setting, the From header’s domain portion changes from the server’s private IP (e.g., 192.168.1.100) to the configured SS_LOCAL_IP_DOMAIN (e.g., sip.yourdomain.com), which improves interoperability with carriers that validate the From header domain. ๐ŸŒ

๐Ÿ”ง Peer number information controls how VOS3000 selects the caller number from incoming SIP signals. This setting works in conjunction with the mapping gateway caller field selection (covered below) to ensure the correct caller number is extracted and presented. For detailed gateway configuration, see our VOS3000 gateway configuration guide. ๐Ÿ“–

๐Ÿ›ก๏ธ Per-Gateway Privacy Settings and Display From

๐Ÿ”’ The VOS3000 SIP display from setting does not operate in isolation. It interacts with per-gateway privacy settings that control how caller identity is presented and protected. These settings are configured at the Routing Gateway > Additional settings > Protocol level and include: ๐Ÿ›ก๏ธ

Privacy SettingOptionsDescriptionInteraction with Display From
P-Asserted-IdentityNone / Passthrough / CallerControls P-Asserted-Identity header insertionWhen set to Caller, PAI carries the real caller; From header may differ based on display mode
P-Preferred-IdentityNone / Passthrough / CallerControls P-Preferred-Identity header insertionSimilar to PAI; provides preferred identity that may differ from From display
PrivacyNone / Passthrough / IdControls Privacy header in outbound signalingWhen set to Id, caller identity in From is hidden; display name shows “anonymous”

๐ŸŽฏ Critical interaction: When Privacy is set to Id, the From header display information shows “anonymous” or ” withheld” regardless of the SS_SIP_E164_DISPLAY_FROM setting. The real caller number is then carried in the P-Asserted-Identity header (if P-Asserted-Identity is set to Caller). This is how VOS3000 supports caller ID blocking while still providing the real number to trusted carriers. For a complete guide on this topic, see our VOS3000 P-Asserted-Identity caller ID guide. ๐Ÿ“ž

๐Ÿ”’ Privacy Header vs. Display From โ€” Priority Order

๐Ÿ“Š Understanding the priority order is essential when both privacy settings and display from settings are configured: ๐Ÿ”‘

๐Ÿ”’ VOS3000 From Header Priority โ€” Privacy vs Display From:

Step 1: Check Privacy Setting (per-gateway)
  โ”œโ”€โ”€ Privacy = None
  โ”‚   โ””โ”€โ”€ No Privacy header added โ†’ proceed to Step 2
  โ”œโ”€โ”€ Privacy = Passthrough
  โ”‚   โ””โ”€โ”€ Pass existing Privacy header โ†’ proceed to Step 2
  โ””โ”€โ”€ Privacy = Id
      โ””โ”€โ”€ Add "Privacy: id" header
          โ””โ”€โ”€ From header โ†’ "Anonymous" <sip:[email protected]>
          โ””โ”€โ”€ Real caller in PAI (if P-Asserted-Identity = Caller)
          โ””โ”€โ”€ โ›” STOP โ€” SS_SIP_E164_DISPLAY_FROM is overridden

Step 2: Check SS_SIP_E164_DISPLAY_FROM (global)
  โ”œโ”€โ”€ Ignore (default)
  โ”‚   โ””โ”€โ”€ From header display name = empty or original
  โ”œโ”€โ”€ E164 Display
  โ”‚   โ””โ”€โ”€ From header display name = "+8801911119966"
  โ””โ”€โ”€ Number Display
      โ””โ”€โ”€ From header display name = "8801911119966"

Step 3: Check Enable Local Domain Name (per-gateway)
  โ”œโ”€โ”€ Disabled
  โ”‚   โ””โ”€โ”€ From URI domain = server IP (e.g., 192.168.1.100)
  โ””โ”€โ”€ Enabled
      โ””โ”€โ”€ From URI domain = SS_LOCAL_IP_DOMAIN (e.g., sip.carrier.com)

๐Ÿ’ก Key takeaway: Privacy settings always take priority over display from settings. If Privacy is set to Id, the From header becomes anonymous regardless of what SS_SIP_E164_DISPLAY_FROM is configured to. For more on privacy configurations, see our VOS3000 parameter description reference. ๐Ÿ“–

๐Ÿ”„ Mapping Gateway Caller Number Extraction

๐Ÿ“Š While SS_SIP_E164_DISPLAY_FROM controls how the From header is presented on outbound calls, the Mapping Gateway settings control how VOS3000 extracts the caller number from inbound SIP signals. This is a critical complementary configuration that determines which field VOS3000 reads to identify the caller. ๐Ÿ”

Extraction FieldSIP HeaderFormatWhen to Use
FromFrom: <sip:number@domain>Standard SIP From URIโœ… Default; most common; broad compatibility
Remote-Party-IDRemote-Party-ID: number;party=callingRFC 3325 identity header๐Ÿ“ก Carriers that send verified caller ID in RPID
DisplayFrom: “Display” <sip:number@domain>Display name portion of From header๐Ÿ“ž When display name differs from URI number

๐Ÿ”ง How this interacts with VOS3000 SIP display from: The Mapping Gateway “Caller” setting determines which field VOS3000 reads as the caller number on incoming calls. The SS_SIP_E164_DISPLAY_FROM setting determines how VOS3000 presents the caller number in the From header on outgoing calls. These two settings work in opposite directions but must be configured consistently to ensure end-to-end caller ID integrity. For detailed mapping gateway configuration, see our VOS3000 gateway configuration and routing mapping guide. ๐Ÿ“–

๐Ÿ“Š Caller Number Extraction Scenario

๐ŸŽฏ Consider a scenario where an upstream carrier sends caller information in the Remote-Party-ID header but the From header contains a generic number. Here is how the Mapping Gateway “Caller” setting determines what VOS3000 uses: ๐Ÿ“ก

๐Ÿ“ž Incoming SIP INVITE from Carrier:

From: "Unknown" <sip:[email protected]>;tag=abc
Remote-Party-ID: "+8801911119966" <sip:[email protected]>;party=calling

Mapping Gateway Caller Setting = "From"
  โ””โ”€โ”€ VOS3000 reads: 0000 (generic number)
  โ””โ”€โ”€ โŒ Wrong caller number for CDR and routing

Mapping Gateway Caller Setting = "Remote-Party-ID"
  โ””โ”€โ”€ VOS3000 reads: +8801911119966 (real caller)
  โ””โ”€โ”€ โœ… Correct caller number for CDR and routing

Mapping Gateway Caller Setting = "Display"
  โ””โ”€โ”€ VOS3000 reads: "Unknown" (display name from From)
  โ””โ”€โ”€ โŒ Not a valid caller number

๐Ÿ’ก Pro tip: Always verify which field your upstream carrier uses to send the real caller number. Many international carriers use Remote-Party-ID or P-Asserted-Identity instead of the From header. Configuring the Mapping Gateway “Caller” setting to the correct field ensures VOS3000 extracts the right caller number. For authentication-related configurations, see our VOS3000 SIP authentication guide. ๐Ÿ”‘

๐Ÿ”— The VOS3000 SIP display from parameter is part of a family of parameters that control caller identity presentation in SIP signaling. Understanding their relationships is essential for proper configuration. ๐Ÿ› ๏ธ

ParameterDefaultDescriptionScope
SS_SIP_E164_DISPLAY_FROMIgnoreMode of SIP display informationGlobal (From header display)
SS_SIP_USER_AGENT_PRIVACYIgnorePrivacy setting for register userOutbound registration privacy

๐Ÿ“ Both parameters are located at: Operation management โ†’ Softswitch management โ†’ Additional settings โ†’ SIP parameter. For the complete parameter reference, see our VOS3000 system parameters guide. ๐Ÿ“–

๐Ÿ”„ SS_SIP_E164_DISPLAY_FROM vs. SS_SIP_USER_AGENT_PRIVACY

โš ๏ธ A common source of confusion is the difference between SS_SIP_E164_DISPLAY_FROM and SS_SIP_USER_AGENT_PRIVACY. While both affect how caller information appears in SIP headers, they serve different purposes: ๐ŸŽฏ

AspectSS_SIP_E164_DISPLAY_FROMSS_SIP_USER_AGENT_PRIVACY
๐Ÿ“Œ PurposeControls display format in From headerControls privacy level for registration user
๐Ÿ”ข DefaultIgnoreIgnore
๐Ÿ“ก Applied ToFrom header display name (INVITE and call signaling)REGISTER messages (outbound registration)
๐Ÿ”„ EffectFormats how the caller number appears in From display nameAdds Privacy header to registration; hides identity
โš™๏ธ OptionsIgnore / display modesIgnore / Id / None

๐Ÿ’ก Simple rule: SS_SIP_E164_DISPLAY_FROM controls how the caller looks in the From header. SS_SIP_USER_AGENT_PRIVACY controls whether the registration user is hidden in outbound REGISTER messages. They apply to different SIP methods and serve different purposes. For more on SIP session management, see our VOS3000 SIP session guide. ๐Ÿ“ก

๐Ÿ“‹ Step-by-Step VOS3000 SIP Display From Configuration

โš™๏ธ Follow these steps to configure the VOS3000 SIP display from settings on your system:

Step 1: Configure Global SS_SIP_E164_DISPLAY_FROM ๐Ÿ“‹

  1. ๐Ÿ” Log in to VOS3000 Client with administrator credentials
  2. ๐Ÿ“Œ Navigate: Operation management โ†’ Softswitch management โ†’ Additional settings โ†’ SIP parameter
  3. ๐Ÿ” Locate SS_SIP_E164_DISPLAY_FROM in the parameter list
  4. โœ๏ธ Set the display mode (default: Ignore; change to E164 display mode if your carrier requires formatted numbers)
  5. ๐Ÿ’พ Save and apply the changes

Step 2: Configure Per-Gateway SIP Settings ๐Ÿ”—

  1. ๐Ÿ“Œ Navigate: Operation management โ†’ Softswitch management โ†’ Routing gateway
  2. ๐Ÿ” Select the target gateway โ†’ Additional settings โ†’ Protocol โ†’ SIP
  3. ๐Ÿ”ง Configure:
    • ๐ŸŒ Enable local domain name: Enable if you want the From URI domain to use SS_LOCAL_IP_DOMAIN instead of IP address
    • ๐Ÿ“ž Peer number information: Set the select mode for SIP signal’s caller extraction
  4. ๐Ÿ’พ Save gateway settings

Step 3: Configure Per-Gateway Privacy Settings ๐Ÿ”’

  1. ๐Ÿ“Œ In the same gateway settings, navigate to Privacy settings
  2. ๐Ÿ”ง Configure:
    • ๐Ÿ›ก๏ธ P-Asserted-Identity: None / Passthrough / Caller
    • ๐Ÿ›ก๏ธ P-Preferred-Identity: None / Passthrough / Caller
    • ๐Ÿ”’ Privacy: None / Passthrough / Id
  3. ๐Ÿ’พ Save privacy settings

Step 4: Configure Mapping Gateway Caller Extraction ๐Ÿ”„

  1. ๐Ÿ“Œ Navigate: Operation management โ†’ Softswitch management โ†’ Mapping gateway
  2. ๐Ÿ” Select the mapping gateway that handles incoming calls
  3. ๐Ÿ”ง Set Caller field to extract caller number from:
    • ๐Ÿ“ž From โ€” standard From header (default, most common)
    • ๐Ÿ“ก Remote-Party-ID โ€” RFC 3325 verified identity
    • ๐Ÿ“Ÿ Display โ€” display name portion of From header
  4. ๐Ÿ’พ Save mapping gateway settings

Step 5: Verify with SIP Debug ๐Ÿ”

๐Ÿ“ After configuration, verify the display from settings are working correctly by examining the SIP INVITE messages. For comprehensive debugging techniques, see our VOS3000 troubleshooting guide. ๐Ÿ”ง

๐Ÿ” Verifying VOS3000 SIP Display From โ€” SIP Debug Trace:

โ”€โ”€โ–บ Outbound INVITE (SS_SIP_E164_DISPLAY_FROM = Ignore):

  INVITE sip:[email protected] SIP/2.0
  From: <sip:[email protected]>;tag=z9hG4bK123
        โ””โ”€โ”€ No display name (Ignore mode)
  To: <sip:[email protected]>

โ”€โ”€โ–บ Outbound INVITE (SS_SIP_E164_DISPLAY_FROM = E164 Display):

  INVITE sip:[email protected] SIP/2.0
  From: "+8801911119966" <sip:[email protected]>;tag=z9hG4bK456
        โ””โ”€โ”€ E164 format display name added โœ…
  To: <sip:[email protected]>

โ”€โ”€โ–บ Outbound INVITE (Privacy = Id, PAI = Caller):

  INVITE sip:[email protected] SIP/2.0
  From: "Anonymous" <sip:[email protected]>;tag=z9hG4bK789
        โ””โ”€โ”€ Privacy overrides display from โ›”
  To: <sip:[email protected]>
  P-Asserted-Identity: <sip:[email protected]>
        โ””โ”€โ”€ Real caller in PAI header ๐Ÿ”’
  Privacy: id

๐Ÿ“Š VOS3000 SIP Display From Best Practices by Deployment

๐ŸŽฏ Different VoIP deployment scenarios require different display from configurations. Here are recommended settings based on real-world deployment experience and VOS3000 manual specifications: ๐Ÿ’ก

Deployment TypeSS_SIP_E164_DISPLAY_FROMPrivacy SettingMapping Gateway Caller
๐Ÿ“ž International wholesale (E164 required)E164 DisplayNoneFrom or Remote-Party-ID
๐Ÿข Enterprise SIP trunkIgnore (default)NoneFrom
๐ŸŒ Multi-carrier terminationE164 DisplayPassthroughRemote-Party-ID
๐Ÿ”’ Privacy-focused (CLIR)IgnoreIdFrom
๐Ÿ“ž Domestic carrier (no E164)Ignore (default)NoneFrom
๐Ÿ“ก RPID-based upstreamE164 DisplayPassthroughRemote-Party-ID

๐Ÿ’ก Important: The VOS3000 SIP display from setting works together with your call routing and gateway privacy configuration. Always verify the complete signaling chain โ€” from inbound caller extraction (Mapping Gateway) through outbound caller presentation (Display From + Privacy) โ€” to ensure consistent caller ID across your entire VoIP network. For expert guidance, reach us on WhatsApp at +8801911119966. ๐Ÿ“ฑ

๐Ÿ›ก๏ธ Common VOS3000 SIP Display From Problems and Solutions

โš ๏ธ Misconfigured display from settings can cause a range of caller ID issues. Here are the most common problems and their solutions:

โŒ Problem 1: Carrier Rejects Calls โ€” 403 Forbidden Due to Invalid From Header

๐Ÿ” Symptom: Upstream carrier returns 403 Forbidden or 484 Number Incomplete on calls that pass through VOS3000. The carrier’s technical support reports that the From header does not contain a valid E164 number.

๐Ÿ’ก Cause: SS_SIP_E164_DISPLAY_FROM is set to Ignore (default), so the From header does not include the E164-formatted display name that the carrier requires for number validation.

โœ… Solutions:

  • ๐Ÿ”ง Change SS_SIP_E164_DISPLAY_FROM from Ignore to the E164 display mode
  • ๐Ÿ“ž Verify the carrier’s exact From header format requirements (with or without “+” prefix)
  • ๐Ÿ“Š Test with a single call first and verify the From header in SIP debug output

โŒ Problem 2: Wrong Caller Number Appears on Called Party Phone

๐Ÿ” Symptom: The called party sees a generic or incorrect number instead of the real caller number on their phone display.

๐Ÿ’ก Cause: The Mapping Gateway “Caller” setting is extracting the caller number from the wrong SIP field. For example, if the carrier sends the real number in Remote-Party-ID but the Mapping Gateway is set to extract from “From”, VOS3000 may be reading a generic or incorrect number.

โœ… Solutions:

  • ๐Ÿ” Examine incoming SIP INVITE messages to identify which field carries the real caller number
  • ๐Ÿ”ง Change Mapping Gateway “Caller” setting to the correct field (From / Remote-Party-ID / Display)
  • ๐Ÿ“ž Verify caller number after the change by making a test call

โŒ Problem 3: Caller ID Shows “Anonymous” When It Should Not

๐Ÿ” Symptom: Outbound calls show “Anonymous” or “Unknown” on the called party’s phone even though the caller has not requested privacy.

๐Ÿ’ก Cause: The per-gateway Privacy setting is configured to “Id” which adds a Privacy: id header and changes the From header to anonymous, overriding the SS_SIP_E164_DISPLAY_FROM setting.

โœ… Solutions:

  • ๐Ÿ”’ Check the per-gateway Privacy setting โ€” change from “Id” to “None” if caller ID blocking is not required
  • ๐Ÿ”ง If selective CLIR (Caller Line Identification Restriction) is needed, use P-Asserted-Identity = Caller with Privacy = Id
  • ๐Ÿ“Š Verify that SS_SIP_E164_DISPLAY_FROM is not set to Ignore if you need a display name

โŒ Problem 4: From Header Shows Private IP Instead of Domain Name

๐Ÿ” Symptom: The From header contains a private IP address (e.g., 192.168.1.100) in the URI domain portion, which some carriers reject because they cannot route responses to a private IP.

๐Ÿ’ก Cause: The “Enable local domain name” per-gateway setting is not enabled, so VOS3000 uses its private IP address in the From header domain.

โœ… Solutions:

  • ๐ŸŒ Enable “Enable local domain name” in the routing gateway’s SIP settings
  • ๐Ÿ”ง Verify that SS_LOCAL_IP_DOMAIN is configured with your public domain name or public IP
  • ๐Ÿ“ž Test call and verify the From header domain matches your public-facing address

๐Ÿ“ž Complete Display and Privacy Parameter Quick Reference

๐Ÿ“Š Here is the complete reference for all parameters and settings that govern caller identity presentation in VOS3000: ๐Ÿ“‹

Parameter / SettingDefaultScopeFunction
SS_SIP_E164_DISPLAY_FROMIgnoreGlobalMode of SIP display information in From header
SS_SIP_USER_AGENT_PRIVACYIgnoreGlobalPrivacy setting for register user (outbound REGISTER)
Enable local domain nameโ€”Per-gatewayChange From field IP to SS_LOCAL_IP_DOMAIN
Peer number informationโ€”Per-gatewaySet select mode to SIP signal’s caller
P-Asserted-Identityโ€”Per-gatewayNone / Passthrough / Caller
P-Preferred-Identityโ€”Per-gatewayNone / Passthrough / Caller
Privacyโ€”Per-gatewayNone / Passthrough / Id
Caller (Mapping Gateway)โ€”Per-mapping-gatewayGet caller from: From / Remote-Party-ID / Display

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

๐Ÿ’ก VOS3000 SIP Display From Configuration Checklist

โœ… Use this checklist when deploying or tuning your VOS3000 SIP display from settings:

CheckActionStatus
๐Ÿ“Œ 1Set SS_SIP_E164_DISPLAY_FROM to appropriate mode (Ignore for passthrough, E164 for formatted display)โ˜
๐Ÿ“Œ 2Verify per-gateway “Enable local domain name” setting matches your deployment needsโ˜
๐Ÿ“Œ 3Configure per-gateway “Peer number information” for correct caller extraction modeโ˜
๐Ÿ“Œ 4Set P-Asserted-Identity to Caller if carriers require verified caller identityโ˜
๐Ÿ“Œ 5Configure Privacy setting (None for normal, Id for caller ID blocking, Passthrough for carrier passthrough)โ˜
๐Ÿ“Œ 6Set Mapping Gateway “Caller” field to the correct SIP header (From / Remote-Party-ID / Display)โ˜
๐Ÿ“Œ 7Test outbound call and verify From header format in SIP debugโ˜
๐Ÿ“Œ 8Verify caller ID appears correctly on called party phone displayโ˜

โ“ Frequently Asked Questions

โ“ What is the default VOS3000 SIP display from setting?

๐Ÿ“‹ The default VOS3000 SIP display from setting is Ignore, configured via the SS_SIP_E164_DISPLAY_FROM parameter. When set to Ignore, VOS3000 does not modify the display information in the From header โ€” it passes the caller information as-is from the original signaling. This provides broad compatibility with most carriers and SIP equipment. If your upstream carrier requires E164-formatted display names in the From header, you must change this from Ignore to the appropriate display mode. ๐Ÿ”ง

โ“ How does SS_SIP_E164_DISPLAY_FROM interact with Privacy settings?

๐Ÿ”’ Privacy settings take priority over SS_SIP_E164_DISPLAY_FROM. When the per-gateway Privacy setting is configured to “Id”, VOS3000 adds a Privacy: id header and changes the From header to anonymous, regardless of what SS_SIP_E164_DISPLAY_FROM is set to. The real caller number is then carried in the P-Asserted-Identity header (if P-Asserted-Identity is set to Caller). This is the standard mechanism for supporting Caller Line Identification Restriction (CLIR) in VOS3000. For more details, see our VOS3000 P-Asserted-Identity guide. ๐Ÿ“ก

โ“ What is E164 format and why do carriers require it?

๐Ÿ“ž E164 is the ITU-T international numbering plan standard that defines the format of international telephone numbers. An E164 number consists of: a “+” prefix, followed by the country code (CC), the national destination code (NDC), and the subscriber number (SN) โ€” for example, +8801911119966. Many international carriers require caller numbers in E164 format in the SIP From header to properly route calls, validate caller identity, and comply with regulatory requirements for emergency services and lawful interception. The VOS3000 SIP display from parameter allows you to ensure the From header displays the E164-formatted number when required. ๐ŸŒ

โ“ What is the Mapping Gateway “Caller” field setting?

๐Ÿ”„ The Mapping Gateway “Caller” field setting determines which SIP header VOS3000 reads to extract the caller number on incoming calls. The available options are: From (reads from the standard From header URI), Remote-Party-ID (reads from the RFC 3325 Remote-Party-ID header), and Display (reads the display name portion of the From header). This setting works in the opposite direction from SS_SIP_E164_DISPLAY_FROM โ€” while Display From controls outbound presentation, the Caller field controls inbound extraction. For detailed configuration, see our VOS3000 gateway configuration guide. ๐Ÿ“–

โ“ When should I enable “Enable local domain name” in per-gateway settings?

๐ŸŒ Enable “Enable local domain name” when your VOS3000 server uses a private IP address internally but has a public domain name or public IP for external communication. When enabled, VOS3000 replaces the private IP in the From header URI domain portion with the configured SS_LOCAL_IP_DOMAIN. This is essential when upstream carriers validate the From header domain and cannot route responses to a private IP address (e.g., 192.168.x.x or 10.x.x.x). Without this setting, calls may fail with 403 Forbidden because the carrier cannot identify the origin server. ๐Ÿ”ง

โ“ Can I set different display from modes for different gateways?

๐Ÿ“Š The SS_SIP_E164_DISPLAY_FROM parameter is a global SIP parameter that applies to all gateways. However, you can achieve per-gateway differentiation through the per-gateway Privacy settings and Enable local domain name settings, which modify how the From header appears independently of the global display from mode. For example, you can set SS_SIP_E164_DISPLAY_FROM to E164 display globally, then use per-gateway Privacy = Id for specific gateways where caller ID blocking is required. For advanced configuration assistance, contact us on WhatsApp at +8801911119966. ๐Ÿ“ฑ

๐Ÿ” Start by examining the SIP INVITE messages in VOS3000’s SIP debug trace. Check the From header format, display name, Privacy header, P-Asserted-Identity header, and the domain portion of the From URI. Compare the actual signaling with your expected format. Common issues include: SS_SIP_E164_DISPLAY_FROM set to Ignore when the carrier requires E164, Mapping Gateway Caller set to the wrong field, Privacy = Id overriding display from settings, and private IP in the From URI domain. For comprehensive troubleshooting techniques, see our VOS3000 troubleshooting guide. ๐Ÿ”ง

๐Ÿ”— Explore these related guides for comprehensive VOS3000 configuration knowledge:


๐Ÿ“ž 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 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