Partners Blog Contact Us

Vidyo and Epic Integration with VidyoConnect Context-Aware Linking (CAL)

Follow

The Epic Context-Aware Linking integration for Vidyo enables healthcare providers to access VidyoConnect™ meetings from within their Epic EHR (Electronic Health Record) system.

This article consists of the following sections: 

Please review the Epic Compatibility with Vidyo Infrastructure article to ensure that you have the proper Epic security updates installed on your Epic environment prior to upgrading Vidyo.

If you want to use Epic integration, you must first enable it in the Super Admin portal. Then, each Tenant Admin can configure it for each tenant that's going to use this integration. Alternatively, you can enable it via REST APIs. This article describes how to configure it via the Super Admin and the Tenant Admin. For information about how to configure it via the REST APIs, refer to version 18.3.1 of the Vidyo Web Services API User Guide.

Before using Epic integration, you must first ensure that you've applied Security Update 20 to both the VidyoPortal™ and VidyoRouter™ and that you're using VidyoPortal and VidyoRouter version 18.4.0 or later. Also, you can use this integration only with VidyoConnect Desktop 18.2.0 or later and VidyoConnect Mobile 18.1.0 or later.

If you need to enable context aware linking on Epic, select this link https://galaxy.epic.com/?#Browse/page=1!68!50!1621949,3769901, and then login with your credentials.

 

Configuring Epic CAL Integration as the Super Admin Portal (On-Premises Only)

In order for this configuration to work, the "Scheduled Room" feature must be enabled on the VidyoPortal. If you do not have this feature enabled; you will receive a 404 error message stating, "This is not a valid room link".

To configure Epic integration in the VidyoPortal (On-Premises):

  1. Log in to the Super Admin portal using your Super Admin account.

    For more information, see Logging in to the Super Admin Portal.

    The Components page displays by default.
  2. Click the Settings tab.

    The Upload System License page displays by default.
  3. Click  to the left of Feature Settings on the left menu.
  4. Click Epic Integration from the submenu.

    The Epic Integration page displays.

    EpicIntegrationTab.png
  5. Select the Enable Epic Integration check box.
  6. Click Save.

Configuring Epic CAL Integration as the Tenant Admin (On-Premises and Cloud)

In order to use Epic integration as an on-premises customer, you must first ensure that the Super Admin has enabled it on the system level as described in the Enabling the EPIC Integration Feature with VidyoConnect Context-Aware Linking (CAL) for On-Premises section above. If you are a cloud customer, you can follow the Tenant Admin steps below to configure your Epic integration. 

To configure Epic integration in the Tenant Admin (On-Premises):

  1. Log in to the Admin portal using your Admin account.

    For more information, see Logging in to the Tenant Admin Portal.

    The Users page displays by default.
  2. Click the Settings tab.

    The License page displays by default.
  3. Click  to the left of Feature Settings on the left menu.
  4. Click Epic Integration from the submenu.

    The Epic Integration page displays.

    EPIC_1.png
  5. Select the Enable the Enable EPIC Integration check box.
  6. Configure the Epic integration for the tenant by entering the following information. (Vidyo supports EPIC set external connection status through a web service which allows Hyperspace to properly reflect the video visit status of the Vidyo system in the provider schedule and connect visit navigator sections):  
    • Enter a 16-digit alphanumeric Crypt Key in the Shared Secret field.

      The 16-digit  crypt/shared secret key can be manually created or you can use a key generator.

      Please note that you must enter the same Shared Secret in your Epic database. This secret will be used for encrypting and decrypting the URL strings.

      EPIC_2.png
    • Enter the Epic Interconnect/SetExternalConnectionStatus URL in the Notification URL field.
    • Enter the Epic Interconnect/SetExternalConnectionStatus user name in the Notification user field.
    • Enter the Epic Interconnect/SetExternalConnectionStatuspassword in the Notification password field.
  7. Click Save.

 

Important Tips when Configuring Epic Integration (On-Premises)

The following information will assist you in your configuration of Epic.

  • Vidyo supports the AES encryption for the crypt algorithm.
  • The format for the crypturl which is configured on the Epic system should have the following format: https://<vidyo portal tenant fqdn>/join/?extDataType=1&extData=%CRYPTSTR%. You will need to replace the <vidyo portal tenant fqdn> with the actual portal FQDN.
  • The Crypt Key is the same as the Shared Secret and is a 16 digit alphanumeric number.

 

Epic Demonstration of CAL

To view a demonstration of CAL in action hosted on Epic's galaxy site, select this link: https://eventarchive.epic.com/telehealth/Vidyo%20CAL%20Demo.mp4. You may need to obtain special login permissions to view this demo.

 

Was this article helpful?
0 out of 1 found this helpful

Comments

1 comment

  • Avatar
    Jason Davis

    The video link does not work.

Please sign in to leave a comment.