The module enables the handling of "Event: dialog" (as defined in RFC 4235) inside of the presence module. This can be used distribute the dialog-info status to the subscribed watchers. The module does not currently implement any authorization rules. It assumes that publish requests are only issued by an authorized application and subscribe requests only by authorized users. Authorization can thus be easily done in Kamailio configuration file before calling handle_publish() and handle_subscribe() functions. Note: This module only activates the processing of the "dialog" in the presence module. To send dialog-info to watchers you also need a source which PUBLISH the dialog info to the presence module. For example you can use the pua_dialoginfo module or any external component. This approach allows to have the presence server and the dialog-info aware publisher (e.g. the main proxy) on different Kamailio instances. This module by default does body aggregation. That means, if the presence module received PUBLISH from multiple presentities (e.g. if the entity has multiple dialogs the pua_dialoginfo will send multiple PUBLISH), the module will parse all the received (and still valid, depending on the Expires header in the PUBLISH request) XML documents and generate a single XML document with multiple "dialog" elements. This is perfectly valid, but unfortunately not supported by all SIP phones, e.g. Linksys SPA962 crashes when it receives dialog-info with multiple dialog elements.
| Parámetro | Tipo | Descripción |
|---|---|---|
| force_single_dialog | int | 3.2. force_dummy_dialog (int) 3.3. default_expires (int) |
| force_dummy_dialog | int | 3.3. default_expires (int) |
| default_expires | int | 3.1. force_single_dialog (int) |
| force_single_dialog | int | By default the module aggregates all available dialog info into a single dialog-info document containing multiple "dialog" elements. If the phone does not support this, you can activate this parameter |
| force_dummy_dialog | int | By default the module returns null body if there are no bodies to aggregate. some sip clients like Bria expect at least one dialog. you can activate this parameter to send a dummy dialog. |
| default_expires | int | The default expires value used when missing from SUBSCRIBE message (in seconds). |
Copyright © 2007 Juha Heinanen
Copyright © 2008 Klaus Darilion, IPCom (Module implementation was
