WCTP Connections

VMP supports inbound WCTP messages from external systems, and forwards these messages to end-users' mobile devices.

Messages are delivered from VMP to:

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.

Note: USA Mobility is supported via outbound WCTP through a direct push rather than polling.

To configure WCTP, the third party needs the VMP Server URL with /wctp?F=XX appended. The format follows:

www.domain.com/wctp?F=XX

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

Tag Description
&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
  High High
  Normal Normal
&OH=Y High Urgent
&OH=Y Normal Normal
&OH=N High High
&OH=N Normal Normal
&ON=Y High High
&ON=Y Normal Normal
&ON=N High High
&ON=N Normal Normal
&OL=Y High High
&OL=Y Normal Normal
&OL=N High High
&OL=N Normal Normal
Note: These settings are supported on the Vocera Collaboration Suite and other Vocera smartphone clients.