# &adminguide;

## Overview

The module extends the presence server implementation, providing the ability to handle the 'ua-profile' event. When a user agent subscribes to ua-profile event for its own AoR, it retrieves the profile data document from the body of a NOTIFY request.

The profile data document format is usually specific to the user agent. Such documents have to be built and added to presentity table by either the admin or a third party application.

Warning: When you add a profile data document (i.e. the user agent's provisioning config) to the presentity table, you must make sure that you set the presentity table expires field to a time value far in the future.

Read more about SIP user agent configuration framework in RFC6080: http://tools.ietf.org/html/rfc6080.

## Dependencies

### &kamailio; Modules

The following modules must be loaded before this module:

- presence.

### External Libraries or Applications

None.

## Exported Parameters

### `default_expires` (int)

The default expires value used when missing from SUBSCRIBE message (in seconds).

Default value is 3600.

#### Set `default_expires` parameter

                ...
                modparam("presence_profile", "default_expires", 3600)
                ...

## Exported Functions

None to be used in configuration file.