Logo
Sign in HotDoc Academy Submit request Remote support I'm a patient

  1. HotDoc Support
  2. General Practitioners
  3. Telehealth On Demand Practitioner Hub

  1. HotDoc Support
  2. General Practitioners
  3. Telehealth On Demand Practitioner Hub
Print Friendly and PDF   Follow

Troubleshooting the HotDoc Dialler

Last updated 20 January 2026 04:55   ∙   ~ minute read

Why am I getting an error when trying to use the HotDoc Dialler Readiness Checker?

The Dialler Readiness Checker helps you identify and fix common technical errors with your setup, such as issues with your microphone, speakers, or network connection, before you call a patient. This ensures a smooth consultation and allows you to focus on providing quality care. The tables below explain the most common errors and how to fix them.

Every clinic’s computer network and setup is unique – things like firewalls, security policies, and network configurations can vary widely.

If the basic troubleshooting steps outlined below do not resolve your issue, the problem is likely to be something specific to your local setup rather than the HotDoc software itself.

That means only your IT team has the right access and permissions to investigate and resolve these issues. For example, they can:

  • Review your network/firewall configuration

  • Adjust security settings that may be blocking the dialler

  • Run technical diagnostics on your local systems

ⓘ Important information

 

 In this article

  • Common errors
  • Advanced troubleshooting for IT providers

 

Common errors

Error Potential Root Cause When? Troubleshooting Fix
Audio: No Audio Permission Microphone permission denied at the browser or operating system level. The system was not given permission to access the microphone and speaker devices. This usually happens when you decline the browser permission prompt or if access has been blocked in browser or OS settings.

Reset microphone permissions in your browser and OS.

If the problem persists, contact your IT team.

Audio: No Microphones Found No microphone could be detected. –

There is an issue with connecting the microphone. Common reasons include:

  • Devices are unplugged or powered off
  • Devices are disabled or not recognised by the OS
  • The browser or Sidebar does not have permission to access audio devices

Ensure devices are connected and recognised by your OS.

If the problem persists, contact your IT team for assistance.

Audio: No Speakers Found No speakers could be detected. –

We can't detect any connected speakers. Common reasons include:

  • Devices are unplugged or powered off
  • Devices are disabled or not recognised by the OS
  • The browser or Sidebar does not have permission to access audio devices

Ensure devices are connected and recognised by your OS.

If the problem persists, contact your IT team for assistance.

Audio: Selecting Microphone Failed
  • Browser is missing essential features required by the Dialler
  • Microphone not working as expected
When using Sidebar versions earlier than v4.0.2 or an unsupported/old browser.

There is an issue with accessing or capturing audio from the selected microphone. Common reasons include:

  • Hardware or connection issue with the microphone
  • Another app is using the microphone exclusively
  • Browser or OS privacy settings blocking microphone use
  • Outdated Sidebar or browser

Ensure your microphone is connected and working, and update to the latest Sidebar and a supported browser.

Contact IT if the problem persists.

Audio: Can't Hear Sample Audio
  • Speaker is muted
  • Speaker not properly connected to the computer
When testing the playback of the sample audio.

There is an issue with hearing sound from your speakers/headphones. Common reasons include:

  • Volume muted or too low
  • Speakers/headphones disconnected or faulty

Check connections, ensure devices are recognised by your OS, and adjust volume.

Contact IT if the problem persists.

Audio: Can't Hear Recorded Microphone Playback
  • Microphone not connected or not working
  • Hardware issue with the microphone
  • Speaker muted or volume too low
When testing the microphone playback.

There is an issue with detecting audio input from the microphone. Common reasons include:

  • Microphone muted or faulty
  • Microphone disconnected
  • Speaker/headphones muted or volume too low

Ensure your microphone is connected and recognised, and the speaker volume is turned up.

Contact IT if the problem persists.

Network: UDP Connection Failure
  • ICE connection failure
  • Firewall settings blocking AWS
  • Network requirements not implemented
When trying to establish a UDP connection.

There is an issue with establishing a media connection over UDP (required for best call quality). Common reasons include:

  • Strict firewall/proxy rules
  • VPN/security software interference
  • Network policies restricting real-time traffic
Contact your IT team to confirm the network meets requirements.
Network: TCP Connection Failure
  • ICE connection failure
  • Firewall settings blocking AWS
  • Network requirements not implemented
When trying to establish a TCP fallback connection.

There is an issue with establishing a media connection over TCP. Common reasons include:

  • Firewall/proxy blocking TCP traffic
  • VPN/security software interference
  • Network policies restricting communication
Contact your IT team to confirm the network meets requirements.
Network: HotDoc Server Connection Failure
  • Firewall blocking HotDoc domains
  • Network requirements not implemented
  • HotDoc server errors
When attempting to connect to HotDoc servers.

There is an issue with connecting to HotDoc's servers over the internet. Common reasons include:

  • No/limited internet
  • Firewall, proxy, or VPN restrictions
  • Temporary HotDoc service issue
Check connectivity and contact IT if issues persist.
Network: Real-time Messaging Connection Failure
  • Firewall blocking PubNub domains
  • Network requirements not implemented
When sending or receiving real-time messages.

There is an issue with reliably sending/receiving real-time messages required for the Dialler. Common reasons include:

  • VPN/security software interference
  • Network restrictions/firewalls
Contact your IT team to confirm the network meets requirements.
Network: Unstable Connection
  • Wi-Fi reset or unstable network
  • Restrictive network settings
  • Security software interfering
  • Network congestion
  • High packet loss, jitter, or latency
  • Dropped signalling
  • Reconnection attempts
  • No audio packets transferred
  • Weak Wi-Fi/mobile signal
  • High network congestion
  • Blocked WebSocket or WebRTC traffic
  • VPN/security software interference

Switch to a wired Ethernet connection or stronger Wi-Fi.

Contact your IT team if issues persist.

Audio: Skipped Audio Test

[Warning]

– When the audio test has been skipped by the IT provider. – –

 

Advanced troubleshooting for IT providers

If your clinic’s dialler isn’t working and basic troubleshooting hasn’t resolved the issue, please follow these steps:

  1. Review the error log
    Check the error message provided by the Dialler Readiness Checker and use the above information about potential causes and troubleshooting steps to identify the issue.

  2. Request an access token from HotDoc Support
    Contact HotDoc Support to generate a secure access token. This will be formatted as a unique URL you can use to access the Dialler Readiness Checker in a web version of the HotDoc Sidebar.

    The URL will be valid for 3 days, after which time you will be redirected to the login page.
    If you require access after this period, you will need to contact our Support team to generate another token.
    ⓘ Important information 


  3. Access the URL and resolve any issues
    Further technical information about the Dialler can be found here: 

Was this article helpful?
Submit Feedback

1 out of 1 found this helpful
  • Dialler Network _ System Requirements.pdf
    500 KB Download

Related articles

  • Practitioners Guide: Telehealth On Demand
  • How to install HotDoc (Best Practice)
  • How to restart the HotDoc services
  • How Do I Action Patient Notes from a Telehealth On Demand Appointment?
  • Why does my Sidebar give me the error 'Failed to Authenticate Connector'?

Related articles

  • Practitioners Guide: Telehealth On Demand
  • How to install HotDoc (Best Practice)
  • How to restart the HotDoc services
  • How Do I Action Patient Notes from a Telehealth On Demand Appointment?
  • Why does my Sidebar give me the error 'Failed to Authenticate Connector'?
© 2023 HotDoc Online Pty Ltd | Terms of Service | Privacy Policy | Contact Us
© 2023 HotDoc Online Pty Ltd

Terms of Service | Privacy Policy