User guide for Zoom Phone Smart Embed integration
Your account admin can allow you to use Zoom Phone Smart Embed with your third-party web application to use softphone services. You can sign in to Zoom Phone Smart Embed from within your web app with Zoom credentials to call, answer a call, control a call, send and receive SMS, access call recordings and voicemails, and view call history.
Notes:
- Zoom Phone Smart Embed is not compatible with mobile browsers.
- Access the Zoom Developer page, if you are a developer and need access to the APIs and events supported by the Softphone component, and also learn how to embed the softphone into your app.
This article covers:
Prerequisites for using Zoom Phone Smart Embed
How to use call controls on Zoom Phone Smart Embed
Note: While on a call, you will see the dialog box Allow Zoom Phone Smart Embed to manage call control actions on your behalf, asking you to make the following selection to manage your call control. You can change your selections at any time.
- Always: This option will apply to all subsequent calls and the dialog box will stop displaying.
- Now: This option will apply to your current call and will need to be selected again for your subsequent calls.
- Never: This option will not allow call control actions.
How to sign in to the Zoom Phone Smart Embed app
- Sign in to the Zoom client app.
- Start the Zoom Phone Smart Embed web app.
- Click the Sign in button.
You will be redirected to the Marketplace page to sign and authorize the app. - In the dialog window, at the bottom of the page do the following:
- Click the checkbox to Allow this app to use my shared permissions to give permission to use your information in accordance with their terms and policies.
Note: You can click on the terms and policies links for further information. - Click Allow.
A successful message will appear to let you know you signed in successfully if you signed in to the domains approved by your admin.
How to receive calls using the Zoom Phone Smart Embed app
It's required to select a device for you to receive calls. By default, the previously selected device is the one made available to receive calls.
- Access the Zoom Phone widget in your Zoom Phone Smart Embed app.
Incoming calls will show in the call confirmation display with the name or number of the caller. - Click one of the following icons:
- Accept: To accept the call.
- Decline: To hang up the call.
- If you accepted the call, you can control the call by doing the following:
- Click the Mute icon
, to mute the call. - Click the Hold icon
, to put the call on hold. - Click the Record icon
, to record the call. - Click the Minimize icon
, to minimize the call.
The call will appear active on the top of the widget, allowing you to access the keypad.
Note: You can click the active call to resume the call control menu. - Click the End icon
, to end the call.
How to make a call using the Zoom Phone Smart embed app
- Access the Zoom Phone widget in your Zoom Phone Smart Embed app.
- From the phone dial pad, click the Keypad tab then enter or dial a phone number to call.
- Click the Phone icon
.
The call control menu will appear. - While on the call, from the call control menu, do the following:
- Click the Mute icon , to mute the call.
- Click the Hold icon , to put the call on hold.
- Click the Record icon , to record the call.
- Click the Minimize icon , to minimize the call.
The call will appear active on the top of the widget, allowing you to access the keypad.
Note: You can click the active call to resume the call control menu. - Click the End icon , to end the call.
How to send and receive SMS messages using Zoom Phone Smart Embed
- The SMS feature in the Zoom Phone Smart Embed allows you to send and receive text messages (SMS) if you are assigned this privilege by your admin. If you don't have this function, please contact your Zoom admin.
- Any changes to your Zoom account, such as assigning or removing a direct number, will require a refresh of your browser page to reflect that change.
Send a text message to a phone number or contact/lead using Zoom Phone Smart Embed
- Access the Zoom Phone widget in your Zoom Phone Smart Embed app.
- From the phone dial pad, select the SMS tab.
- Click the pencil icon
to start writing your new text message. - In the To: box, type the phone number or the name of the contact/lead to send the text message.
- In the Text... box, type your message.
- Click the send icon
to send your message.
Your message will be sent.
Note: If sending the message fails, click Retry to send the message again, or click Delete to delete it. - Click the File icon
to send images.
Notes:
- If you have multiple direct numbers, you will have to choose one number to send your SMS from.
- You can send SMS to up to 10 recipients at a time.
- You can send a message to an existing SMS thread.
Read a text message using Zoom Phone Smart Embed
- Access the Zoom Phone widget in your Zoom Phone Smart Embed.
- From the phone dial pad, select the SMS tab.
- Click the text message you desire to read.
How to view voicemails in the Zoom Phone Smart Embed app
- In your softphone dialer widget, click the Voicemail tab.
Note: Voicemail messages are displayed in reverse chronological order with the most recent messages at the top with the name or number of the caller that left the message. - (Optional) Click the refresh icon
to view the latest voicemail messages. - Hover over a voicemail entry for these options:
- Click the phone icon
to call the selected number. - Click the play icon
to play the associated voicemail.
The voicemail will display as you play it and you can click the pause icon to pause it. - Click on the more icon
, then select Copy Number to copy the phone number or Delete to delete the voicemail.
How to view call history in the Zoom Phone Smart Embed app
- In your softphone dialer widget, click the History tab.
Your call history will be displayed showing the name, or the number of the users you called with the date and time. The most recent call history will display at the top. - Click a call history entry to view the details.
- To the right of All History, click the drop-down arrow
, then select the following:
The calls will be filtered and will display your selection.
- All: To view the entire call history.
- Missed: To view only missed calls.
- Recording: To view recorded calls only.
- Hover over a call history entry for the following options:
- Click the phone icon to call the selected number.
- If the call was recorded, click the play icon to play the associated recording.
Note: While playing a recording, you can click the pause icon to pause it. - Click on the more icon , then select Copy Number to copy the phone number or Delete to delete the call entry.
How to sign out of the Zoom Phone Smart Embed app
- From the Softphone widget, on the top-right corner, click the Profile icon.
- (Optional) Click Settings, to adjust your settings.
- Click Sign Out.
The user session information will be cleared out after signing out.