Move Emergency Contacts from 1.8-Style Events to 2.5+ Contacts
Quick Reference QR-AE-005 · Audio Enhancement EPIC · Rev 1.2 · Oct 2026
After upgrading to EPIC 2.5 or later, move text and email recipients out of the old event actions and into Contacts, then point each event at a contact group.
📄 View or download this guide as a PDF
Click the PDF icon below to open it right here in your browser. In the viewer, use Download (top right) to save a copy, or the printer icon to print it.
Before EPIC 2.5, each event kept its own list of email and text recipients inside its sendEmail and sendSms actions. From 2.5 on, people live in Contacts, sorted into contact groups, and each event just picks the groups to notify. The upgrade doesn't move the old recipients for you.
1️⃣ Find the old recipients
- Log into EPIC. Go to Settings › Events › Advanced.
- Open the event drop-down and select your event. This example uses SAFE Alert.
- Find the action that holds recipients:
sendEmail(email) orsendSms(text). Copy the recipients down if you haven't yet.
Settings › Events. The Advanced button is at the top right.
2️⃣ Clear them
- Click the edit pencil on the action, select all of the recipients in Enter Recipient and delete them.
- Click Update Action. Repeat for each event that sends email or text.
Advanced › the sendEmail action. Clear Enter Recipient, then click Update Action.
3️⃣ Create your contacts
- Go back to the regular Event Builder by clicking Events at the top, then click Contacts.
- Click Add Contact and fill in the name, email, mobile number and job title.
- Pick the Contact Group(s). The group decides which notifications a contact receives.
- Click Add Contact.
| Contact group | Who belongs in it |
|---|---|
| School | Principals and building-level administrators |
| District | Neighboring building principals (if not using District View), SROs, superintendents, operations |
| Support | People who know EPIC's back end. Typically used for system-monitoring events, like devices going offline. |
Events › Contacts › Add Contact. Pick the group(s) and click Add Contact. The mobile number is redacted.
4️⃣ Add a Messages action to each event
- Go back to the Event Builder (the arrow left of Contacts, or Events at the top).
- Click the event to notify on, for example SAFE Alert.
- Scroll down, open Immediate Actions (also labeled Then these actions will happen) and choose Messages - Send text and email notifications.
- Select the Contact Group(s) that should receive it.
- Edit the Email Subject and Message if you want. The defaults are good. Insert tags (variables) as needed (table below).
- Set when it runs. Start with previous runs it at the same time as the action above.
- Scroll to the top and click the green Save button.
Immediate Actions › Messages - Send text and email notifications.
The Messages action: contact group, subject, message, insert tags, and Start with previous.
| Event | What triggers it |
|---|---|
| SAFE Alert | Paired alert: the person pressed both sides of their own microphone, or a SAFE button was pressed |
| SAFE Alert - non-paired | Both sides of a microphone pressed outside its own room, or both sides of a badge. Starts triangulation on the front-office kiosk. |
5️⃣ Message variables (insert tags)
| Tag | What it inserts |
|---|---|
{schoolName} | School name (for example VSC High School) |
{roomName} | The Room Name from Map Setup (not the Display Name) |
{eventName} | Name of the event (for example SAFE Alert) |
{deviceName} | Device name set in Devices (for example VHS-105-MS700) |
{mapName} | Map name: usually the building, or a floor or section |
{zoneName} | Zone name (listed in EPIC's binding variables) |
{ip} | Device IP address (listed in EPIC's binding variables) |
{dateTimeOfEvent} | Date and time the event was triggered |
{emailActionUrl} | Link back to EPIC. For a SAFE Alert it can offer escalation to Lockdown (VSC understanding). |
{alertName} | Alert name. Usually the same as {eventName} (VSC understanding). |
Field tips
- Won't save? If EPIC reports missing fields or invalid data, check the entries outlined in red. Sometimes default entries are there with no values. Delete them and save again.
- A contact only gets an event's messages if one of their groups is picked in that event's Messages action.
- Send a test from one event after the move and confirm each group gets the email and text.
- EPIC 3.2+: make sure someone is in the default Support (missing-badge emails) and Maintenance Contact (offline-device emails) assignments.
📚 Sources & credits
- Compiled by Brad Roy, VSC Director of Operations. Procedure and field notes from VSC's demo server (VSC High School).
- Audio Enhancement: EPIC Release Notes 2.5.4.2 through 3.2.5 (pre-2.5 contact migration warning); EPIC 2.5 Admin Manual DC-40654.0824, Contacts and contact groups (p. 70), Messages action (p. 66); EPIC 3.2 User Management Enhancements DC-41278.0726 (contacts in User Management, Contact user group, contact groups, default contacts).
- EPIC Advanced action editor, Binding Variables list (screenshot 9/16/2025). Screenshots: VSC demo; mobile number redacted.