Phone integration guide

Connect and use Zoom Phone

Connect your practice’s existing Zoom Phone account, make calls, review voicemail and remove the connection.

Your practice needs the phone integration enabled and an authorized connection to its existing provider account. Connecting does not purchase phone service or change your SoapBox role. Screenshots show the actual staging app with synthetic training records; your practice, names and connection status will differ.

Download the complete phone guide (PDF)

Before you start

  • Have a SoapBox practice administrator select the intended practice. Phone & VOIP settings and the web Call Log currently require administrator access.
  • Use an existing Zoom account with Zoom Phone service and an assigned phone number. A Meetings-only account is insufficient. Your Zoom administrator may need to approve the app.
  • For patient calling from SoapBox, install the official Zoom desktop client, sign in to the authorized Phone account and test the microphone and speaker. This workflow does not provide an embedded browser softphone.
  • Confirm your practice’s approved use, communication consent and applicable provider agreements before using patient information. Configure ringing, forwarding, business hours and voicemail in Zoom.

Add the connection

  1. Sign in to SoapBox, complete any security verification and choose the correct practice. If you are new to SoapBox, the sign-in page also offers account creation; complete practice setup before connecting.
  2. Open Phone & VOIP settings. If the link first asked you to sign in, select your practice and open this settings link again.
  3. In the Zoom Phone card, choose Connect. Complete any fresh security verification in SoapBox. Allow the authorization popup for this site.
  4. Sign in to the intended Zoom account. Review the requested permissions and authorize only if the account and use are correct. Do not create a developer app or paste provider secrets into SoapBox support.
  5. Return to the original SoapBox tab and verify the Zoom connection status. If the popup opens SoapBox without refreshing the original tab, reload the original settings page and inspect status before trying again.
  6. Configure the supported staff mappings under Call routing, then make approved test calls and check their records. These mappings select who receives a SoapBox notification; they do not change Zoom’s call-handling rules.
Phone and VOIP settings showing the Zoom Phone Connect button and provider connection status
Actual staging settings. This example has RingCentral selected and Zoom disconnected; use the Zoom Phone card for Zoom setup. The relevant controls are framed for readability; select the image for the complete original capture.

A practice selects one voice provider at a time. Replacing it changes the voice connection. Texting connections and permissions are managed separately when available.

Make and receive calls

  1. Open the intended patient chart, confirm the saved telephone number and select Call.
  2. Review the call dialog and select Start call, then Open Zoom Phone and call. Accept the browser’s request to open the installed Zoom client when appropriate.
  3. Watch Zoom for dialing and the connected call. The handoff can dial automatically: do not press Call again in Zoom or SoapBox just because the app changed windows.
  4. Answer incoming calls in your configured Zoom client or phone. SoapBox can show a caller card when inbound notifications are enabled and the extension is mapped to you.
  5. Confirm the caller and person receiving care, then file the call to the patient or patients actually discussed. See calls, voicemail and patient matching.

Review available voicemail from the Call Log’s Voicemail tab. Transcripts may be pending, empty or unavailable and need human review. This guide does not promise call recording, account-wide access to every staff member’s calls, or a total duration across transferred call legs.

Troubleshoot or reconnect

  • Settings unavailable: check the selected practice, administrator role and whether phone integration is enabled. Marketplace installation does not grant SoapBox access.
  • Authorization denied: verify the Zoom account, Phone service, administrator approval and requested permissions. Read any displayed error before reconnecting.
  • No desktop handoff: check that the Zoom client is installed and signed in to the correct Phone account, then inspect its call screen before retrying.
  • No audio: check the operating system’s input device, Zoom’s selected microphone/speaker and applicable browser permissions. Run Zoom’s microphone test first.
  • No caller card: confirm the provider connection, staff mapping and Show inbound screen-pop setting. During recording, Do not disturb may queue the notification instead.
  • Needs reconnect or an uncertain result: inspect Zoom’s call history before starting another call. Use the connection’s supported Connect/reconnect flow and verify the returned status. Do not create duplicate integrations.

Disconnect and remove Zoom authorization

  1. In the correct practice’s Phone & VOIP settings, choose Disconnect on Zoom Phone and read the confirmation before confirming. Verify that the practice no longer shows it as the selected connected voice provider.
  2. To fully remove the app from your Zoom account, sign in to the Zoom App Marketplace, open My Library (or Manage → Added Apps in the older view), find SoapBox AI - VOIP Integration, then use its actions menu to choose Remove and confirm.
  3. If other SoapBox connections use that Zoom authorization, review their impact before removing the app. Local voice Disconnect is not a promise that independent provider sessions or separately authorized services were removed.

Disconnecting does not delete previously imported SoapBox call records, transcripts or patient links. Existing records remain subject to your practice’s access and retention policies. Data still held in Zoom is managed through Zoom. For a SoapBox data request, follow the Privacy Policy and contact support without sending patient information in ordinary email. To reconnect later, repeat the authorization flow and verify the correct practice and account.

Related Zoom resources

For Zoom’s own account and phone controls, see getting started with Zoom Phone and adding and removing Marketplace apps. Those guides describe Zoom; the steps above describe SoapBox’s integration.