Plantronics + Polycom. Now together as Poly Logo

[FAQ] How can I change my Ringtone or Ring in a special manner for a certain incoming call?

Highlighted
Polycom Employee & Community Manager

[FAQ] How can I change my Ringtone or Ring in a special manner for a certain incoming call?

The Feature Descriptions & Technical Notifications page holds a guide => here <= on how to load a custom Ring Tone for environments that need a louder ring tone.

 

The Community Member Telus provided a conversion guide => here <=

 

In addition you may prefer a certain incoming line to ring with a different Ring Tone.

 

From the UCS 5.2.0 Admin Guide (Page 403):

 

<saf/>

 

The phone uses built-in wave files for some sound effects. The built-in wave files can be replaced with files downloaded from the provisioning server or from the Internet.

 

NOTE: Above should state additional Wave files can be used as they do not replace the built-on files and the statement should be amended in future Admin guides!

 

However, these are stored in volatile memory so the files need to remain accessible if the phone needs to be rebooted.

 

Files are truncated to a maximum size of 300 kilobytes (Pre VVX Phones) and a maximum size of 600 kilobytes (614400 bytes) for all ringtones.

 

NOTE: This statement describes the combined file size of all files used and the statement should be amended in future Admin guides!

 

The phones support the following sampled audio WAVE (.wav) file formats:

 

 

mono 8 kHz G.711 u-Law Supported on all phones
mono L16/8000 (16-bit dynamic range, 8-kHz sample rate)  Supported on All phones
G.711 A-Law Supported on all phones
mono 8 kHz A-law/mu-law  Supported on all phones
L8/16000 (16-bit, 8 kHz sampling rate, mono) Supported on all phones
L16/16000 (16-bit, 16 kHz sampling rate, mono)  Supported on all phones
L16/32000 (16-bit, 32 kHz sampling rate, mono)  Supported on VVX 500/501, 600/601, and 1500
L16/44100 (16-bit, 44.1 kHz sampling rate, mono) Supported on VVX 500/501, 600/601, and 1500
L16/48000 (16-bit, 48 kHz sampling rate, mono) Supported on VVX 500/501, 600/601, and 1500

 

 

saf.x Null, valid path name, or an RFC 1738-compliant URL to an HTTP,
FTP, or TFTP wave file resource.

 

  • If Null, the phone uses a built-in file.
  • If set to a path name, the phone attempts to download this file at boot time from the provisioning server.
  • If set to a URL, the phone attempts to download this file at boot time from the Internet

Example:

 

<test saf.1="tftp://somehost.example.com/sounds/example.wav." />


Example 1 special ring tone: 

 

The below example is for a special Ring Tone (ringer14) called Splash to be played on an incoming call when the Alert-Info fields from INVITE requests contain SpecialRing in the SIP Invite.

 

NOTE: This depends on your SIP Server's ability to modify the SIP INFO Header!

 

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<!-- PlcmConversionCreatedFile version=1.2 converted=Tue Oct 25 13:12:50 2011 -->
<polycomConfig xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="polycomConfig.xsd">
  <se>
    <se.rt>
      <se.rt.custom1 se.rt.custom1.name="Splash" se.rt.custom1.ringer="ringer14" />
    </se.rt>
  </se>
  <voIpProt>
    <voIpProt.SIP>
      <voIpProt.SIP.alertInfo voIpProt.SIP.alertInfo.1.value="SpecialRing" voIpProt.SIP.alertInfo.1.class="custom1"/>
    </voIpProt.SIP>
  </voIpProt>
</polycomConfig>

 

 Wireshark example:

 

SpecialRing.PNG

 

NOTE: Above example is for UC Software 3.3.0 and later!

 

Attached is an Example File of above called specialring.zip

 

Example 2 special ring tone and action:

 

The below example is for a special Ring Tone (ringer10) called Beeble to be played on an incoming call when the Alert-Info fields from the SIP INVITE requests contain ringAutoAnswer and then automatically answers the call.

 

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<!-- PlcmConversionCreatedFile version=1.2 converted=Tue Aug 23 16:59:18 2011 -->
<polycomConfig xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="polycomConfig.xsd">
  <voIpProt>
    <voIpProt.SIP>
      <voIpProt.SIP.alertInfo voIpProt.SIP.alertInfo.1.class="ringAutoAnswer" voIpProt.SIP.alertInfo.1.value="ringAutoAnswer" se.rt.ringAutoAnswer.ringer="ringer10"/>
    </voIpProt.SIP>
  </voIpProt>
</polycomConfig>

 Wireshark example:

 

Invite_ringAutoAnswer.PNG

 

The phone supports the following ring classes: default, visual, answerMute, autoAnswer, ringAnswerMute, ringAutoAnswer, internal, external, emergency, precedence, splash, and custom<y> where y is 1 to 17.

 

NOTE: Above example is for UC Software 3.3.0 and later!

 

Attached is an Example File of above called ringAutoAnswer.zip

 

The Community Member Wdbarker3 provided an enhanced example containing all Ring Tones included in the Software to be mapped against Alert-Info Headers.

 

These are:

Silent
Low Trill
Low Double Trill
Medium Trill
Medium Double Trill
High Trill
High Double Trill
Highest Trill
Highest Double Trill
Beeble
Triplet
Ringback-style
Low Trill Precedence
Ring Splash

 

Example attached as: PolycomTones.zip

 

In addition external Ringtones can be loaded. An example for this could be:

 

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<!-- PlcmConversionCreatedFile version=1.2 converted=Wed Oct 26 12:58:23 2011 -->
<polycomConfig xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="polycomConfig.xsd">
<saf saf.2="http://10.252.75.119/LoudRing.wav" saf.3="http://10.252.75.119/Warble.wav" />
<se>
<se.pat>
<se.pat.ringer>
<se.pat.ringer.ringer15 se.pat.ringer.ringer15.name="Loud Ring">
<se.pat.ringer.ringer15.inst se.pat.ringer.ringer15.inst.1.value="2" />
</se.pat.ringer.ringer15>
<se.pat.ringer.ringer16 se.pat.ringer.ringer16.name="Warble">
<se.pat.ringer.ringer16.inst se.pat.ringer.ringer16.inst.1.value="3" />
</se.pat.ringer.ringer16>
</se.pat.ringer>
</se.pat>
</se>
</polycomConfig>

 

NOTE: Above example is for UC Software 3.3.0 and later!

 

saf.x (Sampled Audio File Number) defines the name and the Location and could be http:\\testserver.com\LoudRing.wav instead

se.pat.ringer.x.name defines the name shown in the Ring Type Menu ( Settings => Basic => Ring Type )

se.pat.ringer.x.value maps the Ring Tone to the saf.x Value

 

Example with Ringtones attached as: ExternalRingTones.zip

 

Please consult the SIP / UC Admin Guide for more details and different settings.

 

Example 3 external ring tone on SIP INVITE:

 

The below wireshark trace shows an example where a URL is specified within the Alert-Info which will then play on the Phone.

 

Pre-requisite in this setup is the server hosting the file.

 

In this example we use the LoudRing.wav which is included when you download the Polycom software.

 

LoudRing.PNG

 

 

Example 4 adding additional ring tones

 

Utilizing the Web Interface (UCS 4.0.0 or newer) a external Ringtone can simply be loaded via the Web Interface:

 

ExternalRingtone.PNG

 

You can add custom ringtones to your phone, and you can apply custom ringtones to specific contacts or phone lines.

 

The phones support the following .wav file formats: G.711u-law, G.711a-law, G.722, G.729AB, Lin16, and iLBC.

To add an audio file to the list, click the Add Audio file icon.

 

You can upload an audio file from your PC or enter a URL pointing to an audio file.

 

Audio files should have a .wav extension name.

 

If you select a file, it will be stored in the phone's flash memory and a copy will be made to the => provisioning server <=.

 

You can save a maximum of 23 audio files or until the phone runs out of memory (depending on the phone model and individual size of the files).

 

You can also define additional Wav files (must be on your your provisioning server) via a configuration file:

 

 

<Tone saf.2="LoudRing.wav" />

 Above would set the Ringer 15 to the LoudRing Wave file. 




<======== Signature / Disclaimer ========>
Please be aware:For questions about the type of support to expect please check here

Please also ensure you always check the VoIP , Video Endpoint , Skype for Business , PSTN or RPM FAQ's

Please remember, if you see a post that helped you , and it answers your question, please mark it as an "Accept as Solution".

The title Polycom Employee & Community Manager is an automatic setting within the community and any forum reply or post is based upon my personal experience and does not reflect the opinion or view of my employer.
Poly employee participation within this community is not mandatory and any post or FAQ article provided by myself is done either during my working hours or outside working hours, in my private time, and maybe answered on weekends, bank holidays or personal holidays.
1 REPLY 1
Polycom Employee & Community Manager

Re: [FAQ] How can I change my Ringtone or Ring in a special manner for a certain incoming call?

Example 5:

 

  • Server independent Intercom

 

UCS 5.2.0 added a new Feature to the compatible phones. This is Server independent as the Phone simply adds the Alert-Info within the INVITE. This works for example also with LYNC or Skype for Business.

 

feature.intercom.enable="1" voIpProt.SIP.intercom.alertInfo="Test"

 

  • The Above will use the String intercom-Test
  • The above places a new Softkey (after pressing more)

    InterComMenu_02.PNG

  • And adds a new Menu Option:

    InterComMenu.PNG

Pressing this key will present the User with the normal Dial Screen and they simply dial the extension of any Intercom Enabled user.

 

The INVITE will then contain this:

 

1015134904|sip  |0|00|    INVITE sip:+14251231002@medeatalk.com;user=phone;transport=tls SIP/2.0
1015134904|sip  |0|00|    Via: SIP/2.0/TLS 192.168.2.52:57913;branch=z9hG4bK79c6e6c0537357D1
1015134904|sip  |0|00|    From: "Alice" <sip:alice@medeatalk.com>;tag=E2C89D44-2CCBA0BD;epid=0004f286f13a
1015134904|sip  |0|00|    To: <sip:+14251231002@medeatalk.com;user=phone>
1015134904|sip  |0|00|    CSeq: 1 INVITE
1015134904|sip  |0|00|    Call-ID: f635e2b05f1fc643bbd255b1b286f13a
1015134904|sip  |0|00|    Contact: <sip:alice@medeatalk.com;opaque=user:epid:l8GlOaRVG1-VQx2wcRMZ5AAA;gruu>
1015134904|sip  |0|00|    Allow: INVITE, ACK, BYE, CANCEL, OPTIONS, INFO, MESSAGE, SUBSCRIBE, NOTIFY, PRACK, UPDATE, REFER
1015134904|sip  |0|00|    User-Agent: PolycomVVX-VVX_600-UA/5.2.0.8330
1015134904|sip  |0|00|    Accept-Language: en
1015134904|sip  |0|00|    P-Preferred-Identity: "Alice" <sip:alice@medeatalk.com>,<tel:+14251231001>
1015134904|sip  |0|00|    Allow-Events: conference,talk,hold
1015134904|sip  |0|00|    Alert-Info: intercom-Test
1015134904|sip  |0|00|    Supported: replaces
1015134904|sip  |0|00|    Supported: ms-safe-transfer
1015134904|sip  |0|00|    Supported: ms-bypass
1015134904|sip  |0|00|    Supported: ms-dialog-route-set-update
1015134904|sip  |0|00|    Supported: timer
1015134904|sip  |0|00|    Supported: 100rel
1015134904|sip  |0|00|    Supported: gruu-10
1015134904|sip  |0|00|    ms-subnet: 192.168.2.0
1015134904|sip  |0|00|    MS-Conversation-ID: cFYZ0NwhMVIpkdgx8l45UtQBs1oJE9ARcFYZ0NwhMVIpkdgx8l45UtQBs1oJE
1015134904|sip  |0|00|    Authorization: TLS-DSK qop="auth", realm="SIP Communications Service", opaque="67D53364", crand="B594753D", cnum="81", targetname="ls.medeatalk.net", response="04e4bc62c66793fd7573c14b9876d430ed2153f2"
1015134904|sip  |0|00|    Max-Forwards: 70
1015134904|sip  |0|00|    Content-Type: application/sdp
1015134904|sip  |0|00|    Content-Length: 640

 ATTENTION:

The intercom- part is hardcoded and was changed in Software 5.2.2 or 5.3.0 or later !

 

Since UC Software 5.2.2 or 5.3.0 or later the intercom part is no longer hard coded and only whatever is defined in voIpProt.SIP.intercom.alertInfo will be utilized.

 

UC Software 5.2.2 or later:

 

1003073602|sip  |0|00|    INVITE sip:3067@10.252.122.122;user=phone SIP/2.0
1003073602|sip  |0|00|    Via: SIP/2.0/UDP 10.252.149.56;rport;branch=z9hG4bKecf28742F0FDDEB
1003073602|sip  |0|00|    From: "3078" <sip:3078@10.252.122.122>;tag=F9671558-B6FDCFD1
1003073602|sip  |0|00|    To: <sip:3067@10.252.122.122;user=phone>
1003073602|sip  |0|00|    CSeq: 1 INVITE
1003073602|sip  |0|00|    Call-ID: 0901939f5e383503aff0dc39b50101ea
1003073602|sip  |0|00|    Contact: <sip:3078@10.252.149.56>
1003073602|sip  |0|00|    Allow: INVITE, ACK, BYE, CANCEL, OPTIONS, INFO, MESSAGE, SUBSCRIBE, NOTIFY, PRACK, UPDATE, REFER
1003073602|sip  |0|00|    User-Agent: PolycomVVX-VVX_411-UA/5.5.1.11526
1003073602|sip  |0|00|    Accept-Language: en
1003073602|sip  |0|00|    Supported: replaces,100rel
1003073602|sip  |0|00|    Allow-Events: conference,talk,hold
1003073602|sip  |0|00|    Alert-Info: Test
1003073602|sip  |0|00|    Max-Forwards: 70
1003073602|sip  |0|00|    Content-Type: application/sdp
1003073602|sip  |0|00|    Content-Length: 352
1003073602|sip  |0|00|    
1003073602|sip  |0|00|    v=0
1003073602|sip  |0|00|    o=- 1507012562 1507012562 IN IP4 10.252.149.56
1003073602|sip  |0|00|    s=Polycom IP Phone
1003073602|sip  |0|00|    c=IN IP4 10.252.149.56
1003073602|sip  |0|00|    t=0 0
1003073602|sip  |0|00|    a=sendrecv
1003073602|sip  |0|00|    m=audio 2224 RTP/AVP 9 102 0 8 18 127
1003073602|sip  |0|00|    a=rtpmap:9 G722/8000
1003073602|sip  |0|00|    a=rtpmap:102 G7221/16000
1003073602|sip  |0|00|    a=fmtp:102 bitrate=32000
1003073602|sip  |0|00|    a=rtpmap:0 PCMU/8000
1003073602|sip  |0|00|    a=rtpmap:8 PCMA/8000
1003073602|sip  |0|00|    a=rtpmap:18 G729/8000
1003073602|sip  |0|00|    a=fmtp:18 annexb=no
1003073602|sip  |0|00|    a=rtpmap:127 telephone-event/8000

Enabling Intercom on a user:

 

voIpProt.SIP.alertInfo.1.value="Test" voIpProt.SIP.alertInfo.1.class="ringAutoAnswer" se.rt.ringAutoAnswer.ringer="ringer10"

 

  • The above will ring once and the answer the call and use the ringtone (ringer10) called Beeble

NOTE: For more customization of this functionality please consult the UCS 5.2.0 Admin Guide or newer!


In order to ring a specific Person via a Softkey please check the EFK example 10 => here <=




<======== Signature / Disclaimer ========>
Please be aware:For questions about the type of support to expect please check here

Please also ensure you always check the VoIP , Video Endpoint , Skype for Business , PSTN or RPM FAQ's

Please remember, if you see a post that helped you , and it answers your question, please mark it as an "Accept as Solution".

The title Polycom Employee & Community Manager is an automatic setting within the community and any forum reply or post is based upon my personal experience and does not reflect the opinion or view of my employer.
Poly employee participation within this community is not mandatory and any post or FAQ article provided by myself is done either during my working hours or outside working hours, in my private time, and maybe answered on weekends, bank holidays or personal holidays.