Access To Contact Header

Overview

For an endpoint to endpoint call, one endpoint receives an INVITE message (in this case the CSP) and returns a 200OK response. The endpoint that sent the INVITE message uses the Contact information from the 200OK response to send the ACK message to the CSP and subsequent messages such as BYE.

Likewise, the endpoint that receives the INVITE (in this case the CSP) uses the Contact header to send future requests such as BYE. Final responses to INVITE message have to be routed back the same path.

 

This feature allows the host read and write access to the following fields in the contact header in the 200OK response for an INVITE message:

Contact Display Name

Contact Username

Contact Parameters

Note that the host portion cannot be changed because if it is changed, the remote endpoint would not be able to route future requests to the CSP correctly.

Pertinent Specification

RFC 2543/3261

API Messages Used

PPL Event Request (0x0044)

PPL Event Indication (0x0043)

Connect with Data (0x0005)

Description

Write Access to Contact Header

The write access to the display name, username, and parameter in the Contact header involves the outbound 200OK response for the INVITE message received and outbound REFER message.

The SIP stack allows the host to fill in the Display Name, Username, and Parameter in the Contact header using the following NPDI TLVs:

0x292B - NPDI SIP Contact Display Name

0x292C - NPDI SIP Contact Parameters

0x292D - NPDI SIP Contact Username

To modify the Contact header fields in the 200OK response for the INVITE message, the host includes the TLVs either of the following:

PPL Event Request for answer in Layer 4 (Component 0x61, Event 0xC9)

Connect with Data (0x0005) message

 

Important! For coupled Call Agent Mode enabled calls, where the host has provided the physical span/channel, the CSP will ignore the above TLVs unless the host continues to provide the coupled span/channel.

Read Access to Contact Header

The read access to the Contact Header fields involves the inbound 200OK response for the INVITE message sent and the inbound REFER message.

The SIP stack reports to the host the Display Name, Username and Parameters in the Contact header with the following NPDI TLVs.

0x292B - NPDI SIP Contact Display Name

0x292C - NPDI SIP Contact Parameters

0x292D - NPDI SIP Contact Username

Configuring the CSP to Report Contact Header

The SIP stack reports the Contact Header as follows:

For Remote End Answered messages- PPL Event Indication (Component 0x00A7, Event 0x0020)

For Inbound REFER messages- PPL Event Indication (Component 0x00A7, Event 0x0020)

This feature is disabled by default. You can enable this feature with the EXS API as follows.

 

To enable this feature, set bit 13 in the SIP Message Information Mask (0x027F) TLV in the VoIP Protocol Configure (0x00EE) message.

Refer to Configuring SIP in the Converged Services Administrator User’s Guide to configure with SwitchKit CSA.