Avaya 16-300272, User Manual

Page: 67 / 82

Broadcast Server User Guide
Appendix A Push XML API
Push XML API Operation
59
Push XML API Operation
Once the Application Gateway is aware of a third-party application, it
performs the following operations:
•
Listens for XML data from the application, including distribution lists
to track for the application and alerts to be pushed.
•
Sends information about the devices that register with the Application
Gateway to the application, as they come online or change.
•
Maintains distribution lists.
•
Pushes alerts from the application over port 9998 to the phones
according to the defined schedule.
•
Updates the alert list on the phones, automatically removing alerts
that are deleted or expired.
•
Notifies the application about the status of the pushed alerts.
The following topics provide a general description of the XML elements
used in those operations:
•
PushMessage Request, page 59
•
DistributionList Request, page 62
•
ServerRegistration Response, page 63
•
Subscribers Response, page 63
•
PushMessageResponse Response, page 63
PushMessage Request
The PushMessage element defines the alert to be pushed to an IP phone
or distribution list. To send more than one PushMessage , you wrap the
elements in a ManagePushMessage element.
The PushMessage element attributes specify the priority and action of the
alert. Alert priority determines whether it will be pushed:
•
Immediately and take control of the audio. Priority = emergency.
•
When the phone is idle. Priority = normal.
•
Only to the alert history item in the Voice Office menu. Priority =
background.