Use diagnostic messages to troubleshoot issues in voice calls

When your agents are on a voice call, they might sometimes see warning or error messages on the Communication Panel. These messages will help them understand the issues that are affecting their call experience. Agents can use the information in the message to diagnose and resolve the issues themselves. For example, if an agent speaks when the microphone is muted, a "You are muted" message occurs to let them consider unmuting the microphone.

Troubleshoot network issues

The following table lists the warning messages that appear when your agents have network issues in their voice calls. These messages help agents diagnose and resolve the issues. Use the network values to find more information about the cause and mitigation steps described in Azure Communication Services.

Message	Description	Network value
Your network is causing poor call quality. Try switching to a better network, or moving closer to a Wi-Fi access point.	Appears when the network connection is lost and the system tries to reconnect to the network.	networkReconnect
Your network is causing poor call quality. Try switching to a better network, or moving closer to a Wi-Fi access point.	Appears when the incoming streaming quality is poor.	networkReceiveQuality
Your network is causing poor call quality. Try switching to a better network, or moving closer to a Wi-Fi access point.	Appears when the outgoing streaming quality is poor.	networkSendQuality
There is a problem connecting to the network. Ensure firewall rules are correctly set up.	Appears when there are problems with the network.	networkRelaysNotReachable

Troubleshoot device issues

The following table lists the messages that appear when your agents have issues with their audio devices in voice calls. Your agents can use the information to take action and resolve the problem. Use the audio values to find more information about the cause and mitigation steps described in Azure Communication Services.

Message	Description	Audio value
No speakers detected. Try connecting one to receive call audio.	Appears when no audio output device or speaker is detected on the user's system.	noSpeakerDevicesEnumerated
You are muted.	Appears when an agent is speaking while it's muted.	speakingWhileMicrophoneIsMuted
No microphone detected. Try connecting one so that others can hear you.	Appears when no microphone is detected on the agent's system.	noMicrophoneDevicesEnumerated
Your microphone is not working. On the communication panel, select More -> Device settings to connect to a different device or try reconnecting this one.	Appears when the microphone is muted unexpectedly or is not functioning.	microphoneMuteUnexpectedly microphoneNotFunctioning

Troubleshoot incoming call notification issues

If you are using a custom notification template and have set the countdown to more than 40 seconds, agents might receive call notifications for too long and encounter errors when they accept such calls. To avoid errors, set the Countdown (seconds) value to 40 seconds or less in the custom notification template that's attached to the voice workstream.

See also

• Azure Communication Services user-facing diagnostics
• How to avoid calls from being disconnected