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

6

(Internal error)

No Active Call

 

active (streaming) call

 

 

 

 

 

 

 

 

 

 

 

 

 

 

Unable to execute URI because the current active

6

(Internal error)

No Active Call for

 

(streaming) call is not associated with the specified

 

 

Application

 

application

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

Cisco Unified IP Phone Services Application Development Notes

 

 

 

 

 

 

 

OL-20949-01

 

 

 

 

 

5-15

 

 

 

 

 

 

 

 

Page 63
Image 63
Cisco Systems OL-20949-01 manual Error and Response, Condition Status Data