Zoom Phone Smart Embed: Session disconnects when mobile device goes to sleep
We are using Zoom Phone Smart Embed embedded as an iframe in our web application. We use it in combination with the Call Me On feature to route outbound calls through a mobile device.
Issue
When the mobile device (with Zoom Workplace app installed) goes to sleep (screen lock), the Smart Embed iframe on the desktop web application displays the following error:
Connection Lost: It seems your session has ended.
Please refresh the page to reconnect and update the device list.
When the mobile device is unlocked and the Zoom app returns to online status, the error message appears to clear on its own. However, the user reports that they also need to refresh the Smart Embed screen multiple times — we have not been able to reproduce this behavior on our end and are still investigating.
Steps to Reproduce
1. Connect a Zoom Phone account to our web application
2. Enable Call Me On in the Zoom Workplace mobile app and set the mobile device as the calling device
3. Load the Smart Embed iframe in the web application
(https://applications.zoom.us/integration/phone/embeddablephone/home)
4. Lock the mobile device screen (sleep)
5. Wait approximately 30 seconds to 1 minute, then check the Smart Embed display
→ The "Connection Lost" message appears.
Environment
- Smart Embed: iframe integration
- iframe URL: https://applications.zoom.us/integration/phone/embeddablephone/home
- Init config: zp-init-config (enableSavingLog: false, enableAutoLog: false, enableContactSearching: false, enableContactMatching: false)
- Mobile device: iOS / Android (latest Zoom Workplace app)
- Desktop browser: Chrome / Edge (latest)
- Calling method: Call Me On
Additional Context
- Due to the organization's security policy, the screen lock timeout on the mobile device is set to 1 minute and cannot be extended.
- We have also observed that the Call Me On feature does not work unless the Zoom Workplace mobile app is kept running in the foreground and logged in. Is this expected behavior for Smart Embed?
Questions
1. Is there a way to keep the Smart Embed session alive regardless of the mobile device's sleep state?
2. Does Smart Embed provide any postMessage event to detect session disconnection (e.g., something like zp-connection-lost)? Are there any plans to introduce such an event?
3. Once the mobile device wakes up and the Zoom Workplace app reconnects, does the Smart Embed session recover automatically? Or is there any scenario where a page refresh is actually required to restore the session?
4. When using Call Me On, is it correct that the Zoom Workplace app on the mobile device must be running and logged in at all times?
Use Case
In our use case, sales representatives make continuous outbound calls from a desktop web application, while the actual calls must be routed through a company-provided mobile device due to security requirements. Having to unlock the mobile device and confirm the Zoom app status every time the screen locks severely impacts productivity.
Any guidance would be greatly appreciated. Thank you.
