Initial Audio Device Check

The initial audio device check allows you to check an audio device's health when Flex starts up. Using the initial audio device check ensures that Flex can properly access your agents' audio devices before agents become available and are being offered any phone calls. This will significantly reduce the number of audio related issues resulting in cancelled incoming and outgoing calls.

Starting from version 1.25 of Flex UI, Initial audio device check (previously in Pilot release) is GA and will be enabled by default for all accounts. If you still would like to turn it off, you can do so with Flex UI configuration. Go to section "How do I turn the audio device check feature on / off?" below, to find out more.

Why do audio device issues occur?

The most common issues with accessing the audio device are:

  • Browser permissions for Microphone access have not been granted
  • Disconnected or faulty USB headset
  • Headset driver issues

You can read up on the full list here.

How does the audio device check work?

To make sure that your audio device is ready to be used when you start receiving or making calls, the Flex UI will try to access an audio device from the list of available devices when Flex starts up, the browser window refreshes, or the available device list changes. In most cases, it will be a default device. If the Flex UI is able to access the device, then it will use the device for incoming and outgoing calls.

What happens if Flex UI couldn't access any devices?

If the Flex UI doesn't find any devices, it will reject all incoming and outgoing calls by rejecting the task reservation. The Flex UI will show the user an error describing the issue. Reservations will be rejected until the user fixes the device issue.

We strongly advise users to switch to an unavailable state as soon as the error occurs so that further calls can be properly routed to other agents.

Once the device list has been updated, the Flex UI will check for available devices again. The Flex UI checks the audio device on every browser refresh AND on any changes in the available device list.

How do I turn the audio device check feature on / off?

You might want to keep this feature off for the following reasons:

  • You are a messaging-only contact center and do not make or receive calls
  • You have customized Flex to receive calls over non-WebRTC devices
  • You are a developer and use a Bluetooth headset to listen to banging tracks and deep cuts while developing.

Flex also provides a config flag. This allows you to bypass the audio device check.

appConfig = {
  initialDeviceCheck: false

Rate this page:

Need some help?

We all do sometimes; code is hard. Get help now from our support team, or lean on the wisdom of the crowd by visiting Twilio's Stack Overflow Collective or browsing the Twilio tag on Stack Overflow.

Thank you for your feedback!

Please select the reason(s) for your feedback. The additional information you provide helps us improve our documentation:

Sending your feedback...
🎉 Thank you for your feedback!
Something went wrong. Please try again.

Thanks for your feedback!