Actions

Difference between revisions of "SIP Headers"

From Zenitel Wiki

(Adjust default volume)
Line 2: Line 2:
 
Vingtor-Stentofon IP stations support a selection of custom SIP headers to manipulate aspects of the call. These headers must be included in the initial INVITE  
 
Vingtor-Stentofon IP stations support a selection of custom SIP headers to manipulate aspects of the call. These headers must be included in the initial INVITE  
  
=== Listen In Call (Turbine only) ===
+
===Listen In Call (Turbine only)===
 
If the station receives “'''X-Zenitel-Audio: listener'''” in a SIP INVITE message it means that the call will not be visible in the station and that audio is only sent from the station, not played out on the speaker. The audio sent from the station is microphone audio without echo cancellation, therefore any speaker audio caught by the microphone is included. The station supports one "listen in call" at a time and any new "listen in calls" will be rejected.. The station can operate normally while someone is listening, for example making a new outgoing/incoming call is possible.
 
If the station receives “'''X-Zenitel-Audio: listener'''” in a SIP INVITE message it means that the call will not be visible in the station and that audio is only sent from the station, not played out on the speaker. The audio sent from the station is microphone audio without echo cancellation, therefore any speaker audio caught by the microphone is included. The station supports one "listen in call" at a time and any new "listen in calls" will be rejected.. The station can operate normally while someone is listening, for example making a new outgoing/incoming call is possible.
 
Configuration for Asterisk  
 
Configuration for Asterisk  
Line 11: Line 11:
 
Listen-In currently supports only G.711 and G.722. G.729 is not supported
 
Listen-In currently supports only G.711 and G.722. G.729 is not supported
 
<br>
 
<br>
=== Volume (Turbine only) ===
+
===Volume (Turbine only)===
  
 
A custom volume header can be used to reduce the volume for the duration of a call. The header name is "'''X-Volume-Db'''" with allowed values from +20 to -20 dB.
 
A custom volume header can be used to reduce the volume for the duration of a call. The header name is "'''X-Volume-Db'''" with allowed values from +20 to -20 dB.
Line 27: Line 27:
 
  exten => 904,2,Dial(SIP/211)
 
  exten => 904,2,Dial(SIP/211)
  
=== Priority ===
+
===Priority===
  
 
The Priority header can be used to prioritize calls to ensure that the highest priority conversation/message is played. RFC3261 defines the "Priority" header with values: non-urgent, normal, urgent, emergency. Our handling of different priority values is described below
 
The Priority header can be used to prioritize calls to ensure that the highest priority conversation/message is played. RFC3261 defines the "Priority" header with values: non-urgent, normal, urgent, emergency. Our handling of different priority values is described below
 
If there is an existing call and the device receives a second call with same or lower priority, the new call will be rejected with busy
 
If there is an existing call and the device receives a second call with same or lower priority, the new call will be rejected with busy
 +
 
*A call with priority non-urgent is stopped when receiving a new call with priority normal
 
*A call with priority non-urgent is stopped when receiving a new call with priority normal
 
*A call with priority non-urgent or normal is stopped when receiving a new call with priority urgent or emergency
 
*A call with priority non-urgent or normal is stopped when receiving a new call with priority urgent or emergency
Line 42: Line 43:
 
  exten => 907,2,Dial(SIP/211)
 
  exten => 907,2,Dial(SIP/211)
 
   
 
   
=== Answer-Mode ===
+
===Answer-Mode===
  
 
It is possible to request answer-mode from the station by adding the header "'''Answer-Mode'''". Valid values are either "'''auto'''" or "'''manual'''". By requesting "auto" the station will automatically answer regardless of configured mode. If requesting "manual" the station will not auto-answer the call.
 
It is possible to request answer-mode from the station by adding the header "'''Answer-Mode'''". Valid values are either "'''auto'''" or "'''manual'''". By requesting "auto" the station will automatically answer regardless of configured mode. If requesting "manual" the station will not auto-answer the call.
Line 53: Line 54:
 
  exten => 902,2,Dial(SIP/211)
 
  exten => 902,2,Dial(SIP/211)
  
=== Adjust default volume ===
+
===Adjust default volume===
 
As from Turbine ver. 4.10 it is possible to adjust volume using SIP OPTIONS with x-header by adding '''x-volume-level-override'''. The function will override the configured station volume. Value can be 0-7. It will override the configured volume setting.
 
As from Turbine ver. 4.10 it is possible to adjust volume using SIP OPTIONS with x-header by adding '''x-volume-level-override'''. The function will override the configured station volume. Value can be 0-7. It will override the configured volume setting.
 +
 +
The effect will only last until station reboot.
  
 
[[Category: SIP intercom - Configuration]]
 
[[Category: SIP intercom - Configuration]]

Revision as of 00:57, 22 October 2020

SIP Icon 300px.png

Vingtor-Stentofon IP stations support a selection of custom SIP headers to manipulate aspects of the call. These headers must be included in the initial INVITE

Listen In Call (Turbine only)

If the station receives “X-Zenitel-Audio: listener” in a SIP INVITE message it means that the call will not be visible in the station and that audio is only sent from the station, not played out on the speaker. The audio sent from the station is microphone audio without echo cancellation, therefore any speaker audio caught by the microphone is included. The station supports one "listen in call" at a time and any new "listen in calls" will be rejected.. The station can operate normally while someone is listening, for example making a new outgoing/incoming call is possible. Configuration for Asterisk

asterisk example extension.conf

exten => 905,1,SIPAddHeader(X-Zenitel-Audio: listener)
exten => 905,2,Dial(SIP/211)

Listen-In currently supports only G.711 and G.722. G.729 is not supported

Volume (Turbine only)

A custom volume header can be used to reduce the volume for the duration of a call. The header name is "X-Volume-Db" with allowed values from +20 to -20 dB. Example header for setting volume to -15 dB: X-Volume-Db: -15

asterisk example extension.conf

increase volume by 5 dB:

exten => 903,1,SipAddHeader(x-volume-db: 5)
exten => 903,2,Dial(SIP/211)

decrease volume by 10 dB:

exten => 904,1,SipAddHeader(x-volume-db: -10)
exten => 904,2,Dial(SIP/211)

Priority

The Priority header can be used to prioritize calls to ensure that the highest priority conversation/message is played. RFC3261 defines the "Priority" header with values: non-urgent, normal, urgent, emergency. Our handling of different priority values is described below If there is an existing call and the device receives a second call with same or lower priority, the new call will be rejected with busy

  • A call with priority non-urgent is stopped when receiving a new call with priority normal
  • A call with priority non-urgent or normal is stopped when receiving a new call with priority urgent or emergency
  • A call with priority urgent is put on hold when receiving an emergency call. The urgent call is automatically resumed when the emergency call ends.

asterisk example extension.conf

exten => 906,1,SipAddHeader(Priority: urgent)
exten => 906,2,Dial(SIP/211)

exten => 907,1,SipAddHeader(Priority: emergency)
exten => 907,2,Dial(SIP/211)

Answer-Mode

It is possible to request answer-mode from the station by adding the header "Answer-Mode". Valid values are either "auto" or "manual". By requesting "auto" the station will automatically answer regardless of configured mode. If requesting "manual" the station will not auto-answer the call.

asterisk example extension.conf

exten => 901,1,SipAddHeader(answer-mode: auto)
exten => 901,2,Dial(SIP/211)
 
exten => 902,1,SipAddHeader(answer-mode: manual)
exten => 902,2,Dial(SIP/211)

Adjust default volume

As from Turbine ver. 4.10 it is possible to adjust volume using SIP OPTIONS with x-header by adding x-volume-level-override. The function will override the configured station volume. Value can be 0-7. It will override the configured volume setting.

The effect will only last until station reboot.