Automatic Epic CAL link expiration for ad-hoc rooms

This section contains information for the automatic expiration of links for ad-hoc rooms.

• Prerequisites
• Configure your tenant and add the LinkValidityPeriod parameter
• Add the Timestamp parameter to the CRYPTSTRING
• Test

With the current Epic CAL Integration, the extData can include an optional AppointmentTime parameter to handle link expiration for scheduled visits. However, this does not work for ad-hoc scheduling, the Epic mnemonic used for scheduled visits—%EXTENSION;15354%—returns nothing when used for ad-hoc scheduling.

To handle this use case, Vidyo has added the Timestamp parameter. This parameter allows for setting the current time as the start of the linkValidityPeriod (in UNIX time format). It is an optional configuration that is disabled by default and should be configured in conjunction with your Epic FDI record.

Prerequisites

For the required component versions for this feature, see Epic CAL feature compatibility with Vidyo versions.

Configure your tenant and add the LinkValidityPeriod parameter

Follow the instructions in Automatic Epic CAL link expiration to:

• Configure the default CAL link validity period and time zone of the Epic Integration Server in the Tenant Admin.
• Add the LinkValidityPeriod parameter to the CRYPTSTRING

Add the Timestamp parameter to the CRYPTSTRING

The Timestamp is an optional CAL link parameter that allows Epic integrations to specify a link validity period on a per-link basis.

Parameter	Value
Timestamp	Unix timestamp in seconds

The Timestamp must be included inside the CRYPTSTRING as part the encrypted extData that is passed to Vidyo from the Epic FDI record.

Here is an example of a decrypted CRYPTSTRING with the LinkValidityPeriod parameter set for a 60-minute expiration period (with added line breaks for legibility):

Test

Use the Context Aware Sample Link Generator in the Tenant Admin to generate a sample Epic CAL URL link with the Timestamp parameter.