This task sends an IM to one of more recipients on behalf of a user.
- This API is authorized if psconnector service attribute ‘force application authorization rule’ is disabled, or if the sender has this calling app in its service profile. If authorization fails, an UnAuthorizedException is thrown.
This is an asynchronous task.
Both sender and recipients URIs are mandatory. They have to be a Presence Services user, and the parameter should be the user's SMGR login name.
All mandatory fields should either be mapped using the Input Mapping window or entered in the Properties window for validation to succeed.
senderUri (mandatory) – SMGR login name defined for the message sender.
recipientUris (mandatory) – A list of SMGR login names for all the message receivers.
message (mandatory) – Message to be sent via Presence Services Connector, it should be a non-empty string.
status – request status code. It can be one of the following: 200 - request was successful; 403 - not authorized; 404 - invalid sender or recipient; 500 - other error, please check logs.
reason – detailed reason in case get presence request had failed. This field is empty if request was successful.
Not applicable.
Presence Services must be configured and running.
Presence Services Connector must be configured and running.
Not applicable.
Send a message if user status changed from 'busy' to 'available'.