Configuration scope
Noise suppression can be configured at two levels:- Connection level: Applied to all phone numbers associated with the SIP connection. This setting overrides individual number configurations.
- Number level: Applied to specific phone numbers for granular control.
Connection-level settings take precedence over number-level configurations, simplifying management and ensuring consistent audio quality across all calls.
Configuration via API
Configure at connection level
PATCH /v2/ip_connections/ with thenoise_suppression object:
Configure at number level
PATCH /v2/phone_numbers//voice with thenoise_suppression object:
Direction options
Thedirection parameter controls which audio streams are processed:
| Value | Description | Use case |
|---|---|---|
inbound | Processes audio from the PSTN to your system | Clean up audio received by your users or applications |
outbound | Processes audio from your system to the PSTN | Reduce background noise from your users or applications |
both | Processes audio in both directions | Maximum call clarity when both sides may have background noise |
disabled | Turns off noise suppression | Preserve natural ambient sounds when needed |
Codec compatibility
Noise suppression works with standard SIP trunking codecs including:- G.711 (μ-law and A-law)
- G.722
- Opus
Performance considerations
- Each direction (inbound/outbound) is processed and billed independently
- Processing adds minimal latency (typically < 20ms)
- Noise suppression is applied in real-time during the call
- Connection-level configuration provides consistent behavior across all numbers
Best practices
- Use connection-level configuration for consistent audio quality across all phone numbers
- Enable bidirectional suppression (
both) for optimal results in noisy environments - Test with your specific use case to balance noise reduction with audio naturalness
- Monitor call quality metrics to validate the impact on your application