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