Zoom telehealth integration
Connect one Zoom account per organization, provision telehealth meetings from the calendar, and bring recordings and transcripts into the chart.
Zoom telehealth integration
Connect one Zoom account per organization, provision telehealth meetings from the calendar, and bring recordings and transcripts into the chart.
Connect Zoom to your Hero EMR organization
An organization admin completes the Zoom setup from Hero EMR. Only one Zoom account can be connected per Hero EMR organization, and each physician should be mapped to a licensed Zoom host user before telehealth meetings are provisioned.
- Sign in to Hero EMR with an admin account. Open the admin area and go to the external provider settings where the Zoom integration is managed.
- Open the Video conferencing tab. In Hero EMR, navigate to
Admin > External Providers > Video conferencing. - Open the Zoom setup. The tab opens on an Active provider card with two choices, Zoom and Google Workspace. Pick Zoom to show its connection card. If it is not ready, Hero asks you to finish setup before switching future visits.
- Click
Connect Zoom. Hero EMR will redirect you to Zoom so you can authorize the integration for your organization. - Approve the Zoom authorization request. Sign in to the Zoom account you want connected to Hero EMR and grant the requested permissions. The integration uses Zoom access needed to read users, create and manage meetings, and optionally retrieve cloud-recording transcript files.
- Return to Hero EMR after Zoom redirects back. Once authorization succeeds, the card reads Zoom Telehealth with a Connected badge and a Connection summary — account, installed by, users last synced, and hosts available.
- Pull in your Zoom users. In Physician host mapping, click
Refresh hostsso Hero EMR can re-read the active users from the connected Zoom account. - Map each physician to a licensed Zoom host user. Pick a host from the dropdown next to every physician who will run telehealth visits. There is no save button — the mapping saves itself about a second after you choose; watch for the Saving… indicator turning into Saved (or Save failed). Where Hero can guess the match, a Use suggested: <name> shortcut appears under the dropdown. Each row shows Ready or Needs host.
- Confirm the active provider after setup. Select
Zoomagain if it is not already active, then confirmUse Zoom. Hero checks connection readiness again before switching. For Google Workspace, setup and verification refresh readiness on this screen too; select it again and confirmUse Google Workspacewhen ready. - Test with a telehealth appointment. Schedule or open a telehealth visit and confirm the meeting provisions correctly for the mapped physician.
Reprovision upcoming on the Active provider card and confirm — existing links for those visits may be replaced once provisioning finishes, so tell patients who already have a join link before you run it. The button stays disabled until the active provider is connected.
Run telehealth visits and optional note workflows
After setup, Hero uses the active video provider for new telehealth meetings. The Zoom instructions below apply to visits provisioned with Zoom. Providers, staff, and patients use the existing Hero EMR scheduling and encounter screens.
Day-to-day telehealth use
- Schedule a telehealth appointment in Hero EMR. The physician assigned to that visit must already be mapped to a licensed Zoom host user.
- Open the appointment from the calendar or schedule view. Hero EMR validates the Zoom meeting before launch and can queue meeting setup if a new meeting must be provisioned.
- Help the patient join. Video-visit confirmations and reminders include a Hero join link, which opens the meeting for that appointment. Patients can also join from their portal appointment when joining is available. Staff can send the link again with
Send video link…on the calendar. - Join from the calendar. In the Calendar’s
Dayview, each video visit has aJoinbutton in the Virtual column. It turns on 15 minutes before the visit and stays on until an hour after the start time. Hero EMR opens the Zoom host start URL (or the join URL) for the visit, and the visit’s note. For Google Meet, join while signed in to the practice’s Google Meet host account the clinician is mapped to; Hero names that account when you clickJoin. - A visit moved from your previous system before your practice goes live on Hero has no Hero video link yet:
Joinsays “Use your previous system’s video link until go-live”, with the planned go-live date when one is set (Detailsshows the whole message), and does not keep checking. Use your previous system’s video link for that visit; Hero creates the link when your practice goes live and the visits move over. - Repair or resync if needed. If a meeting is missing or out of sync, staff can use the built-in meeting setup or reschedule flow from the appointment so Hero EMR re-queues the Zoom provisioning job.
Ambient dictation with Zoom audio
- Open the note writer for the encounter. Launch the encounter note from the telehealth visit.
- Open audio settings next to the microphone control. Enable the option to capture Zoom or system audio.
- Select your audio sources. Choose your microphone, then choose a virtual system-audio input such as
ZoomAudioDevice (Virtual). If that device is not available, a BlackHole plus Multi-Output Zoom speaker setup can also work. - Test before live visits. Audio routing differs by machine, so verify that your microphone and Zoom audio are captured correctly before relying on the workflow in production.
Transcript import
- End the Zoom meeting so Zoom can finish processing the cloud recording.
- Open the encounter note in Hero EMR and use the Zoom transcript import option.
- If the transcript is not ready yet, wait a few minutes and try again.
- If there is no cloud recording, Hero EMR cannot import a Zoom transcript for that meeting.
Important operating rules
- One Zoom account is connected per Hero EMR organization.
- Each physician should map to a single licensed Zoom host user.
- Unmapped or unlicensed hosts will block telehealth meeting provisioning.
- Rescheduling the appointment should be followed by a Zoom sync if the meeting time needs to be refreshed.
Send a patient the telehealth (video visit) link, or change an in-person visit to telehealth
Patients get the link to their telehealth or virtual visit automatically: every video-visit confirmation and reminder carries a Hero join link, and the visit shows Join video visit in the patient portal and app. The button turns on 15 minutes before the visit (“The join button turns on 15 minutes before your visit”), and a patient with unfinished pre-visit tasks is asked to complete them first.
A patient can’t find the link, or the visit is happening right now
Send the patient their link again from the calendar, or copy it to share another way.
- Right-click the video visit on the calendar (on a Mac, Control-click or two-finger click) and choose
Send video link…. You can also click the visit and pressSend video linkat the top of the visit pane. It is offered for a video visit that is booked, checked in or under way, until an hour after its start time, to staff who can book appointments. - Choose Text, Email or both. The
Send video linkwindow ticks each one Hero can use and shows the phone number and email it will go to (partly hidden). When one can’t be used it says why, for example “No phone number on file for texts.” or “The patient opted out of texts.” For a child whose parent gets their notices, it goes to the parent’s phone and email. - Click
Send. The patient gets a text that says “Your video visit with (provider) is at (time). Join here: (link)”, and an email with aJoin video visitbutton. During the join window (15 minutes before the visit until an hour after it starts) it goes out right away, even during the patient’s quiet hours. Earlier than that, it waits until the patient’s quiet hours end, but never past the time the link opens. The message at the top of the screen says what went where, for example “Video link sent by text to ***-***-0147 and by email to j***@example.com.”
To copy the link instead, for example to paste it into a chat, right-click the visit and choose Copy patient link, or press Copy in the Send video link window. Share Hero’s link, not the Zoom or Google Meet link: opening Hero’s link records that the patient joined, so the visit isn’t treated as a no-show.
A visit moved from the practice’s previous system before the practice goes live on Hero has no Hero link yet: the previous system still sends the patient its own link, and a patient who presses Join video visit in the portal or app sees “Your practice will send you the video link for this visit. If you don’t have it, please call the office.”
Hero says why it can’t send a link for a visit that isn’t a video visit (use Convert to video visit first), one that was cancelled, marked a no-show or completed, one on hold, or one whose join time has passed. Pressing Send again within a minute doesn’t send a second message (“Already sent in the last minute.”). Patients can also open the link in their confirmation or reminder email or text, or sign in to the patient portal or app and press Join video visit on the appointment. Reminders follow your Appointment Reminder Policy.
Change an in-person appointment to a video visit
- Right-click the visit on the calendar (on a Mac, Control-click or two-finger click) and choose
Convert to video visit. It is offered for an in-person visit that is booked or confirmed and hasn’t started, today or later, to staff who can book appointments. - Pick the video visit type if asked. When the provider has one telehealth visit type, or one that clearly matches (for example Follow-up and Follow-up - Telehealth), Hero converts at once. Otherwise the
Convert to video visitwindow lists the provider’s video visit types with the best match chosen; clickConvert and email link. - Read the confirmation. The appointment keeps its time and length and becomes a video visit, and the patient is emailed the join link, for example “Now a video visit (…). Emailed … the join link; they can join now.” during the join window. If the patient has no email Hero can use, it says “No email went out: … has no email address Hero can use. Share the join link another way.”
Hero refuses the change, and says why, for a visit on hold (“Confirm it first”), one that has started or whose time has passed, one whose note is already signed, one that is already a video visit, and when the provider has no video visit type yet (add one in Visit Config). To go back to in person, change the visit type with Edit appointment (see Change an appointment’s provider or visit type).
Disconnect the integration from Hero EMR and Zoom
You can remove the app from the Hero EMR side, the Zoom side, or both. If the app is disconnected, new telehealth meetings will not be provisioned until the organization reconnects Zoom and remaps physicians if needed.
- Open the Zoom panel in Hero EMR. Go to
Admin > External Providers > Video conferencingand make sure Zoom is the selected provider. - Click
Disconnect Zoom. The button sits at the bottom of the Connection card. Confirm the disconnect action. Hero EMR will revoke the active Zoom installation for the organization and return the status to setup mode or deauthorized state. - Remove the app in Zoom if you want the Zoom-side installation fully gone. A Zoom admin can deauthorize or uninstall the Hero EMR app from Zoom Marketplace or the Zoom admin app management interface.
- Reconnect later if needed. To restore telehealth provisioning, repeat the add flow, click
Refresh hostsagain, and verify physician host mappings.
Common Zoom integration issues
Setup issues
- If Zoom is connected but no hosts appear, the panel says so directly: “No licensed Zoom hosts were found.” Assign Zoom licenses to those users in your Zoom account first, then click
Refresh hostsagain in Hero EMR. - If meetings stay pending, confirm the physician is mapped to a licensed Zoom host user.
- If
Joinsays to use your previous system’s video link, the visit was moved from that system and Hero creates its link when your practice goes live on Hero. Until then, use the previous system’s link. - If the Zoom account was already connected elsewhere, disconnect it from the other organization before reconnecting.
- If the app shows deauthorized, reconnect it from Hero EMR using the add steps above.
Transcript and audio issues
- Transcript import requires a Zoom cloud recording and enough time for Zoom to finish processing it.
- If transcript download permissions are missing, reconnect the app after updating the Zoom app scopes for cloud recording access.
- If Zoom audio is missing from ambient dictation, re-check the selected virtual audio input and test your local routing.
- If you need help, contact support@heroemr.com and include your organization name plus screenshots.
Need help? Email support@heroemr.com.