Troubleshooting, limitations and production verification

xConnect

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.