asnGetAndSubscribePresence

Operation to retrieve contact data and to subscribe to events when these data will change.

If a client is interested in monitoring the presence and data of its own and other contacts, this operation
gives the possibility to get data about a contact, its used services (lines, appointments, chat etc.) and his calculated presence. See AsnGetAndSubscribePresenceArgument for more information.

To unsubscribe from contacts, call asnUnsubscribePresence This is highly recommended before closing the connection to the ucserver.

If the operation fails it will return AsnRequestError

If the operation is successful at least on some given contacts, it will return AsnGetAndSubscribePresenceResult

ArgumentType: AsnGetAndSubscribePresenceArgument

AsnGetAndSubscribePresenceArgument is an Object

Name Type Optional Comment
seqContactIDs UTF8StringList List of strings containing the contact ID of the requestet contact (e.g. 'sip:tester@test.com')

iEventFlagsToSubscribe number yes AsnPresenceSubscriptionFlags - which events does the client wants to receive from the server.

iContactDetailsReturnFilter number yes AsnPresenceSubscriptionFlags - which return values are needed from the ucserver.

bOpenOnlyInternalContacts boolean yes
bDontRequestPermissions boolean yes Keine Berechtigungsanfrage starten

optionalParams AsnOptionalParameters yes (z.B. sollen anonyme Benutzer eben nicht alle Events bekommen können

ResultType: AsnGetAndSubscribePresenceResult

AsnGetAndSubscribePresenceResult is an Object

Name Type Optional Comment
seqSubscribedPresence AsnPresenceList Kontakte die angefordert wurden

optionalParams AsnOptionalParameters yes

ErrorType: AsnRequestError

AsnRequestError is an Object

Name Type Optional Comment
iErrorDetail number A number representing the error

u8sErrorString string A string representing the error

optionalParams AsnOptionalParameters yes No optional params yet

Version 7