Error messages with WebRTC phones


Note: This article applies to PureCloud Embeddable Framework, PureCloud for Chrome, PureCloud for Firefox, PureCloud for Salesforce, and PureCloud for Zendesk.

When you attempt to use WebRTC phones, you encounter one of the following error messages in the client. 

No audio devices are available for WebRTC phones to use

This error can occur in PureCloud Embeddable Framework, PureCloud for Chrome, PureCloud for Firefox, PureCloud for Salesforce, or PureCloud for Zendesk.

WebRTC phones require access to audio devices. When you first select a WebRTC phone, your browser detects which audio devices are available for use and the client makes them available for you to select. If your browser cannot detect any audio devices, then you receive the following message:

Error message indicating that no audio devices available

Fix the settings for audio devices in your browser or operating system and then refresh your browser. 

The WebRTC Phone window is unable to display

This error can occur in PureCloud Embeddable Framework, PureCloud for Salesforce, or PureCloud for Zendesk.

Error message about WebRTC Phone window not displaying

The WebRTC Phone window is unable to display for these reasons:

  • You have pop-up blocker turned on in your browser.
    1. Allow access to pop-ups in your browser.
    2. Refresh your browser.
  • You use a Firefox browser and have attempted to close the WebRTC Phone window (or tab).

    In the Firefox browser, when you close the WebRTC Phone window (or tab), the browser warning dialog box replaces the WebRTC Phone window (or tab). The WebRTC Phone window (or tab) must remain open to maintain WebRTC phone connectivity.

    Note: When using a browser in full-screen mode on a computer running macOS, the WebRTC Phone window appears as a tab in your browser. To maintain WebRTC phone connectivity, do not close this tab.
    1. In the browser warning dialog box, click Stay on Page.
    2. Refresh your browser.

WebRTC Phone does not have permission to access microphone

The following error can occur for Chrome browser users of PureCloud Embeddable Framework, PureCloud for Chrome, PureCloud for Salesforce, or PureCloud for Zendesk. Error message about missing permission to access microphone

If you use a Chrome browser, when you first select a WebRTC phone, Chrome prompts you about allowing the app to use your microphone.Chrome dialog about sharing your microphone

You did not select Allow. However, now you want the app to use your microphone. 

Grant the app access to your microphone.

If you use a private deployment of PureCloud Embeddable Framework, confirm that your iframe includes the camera, microphone, and autoplay attributes.

<iframe allow="camera *; microphone *; autoplay *" src="https://apps.mypurecloud.com/crm/embeddableframework.html"></iframe>
Note: For WebRTC phones to function correctly, you must add the recommended attributes to your iframe.

The following error can occur for Firefox browser users of PureCloud Embeddable Framework, PureCloud for Firefox, PureCloud for Salesforce, or PureCloud for Zendesk.

Error message about missing permission to access microphone

If you use a Firefox browser, when you first select a WebRTC phone, Firefox prompts you about allowing the app to use your microphone. Firefox dialog about sharing your microphone

You selected Remember this decision and clicked Don’t Allow. However, now you want the app to use your microphone. 

In your Firefox preferences, change Block under the URL for the app to Allow.

For more information about the integrations, see About the PureCloud browser extensionsAbout PureCloud Embeddable Framework, About PureCloud for Salesforce, and About PureCloud for Zendesk.