Skip to main content

mod_dptools: presence

About

Sends an event of either type PRESENCE_IN or PRESENCE_OUT. Currently, this function is not very useful in conjunction with sofia. This does not affect the presence of hook state for use with BLF either, but sending an event that expresses the user's hook state does.

Usage

presence <user> <rpid> <message> 

This application may be run inline from the XML dialplan.

Examples

 presence in|1000@xxx.xxx.xxx.xxx|dnd|'Do not disturb.'
 presence out|1000@xxx.xxx.xxx.xxx|unavailable|'Currently out for a pot of hot coffee.'

API

It can also be used as an API command

 presence,[in|out] <user> <rpid> <message>
presence in 1000@192.168.0.48 unknown dnd

You can get the following event

   Event-Name: PRESENCE_IN
Core-UUID: 3a66caec-e488-4aed-8bc6-634bcc7cc4fe
FreeSWITCH-Hostname: seven.local
FreeSWITCH-Switchname: seven.local
FreeSWITCH-IPv4: 192.168.0.48
FreeSWITCH-IPv6: ::1
Event-Date-Local: 2011-11-17 13:18:35
Event-Date-GMT: Thu, 17 Nov 2011 05:18:35 GMT
Event-Date-Timestamp: 1321507115845012
Event-Calling-File: mod_dptools.c
Event-Calling-Function: presence_api_function
Event-Calling-Line-Number: 1550
proto: dp
login: /Users/seven/workspace/freeswitch/fs-0905/src/mod/applications/mod_dptools/mod_dptools.c
from: 1000@192.168.0.48
rpid: unknown
status: dnd
event_type: presence
alt_event_type: dialog
event_count: 0