|Wireless Gateway and Email Configuration / Inbound Integration|
VMP supports inbound WCTP messages from external systems, and forwards these messages to end-users' mobile devices.
Delivery receipts, read receipts, text responses, and multiple choice responses are supported. The WCTP request sent to the VMP Server sets the appropriate flags to true as per the specification, and the VMP Server provides the response to the initiating system. The VMP Server posts these responses and read/delivery receipts back to the originating system in real time.
The VMP SOAP-based API provides support for external systems to send messages, and to receive delivery statuses and responses to the messages (see the Vocera Messaging Platform API Guide for details).
Systems that support WCTP generally allow the administrator to identify users in the system as WCTP users, and point the WCTP configuration to the VMP Server. When a message needs to be sent, the system will send the message via the WCTP protocol to the VMP Server.
To configure WCTP, the third party needs the VMP Server URL with /wctp?F=XX appended. The format follows:
XX refers to the third-party system initiating the messages. The configuration is shown in the following code sample:
F=EM For Emergin F=generic For all other systems (including Connexall)
To override the end user's profile settings, based on the priority of the message sent, append one or more of the following additional tags to the URL. Each tag can be set to Y (override) or N (do not override).
|&OH||Whether to override the user profile when the priority is High.|
|&ON||Whether to override the user profile when the priority is Normal.|
|&OL||Whether to override the user profile when the priority is Low.|
The priority of the VMP message depends on these settings and on the priority of the message payload, as shown in the table below.
|Priority appended to URL||Message payload priority||Resulting VMP message priority|
If you are using an Emergin third-party system, and your message text contains LVL or lvl, the multiple-choice responses *ACK and *NAK are automatically inserted into the message.