Using Zoom's Epic integration


The Zoom integration with Epic enables healthcare organizations to launch Zoom from within an Epic video visit workflow. Using context-aware linking in Epic, a link to a Zoom video session can be placed in an Epic appointment. This enables Epic users to easily use Zoom and the Epic EHR in a streamlined side-by-side workflow.

Physicians can go into their video visit appointments in Hyperspace and launch directly into the video visit in Zoom. They will continue to document in Epic while performing the video visit. Patients can launch into Zoom from their MyChart Patient portal on their personal computer or mobile device.

If you want to learn more about the Zoom/Epic Telehealth integration or would like more information on telehealth in Epic, please reach out to your Ambulatory TS.

If you need more information on the FHIR version, refer to the Epic FHIR integration guide

Note: With the deprecation of JWT authentication in September 2023, an account admin should migrate to authenticating the Epic integration with OAuth

This article covers:

Prerequisites for the Epic integration

How to add and configure the Epic integration

Adding Epic from the Zoom Marketplace

  1. Sign in to the Zoom App Marketplace with your Zoom owner or admin account.
  2. In the top-right corner, search for Epic and click the app.
  3. Click Add.
  4. Confirm the permissions the app requires, then click Allow.
    An admin on your Epic account will need to complete the following steps for configuration.

Configure Epic

In order to obtain some of the configuration information, you will need to be in contact with your Epic technical representative for help on building the FDR links and workflow.

Note: Follow the below steps only if you have earlier used JWT app to copy Api Key & Secret, and are reinstalling the Epic app. If not, please skip these steps.

  1. Sign in to the Zoom App Marketplace with your Zoom developer account.
  2. In the top-right corner, click Manage.
  3. In the navigation menu, click Created Apps.
  4. Click your developer.zoom.us API (JWT).
  5. Click App credentials.
  6. Copy your API Key and API Secret for use as Encryption Key and Secret in a later step.

 

  1. Once you have added the Epic app, configure the following fields:
    • Default Host User Email: This email address will be the default user that the Zoom meeting will be hosted for. Once the provider joins the meeting, they will become the host.
    • Provider User Type: The Zoom plan assigned to provider accounts when a user is automatically created as part of joining a telehealth meeting.
    • Encryption Key: The Zoom API Key. This must be from a paid account and the same Key configured in the Epic system.
    • Encryption Secret: The Zoom API Secret. This must be from a paid account and the same Secret configured in the Epic system.
    • Epic Environment: Select Test if will be used with an Epic test environment or select to Production if will be used in a live Epic production environment.
    • Default Patient Admittance Policy: Select Automatically enter the meeting when the provider joins if the patient should enter the meeting automatically when the provider joins the meeting. Select Be manually admitted to the meeting by the provider if the patient should be admitted into the meeting manually by the provider.
    • Authorization Type
      • No Authorization: Select this if no authorization is required for Epic notifications.
      • Basic Authorization: Select this to use basic authorization for Epic notifications and enter the auth name and password:
    • Auth Name: The user name of an Epic account that will be used for notification authorization if basic authorization is enabled.
    • Auth Password: The password of an Epic account that will be used for notification authorization if basic authorization is enabled.
    • Epic Connection Status Endpoint URL: Enter the URL from the Epic system where the Epic patient/provider join/leave notifications are to be sent to.
    • Epic Device Test Endpoint URL: Enter the URL from the Epic system where the device test results notifications are to be sent to.
    • Device Test Help Endpoint URL: Enter the URL where patients should be directed to when they click the help URL while running a device test.
    • Customize Launch Page: This allows the configuration of the text and image displayed when a patient joins a meeting before the host joins. 
      • Custom Text: Enter the custom text that will be displayed to participants on the meeting launch page.
        Note: The text can be a maximum of 256 characters.
      • Custom Logo: This allows the uploading of a logo that will be displayed on the meeting launch page.
        Note: The image can only be in a png or jpg file format, a max file size of 2 MB, and a maximum dimension of 800 x 600.
  2. Click Save Changes.

Re-authenticating with OAuth

With OAuth support for the Epic Zoom App and the deprecation of JWT authentication in September 2023, Epic admins can follow these steps to migrate from JWT to OAuth authentication.

  1. Sign in to the Zoom App Marketplace as the account administrator.
  2. In the top right of the page, click Manage.
  3. In the navigation menu, click Added Apps.
  4. Click the Epic app. 
  5. Click Update
    You will be prompted to authenticate with your Epic account. 
  6. Provide access to the requested permissions. When authentication is complete, you will return to the Epic marketplace page. 

How to use the Epic Integration

Data security

This app accesses and uses the following information from your Zoom account:

This app accesses and uses the following information from your Epic account:

Troubleshooting Epic integration issues

Epic green light issue

A provider using Epic’s Hyperspace or other client can know when a patient joins the telehealth meeting by a green light that lights up. If there are problems with the green light not working correctly, there are notification records that can be used to help diagnose the cause.

To access the notification records screen:

  1. Sign in to the Zoom App Marketplace with your Zoom account.
  2. In the top-right corner, click Manage.
  3. In the navigation menu, click Added Apps.
  4. Locate and select the Epic app.
  5. Click Manage, then click Configure.
  6. Click the Notification Records tab.
  7. Enter the Zoom meeting ID of the meeting that the green light was not working properly for, then click Search.

A list of notification records should appear. Each row in the table corresponds to a notification that is sent to Epic telling it when patients and providers join and leave the meeting.

The RespCode column indicates if the notification was successfully handled by Epic. When successful, a 200 will be displayed for each record. A value other than 200 indicates there is a problem with the notifications reaching Epic which can cause the green light to not work properly. Some things to check if there are problems:

For additional help or technical support, submit a request to Zoom Support.