Troubleshooting, limitations and production verification
Resolve schema, permission, browser, audio, WSS, IVR, provisioning, event, widget and call-state failures and understand unsupported PSTN functions.
Guides in this workflow
Follow the guide that matches the exact action, filter, menu change or issue.
Resolve schema not ready
Reactivate/upgrade through the module lifecycle and confirm all required tables and schema version 8.
Resolve a missing xConnect menu
Confirm activation and View permission.
Resolve a missing administrator phone icon
Confirm Use internal calling and injected assets/hooks.
Resolve a missing client phone
Confirm authenticated contact context and client visibility/settings.
Resolve permission denied
Grant View, Manage or Use internal calling according to the action.
Resolve invalid WSS settings
Use a valid wss:// endpoint with working TLS and browser reachability.
Resolve invalid SIP domain
Use a valid hostname and matching certificate/runtime configuration.
Resolve invalid switch path
Use an absolute module-owned path without traversal.
Resolve voice engine unavailable
Check transport configuration, browser signalling, internal calling, provisioning and live gateway readiness.
Resolve missing extensions
Run Backfill and review errors/collisions.
Resolve failed provisioning jobs
Inspect attempt count, last error, generated configuration and permissions/path ownership.
Resolve destination offline
Ask the destination to sign in/restore presence or choose another available route.
Resolve blocked ringtone or microphone
Interact with the page, grant browser microphone permission and verify audio device selection.
Resolve one-way or no audio
Check WebRTC media/firewall/NAT/TLS and complete two-browser UAT.
Resolve unavailable account IVR
Confirm the tenant account, main extension ID, active account route and generated IVR configuration.
Resolve origin denied
Add the exact normalised website origin to the account allow-list.
Resolve widget session denied
Create a new session after checking token, origin, expiry, account and extension status.
Resolve widget rate limited or busy
Wait for the window/session count to clear and verify configured limits.
Resolve missing switch events
Check event bridge enabled/configured, secret file, callback reachability, signature and last-event time.
Resolve stale call state
Run runtime reconciliation and restore authoritative switch-event delivery.
Resolve invalid activation snapshot
Use a readable JSON snapshot in the allowed temporary path and size range.
Understand unsupported PSTN and external calling
Recognise that the module intentionally does not provide carrier trunks, public numbers, SMS or outbound PSTN.
Understand unsupported call recording
Recognise that the supplied module has no user-facing recording, transcription or voicemail workflow.
Understand unsupported conferencing
Recognise that no multi-party conference-room workflow is implemented.
Verify xConnect after deployment
Test settings, extensions, directory, direct call, account IVR, website widget, presence, missed calls, event evidence and two-way audio.