Appearance
Injecting a Greeting or Announcement before a call on Cisco Callmanager
You can use rules to inject a Callmanager greeting announcement to any call using policies and the Cisco CURRI API. Upload audio to all your Callmanagers as an Announcement. Anywhere you reference it in Call Telemetry, it must be the same name as Call Manager.
Newer versions of Call Telemetry will query all available greetings from Cisco Callmanager for selection. You can select the greeting you want to play in the Rule Modifier page.
Also if you are playing a greeting externally. as the first greeting before the call reaches any other endpoint - you need SIP Early offer.
Feature Requirements
- Call Telemetry Appliance 0.7.0 or later
- Call Telemetry Community or Higher License
- Cisco Callmanager 8.5 with CURRI Integration to Call Telemetry
- Configured External Call Control Profile Inspection - A route pattern, translation pattern, or phone extension must be enabled for Call Telemetry Policy inspection.
- Enable Early offer from Cisco Callmanager to Carrier – Make sure within the Callmanager SIP Trunk to set Early offer Mandatory, and set "REL1XXX" to when SDP is present as shown below:
- Annunciators – Make sure your Annunciators are available in your Media Resource Group (MRG), and Media Resource Group List (MRGL), and your MRGL is assigned to the the SIP Trunk. Standard Cisco Callmanager SRND design practices apply here.
- Upload the .wav file to all Callmanagers within each locale installed.
- At this time, you cannot use a PRI or T1, only SIP Trunks. See Cisco Bug Toolkit - ECC Greeting Support on PRI
Announcements and Cisco Callmanager Locales
Cisco Callmanager Locales and Announcements interaction with CURRI API requires a little planning. The Cisco CURRI API applies announcement Locales from the calling device's settings. If this is a phone, the announcement will request the locale of the calling phone. If it the callflow results in the calling device as the SIP Trunk, it will not have a Locale setting, and will default to the Cisco Callmanager default Locale.
TIP
In my testing, SIP Trunks only play greetings from the EN_US locale, even when I have other international Locales installed on my cluster. I beleive this is because SIP Trunks do not have a Locale, and therefore default to the system default Locale on your cluster. Even if you have phones in other Locales, and apply the policy on the phone, the Locale defines the announcement, and for greetings before the call reaches a phone, that locale is the SIP Trunk, which is "default".
Configuring Cisco Call Greeting Injection
You can use the Call Telemetry Policy Rules to inject a greeting before any call. Below is an example of the Cisco Callmanager side, and the Call Telemetry side within the Rule modifiers. The greeting is played before the call reaches any other endpoint.
Example working CUBE Config
This CUBE Config shows SIP Early offer, and has all configuration needed for Cisco Callmanager to inject a greeting.
Example and corresponding Debugs
Bellow are sample Cisco CUBE Debugs. Each message is annotated to help you understand the interaction.
- Successful CUBE Integration injecting greeting before phone rings.
- Failed - CUBE Integration without REL1XXX enabled.