Nortel Networks Broadcast Server warranty Push XML API Operation, PushMessage Request

Appendix A Push XML API

Push XML API Operation

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 a 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.

Broadcast Server User Guide 59