Provider Manual · Part XXIII

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.

17 sections~25 min read
XXIII
Part XXIII

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.

23.1Phone setup

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.

  1. Turn on the phone feature. A practice administrator, or someone allowed to manage additional features, opens Admin → Additional Features, enables Soaper Phone, and clicks Save Changes.
  2. 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 to Analytics, and they can review the Agent Log but not change settings. Viewing settings and changing them are separate permissions; a person with read-only access cannot save changes.
  3. Keep your current number, or get a new one. To keep the practice’s current number, open Admin → Practice Setup, find Phone setup, and click Request 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, open Numbers & Routing, click Get a phone number, enter an Area code (optionally Ends with), press Search, choose Use this number, review the price, and click Buy and set up. A new number rings a published phone tree, so publish one first. If a Backup number is 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, use Add an emergency address. A practice can get up to three numbers this way; contact Hero support for more.
  4. Choose the tab for the job. Numbers & Routing controls each number’s call flow; AI Agent configures the answering agent (AI Agent settings); Call Routing manages ring groups, schedules, and holidays; Voicemail manages mailboxes. Devices & Dial-out sets up staff phones, recording, and emergency alerts. Agent Log and Analytics help review calls.
Turning the feature off affects callers. Provisioned numbers use their configured failover destination. Review that destination before switching off the phone system.
23.2Browser calling

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.

  1. 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 use Check again. A blocked microphone must be allowed in the browser’s site settings; reload afterwards.
  2. Choose audio devices. Open Phone audio and alerts in the dock. Choose Microphone and, where supported, Speaker. Ring on this computer controls the ringtone; only one of your tabs rings. Desktop alerts needs the browser’s notification permission.
  3. Keep a dedicated phone computer available. Keep this computer signed in for calls stops 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.
  4. 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. Use Do not disturb when you should not receive calls.
Calls that end immediately: check the microphone is plugged in, allowed for this site, and not held by another program. For messages left while nobody answers, see Voicemail in the Inbox.

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.

23.3Ringing & busy calls

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.

  1. Choose simultaneous or ordered ringing. Everyone at once rings available members together. The other strategies ring one person at a time, in priority order or by rotation.
  2. 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.
  3. Set If everyone is on another call. The default, Go to the next step right away, follows the no-answer path immediately. Choose Keep the caller ringing until someone is free to wait, then set Wait up to (seconds) from 1 to 120. Callers hear ringing while they wait; when time runs out, the no-answer step still applies.
  4. 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.
23.4Desk phones

Set up desk phones for an office location

On for every practice. Desk phones are available to every practice using Soaper Phone, unless Hero support turned them off for yours. Phone managers work under Admin → Soaper Phone → Devices & Dial-out → Desk phones. The panel shows the practice’s outside-call limits; contact Hero to change them.
  1. Prepare the location’s emergency address. On Numbers & Routing, register the correct 911 address for a dedicated location number and wait for confirmation. Set up the 911 alert list too.
  2. Add the office location. Use Add office location. Enter its Name, select the registered 911 address and Emergency callback number, and supply Office internet addresses — at the office, Add this computer’s internet address fills in the one you are on. Confirm the physical address before Add location. Emergency callbacks ring the location’s desk phones directly.
  3. Complete the location’s alert setup. If the location asks for it, use Set up 911 alert and wait for setup to finish. A location must be ready before adding its phones.
  4. Add the phone. Use Add desk phone, name it, choose whether it belongs to a person or is shared, and choose its Office location. A personal phone also needs a Person. Enter its MAC 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. Enable Dial out from the keypad if appropriate, then Add phone.
  5. 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 under Settings → Auto Provision on the phone’s web page), and Hero connects the phone., which shows Waiting for the phone… until it reads Connected. For another brand, or without a MAC address, use Enter settings by hand instead: a one-time setup sheet with the connection settings. Copy the password or use Print before closing the sheet: it cannot be shown again. Keep a printed sheet secure or shred it after setup.
  6. 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 link gives the phone a new link, and the old one stops working. On a phone set up by hand, if the password is lost, use Reset password and update the phone with the new sheet. Move to another location also issues new settings; use it when physically moving a phone so emergency calls report the correct location. Disable stops the phone from making and taking calls, including emergency calls; enabling it again requires new setup.
Use the location where the phone actually sits. Emergency calls report the registered office address. A phone signed in from outside the office has dial-out paused until it returns to the office connection.
23.5Emergency call alerts

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.

Browser calling uses a registered address. Review 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.

23.6Review calls

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.

Outbound AI-call recordings are kept for seven days by default. Check the call’s 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.
23.7AI outbound calls

Ask the AI to make a call, then review the plan

Hero turns this on for your practice — ask support. Starting an AI call needs phone-management access, an enabled answering agent, and an approved destination. Planning from a sentence and connecting you to a person have additional setup requirements. Ask Hero to configure your callback number before requesting a handoff. Until Hero turns AI calling on, 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.
  1. Open New AI call in the Agent Log. Under What should the AI do?, describe whom to call and the task. Click Plan call. Nothing is dialed yet; answer any clarification request and plan again.
  2. Review the destination and task. Check Who it will call, the number, any published hours and warnings, and What the AI will do. Use Show full instructions to read the full plan. Edit instruction takes you back to revise it.
  3. Decide what may be shared. Under What it may share, untick any detail the agent should not receive. Check Connecting you to confirm whether the AI handles the whole call or rings you after reaching the requested person.
  4. Start only after review. Click Start call. If the plan expires, use Plan again and review the replacement. The Agent Log shows progress and the eventual result.
  5. Use manual details when needed. Enter details manually opens Number to call, Goal, optional Instructions, and Allowed details. Use Add detail for information the agent may disclose. Connect me when a person answers also needs Department to reach. This form starts with Start AI call.
  6. 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.

23.8AI Agent settings

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).

  1. Turn the agent on. AI answering agent switches 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.
  2. Write the greeting and pick the voice. Under Greeting and voice, set the Agent name, the Greeting (it may use {org_name} and {agent_name}; Callers hear previews it), the Goodbye and the After-hours message. A blank field uses the standard wording shown in grey. Beside Callers hear, choose the Voice and press Play greeting to 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.
  3. Choose what it can do. Each switch under What the agent can do says what happens when it is off. Off means the agent cannot do it at all, not just that it is asked not to.
  4. Choose the locations it mentions. Locations the agent mentions lists 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.
  5. 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-offs holds Maximum turns, Escalation instructions and Practice instructions (Train your AI front desk).
SwitchWhen it is onStarts
Schedule new appointmentsFinds 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 appointmentsLooks up an upcoming visit, moves it or cancels it.On
Prescription refill requestsA 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 messagesTakes a message for the practice (Messages the AI takes).On
Answer practice questionsHours, locations, fax number, accepted insurance and your doctors, read from Clinic Information (Edit practice info).On
Transfer to staffHands the live call to a ring group, a person or a voicemail box from your phone tree.Off
Send callers to voicemailA 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 numberWhen 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.

Bills and results stay in the portal. The agent doesn’t go through a patient’s bill or results on the phone; it points the patient to your patient portal (only to the parts your portal has turned on) and says its web address.
23.8aTrain the AI front desk

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.

  1. Write practice instructions. In Admin → Soaper Phone → AI Agent, under Instructions and hand-offs, use Practice instructions for “anything specific to your practice the agent should know or say, e.g. parking directions or which visits need a referral.”
  2. 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 under What the agent can do for what it may do at all (AI Agent settings).
  3. 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, Locations and Insurance. Choose which locations it mentions under Locations the agent mentions.
  4. Press Save AI agent settings in the bar at the bottom of the AI Agent tab.
  5. Check real calls. Review what it said in the Agent Log (Review calls) and adjust the instructions where it went wrong.
23.8bInsurance the AI mentions

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.

  1. Open Admin → Practice Info and click Insurance (under Records).
  2. 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. Add Notes if needed (for example PPO only, location-specific, prior auth notes…).
  3. 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.

23.9Messages the AI takes

Where the agent’s messages and requests land

The callerWhat the agent doesWhere it lands
A verified patient leaving a messageTakes 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 accountTakes 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 refillLists 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 ageSee 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.

23.10Monthly AI usage

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.

  1. Set Monthly limit (AI minutes). Leave it blank for no limit (the default).
  2. Set First alert at (% of the limit). 80 by default; you also get an alert when the limit is reached.
  3. Choose When the limit is reached. Keep the AI answering and alert us changes nothing for callers. Stop the AI for new calls until next month sends 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.
  4. 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’s Patient view can get them; anyone saved who can’t is marked.
  5. Press Save AI agent settings.
Stopped for the month? The card says The monthly limit is reached. New calls skip the AI until {date}. Raise or clear the limit to turn it back on now. With Keep the AI answering, it says The monthly limit is reached. The AI keeps answering.
23.11Crisis calls

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.

  1. 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).
  2. 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 clinicians goes back. Someone who can’t open the Patient folder is marked Can’t open the Patient folder in the Inbox, so gets no alerts.
  3. Connect crisis callers to — No one (alert and urgent message only) by default, or a person (rings their Hero phones), a ring group, or An outside phone number such as an on-call cell (the person who answers presses 1 to take the call). Name the assistant uses is 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.
Crisis detection is automated and won’t be perfect. It can miss a crisis or flag a call that isn’t one. Don’t rely on it as your only safeguard. The assistant always tells callers to call 911 in an emergency and gives them 988, the Suicide and Crisis Lifeline. After each call a review also looks for signs of a crisis the assistant didn’t report, and alerts the same people.
23.12Calls about minors

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.

23.13AI in other languages

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.

  1. Open Admin → Soaper Phone → Numbers & Routing and open the number’s phone tree.
  2. 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) or AI 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.
  3. To add languages to your own menu, select the menu step and click Add language options. Tick the Languages; each takes the next free key from 1 to 9. Check If the AI cannot take the call and what The menu will say, then click Add options.
  4. Or set one AI step’s language with its Language select (English, Spanish, Mandarin Chinese, Korean, Russian). The diagram then reads, for example, AI agent · Spanish.
  5. Click Save draft, then Publish. 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.

23.14After hours & covering provider

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.

  1. Set your hours. In Admin → Soaper Phone → Call Routing, check the schedule and holidays the phone tree uses.
  2. Open the number’s phone tree on Numbers & Routing and click Add step. Add a Business hours step (“Send the call one way during open hours and another way outside them.”) and choose its Schedule.
  3. Add a Forward outside step (“Forward to an outside number, such as an answering service.”). In Forward 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.
  4. Send the Business hours step’s closed (and holiday) branch to the Forward outside step. Save draft, then Publish.

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).

23.15Port or link other numbers

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.

  1. Open Admin → Practice Setup and find Phone setup (or the fax step for a fax number).
  2. Click Request port (“For keeping your current number. Hero will email you a form to sign.”). The step then reads Port requested.
  3. Sign the authorization form Hero emails you and send a recent bill from the current phone company (Zoom, Spruce or your carrier).
  4. 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.