Phones & calls
Prepare the office phones, route incoming calls, decide what the AI answering agent may do, review what it handled, and check a plan before asking it to make a call.
Phones & calls
Prepare the office phones, route incoming calls, decide what the AI answering agent may do, review what it handled, and check a plan before asking it to make a call.
Open the practice phone workspace
Hero brings incoming calls, voicemail, browser calling, desk phones, and an AI answering agent into the practice workspace. The on-screen name is Soaper Phone.
- Turn on the phone feature. A practice administrator, or someone allowed to manage additional features, opens
Admin → Additional Features, enablesSoaper Phone, and clicksSave Changes. - Open
Admin → Soaper Phone. Administrators and staff with phone configuration access can open it. Staff who only have phone analytics access also see the menu entry; it opens straight toAnalytics, and they can review theAgent Logbut not change settings. Viewing settings and changing them are separate permissions; a person with read-only access cannot save changes. - Keep your current number, or get a new one. To keep the practice’s current number, open
Admin → Practice Setup, findPhone setup, and clickRequest port. Hero emails a short authorization form to sign and asks for a recent bill from your phone company. Keep your current phone service on until Hero says the move is done; calls and texts move together. For a new number, openNumbers & Routing, clickGet a phone number, enter anArea code(optionallyEnds with), pressSearch, chooseUse this number, review the price, and clickBuy and set up. A new number rings a published phone tree, so publish one first. If aBackup numberis requested, enter a phone outside Hero, such as a cell; calls ring it if Hero’s phone service is ever unreachable. When the number is ready, useAdd an emergency address. A practice can get up to three numbers this way; contact Hero support for more. - Choose the tab for the job.
Numbers & Routingcontrols each number’s call flow;AI Agentconfigures the answering agent (AI Agent settings);Call Routingmanages ring groups, schedules, and holidays;Voicemailmanages mailboxes.Devices & Dial-outsets up staff phones, recording, and emergency alerts.Agent LogandAnalyticshelp review calls.
Make the office computer ready for calls
The phone dock lets authorized staff place and answer calls without leaving Hero. In Admin → Soaper Phone → Devices & Dial-out, a phone manager turns on each person’s Softphone and assigns their Caller ID.
- Open the phone dock and check the microphone. If it says
Allow microphone, click that action and allow access in the browser. If no microphone is available, connect a headset and useCheck again. A blocked microphone must be allowed in the browser’s site settings; reload afterwards. - Choose audio devices. Open
Phone audio and alertsin the dock. ChooseMicrophoneand, where supported,Speaker.Ring on this computercontrols the ringtone; only one of your tabs rings.Desktop alertsneeds the browser’s notification permission. - Keep a dedicated phone computer available.
Keep this computer signed in for callsstops automatic sign-out while the phone is set up here. Use it on a dedicated front-desk or office computer. Leave it off on shared or personal laptops. These audio and sign-in choices apply to this computer only. - Place a call. Enter a name or number in the dock, select the correct patient number if searching, and click
Call. Hero checks microphone access before placing the call. UseDo not disturbwhen you should not receive calls.
Phone managers can enable Record outbound calls under Outbound recording. Both parties hear an announcement before the conversation begins. Listening to recordings requires separate access.
Choose who rings and what happens when everyone is busy
Under Admin → Soaper Phone → Call Routing, phone managers create or edit a ring group, choose its members, and set the Ring strategy. A personal desk phone rings with its owner; a shared desk phone can be added directly to a group.
- Choose simultaneous or ordered ringing.
Everyone at oncerings available members together. The other strategies ring one person at a time, in priority order or by rotation. - Set
Total ring time. This is how long the group can ring before the call follows its no-answer step. Each member’s ring time must fit inside that total. - Set
If everyone is on another call. The default,Go to the next step right away, follows the no-answer path immediately. ChooseKeep the caller ringing until someone is freeto wait, then setWait up to (seconds)from 1 to 120. Callers hear ringing while they wait; when time runs out, the no-answer step still applies. - Check the no-answer destination. An unanswered ring group can lead to its configured voicemail box. Busy or declined phones do not keep a caller waiting for a phone that cannot take the call.
Set up desk phones for an office location
Admin → Soaper Phone → Devices & Dial-out → Desk phones. The panel shows the practice’s outside-call limits; contact Hero to change them.- Prepare the location’s emergency address. On
Numbers & Routing, register the correct911 addressfor a dedicated location number and wait for confirmation. Set up the 911 alert list too. - Add the office location. Use
Add office location. Enter itsName, select the registered911 addressandEmergency callback number, and supplyOffice internet addresses— at the office,Add this computer’s internet addressfills in the one you are on. Confirm the physical address beforeAdd location. Emergency callbacks ring the location’s desk phones directly. - Complete the location’s alert setup. If the location asks for it, use
Set up 911 alertand wait for setup to finish. A location must be ready before adding its phones. - Add the phone. Use
Add desk phone, name it, choose whether it belongs to a person or is shared, and choose itsOffice location. A personal phone also needs aPerson. Enter itsMAC address(on the sticker under the phone or on its box) to let it set itself up, or leave it blank to enter the settings by hand. EnableDial out from the keypadif appropriate, thenAdd phone. - Connect the phone. With a MAC address, the
Connect {phone}window walks you through three steps: Plug the phone in., Give the phone its setup link — once. (copy the link; on a Yealink phone,Menu → Provision → Server URL, type the link,Save,Auto Provision Now, or the same underSettings → Auto Provisionon the phone’s web page), and Hero connects the phone., which shows Waiting for the phone… until it readsConnected. For another brand, or without a MAC address, useEnter settings by hand instead: a one-time setup sheet with the connection settings. Copy the password or usePrintbefore closing the sheet: it cannot be shown again. Keep a printed sheet secure or shred it after setup. - Check and maintain the phone. Refresh its status after setup. A phone set up from its link picks up new settings when it restarts, or within the hour;
Make a new setup linkgives the phone a new link, and the old one stops working. On a phone set up by hand, if the password is lost, useReset passwordand update the phone with the new sheet.Move to another locationalso issues new settings; use it when physically moving a phone so emergency calls report the correct location.Disablestops the phone from making and taking calls, including emergency calls; enabling it again requires new setup.
Choose who receives 911 call alerts
In Admin → Soaper Phone → Devices & Dial-out, the 911 alert list selects active teammates to notify when someone dials 911 from a browser or desk phone. Select recipients and click Save list. An empty list alerts nobody.
Desk-phone alerts interrupt the recipient’s Hero screen and include the phone, office location, and call result. A failed emergency call is reported too. Acknowledge the alert after reading it; acknowledgement does not end the call.
911 from the softphone with your phone manager. Someone working at home or travelling must use their own phone for emergency calls, because the office number’s registered address does not follow the computer.The phone alert list is separate from the practice’s Panic button, which asks signed-in teammates for immediate help.
Review AI-handled calls in the Agent Log
Open Admin → Soaper Phone → Agent Log to review AI-handled calls. Select a Range, then filter Direction to Inbound or Outbound, search, or narrow by category and outcome. Dates use the practice time zone.
Open a call for its timing, outcome, AI review, recording, and transcript. Recording and transcript access are separately controlled, so a teammate who can see the call list may not be able to listen or read the transcript. Review the actual conversation before relying on an automated summary.
Recording kept until date. Afterwards the audio is deleted and the call shows its retention notice. The call entry, transcript, and AI review remain; an older call with no playable recording is not necessarily a failed recording.Ask the AI to make a call, then review the plan
New AI call stays visible but greyed out with the note “AI calling isn’t turned on for your practice yet — ask Hero support”. A destination that is not approved for your practice is refused when you plan the call, with a plain explanation.- Open
New AI callin theAgent Log. UnderWhat should the AI do?, describe whom to call and the task. ClickPlan call. Nothing is dialed yet; answer any clarification request and plan again. - Review the destination and task. Check
Who it will call, the number, any published hours and warnings, andWhat the AI will do. UseShow full instructionsto read the full plan.Edit instructiontakes you back to revise it. - Decide what may be shared. Under
What it may share, untick any detail the agent should not receive. CheckConnecting youto confirm whether the AI handles the whole call or rings you after reaching the requested person. - Start only after review. Click
Start call. If the plan expires, usePlan againand review the replacement. TheAgent Logshows progress and the eventual result. - Use manual details when needed.
Enter details manuallyopensNumber to call,Goal, optionalInstructions, andAllowed details. UseAdd detailfor information the agent may disclose.Connect me when a person answersalso needsDepartment to reach. This form starts withStart AI call. - Stay available during the call. For a handoff, Hero rings your configured phone after a person answers; press 1 to join. If the agent needs information and requester chat is enabled, it asks in
Team Chat. Reply in that call’s conversation; the agent can wait on the line for your answer.
Call limits can prevent a new attempt. Up to ten AI calls to the same destination are allowed per practice-local day. If a destination or capability is unavailable, ask support rather than repeatedly starting the call.
Choose what the AI answering agent may do
Admin → Soaper Phone → AI Agent sets up the agent that answers wherever a published phone tree sends a call to it. Phone managers can change it; others with access see it read-only. Changes are kept as a draft until you press Save AI agent settings in the bar at the bottom (Discard changes drops them).
- Turn the agent on.
AI answering agentswitches it on or off. When it is off, phone trees can’t publish an AI step and a published one follows its fallback path at once, so no caller is left with a silent agent. - Write the greeting and pick the voice. Under
Greeting and voice, set theAgent name, theGreeting(it may use{org_name}and{agent_name}; Callers hear previews it), theGoodbyeand theAfter-hours message. A blank field uses the standard wording shown in grey. Beside Callers hear, choose theVoiceand pressPlay greetingto hear the greeting in that voice the way callers will, unsaved changes included; press it again to stop. Only people who can change the phone system can play it. - Choose what it can do. Each switch under
What the agent can dosays what happens when it is off. Off means the agent cannot do it at all, not just that it is asked not to. - Choose the locations it mentions.
Locations the agent mentionslists your active locations. Turn off one you use only for billing or hospital work: the agent won’t mention it, read out its hours, or book visits there, and it stays available to your staff. - Set crisis calls and calls about minors (Crisis calls, Calls about minors), the monthly limit (Monthly AI usage), and, if transfers are on,
Where the agent can transfer calls.Instructions and hand-offsholdsMaximum turns,Escalation instructionsandPractice instructions(Train your AI front desk).
| Switch | When it is on | Starts |
|---|---|---|
Schedule new appointments | Finds open times with your doctors and books them. Register new patients under it texts a registration link to callers who aren’t patients yet. | On |
Reschedule or cancel appointments | Looks up an upcoming visit, moves it or cancels it. | On |
Prescription refill requests | A verified patient can ask for a refill of a medication on file; it goes to the Refills folder like a portal request. It follows your refill settings under Prescriptions: patients must be allowed to request refills there, or the agent points callers to the patient portal and pharmacy instead. | On |
Take messages | Takes a message for the practice (Messages the AI takes). | On |
Answer practice questions | Hours, locations, fax number, accepted insurance and your doctors, read from Clinic Information (Edit practice info). | On |
Transfer to staff | Hands the live call to a ring group, a person or a voicemail box from your phone tree. | Off |
Send callers to voicemail | A caller who asks to leave a voicemail goes to the voicemail your phone tree sets as the agent’s fallback. | Off |
Recognize callers by phone number | When a call comes from a number on a chart, the agent asks only for a date of birth, confirms the name, and lists who the caller can schedule or request refills for: themselves, children they are the parent or guarantor of, and people they manage in the patient portal or are a verified legal representative for. With it off, every caller gives their full name and date of birth. | On |
A line under the switches says what the agent offers when a caller asks for something that is off: to take a message, a transfer to staff, or to call back during office hours.
Train your AI front desk: what the AI phone agent knows and says
You train the AI answering agent (your AI front desk or AI receptionist) by giving it written instructions and by keeping your practice information current. It answers from what you enter; it does not learn from past calls on its own.
- Write practice instructions. In
Admin → Soaper Phone → AI Agent, underInstructions and hand-offs, usePractice instructionsfor “anything specific to your practice the agent should know or say, e.g. parking directions or which visits need a referral.” - Say when it should hand off. In
Escalation instructions, “describe the situations where the agent should transfer to staff or take a message rather than continue.” Set the switches underWhat the agent can dofor what it may do at all (AI Agent settings). - Keep the facts it reads current. The agent answers practice questions from
Admin → Practice Info(“Practice details, accepted insurance, and what the AI phone agent and Inquiry Hero tell callers”):Overview,Custom Info,Providers,LocationsandInsurance. Choose which locations it mentions underLocations the agent mentions. - Press
Save AI agent settingsin the bar at the bottom of the AI Agent tab. - Check real calls. Review what it said in the
Agent Log(Review calls) and adjust the instructions where it went wrong.
Add to the list of insurances the AI phone agent tells callers you accept
The AI phone agent reads the practice’s accepted insurance list when callers ask which insurance you take. Add a plan to Accepted Insurance in Practice Info and the agent can name it.
- Open
Admin → Practice Infoand clickInsurance(under Records). - Under
Accepted Insurance, search in Search carrier or type a new plan name and pick the carrier, or type a plan name that isn’t listed. AddNotesif needed (for example PPO only, location-specific, prior auth notes…). - Remove a carrier you no longer take from the same list. A message confirms “Accepted insurance list was updated.”
Observed in Patient Records, below, lists insurers already on your patients’ charts for reference; it is not your accepted list.
Insurance we don’t accept
The same tab has Insurance we don’t accept (“Plans your practice does not take. Off until you add a plan; nothing changes for other plans.”). Search for the plan (for example UnitedHealthcare Community Plan), choose When a patient has it — Flag only or Treat as self-pay — and add Notes (Why, or what staff should tell the patient…). Staff then see a Not accepted chip on the patient’s policy, on the calendar and when booking, and patients see “Insurance not accepted” with your message in the portal; it never blocks sign-up or booking. The AI phone agent answers from the accepted list above; to have it tell callers about a plan you don’t take, add a sentence to Practice instructions. For how Treat as self-pay affects claims, see the billing pages.
Where the agent’s messages and requests land
| The caller | What the agent does | Where it lands |
|---|---|---|
| A verified patient leaving a message | Takes the message for the practice. | A patient thread in Inbox → Patient (Patient threads). |
| Anyone else: a new patient, a parent, a former patient, a pharmacy, lab or other office, a patient with no portal account | Takes an office message with the caller’s name, organization, callback number (with extension) and message, one per call; a correction is added to the same message. Nothing is sent to the caller. | Inbox → Inquiries, as a Phone message. There is no reply box: call the caller back at the number shown, then set the status to Responded. |
| A verified patient asking for a refill | Lists their medications on file and files the request (when Prescription refill requests is on and your practice takes refill requests). | Inbox → Refills, showing Requested via the AI phone (Refills worklist). |
| A caller who may be in crisis, or a call about a patient under your minor age | See Crisis calls and Calls about minors. | Crisis: an urgent item in Inbox → Patient (Crisis and AI usage alerts). |
With Take messages on, the agent sends a caller to voicemail only when they ask for it. Review what the agent did with each call in the Agent Log.
Watch AI phone minutes and set a monthly limit
The Monthly AI usage card at the top of the AI Agent tab shows this month’s AI phone minutes — for example 312 of 500 AI minutes used in October — with a bar, the Inbound and Outbound minutes, and the day it resets. Months follow your practice’s time zone, and the minutes are counted the same way they are billed. Nothing changes until you set a limit.
- Set
Monthly limit (AI minutes). Leave it blank for no limit (the default). - Set
First alert at (% of the limit). 80 by default; you also get an alert when the limit is reached. - Choose
When the limit is reached.Keep the AI answering and alert uschanges nothing for callers.Stop the AI for new calls until next monthsends new calls down the backup path in your phone tree (for example voicemail or a ring group); calls already with the AI finish normally, AI outbound calls and automatic return calls wait, and numbers that go straight to the AI keep answering. - Pick
Who gets usage alerts. With nobody picked, alerts go to the practice owner and admins. Alerts appear in each person’s Inbox and never include patient information (AI usage alerts). Only people who can open the Inbox’sPatientview can get them; anyone saved who can’t is marked. - Press
Save AI agent settings.
Keep the AI answering, it says The monthly limit is reached. The AI keeps answering.Decide who hears about a crisis call, and who can take it
When a caller mentions suicide, self-harm, hurting someone, an overdose or another danger right now, the assistant tells them to call 911 and gives them 988. The Crisis calls card on the AI Agent tab decides who on your team hears about it and whether the caller can be connected to a person.
Alert staff about crisis calls— on by default. Each person on the list gets the alert in their Inbox, marked urgent: one item per call, updated as the call goes on (Crisis and AI usage alerts). Turning it back on asks you to confirm (Turn on crisis alerts?→Turn on alerts).Who gets the alert— by default the practice owner and admins and all clinicians.Pick people instead…chooses your own list;Use owner/admins and all cliniciansgoes back. Someone who can’t open the Patient folder is marked Can’t open the Patient folder in the Inbox, so gets no alerts.Connect crisis callers to—No one (alert and urgent message only)by default, or a person (rings their Hero phones), a ring group, orAn outside phone numbersuch as an on-call cell (the person who answers presses 1 to take the call).Name the assistant usesis optional, for example our on-call clinician. After the 911 and 988 guidance the assistant offers the connection; if no one picks up within about 20 seconds it comes back to the caller, repeats the 988 guidance and takes an urgent message.
Calls about children and teens: let the AI help, or send them to your staff
The card Calls about patients under 18 (it shows your practice’s own minor age, from your minor and teen settings) covers a parent or guardian calling about a child, a new patient who is a child, and a teen calling about themselves. Since October 31, 2026 the default is Let the assistant help; a practice that wants these calls handled by people picks Send to staff and saves. A practice that had already saved Send to staff keeps it.
Send to staff
- The assistant doesn’t look up or share anything about the patient: no appointments, messages, refills or results.
- It tells the caller the office handles calls about patients under that age, then transfers the call to your staff if transfers are set up (taking a message if no one answers), or puts the caller through to your phone tree’s voicemail, or takes a message with their name and number where there is no voicemail.
- Questions about hours, locations and insurance are still answered.
Let the assistant help — the default
- The assistant helps with patients under that age the same way it helps adults, within your parent and teen privacy settings.
A crisis always comes first: if a caller about a minor may be in crisis, the crisis steps above apply.
Offer the AI agent in Spanish, Mandarin, Korean or Russian in your phone tree
Callers can press a key to talk with the AI agent in their language. Start from a five-language preset, or add language keys to an existing menu with Add language options.
- Open
Admin → Soaper Phone → Numbers & Routingand open the number’s phone tree. - To start fresh, pick a preset under Start from a preset: —
Ring your team, then voicemail or AI, in five languages(press 1 voicemail, 2 English, 3 Spanish, 4 Mandarin, 5 Korean, 6 Russian) orAI answers first, in five languages(press 1 or stay on the line for English, 2 Spanish, 3 Mandarin, 4 Korean, 5 Russian). Presets that use the AI need the AI agent turned on first. - To add languages to your own menu, select the menu step and click
Add language options. Tick theLanguages; each takes the next free key from 1 to 9. CheckIf the AI cannot take the calland whatThe menu will say, then clickAdd options. - Or set one AI step’s language with its
Languageselect (English, Spanish, Mandarin Chinese, Korean, Russian). The diagram then reads, for example,AI agent · Spanish. - Click
Save draft, thenPublish. Nothing reaches callers until you publish.
A menu that plays a recorded message is left alone, with a warning: re-record it to include the new options. To drop a language, delete its key on the menu, its AI step and its sentence in the menu message.
Put calls through to the covering provider or answering service when the office is closed
To send after-hours calls to an on-call or covering provider, add a Business hours step to the phone tree and route the closed branch to a Forward outside step with the covering provider’s or answering service’s number.
- Set your hours. In
Admin → Soaper Phone → Call Routing, check the schedule and holidays the phone tree uses. - Open the number’s phone tree on
Numbers & Routingand clickAdd step. Add aBusiness hoursstep (“Send the call one way during open hours and another way outside them.”) and choose itsSchedule. - Add a
Forward outsidestep (“Forward to an outside number, such as an answering service.”). InForward to, enter the covering provider’s or service’s phone number; it cannot be one of your own Soaper Phone numbers. Choose where the call goes if nobody answers, such as voicemail. - Send the
Business hoursstep’s closed (and holiday) branch to theForward outsidestep.Save draft, thenPublish.
To ring an on-call person inside Hero instead, use a Ring people step with their ring group. For crisis calls, Connect crisis callers to can ring an outside number such as an on-call cell (Crisis calls).
Port your phone or texting (SMS) number to Hero; Zoom Phone and Spruce numbers
To use a number you already have — for calls, texting or fax — port (transfer) it to Hero. Hero does not link to or sync with a Zoom Phone, Spruce Health or other outside phone service; a number stays with that service until it is ported.
- Open
Admin → Practice Setupand findPhone setup(or the fax step for a fax number). - Click
Request port(“For keeping your current number. Hero will email you a form to sign.”). The step then readsPort requested. - Sign the authorization form Hero emails you and send a recent bill from the current phone company (Zoom, Spruce or your carrier).
- Keep the old service on until Hero says the move is done. Then set up texting on the number in
Admin → External Providers → SMS, where the texting number can be the practice phone or the phone agent number.
Until the number moves, you can still send calls the other way: a Forward outside step in a Hero phone tree can forward calls to any outside number (After hours & covering provider).
Need help? Email support@heroemr.com.