Diversion

An example of the header is shown below:

Diversion: <sip:654@IPG2Host;user=phone>;reason=user-busy;screen=no;privacy=off;counter=1

The header properties are shown in the following table:

Header Level Action

Add

Delete

Modify

List Entries

Operations Supported

Yes

Yes

Yes

3

Keyword

Sub Types

Attributes

Name

String

Read/Write

Param

Param

Read/Write

Privacy

Enum Privacy (see Privacy)

Read/Write

Reason

Enum Reason (see Reason (Diversion))

Read/Write

Screen

Enum Screen (see Screen)

Read/Write

URL

URL Structure (see URL)

Read/Write

Below are header manipulation examples:

Example 1

Rule:

Add a Diversion header to all INVITE messages:

Message Type: Invite
Action Subject: header.Diversion
Action Type: Add
Action Value: '<tel:+101>;reason=unknown; counter=1;screen=no; privacy=off'

Result:

Diversion: <tel:+101>;reason=user-busy;screen=no;privacy=off;counter=1

Example 2

Rule:

Modify the Reason parameter in the header to 1 (see Reason (Diversion) for possible values):

Message Type: Invite
Action Subject: header.Diversion.reason
Action Type: Modify
Action Value: '1'

Result:

Diversion: <tel:+101>;reason=user-busy;screen=no;privacy=off;counter=1

Example 3

Rule:

The URL in the Diversion header is modified to that which is contained in the header URL:

Message Type: Invite
Action Subject: header.Diversion.URL
Action Type: Modify
Action Value: header.from.url

Result:

Diversion:<sip:555@IPG2Host;user=phone>;reason=user-busy;screen=no;privacy=off;counter=1