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 INVITE Timeout and Gateway Switching: Complete Call Setup Guide

VOS3000 SIP INVITE Timeout and Gateway Switching: Complete Call Setup Guide

๐Ÿ“ž Nothing kills call completion rates faster than an incorrectly configured VOS3000 SIP INVITE timeout โ€” and nothing disrupts active calls more than misconfigured gateway switching behavior. When your softswitch sends an INVITE and the far end never responds, how long should it wait? What happens when a gateway responds with SDP โ€” should VOS3000 commit to that gateway or keep trying alternatives? These decisions, controlled by SS_SIP_TIMEOUT_INVITE, SS_SIP_STOP_SWITCH_AFTER_SDP, and SS_SIP_USER_AGENT_STOP_SWITCH_AFTER_INVITE_TIMEOUT, directly impact your ASR, call reliability, and caller experience. โฑ๏ธ

โš™๏ธ Set the INVITE timeout too short, and legitimate calls get abandoned before the gateway can answer. Set it too long, and failed calls consume precious port capacity. Enable gateway switching after SDP, and you risk disrupting early media. Disable switching after INVITE timeout, and backup routes never get tried. Understanding how these three parameters work together is what separates a basic VOS3000 deployment from a professionally tuned one. ๐Ÿ”ง

๐ŸŽฏ This guide covers every aspect of the VOS3000 SIP INVITE timeout, gateway switching decisions, and stop switch behavior: the global parameters, per-gateway overrides, related system parameters like SS_GATEWAY_SWITCH_LIMIT and SS_GATEWAY_SWITCH_STOP_AFTER_RTP_START, and best practices for configuring gateway failover in production environments. All data is sourced exclusively from the official VOS3000 V2.1.9.07 Manual, Section 4.3.5.2 (Tables 4-3 and 4-4). For expert assistance, contact us on WhatsApp at +8801911119966. ๐Ÿ’ก

๐Ÿ” What Is VOS3000 SIP INVITE Timeout?

โฑ๏ธ The VOS3000 SIP INVITE timeout defines the maximum number of seconds the softswitch will wait for a response after sending a SIP INVITE message to a gateway. If no provisional response (100 Trying, 180 Ringing, 183 Session Progress) or final response (200 OK, 4xx, 5xx, 6xx) arrives within this period, VOS3000 considers the INVITE failed and proceeds to the gateway switching decision. ๐Ÿ“ž

๐Ÿ“‹ This parameter is governed by SS_SIP_TIMEOUT_INVITE with a default value of 10 seconds:

AttributeValue
๐Ÿ“Œ Parameter NameSS_SIP_TIMEOUT_INVITE
๐Ÿ”ข Default Value10
๐Ÿ“ UnitSeconds
๐Ÿ“ DescriptionSIP INVITE timeout. Default value in “Routing Gateway > Additional settings > Protocol > SIP”
๐Ÿ“ LocationOperation management โ†’ Softswitch management โ†’ Additional settings โ†’ SIP parameter

๐Ÿ’ก How the 10-second default works: When VOS3000 sends an INVITE to a gateway, it starts a countdown timer. During this period, SIP retransmissions occur based on SS_SIP_RESEND_INTERVAL (default: 0.5,1,2,4,4,4,4,4,4,4). If no response arrives within 10 seconds total, VOS3000 stops retransmitting, marks the INVITE as failed, and proceeds based on your gateway switching configuration.

๐Ÿ“‹ VOS3000 SIP INVITE Timeout vs Other SIP Timers

๐ŸŒ The VOS3000 SIP INVITE timeout is just one of several SIP timers that govern call setup. Understanding the differences is essential:

TimerParameterDefaultControls
๐Ÿ“ž INVITE TimeoutSS_SIP_TIMEOUT_INVITE10 secondsTotal wait for any INVITE response
โณ Trying TimeoutSS_SIP_TIMEOUT_TRYING20 secondsWait for progress after 100 Trying
๐Ÿ”” Ringing TimeoutSS_SIP_TIMEOUT_RINGING120 secondsWait for answer while ringing
๐Ÿ“ก Session ProgressSS_SIP_TIMEOUT_SESSION_PROGRESS20 secondsWait after 183 Session Progress

๐Ÿ”‘ Key distinction: The VOS3000 SIP INVITE timeout is the overall timer for the INVITE transaction. The Trying, Ringing, and Session Progress timers only activate after specific provisional responses are received. If no response comes at all, only the INVITE timeout applies.

๐Ÿ”„ Gateway Switching Decision Points

๐ŸŒ VOS3000 makes gateway switching decisions at multiple points during call setup. Understanding these decision points is critical for configuring reliable failover. The two most important are controlled by the VOS3000 SIP INVITE timeout parameters: ๐Ÿ“ก

Decision PointParameterDefaultEffect
๐Ÿ“จ After SDP receivedSS_SIP_STOP_SWITCH_AFTER_SDPOnStops switching โ€” commits to gateway
โฑ๏ธ After INVITE timeoutSS_SIP_USER_AGENT_STOP_SWITCH_AFTER_INVITE_TIMEOUTOffContinues switching โ€” tries next gateway
๐Ÿ“ก After RTP startsSS_GATEWAY_SWITCH_STOP_AFTER_RTP_STARTOnStops switching when RTP media flows
๐Ÿ“ž Callee busySS_GATEWAY_SWITCH_STOP_AFTER_USER_BUSYOnStops switching when 486 Busy received
๐Ÿ”— Until connectSS_GATEWAY_SWITCH_UNTIL_CONNECTOffSwitch until 200 OK received

๐Ÿ”‘ Key insight: These parameters work together as a layered decision system. The VOS3000 SIP INVITE timeout parameters (stop switch after SDP and stop switch after INVITE timeout) are the two most important because they control the two most common switching decisions: committing after media negotiation begins, and failing over after a gateway is unresponsive.

๐Ÿ›‘ SS_SIP_STOP_SWITCH_AFTER_SDP โ€” Stop Switch After SDP

๐Ÿ“ž The SS_SIP_STOP_SWITCH_AFTER_SDP parameter controls whether VOS3000 stops trying alternative gateways once it receives SDP (Session Description Protocol) in a provisional response from the current gateway. When this parameter is On (default), VOS3000 commits to the current gateway as soon as SDP arrives โ€” preventing mid-setup failover that would disrupt early media and call progress. ๐Ÿ›ก๏ธ

AttributeValue
๐Ÿ“Œ Parameter NameSS_SIP_STOP_SWITCH_AFTER_SDP
๐Ÿ”ข Default ValueOn
๐Ÿ“ DescriptionStop Switch Gateway After Receive SDP
๐Ÿ“‹ OptionsOn / Off
๐Ÿ“ LocationOperation management โ†’ Softswitch management โ†’ Additional settings โ†’ SIP parameter

๐Ÿ’ก Why SDP matters in gateway switching: In the SIP call flow, SDP carries the media negotiation details โ€” codecs, IP addresses, and port numbers. When a gateway sends SDP in a 183 Session Progress response, it means the gateway has allocated media resources, early media may already be playing, the media session is partially established, and switching to another gateway at this point causes audio disruption and potential double-answer scenarios.

SettingGateway Switching BehaviorCall ImpactWhen to Use
โœ… On (default)Stops switching after SDP โ€” commits to current gateway๐Ÿ›ก๏ธ Prevents audio disruption, no double-answer, stable media path๐Ÿ“ž Nearly all deployments โ€” recommended default
โŒ OffContinues switching even after SDP โ€” may try other gatewaysโš ๏ธ Audio disruption risk, potential double-answer, unstable media๐Ÿ”ฌ Only for special testing or specific carrier requirements

๐Ÿšจ Warning: Setting SS_SIP_STOP_SWITCH_AFTER_SDP to Off is rarely appropriate. When a gateway has already sent SDP and you switch to another gateway, the original gateway may continue playing audio or billing for the session while the new gateway also attempts call setup. This creates chaotic call states. โšก

โฑ๏ธ SS_SIP_USER_AGENT_STOP_SWITCH_AFTER_INVITE_TIMEOUT

๐Ÿ”„ The companion parameter to stop switch after SDP is SS_SIP_USER_AGENT_STOP_SWITCH_AFTER_INVITE_TIMEOUT. While the SDP parameter controls switching after media negotiation begins, this parameter controls switching after an INVITE times out with no response at all. โณ

AttributeValue
๐Ÿ“Œ Parameter NameSS_SIP_USER_AGENT_STOP_SWITCH_AFTER_INVITE_TIMEOUT
๐Ÿ”ข Default ValueOff
๐Ÿ“ DescriptionStop Switch Gateway After INVITE Timeout
๐Ÿ“‹ OptionsOn / Off
๐Ÿ“ Per-Gateway OverrideYes โ€” Routing Gateway > Additional settings > Protocol > SIP

๐Ÿ”‘ Why the default is Off: When a gateway does not respond to an INVITE within the timeout period (defined by SS_SIP_TIMEOUT_INVITE), the most common cause is a network or gateway failure. In this scenario, you want VOS3000 to try the next available gateway โ€” not give up. Setting this parameter to Off (default) ensures that backup routes are attempted, maximizing call completion rates. ๐Ÿ“ˆ

SettingINVITE Timeout BehaviorImpact on Call
โŒ Off (default)VOS3000 continues gateway switching to the next available gatewayโœ… Call attempts backup routes โ€” higher completion rate
โœ… OnVOS3000 stops switching โ€” call fails immediately after INVITE timeoutโš ๏ธ No failover โ€” caller gets failure tone right away

๐Ÿ’ก When to set On: The only scenario where setting this to On makes sense is for compliance or regulatory routing where calls must use a specific carrier and failover to alternatives is not permitted. ๐Ÿ›๏ธ

๐Ÿ“Š Complete Gateway Switching Flow

๐Ÿ”„ Understanding how the VOS3000 SIP INVITE timeout interacts with gateway switching requires seeing the complete flow. Here is the full decision tree: ๐ŸŒณ

๐Ÿ“ž VOS3000 INVITE Timeout & Gateway Switching Flow:

VOS3000 โ”€โ”€โ–บ INVITE โ”€โ”€โ–บ Gateway A (Primary)
    โ”‚                          โ”‚
    โ”‚   โฑ๏ธ INVITE Timeout countdown starts
    โ”‚   ๐Ÿ“ก Retransmissions per SS_SIP_RESEND_INTERVAL
    โ”‚                          โ”‚
    โ”‚   โ”Œโ”€โ”€ T = INVITE Timeout โ”€โ”€โ”
    โ”‚   โ”‚   No response received โ”‚
    โ”‚   โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜
    โ”‚                          โ”‚
    โ”œโ”€โ”€ โŒ Gateway A INVITE failed
    โ”‚
    โ”œโ”€โ”€ Check: Stop switch after INVITE timeout?
    โ”‚   โ”‚
    โ”‚   โ”œโ”€โ”€ OFF (default) โœ…
    โ”‚   โ”‚   โ””โ”€โ”€โ–บ Try next gateway in route
    โ”‚   โ”‚        VOS3000 โ”€โ”€โ–บ INVITE โ”€โ”€โ–บ Gateway B (Backup)
    โ”‚   โ”‚                          โ”‚
    โ”‚   โ”‚            (new INVITE timeout starts)
    โ”‚   โ”‚
    โ”‚   โ””โ”€โ”€ ON โš ๏ธ
    โ”‚       โ””โ”€โ”€โ–บ Stop switching
    โ”‚            Return error to caller (SIP 408 / 503)
    โ”‚
    โ”Œโ”€โ”€ OR Gateway A responds โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
    โ”‚                                           โ”‚
    โ”‚   โ”œโ”€โ”€ 100 Trying / 180 Ringing (no SDP)   โ”‚
    โ”‚   โ”‚   โ””โ”€โ”€โ–บ Continue waiting               โ”‚
    โ”‚   โ”‚        (may still switch)              โ”‚
    โ”‚   โ”‚                                       โ”‚
    โ”‚   โ”œโ”€โ”€ 183 Session Progress + SDP          โ”‚
    โ”‚   โ”‚   โ”œโ”€โ”€ Stop switch after SDP =         โ”‚
    โ”‚   โ”‚   โ”‚   ON (default) โœ…                 โ”‚
    โ”‚   โ”‚   โ”‚   โ””โ”€โ”€โ–บ Commit to Gateway A        โ”‚
    โ”‚   โ”‚   โ”‚        No more switching           โ”‚
    โ”‚   โ”‚   โ”‚                                   โ”‚
    โ”‚   โ”‚   โ””โ”€โ”€ Stop switch after SDP =         โ”‚
    โ”‚   โ”‚       OFF โš ๏ธ                          โ”‚
    โ”‚   โ”‚       โ””โ”€โ”€โ–บ May switch to Gateway B    โ”‚
    โ”‚   โ”‚            (risk of disruption!)       โ”‚
    โ”‚   โ”‚                                       โ”‚
    โ”‚   โ”œโ”€โ”€ SIP Error Code (4xx/5xx/6xx)        โ”‚
    โ”‚   โ”‚   โ””โ”€โ”€โ–บ May try next gateway           โ”‚
    โ”‚   โ”‚                                       โ”‚
    โ”‚   โ””โ”€โ”€ 200 OK (Answer)                     โ”‚
    โ”‚       โ””โ”€โ”€โ–บ Call established                โ”‚
    โ”‚            No switching                    โ”‚
    โ”‚                                           โ”‚
    โ””โ”€โ”€ ๐Ÿ“ CDR recorded with switching details   โ”‚

๐Ÿ”ง For detailed gateway failover configuration, see our vendor failover setup guide. For more on the complete SIP call flow, see our SIP call flow reference. ๐Ÿ“ก

๐Ÿ“‹ The VOS3000 SIP INVITE timeout and stop switch parameters do not work in isolation. Several system-level parameters from Table 4-4 of the official VOS3000 2.1.9.07 manual control the broader gateway switching behavior: ๐Ÿ”ง

ParameterDefaultDescription
๐Ÿ“Œ SS_GATEWAY_SWITCH_LIMITNoneTimes limit for Routing Gateway Auto-Switch โ€” maximum number of gateways VOS3000 will try
๐Ÿ“ก SS_GATEWAY_SWITCH_STOP_AFTER_RTP_STARTOnStop Switch Gateway when RTP Start โ€” prevents switching once media flows
๐Ÿ“ž SS_GATEWAY_SWITCH_STOP_AFTER_USER_BUSYOnCallee busy stop switch โ€” stops trying other gateways when 486 Busy received
๐Ÿ”— SS_GATEWAY_SWITCH_UNTIL_CONNECTOffSwitch Gateway Until Connect โ€” when On, continues switching until 200 OK received

๐Ÿ”‘ Key takeaway: The default VOS3000 configuration creates a logical switching strategy โ€” try alternative gateways when the primary is unresponsive (INVITE timeout), but stop switching once the call progresses to the point where switching would cause disruption (SDP received, RTP started, callee busy). This is the correct behavior for virtually all VoIP deployments. โœ…

๐Ÿ–ฅ๏ธ Per-Gateway INVITE Timeout and Stop Switch Settings

๐ŸŽฏ Not all gateways are created equal. VOS3000 provides per-gateway overrides for both INVITE timeout and stop switch behavior. ๐Ÿ“ก

๐Ÿ“‹ Gateway-Level SIP Settings

๐Ÿ“ Path: Routing Gateway โ†’ Additional settings โ†’ Protocol โ†’ SIP

Gateway SettingDefault SourceFunction
๐Ÿ“ž Invite timeoutSS_SIP_TIMEOUT_INVITE (10s)INVITE signal timeout for this specific gateway
๐Ÿ›‘ Stop switch gateway after receive SDPSS_SIP_STOP_SWITCH_AFTER_SDP (On)Prevent or allow gateway switching once SDP is received
๐Ÿšซ Stop switching response codeโ€”Stop switch gateway when receiving this specific SIP code
๐Ÿ”„ Stop switch gateway after INVITE timeoutSS_SIP_USER_AGENT_STOP_SWITCH_AFTER_INVITE_TIMEOUT (Off)Control failover behavior after INVITE timeout expires
Gateway TypeRecommended INVITE TimeoutRationale
๐Ÿข Local LAN gateway5โ€“8 secondsโœ… Fast response expected; shorter timeout frees resources quickly
๐ŸŒ Standard WAN gateway10 seconds (default)๐Ÿ”ง Proven balance for typical VoIP networks
๐Ÿ“ก High-latency / satellite15โ€“20 secondsโฑ๏ธ Accounts for propagation delay and slow gateway response
๐Ÿ›ก๏ธ Premium carrier gateway8โ€“10 seconds๐Ÿ“ž Reliable carriers respond quickly; faster failover on failure
โš ๏ธ Intermittent gateway5โ€“7 seconds๐Ÿ”„ Quick failover to backup route; minimize dead air time

๐Ÿšซ Stop Switching Response Code โ€” Per-Code Control

๐Ÿ“‹ Beyond the global stop switch parameters, VOS3000 offers a more granular control: the “Stop switching response code” per-gateway setting. This lets you specify a particular SIP response code that triggers stop-switch behavior. ๐ŸŽฏ

SIP CodeMeaningSet as Stop Code?Rationale
๐Ÿšซ 403 ForbiddenDestination not authorizedโœ… YesOther gateways likely same result
๐Ÿ” 404 Not FoundDestination does not existโœ… YesNumber invalid on all routes
๐Ÿ”ง 503 Service UnavailableGateway overloadedโŒ NoAnother gateway may accept โ€” see our SIP 503/408 fix guide
โฑ๏ธ 408 Request TimeoutNo response from gatewayโŒ NoBackup gateway should be tried

๐Ÿ”ง Step-by-Step Configuration

๐Ÿ–ฅ๏ธ Follow these steps to configure the VOS3000 SIP INVITE timeout and gateway switching parameters:

Step 1: Configure Global INVITE Timeout ๐ŸŒ

  1. ๐Ÿ” Log in to VOS3000 Client
  2. ๐Ÿ“Œ Navigate: Operation management โ†’ Softswitch management โ†’ Additional settings โ†’ SIP parameter
  3. ๐Ÿ” Locate SS_SIP_TIMEOUT_INVITE and set based on network characteristics (default: 10)
  4. ๐Ÿ” Verify SS_SIP_STOP_SWITCH_AFTER_SDP is On (default)
  5. ๐Ÿ” Verify SS_SIP_USER_AGENT_STOP_SWITCH_AFTER_INVITE_TIMEOUT is Off (default)
  6. ๐Ÿ’พ Save and apply

Step 2: Configure Per-Gateway Settings ๐ŸŽฏ

  1. ๐Ÿ“Œ Navigate: Routing Gateway โ†’ Additional settings โ†’ Protocol โ†’ SIP
  2. โœ๏ธ Set Invite timeout per gateway (leave empty for global default)
  3. ๐Ÿ”ง Configure Stop switch gateway after receive SDP โ€” typically leave Default/On
  4. ๐Ÿšซ Set Stop switching response code if needed (e.g., 403, 404)
  5. ๐Ÿ”„ Set Stop switch gateway after INVITE timeout โ€” typically leave Default/Off
  6. ๐Ÿ’พ Save gateway configuration

Step 3: Configure System-Level Gateway Switch Parameters โš™๏ธ

ParameterDefaultRecommendedNotes
SS_GATEWAY_SWITCH_LIMITNone3โ€“5โœ… Prevents excessive failover loops
SS_GATEWAY_SWITCH_STOP_AFTER_RTP_STARTOnOn๐Ÿ“ž Never switch after media starts
SS_GATEWAY_SWITCH_STOP_AFTER_USER_BUSYOnOn๐Ÿšซ Busy means busy on all routes typically
SS_GATEWAY_SWITCH_UNTIL_CONNECTOffOffโš ๏ธ Setting On may cause excessive switching

๐Ÿ›ก๏ธ Common Problems and Solutions

โŒ Problem 1: Gateway Failover Not Triggering

๐Ÿ” Symptom: When the primary gateway goes down, calls fail instead of routing to the backup gateway.

๐Ÿ’ก Cause: The “Stop switch gateway after INVITE timeout” is set to On, preventing VOS3000 from trying the next gateway.

โœ… Solutions:

  • ๐Ÿ”„ Set “Stop switch gateway after INVITE timeout” to Off (default) in the gateway’s SIP settings
  • ๐Ÿ“‹ Verify your vendor failover configuration includes backup gateways
  • ๐Ÿ›ก๏ธ Ensure the SS_SIP_USER_AGENT_STOP_SWITCH_AFTER_INVITE_TIMEOUT global parameter is also Off

โŒ Problem 2: Audio Disruption During Call Setup

๐Ÿ” Symptom: Callers hear ringback tone that suddenly cuts off and restarts, or brief audio glitches during call setup.

๐Ÿ’ก Cause: SS_SIP_STOP_SWITCH_AFTER_SDP is set to Off, allowing VOS3000 to switch gateways after SDP has been received and early media is flowing.

โœ… Solutions:

  • ๐Ÿ›‘ Set SS_SIP_STOP_SWITCH_AFTER_SDP to On (default) globally
  • ๐Ÿ”ง Check per-gateway settings โ€” ensure “Stop switch gateway after receive SDP” is not Off
  • ๐Ÿ“ž Verify SS_GATEWAY_SWITCH_STOP_AFTER_RTP_START is On

โŒ Problem 3: Callers Hear Long Dead Air Before Failure

๐Ÿ” Symptom: Callers hear 15-20 seconds of silence before getting a busy or failure tone.

๐Ÿ’ก Cause: The VOS3000 SIP INVITE timeout is set too high, causing the softswitch to wait unnecessarily long.

โœ… Solutions:

  • โฑ๏ธ Reduce the INVITE timeout to 8-10 seconds for standard gateways
  • ๐ŸŽฏ For local gateways, set per-gateway timeout to 5 seconds
  • ๐Ÿ”„ Ensure failover is enabled so backup gateways are tried quickly
  • ๐Ÿ“Š Monitor your call termination reasons to identify patterns

๐Ÿ“Š Complete Parameter Reference

ParameterDefaultUnitPurpose
SS_SIP_TIMEOUT_INVITE10SecondsSIP INVITE timeout โ€” total wait for INVITE response
SS_SIP_RESEND_INTERVAL0.5,1,2,4,4,4,4,4,4,4SecondsINVITE retransmission intervals
SS_SIP_STOP_SWITCH_AFTER_SDPOnOn/OffStop gateway switching after SDP received
SS_SIP_USER_AGENT_STOP_SWITCH_AFTER_INVITE_TIMEOUTOffOn/OffStop gateway switching after INVITE timeout
SS_GATEWAY_SWITCH_LIMITNoneNumberMax gateway switching attempts
SS_GATEWAY_SWITCH_STOP_AFTER_RTP_STARTOnOn/OffStop switching after RTP media starts
SS_GATEWAY_SWITCH_STOP_AFTER_USER_BUSYOnOn/OffStop switching on 486 Busy
SS_GATEWAY_SWITCH_UNTIL_CONNECTOffOn/OffKeep switching until 200 OK

โ“ Frequently Asked Questions

โ“ What is the default VOS3000 SIP INVITE timeout?

โฑ๏ธ The default VOS3000 SIP INVITE timeout is 10 seconds, configured via SS_SIP_TIMEOUT_INVITE. VOS3000 will wait up to 10 seconds for any response before considering the attempt failed. The default can be overridden per gateway in Routing Gateway > Additional settings > Protocol > SIP.

โ“ What does SS_SIP_STOP_SWITCH_AFTER_SDP do?

๐Ÿ›‘ When On (default), VOS3000 stops trying alternative gateways once it receives SDP in a provisional response (like 183 Session Progress with SDP). This prevents mid-call audio disruption, double-answer scenarios, and media path instability. When Off, VOS3000 may switch gateways even after media negotiation has begun โ€” which is almost never desirable. Keep this On. ๐Ÿ”ง

โ“ Should I enable stop switch after INVITE timeout?

๐Ÿ”„ No โ€” keep it Off (default) for most deployments. When a gateway does not respond to an INVITE, you want VOS3000 to try the next available gateway (failover). Setting it to On means VOS3000 stops switching and the call fails immediately. The only exception is compliance routing where failover to a different carrier is not permitted. ๐Ÿ›๏ธ

โ“ How do I prevent infinite gateway switching loops?

๐Ÿ”ข Set SS_GATEWAY_SWITCH_LIMIT to a reasonable value (3โ€“5 gateway attempts). This prevents VOS3000 from endlessly cycling through gateways when all are failing. Also keep SS_GATEWAY_SWITCH_UNTIL_CONNECT Off (default) and ensure SS_SIP_STOP_SWITCH_AFTER_SDP is On (default). ๐Ÿ›ก๏ธ

๐Ÿ“ž Need Expert Help?

๐Ÿ”ง Proper VOS3000 SIP INVITE timeout and gateway switching configuration is essential for maximizing call completion rates, enabling fast gateway failover, and delivering a quality caller experience. Whether you need help with timeout tuning, stop switch configuration, or troubleshooting failover issues, our team is ready to assist. ๐Ÿ›ก๏ธ

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


๐Ÿ“ž Need Professional VOS3000 Setup Support?

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

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


VOS3000 SIP Authentication Retry, VOS3000 SIP Early Hangup, VOS3000 SIP Session Timer Refresh, VOS3000 Non-Timer Endpoint Safety, VOS3000 SIP NAT Keepalive, VOS3000 SIP Resend Interval, VOS3000 SIP INVITE Timeout, VOS3000 SIP Call Progress Timeout, VOS3000 SIP Outbound Registration Parameters, VOS3000 SIP Privacy Header, VOS3000 SIP Routing Gateway Contact, VOS3000 SIP Publish Expire, VOS3000 SIP Display From, VOS3000 SIP Send UnregisterVOS3000 SIP Authentication Retry, VOS3000 SIP Early Hangup, VOS3000 SIP Session Timer Refresh, VOS3000 Non-Timer Endpoint Safety, VOS3000 SIP NAT Keepalive, VOS3000 SIP Resend Interval, VOS3000 SIP INVITE Timeout, VOS3000 SIP Call Progress Timeout, VOS3000 SIP Outbound Registration Parameters, VOS3000 SIP Privacy Header, VOS3000 SIP Routing Gateway Contact, VOS3000 SIP Publish Expire, VOS3000 SIP Display From, VOS3000 SIP Send UnregisterVOS3000 SIP Authentication Retry, VOS3000 SIP Early Hangup, VOS3000 SIP Session Timer Refresh, VOS3000 Non-Timer Endpoint Safety, VOS3000 SIP NAT Keepalive, VOS3000 SIP Resend Interval, VOS3000 SIP INVITE Timeout, VOS3000 SIP Call Progress Timeout, VOS3000 SIP Outbound Registration Parameters, VOS3000 SIP Privacy Header, VOS3000 SIP Routing Gateway Contact, VOS3000 SIP Publish Expire, VOS3000 SIP Display From, VOS3000 SIP Send Unregister
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 Privacy Header: Essential Caller ID Protection Guide

VOS3000 SIP Privacy Header: Essential Caller ID Protection Guide

๐Ÿ” Have you ever needed to protect caller identity on your VOS3000 softswitch โ€” but found yourself confused by the three different privacy modes and how they interact with per-gateway settings? The VOS3000 SIP privacy header is the key to controlling exactly how caller ID information is exposed or hidden in your SIP signaling. Configured via SS_SIP_USER_AGENT_PRIVACY, this parameter determines whether VOS3000 includes a Privacy header in outbound SIP messages and what value that header carries. ๐Ÿ›ก๏ธ

๐Ÿ“ž Whether you are managing wholesale VoIP routes that require caller ID hiding, enterprise PBX trunks with privacy requirements, or regulatory compliance for caller identification, understanding the VOS3000 SIP privacy header is essential. The global parameter controls the default behavior, while per-gateway settings on Routing Gateways and Mapping Gateways give you granular control over each interconnect. This guide covers every aspect โ€” from the three global modes (Ignore/Id/None) to per-gateway Privacy, P-Asserted-Identity, and P-Preferred-Identity configuration. ๐ŸŽฏ

๐Ÿ”ง We will reference only official VOS3000 2.1.9.07 manual data โ€” no guesses, no fabricated values. Let’s dive in! ๐Ÿ’ก

Table of Contents

๐Ÿ” What Is VOS3000 SIP Privacy Header?

๐Ÿ›ก๏ธ The VOS3000 SIP privacy header controls whether VOS3000 includes a Privacy header in SIP messages sent by registered user agents. The Privacy header, defined in RFC 3323, signals to downstream entities how the caller’s identity should be handled โ€” specifically whether the caller ID should be hidden from the called party or displayed normally. ๐Ÿ“ž

๐Ÿ“‹ This parameter is governed by SS_SIP_USER_AGENT_PRIVACY with a default value of Ignore. Here is the official reference from the VOS3000 2.1.9.07 manual:

AttributeValue
๐Ÿ“Œ Parameter NameSS_SIP_USER_AGENT_PRIVACY
๐Ÿ”ข Default ValueIgnore
๐Ÿ“ DescriptionPrivacy Setting for Register User
โš™๏ธ OptionsIgnore / Id / None
๐Ÿ“ NavigationOperation management โ†’ Softswitch management โ†’ Additional settings โ†’ SIP parameter

๐Ÿ’ก Key insight: The default of “Ignore” means VOS3000 does NOT include any Privacy header in outbound SIP messages. This is the most common setting for standard VoIP deployments where caller ID presentation is the default behavior. Only when you change this to “Id” or “None” will VOS3000 actively insert a Privacy header.

๐ŸŽฏ Why VOS3000 SIP Privacy Header Matters

โš ๏ธ Without proper privacy header configuration, several problems can occur:

  • ๐Ÿ”“ Unintended caller ID exposure: Sensitive caller numbers may be visible to downstream providers or called parties when they should be hidden
  • ๐Ÿ“‹ Regulatory non-compliance: Many jurisdictions require caller ID blocking capability; without Privacy headers, you cannot honor user privacy requests
  • ๐Ÿšซ Call rejection by carriers: Some carriers reject calls without proper privacy indicators when the calling party has requested anonymity
  • ๐Ÿ”„ Inconsistent privacy behavior: Without per-gateway control, privacy settings are “all or nothing” across all interconnects
  • ๐Ÿ“ก Identity header mismatch: Privacy header must be coordinated with P-Asserted-Identity and P-Preferred-Identity headers for consistent caller identification

โš™๏ธ VOS3000 SIP Privacy Header Modes Explained

๐Ÿ“Š The SS_SIP_USER_AGENT_PRIVACY parameter offers three distinct modes, each producing a different SIP signaling behavior. Understanding exactly what each mode does is critical for proper configuration. ๐Ÿ”‘

ModeSIP Header OutputMeaningUse Case
๐Ÿšซ Ignore (Default)No Privacy fieldVOS3000 does not add any Privacy header โ€” caller ID is presented normallyStandard VoIP โ€” caller ID shown to called party
๐Ÿ” IdPrivacy: idRequests identity privacy โ€” the caller ID should be hidden from the called party but available to trusted network entitiesCaller ID blocking โ€” caller requested privacy
๐Ÿ”“ NonePrivacy: noneExplicitly states no privacy is requested โ€” caller ID may be displayedExplicit caller ID presentation โ€” overrides network defaults

๐Ÿ”‘ Critical distinction: “Privacy: id” and “Privacy: none” are NOT the same as omitting the header entirely. According to RFC 3323, the absence of a Privacy header means no privacy preference is expressed (the network decides), while “Privacy: none” explicitly declares that no privacy is requested. “Privacy: id” requests that the calling user’s identity be kept private from the called party. ๐Ÿ“ก

๐Ÿ“ก SIP Message Examples Per Mode

๐Ÿ“ž VOS3000 SIP Privacy Header โ€” Message Examples:

โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€
๐Ÿšซ Mode: Ignore (Default) โ€” No Privacy header
โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€
INVITE sip:[email protected] SIP/2.0
Via: SIP/2.0/UDP 192.168.1.1:5060
From: "Alice" <sip:[email protected]>;tag=1234
To: <sip:[email protected]>
Call-ID: [email protected]
CSeq: 1 INVITE
Content-Type: application/sdp
Content-Length: ...
  โ† No Privacy header present

โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€
๐Ÿ” Mode: Id โ€” Privacy: id header added
โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€
INVITE sip:[email protected] SIP/2.0
Via: SIP/2.0/UDP 192.168.1.1:5060
From: "Anonymous" <sip:[email protected]>;tag=1234
To: <sip:[email protected]>
Privacy: id
Call-ID: [email protected]
CSeq: 1 INVITE
Content-Type: application/sdp
Content-Length: ...
  โ† Privacy: id โ€” caller identity hidden

โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€
๐Ÿ”“ Mode: None โ€” Privacy: none header added
โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€
INVITE sip:[email protected] SIP/2.0
Via: SIP/2.0/UDP 192.168.1.1:5060
From: "Alice" <sip:[email protected]>;tag=1234
To: <sip:[email protected]>
Privacy: none
Call-ID: [email protected]
CSeq: 1 INVITE
Content-Type: application/sdp
Content-Length: ...
  โ† Privacy: none โ€” no privacy requested

๐Ÿ–ฅ๏ธ Per-Gateway VOS3000 SIP Privacy Settings (Routing Gateway)

๐Ÿ”ง While SS_SIP_USER_AGENT_PRIVACY controls the global default, VOS3000 provides powerful per-gateway privacy controls on Routing Gateways. These settings are found in Routing Gateway > Additional settings > Protocol > SIP and offer far more granularity than the global parameter alone. ๐ŸŽฏ

๐Ÿ’ก The per-gateway settings include not just the Privacy header, but also the P-Preferred-Identity and P-Asserted-Identity headers โ€” both defined in RFC 3325. These identity headers work together with the Privacy header to provide a complete caller identification and privacy framework. ๐Ÿ“‹

SettingOptionsDescription
๐Ÿ›ก๏ธ PrivacyNone / Passthrough / IdSIP Privacy header โ€” controls caller ID privacy for this gateway
๐Ÿ‘ค P-Preferred-IdentityNone / Passthrough / CallerSIP P-Preferred-Identity header โ€” preferred identity for the caller
๐Ÿ“‹ P-Asserted-IdentityNone / Passthrough / CallerSIP P-Asserted-Identity header โ€” asserted identity for the caller
๐Ÿ“ž Caller dial planDial plan selectionDial plans for the caller number in “P-Asserted-Identity” field

๐Ÿ›ก๏ธ Routing Gateway Privacy Options in Detail

๐Ÿ“Š The per-gateway Privacy setting on Routing Gateways provides three options that differ from the global SS_SIP_USER_AGENT_PRIVACY modes. Here is what each option does: ๐Ÿ”

OptionSIP Header EffectBehaviorWhen to Use
๐Ÿšซ NoneNo Privacy field addedVOS3000 does not add any Privacy header to outbound INVITE messages via this gatewayStandard termination โ€” caller ID presented normally
๐Ÿ”„ PassthroughPass through privacy fieldVOS3000 forwards any existing Privacy header from the incoming call leg to the outbound leg via this gatewayTransparent proxy โ€” honor upstream privacy requests
๐Ÿ” IdAdd Privacy: id headerVOS3000 actively adds “Privacy: id” to outbound INVITE messages via this gatewayForce caller ID hiding on this gateway

๐Ÿ’ก Important: The Passthrough option is particularly powerful for wholesale VoIP providers. When a downstream carrier sends a call with “Privacy: id” and you need to forward that call to a termination provider, Passthrough ensures the privacy request is honored end-to-end. Without Passthrough, the Privacy header would be dropped and the caller ID could be exposed. For more on SIP call flow, see our SIP call flow guide. ๐Ÿ“ก

๐Ÿ“‹ P-Asserted-Identity and P-Preferred-Identity Headers

๐Ÿ‘ค The P-Asserted-Identity (PAI) and P-Preferred-Identity (PPI) headers work hand-in-hand with the VOS3000 SIP privacy header. While the Privacy header controls whether the caller ID should be hidden, the PAI and PPI headers carry the actual caller identity information within the trusted network. ๐Ÿ”

๐ŸŽฏ For a deep dive into PAI configuration, see our dedicated VOS3000 P-Asserted-Identity caller ID guide. Below is the per-gateway reference for both headers:

HeaderOptionSIP EffectUse Case
๐Ÿ“‹ P-Asserted-IdentityNoneNo PAI header addedProvider does not require PAI
๐Ÿ“‹ P-Asserted-IdentityPassthroughForward existing PAI header from upstreamTransparent โ€” forward caller identity
๐Ÿ“‹ P-Asserted-IdentityCallerAdd PAI header with caller numberProvider requires PAI for caller identification
๐Ÿ‘ค P-Preferred-IdentityNoneNo PPI header addedStandard โ€” no PPI needed
๐Ÿ‘ค P-Preferred-IdentityPassthroughForward existing PPI header from upstreamTransparent โ€” forward preferred identity
๐Ÿ‘ค P-Preferred-IdentityCallerAdd PPI header with caller numberUAC-originated calls with preferred identity

๐Ÿ” Key relationship: When Privacy: id is set and P-Asserted-Identity is also configured, the PAI header carries the real caller identity within the trusted network while the Privacy header instructs the network to hide this identity from the called party. The From header is typically set to “Anonymous” while the PAI contains the actual number. This is the standard pattern for caller ID blocking in SIP networks per RFC 3325. ๐Ÿ“ก

๐Ÿ“ž Caller Dial Plan for P-Asserted-Identity

๐Ÿ”ง The Caller dial plan setting in the Routing Gateway SIP configuration determines how the caller number is formatted in the P-Asserted-Identity field. This is essential when the termination provider requires a specific number format (e.g., E.164 with country code, or local format without country code). The dial plan transforms the caller number before it is placed in the PAI header. ๐Ÿ“‹

๐Ÿ’ก For comprehensive caller ID management including dial plans and number formatting, refer to our VOS3000 caller ID management guide. ๐ŸŽฏ

๐Ÿ”„ Per-Gateway VOS3000 SIP Privacy Header (Mapping Gateway)

๐Ÿ–ฅ๏ธ In addition to Routing Gateway settings, VOS3000 also provides privacy control on the Mapping Gateway side. This is configured in Mapping Gateway > Additional settings > Protocol > SIP. ๐Ÿ”ง

SettingDescription
๐Ÿ›ก๏ธ Support PrivacyPass through mapping gateway private domain โ€” forwards Privacy header through the mapping gateway

๐Ÿ’ก What this does: When Support Privacy is enabled on a Mapping Gateway, VOS3000 passes through the Privacy header from the originating side to the routing side through the mapping gateway’s private domain. This ensures that privacy requests are preserved across the mapping gateway boundary. If disabled, the Privacy header may be stripped when the call traverses the mapping gateway. ๐Ÿ“ก

๐ŸŽฏ When to enable: Enable Support Privacy on Mapping Gateways when you need end-to-end privacy header preservation across multiple network domains. This is critical for wholesale VoIP providers who need to honor upstream privacy requests when routing calls through mapping gateways. For more about gateway configuration, see our gateway configuration guide. ๐Ÿ”—

๐Ÿ“Š The SS_SIP_E164_DISPLAY_FROM parameter is closely related to the VOS3000 SIP privacy header. While the Privacy header controls whether the caller ID is hidden, SS_SIP_E164_DISPLAY_FROM controls how the caller’s display information appears in the SIP From header. ๐Ÿ“‹

AttributeValue
๐Ÿ“Œ Parameter NameSS_SIP_E164_DISPLAY_FROM
๐Ÿ”ข Default ValueIgnore
๐Ÿ“ DescriptionMode of SIP display information
๐Ÿ“ NavigationOperation management โ†’ Softswitch management โ†’ Additional settings โ†’ SIP parameter

๐Ÿ’ก Why it matters: When SS_SIP_USER_AGENT_PRIVACY is set to “Id” (Privacy: id), the From header display name is typically changed to “Anonymous.” The SS_SIP_E164_DISPLAY_FROM parameter controls the display information format in the From header independently โ€” it determines whether the display portion uses E.164 format, the original format, or is ignored. Both parameters work together to control how caller identity is presented in SIP signaling. For the complete parameter reference, see our VOS3000 parameter description and system parameters guide. ๐Ÿ”ง

๐Ÿ”ง Step-by-Step VOS3000 SIP Privacy Header Configuration

โš™๏ธ Follow these steps to configure the VOS3000 SIP privacy header on your system:

Step 1: Configure Global SS_SIP_USER_AGENT_PRIVACY ๐Ÿ“‹

  1. ๐Ÿ” Log in to VOS3000 Client
  2. ๐Ÿ“Œ Navigate: Operation management โ†’ Softswitch management โ†’ Additional settings โ†’ SIP parameter
  3. ๐Ÿ” Locate SS_SIP_USER_AGENT_PRIVACY in the parameter list
  4. โœ๏ธ Select the desired mode: Ignore / Id / None
  5. ๐Ÿ’พ Save and apply the changes

Step 2: Configure Per-Gateway Privacy on Routing Gateways ๐Ÿ–ฅ๏ธ

  1. ๐Ÿ“Œ Navigate: Routing Gateway โ†’ [Select Gateway] โ†’ Additional settings โ†’ Protocol โ†’ SIP
  2. ๐Ÿ›ก๏ธ Set Privacy: None / Passthrough / Id
  3. ๐Ÿ‘ค Set P-Preferred-Identity: None / Passthrough / Caller
  4. ๐Ÿ“‹ Set P-Asserted-Identity: None / Passthrough / Caller
  5. ๐Ÿ“ž Select Caller dial plan for PAI number formatting (if P-Asserted-Identity is set to Caller)
  6. ๐Ÿ’พ Save gateway settings

Step 3: Configure Mapping Gateway Privacy (If Applicable) ๐Ÿ”„

  1. ๐Ÿ“Œ Navigate: Mapping Gateway โ†’ [Select Gateway] โ†’ Additional settings โ†’ Protocol โ†’ SIP
  2. ๐Ÿ›ก๏ธ Enable Support Privacy to pass through privacy fields
  3. ๐Ÿ’พ Save mapping gateway settings

Step 4: Verify with SIP Debug ๐Ÿ”

๐Ÿ“ After configuration, verify the privacy headers are working correctly using SIP debug tools. For comprehensive debugging instructions, see our VOS3000 troubleshooting guide.

๐Ÿ“ž VOS3000 SIP Privacy Header โ€” Verification Flow:

Caller โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€ VOS3000 โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€ Termination Gateway
  โ”‚                      โ”‚                          โ”‚
  โ”‚โ”€โ”€ INVITE โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ–บโ”‚                          โ”‚
  โ”‚   From: sip:1234@... โ”‚                          โ”‚
  โ”‚   Privacy: id        โ”‚                          โ”‚
  โ”‚                      โ”‚                          โ”‚
  โ”‚                      โ”‚โ”€โ”€ INVITE โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ–บโ”‚
  โ”‚                      โ”‚   From: Anonymous@...    โ”‚
  โ”‚                      โ”‚   Privacy: id            โ”‚  โ† Per-gateway Privacy=Id
  โ”‚                      โ”‚   P-Asserted-Identity:   โ”‚  โ† Per-gateway PAI=Caller
  โ”‚                      โ”‚     <sip:1234@domain>   โ”‚
  โ”‚                      โ”‚                          โ”‚
  โ”‚                      โ”‚  โœ… Called party sees:   โ”‚
  โ”‚                      โ”‚  "Anonymous" (From)      โ”‚
  โ”‚                      โ”‚  Trusted network sees:   โ”‚
  โ”‚                      โ”‚  1234 (PAI header)       โ”‚

๐Ÿ“Š VOS3000 SIP Privacy Header Best Practices by Deployment

๐ŸŽฏ Different VoIP deployment types require different privacy header configurations. Here are our recommended settings based on real-world experience: ๐Ÿ’ก

Deployment TypeGlobal PrivacyRouting GW PrivacyPAI SettingRationale
๐Ÿ“ž Wholesale VoIPIgnorePassthroughCallerHonor upstream privacy; provide PAI for caller ID delivery
๐Ÿข Enterprise PBXIgnoreNone or PassthroughCallerPresent caller ID normally; PAI for carrier requirements
๐Ÿ” Privacy-required routesIdIdCallerForce Privacy: id on all calls; PAI carries real number in trusted network
๐Ÿ“ก SIP trunkingIgnorePassthroughPassthrough or CallerTransparent privacy handling; follow upstream provider requirements
๐ŸŒ Multi-carrier routingIgnorePer-carrier settingsPer-carrier settingsDifferent carriers have different PAI and privacy requirements

๐Ÿ’ก Pro tip: The most flexible approach is to set the global SS_SIP_USER_AGENT_PRIVACY to Ignore and then use per-gateway settings on Routing Gateways for specific privacy requirements. This way, each termination provider can have its own Privacy, PAI, and PPI settings without affecting other gateways. For call routing configuration, see our call routing guide. ๐Ÿ“Š

๐Ÿ›ก๏ธ Common VOS3000 SIP Privacy Header Problems and Solutions

โš ๏ธ Misconfigured privacy headers can cause a range of issues. Here are the most common problems and their solutions:

โŒ Problem 1: Caller ID Not Hidden Despite Privacy: id

๐Ÿ” Symptom: SS_SIP_USER_AGENT_PRIVACY is set to “Id” but the called party still sees the caller number.

๐Ÿ’ก Cause: The per-gateway Privacy setting on the Routing Gateway may be set to “None,” which overrides the global parameter. Or the termination provider is ignoring the Privacy header and reading the number from the PAI header without honoring the privacy indicator.

โœ… Solutions:

  • ๐Ÿ”ง Verify the per-gateway Privacy setting is set to “Id” or “Passthrough” on the relevant Routing Gateway
  • ๐Ÿ“‹ Check that the P-Asserted-Identity header is not being sent to untrusted networks
  • ๐Ÿ“ก Capture a SIP trace to confirm the Privacy: id header is actually present in the outbound INVITE

โŒ Problem 2: Privacy Header Not Preserved Across Mapping Gateways

๐Ÿ” Symptom: Privacy header is present on the originating side but missing on the termination side after the call passes through a Mapping Gateway.

๐Ÿ’ก Cause: The Mapping Gateway’s Support Privacy setting is not enabled, so the Privacy header is stripped during the mapping gateway traversal.

โœ… Solutions:

  • ๐Ÿ›ก๏ธ Enable Support Privacy on the Mapping Gateway: Mapping Gateway > Additional settings > Protocol > SIP
  • ๐Ÿ”„ Verify the privacy field is passing through by checking SIP traces on both sides of the mapping gateway
  • ๐Ÿ“‹ If using multiple mapping gateways, ensure Support Privacy is enabled on all of them

โŒ Problem 3: Termination Provider Rejects Calls Without PAI

๐Ÿ” Symptom: Calls to a specific termination provider are rejected with SIP 403 or 403 errors. The provider requires a P-Asserted-Identity header.

๐Ÿ’ก Cause: The P-Asserted-Identity setting on the Routing Gateway for this provider is set to “None,” so no PAI header is included in the outbound INVITE.

โœ… Solutions:

  • ๐Ÿ“‹ Set P-Asserted-Identity to Caller on the Routing Gateway for this provider
  • ๐Ÿ“ž Configure the Caller dial plan to format the number as required by the provider (e.g., E.164 with + prefix)
  • ๐Ÿ” If privacy is also required, keep Privacy set to “Id” โ€” the PAI header will carry the number in the trusted network while the From header shows “Anonymous”

โŒ Problem 4: Confusion Between Global and Per-Gateway Privacy Settings

๐Ÿ” Symptom: Privacy behavior is inconsistent โ€” some gateways hide caller ID and others do not, and you are unsure which setting is in control.

๐Ÿ’ก Cause: Both the global SS_SIP_USER_AGENT_PRIVACY and per-gateway Privacy settings exist, and they can conflict or produce unexpected results when not coordinated.

โœ… Solutions:

  • โš™๏ธ Set the global SS_SIP_USER_AGENT_PRIVACY to Ignore as a baseline
  • ๐Ÿ–ฅ๏ธ Use per-gateway Privacy settings on Routing Gateways to control privacy for each interconnect independently
  • ๐Ÿ“ Document which gateways have which privacy settings for easy troubleshooting
  • ๐Ÿ” For security best practices, see our VOS3000 security guide

๐Ÿ“‹ Complete VOS3000 SIP Privacy Header Parameter Quick Reference

๐Ÿ“Š Here is the complete reference table for all privacy-related parameters and settings in VOS3000:

Parameter / SettingDefaultLocationScope
SS_SIP_USER_AGENT_PRIVACYIgnoreSIP parameter (global)All registered users
SS_SIP_E164_DISPLAY_FROMIgnoreSIP parameter (global)All SIP display information
Privacy (Routing GW)โ€”Routing GW > SIPPer-routing-gateway
P-Asserted-Identity (Routing GW)โ€”Routing GW > SIPPer-routing-gateway
P-Preferred-Identity (Routing GW)โ€”Routing GW > SIPPer-routing-gateway
Caller dial plan (Routing GW)โ€”Routing GW > SIPPer-routing-gateway (PAI format)
Support Privacy (Mapping GW)โ€”Mapping GW > SIPPer-mapping-gateway

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

๐Ÿ’ก VOS3000 SIP Privacy Header Configuration Checklist

โœ… Use this checklist when deploying or tuning your VOS3000 SIP privacy header settings:

CheckActionStatus
๐Ÿ“Œ 1Set SS_SIP_USER_AGENT_PRIVACY to appropriate mode (Ignore/Id/None) for your deploymentโ˜
๐Ÿ“Œ 2Configure per-gateway Privacy on each Routing Gateway (None/Passthrough/Id)โ˜
๐Ÿ“Œ 3Set P-Asserted-Identity on each Routing Gateway per provider requirementsโ˜
๐Ÿ“Œ 4Configure P-Preferred-Identity where needed (typically for UAC-originated calls)โ˜
๐Ÿ“Œ 5Select Caller dial plan for PAI number formatting on each Routing Gatewayโ˜
๐Ÿ“Œ 6Enable Support Privacy on Mapping Gateways that need to preserve privacy headersโ˜
๐Ÿ“Œ 7Verify with SIP trace that Privacy and identity headers appear correctly in outbound INVITEโ˜
๐Ÿ“Œ 8Review SS_SIP_E164_DISPLAY_FROM for consistent From header display behaviorโ˜

โ“ Frequently Asked Questions

โ“ What is the default VOS3000 SIP privacy header setting?

๐Ÿ›ก๏ธ The default VOS3000 SIP privacy header setting is Ignore, configured via the SS_SIP_USER_AGENT_PRIVACY parameter. When set to Ignore, VOS3000 does not include any Privacy header in SIP messages โ€” caller ID is presented normally. The other options are “Id” (adds Privacy: id to hide caller identity) and “None” (adds Privacy: none to explicitly indicate no privacy requested). ๐Ÿ””

โ“ What is the difference between Privacy: id and Privacy: none?

๐Ÿ“Š Privacy: id requests that the calling user’s identity be kept private from the called party โ€” the From header typically shows “Anonymous” while the real number is carried in the P-Asserted-Identity header within the trusted network. Privacy: none explicitly states that no privacy is requested and the caller ID may be displayed. The key difference from having no Privacy header at all is that “Privacy: none” is an explicit declaration, while the absence of a header means no privacy preference is expressed. Per RFC 3323, these are semantically different. ๐Ÿ“ก

โ“ How do per-gateway Privacy settings interact with SS_SIP_USER_AGENT_PRIVACY?

๐Ÿ”ง The global SS_SIP_USER_AGENT_PRIVACY controls the default privacy behavior for all registered user agents. The per-gateway Privacy settings on Routing Gateways provide more granular control for each termination interconnect. The recommended approach is to set the global parameter to Ignore and use per-gateway settings for specific requirements โ€” this gives you the most flexibility. Per-gateway settings take precedence over the global default for calls routed through that specific gateway. ๐Ÿ–ฅ๏ธ

โ“ When should I use the Passthrough option for Privacy?

๐Ÿ”„ Use Passthrough when you need to preserve an existing Privacy header from an upstream provider. For example, if a wholesale customer sends a call with “Privacy: id” and you need to forward that call to a termination provider while honoring the privacy request, set the Routing Gateway’s Privacy to Passthrough. This is the most common setting for wholesale VoIP providers who act as a transit between originating and terminating networks. Without Passthrough, the Privacy header would be dropped and the caller ID could be exposed unintentionally. ๐Ÿ“ž

โ“ Do I need P-Asserted-Identity when using Privacy: id?

๐Ÿ” Yes, in most cases. When Privacy: id is set, the From header displays “Anonymous” to the called party. However, the real caller identity still needs to be communicated within the trusted network for billing, routing, and regulatory purposes. The P-Asserted-Identity (PAI) header carries this information โ€” it is visible to trusted network entities but should not be forwarded to untrusted endpoints. Setting PAI to “Caller” on the Routing Gateway ensures the real number is included in the PAI header while the Privacy header keeps it hidden from the called party. For detailed PAI configuration, see our P-Asserted-Identity guide. ๐Ÿ“‹

โ“ What does Support Privacy on Mapping Gateway do?

๐Ÿ–ฅ๏ธ The Support Privacy setting on Mapping Gateways enables the pass-through of the Privacy header across the mapping gateway’s private domain. When enabled, any Privacy header present in the incoming call leg is preserved and forwarded to the outbound routing side. When disabled, the Privacy header may be stripped when the call traverses the mapping gateway boundary. Enable this setting when you need end-to-end privacy header preservation in multi-domain deployments โ€” especially critical for wholesale VoIP providers. ๐Ÿ”„

โ“ How do I troubleshoot VOS3000 SIP privacy header issues?

๐Ÿ” Start by capturing a SIP trace on both the incoming and outgoing sides of VOS3000. Verify that the Privacy header appears (or does not appear) as expected in the outbound INVITE. Check that per-gateway Privacy settings match your expectations for each Routing Gateway. If privacy headers are missing after a Mapping Gateway, verify that Support Privacy is enabled. For PAI-related issues, confirm the P-Asserted-Identity setting is configured to “Caller” and the Caller dial plan is correct. For detailed troubleshooting, see our VOS3000 troubleshooting guide. For expert support, contact us on WhatsApp at +8801911119966. ๐Ÿ“ž

๐Ÿ“ž Need Expert Help with VOS3000 SIP Privacy Header?

๐Ÿ”ง Configuring the VOS3000 SIP privacy header correctly is essential for protecting caller identity, meeting regulatory requirements, and maintaining compatibility with termination providers. Whether you need help with global parameter tuning, per-gateway Privacy and PAI configuration, or troubleshooting caller ID exposure issues, our team is ready to assist. ๐Ÿ›ก๏ธ

๐Ÿ’ฌ WhatsApp: +8801911119966 โ€” Get instant support for VOS3000 SIP privacy header configuration, caller ID protection, and identity header setup. ๐ŸŒ

๐Ÿ“ž Still have questions about the VOS3000 SIP privacy header? Reach out on WhatsApp at +8801911119966 โ€” we provide professional VOS3000 installation, configuration, and support services worldwide. For official VOS3000 software downloads, visit vos3000.com. ๐ŸŒ


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