Skip to main content

Troubleshooting

This page outlines initial diagnostic steps for common softphone issues. Expanded error code mapping will follow.

Audio Issues

SymptomAction
Cannot hear callerCheck output device OS setting and Edge audio select (future setting panel).
Caller cannot hear youVerify microphone permissions & mute state.
Echo / feedbackUse headset; ensure only one active output source.

Connection & Login

SymptomAction
Login fails with valid credsConfirm correct Enterprise URL entered; check 2FA code freshness.
Frequent disconnectsValidate network stability.
Call setup delayLook for DNS resolution latency; try corporate VPN off as test.

Call Control Problems

SymptomAction
Transfer button disabledFeature may be role-restricted (RBAC roadmap) or no second leg initiated.
Merge not availableRequires at least two simultaneous legs (one on hold).
DTMF not recognizedVerify tone mode and that IVR expects DTMF (not voice).

Performance Tips

  • Keep system resources available (close heavy background apps).
  • Use wired or high-quality Wi-Fi connection.
  • Maintain updated desktop runtime dependencies.

Collecting Logs (Planned)

Logging export option will allow packaging recent call events + diagnostics for support review.

When to Escalate

Provide: timestamp, caller/callee numbers, steps taken, logs (if available), screenshot of error.

This page will evolve with real-world telemetry and support feedback.