Cisco Systems OL-20949-01 IP Phone User Manual


 
5-15
Cisco Unified IP Phone Services Application Development Notes
OL-20949-01
Chapter 5 Internal URI Features
Telephony URIs
Audible feedback to the user can be enabled or disabled and an optional application ID can be specified
to ensure that the DTMF digits will only be sent to the call which is associated with a specific
application.
URI Format
SendDigits:dtmfSequence:audibleFeedback::applicationId
Where
dtmfSequence
= the sequence of DTMF digits to be sent. Value must contain only 0123456789#*ABCD
audibleFeedback =
indicates whether to provide audible feedback to the user as the DTMF digits are
entered. Values can be 0 (false) or 1 (true).
applicationId =
optional identifier of the application associated with the call which must receive the
DTMF digits. Value must be 0-64 and cannot contain colons. The default value is null indicating that the
active call should receive the DTMF digits, regardless of any application association.
For example:
Make a call using a calling card service that implements these steps:
1. Connects to a 800 calling card service (using the Dial URI)
2. Application waits to give call time to connect
3. Dials the destination number, ensuring that the digits can only be dialed from this application.
4. Pauses 2 seconds
5. Dials the calling card number
6. Pauses 1 second
7. Dials the pin number
<CiscoIPPhoneExecute>
<ExecuteItem URL="Dial:918005551212:1:Cisco/Dialer"/>
</CiscoIPPhoneExecute>
<CiscoIPPhoneExecute>
<ExecuteItem URL="SendDigits:6185551212,,987654321,1234:1:Cisco/Dialer"/>
</CiscoIPPhoneExecute>
Error and Response
When the SendDigits URI is invoked via an Execute object, it will use the standard URI Status and Data
values in ResponseItems:
Condition Status Data
Executed successfully 0 (Success) Success
URI syntax is invalid 1 (Parse error) Invalid URI
URI is not supported 6 (Internal error) URI not found
Unable to execute URI because there currently is no
acti
ve (streaming) call
6 (Internal error) No Active Call
Unable to execute URI because the current active
(s
treaming) call is not associated with the specified
application
6 (Internal error) No Active Call for
Application