Configuring Email Pass-Through Handling

The email integration allows Epic to send emails to Vocera announcing the start of a shift, the end of a shift, or a cleaning request for a device user that is specified in the subject of the email. If Epic sends any other type of email, the EVS integration passes it through as a message to the Vocera device of the person specified in the email subject. The email pass-through configuration allows you to customize features of this message, such as a tone to play on the device, a priority, and so forth.

Specify any parameters for the email pass-through integration in the <voiceOther> section of the pluginproperties.xml file. You can customize the following main features of the email pass-through integration:

• Retry settings for message pass-through attempts

  Vocera attempts to pass-through email messages other than start shift, end shift, or cleaning requests to a user's device. If the first delivery attempt for a message fails:

  • Vocera escalates immediately when the failure is due to an invalid user ID.
  • Vocera re-sends the message when the failure is potentially recoverable; for example, when delivery fails because a user is not logged in.

  The values in the <send><retry> section determine how often Vocera attempts to re-send the message.

• Message escalation settings

  In the pass-through integration, an escalation is a message that is sent to an administrator's Vocera device when an unrecoverable error occurs. The following events result in an escalation during the pass-through integration:

  • Sending a pass-through message to an invalid user ID
  • A timeout that occurs as a result of a pass-through message retry failure

  If you want Vocera to send an escalation notification when a message pass-through fails, you must specify a value for <voceraID> in the message escalation parameters. If <voceraID> is not specified, Vocera discards the escalation message.

• Message customizations

  In the pass-through integration, a message is an email that Vocera is passing on to an Environmental Services employee. You typically do not need to specify any content for the message, since Vocera passes the content of the email through to the user; however, you may want to customize the message tone or priority.