Epic Integration

This guide covers connecting Vigil to Epic.

Prerequisites

Before starting, you need:

• Epic App Orchard registration (or equivalent)
• FHIR R4 endpoint URL
• OAuth2 client credentials (client ID, client secret)
• Required scopes approved

Work with your Epic administrator to obtain these credentials.

Required Scopes

Request these FHIR scopes:

Scope	Purpose
patient/Patient.read	Read patient demographics
patient/Observation.read	Read existing observations
patient/Observation.write	Write observations from Vigil

Configuration Steps

1. Access Integration Settings

1. Sign in to Vigil as IT Admin
2. Navigate to Settings > Integrations
3. Tap Config tab

2. Configure EMR Connection

Field	Value
EMR Type	Epic
FHIR Base URL	https://fhir.epic.com/interconnect-fhir-oauth/api/FHIR/R4 (example)
Auth URL	https://fhir.epic.com/interconnect-fhir-oauth/oauth2/token (example)
Client ID	From Epic
Client Secret	From Epic
FHIR Version	R4

3. Configure Patient Matching

Select matching method based on your Epic configuration:

• MRN - Match on Epic MRN
• MRN + DOB - Match on MRN and date of birth

4. Configure Data Flows

Enable desired data flows:

• ✓ Patient Census (Inbound)
• ✓ Observations (Outbound)
• ✓ Vitals (Outbound)
• ✓ Assessments (Outbound)

5. Test Connection

1. Tap Save
2. Return to Status tab
3. Tap Test Connection
4. Verify successful connection

ADT Integration

To receive patient census updates:

Epic Configuration

1. Configure Epic to send ADT messages to Vigil's webhook
2. Use HL7 v2.5.1 format
3. Include these segments:
   • MSH (Message Header)
   • EVN (Event Type)
   • PID (Patient Identification)
   • PV1 (Patient Visit)

Vigil Configuration

1. Navigate to Config tab
2. Set HL7 Version to 2.5.1
3. Note the Webhook URL displayed
4. Provide this URL to your Epic administrator

ADT Events

Event	Epic Action	Vigil Action
A01	Admit	Create patient
A02	Transfer	Update unit/room
A03	Discharge	Mark discharged
A08	Update	Update demographics

SMART on FHIR Launch

Enable launching Vigil directly from Epic:

Configuration

1. In Config tab, set SMART Launch URL
2. Provide this URL to your Epic administrator
3. Epic configures a hyperlink or button

Usage

1. Staff clicks Vigil link in Epic
2. Vigil opens to the correct patient context
3. No additional sign-in required (SSO)

Troubleshooting

Connection fails

• Verify FHIR Base URL is accessible from Vigil
• Check client credentials are correct
• Ensure required scopes are approved

Syncs failing

• Check Sync Log for error messages
• Verify patient exists in Epic (matching may fail)
• Review OAuth token expiration

ADT not arriving

• Verify Epic is configured to send to correct URL
• Check network connectivity
• Review ADT Log for received messages

Contact your Epic administrator and Vigil support for complex issues.