Troubleshooting Guide

This comprehensive guide provides solutions for common issues you might encounter while using the Vodia PBX system. The troubleshooting steps are organized by feature area to help you quickly find the information you need.

Phone Interface Issues

No Audio or Video

Problem

Cannot hear or see the other party during a call.

Solution:

• Check that your browser has permission to access your microphone and camera
  • Look for the camera/microphone icon in your browser's address bar
  • Ensure permissions are set to "Allow"
• Verify that the correct devices are selected in settings
  • Navigate to Audio and Video Device Management
  • Confirm your preferred microphone, speakers, and camera are selected
• Try refreshing the page to reset the connection
• Test your audio devices in another application to confirm they work
• If using a headset, ensure it's properly connected and recognized by your system

Call Won't Connect

Problem

Unable to make or receive calls through the phone interface.

Solution:

• Check your internet connection
  • Test by loading other websites
  • Verify you have stable connectivity with minimum 100 Kbps up/down for voice calls
• Ensure your browser is up to date
  • Update to the latest version of Chrome, Firefox, or Edge
• Verify that your PBX account is properly registered
  • Look for registration status indicators in the interface
  • Check with your administrator if registration issues persist
• Try using incognito/private browsing mode to rule out extension conflicts
  • Browser extensions might interfere with WebRTC functionality
• Make sure your device is not in Do Not Disturb (DND) mode
  • Check for DND indicators in your interface
  • Disable DND if it's enabled

Keyboard Shortcuts Not Working

Problem

The keyboard shortcuts (Cmd+D, A, H, M) aren't functioning.

Solution:

• Ensure the phone interface has focus (click on it first)
• Check if another application is capturing the key commands
• Verify keyboard shortcuts are enabled in your user preferences
• Try a browser refresh to reset the interface
• Check if you've modified the default shortcuts in your user preferences

Call Management Problems

Cannot See All Calls in Tenant Calls View

Problem

Not all active calls are visible in the Tenant Calls view.

Solution:

• The view shows only calls that are currently active
  • Terminated calls are removed from the display
• Verify you have administrator permissions to see all tenant calls
  • Contact your system administrator for access if needed
• Check that view filters are not limiting which calls you can see
• Ensure you're viewing the correct time period for historical calls

Call Information Not Updating

Problem

Call status and information doesn't refresh automatically.

Solution:

• The interface updates automatically when the tab is visible
  • If you switched back to a tab that was hidden, it may take a moment to refresh
• Try manually refreshing the page
• Ensure your browser permissions allow background updates
• Check for network connectivity issues that might prevent updates
• Verify WebSocket connections are not blocked by network policies

Unable to Transfer Calls

Problem

Call transfer function isn't working.

Solution:

• Verify you have an active call before attempting to transfer
• Check that the destination number is valid and accessible
• Ensure you have permission to transfer calls
• Try using the drag-and-drop transfer method as an alternative:
  • Drag the active call onto the destination extension in the sidebar
• Check if your call handling settings are preventing transfers
• Ensure the destination extension is registered and available

Voicemail Difficulties

Message Not Playing

Problem

Cannot play voicemail messages.

Solution:

• Check your audio settings and volume
  • Ensure your speakers or headphones are working
  • Verify volume is not muted
• Ensure your browser supports audio playback
  • Update to the latest browser version
• Try downloading the message and playing it with your system's audio player
  • Use the Download button in the voicemail interface
• Clear your browser cache and reload the page
• Check if the voicemail file format is supported by your browser

Fax Not Displaying

Problem

Cannot view received fax documents.

Solution:

• Ensure your browser is updated to the latest version
• Try downloading the fax as a PDF to view it in a dedicated PDF reader
• Check if you have permission to view fax documents
• Verify the fax was received completely (check file size)
• Make sure your browser supports PDF viewing or has a PDF plugin

Voicemail List Not Updating

Problem

New messages aren't appearing in the voicemail list.

Solution:

• Click the reload button to refresh the list
• Check your network connection
• Verify your mailbox is properly configured
• If problems persist, try logging out and back in to the system
• Ensure your mailbox isn't full (check mailbox size settings)

Greetings Not Playing Correctly

Problem

Custom voicemail greetings aren't playing when callers reach your mailbox.

Solution:

• Make sure you've selected the correct greeting for each condition
• Verify that greetings have been properly recorded or text has been entered
• Check that the mailbox is enabled
• Test by calling your own extension
• Ensure audio file formats are compatible with the system
• Verify that your special condition greetings (busy, DND, etc.) are properly configured

Call Forwarding Issues

Calls Not Forwarding

Problem

Calls aren't being forwarded according to your settings.

Solution:

• Verify destination numbers are correct and include any required prefixes
• Check time-based settings to ensure forwarding is active at the current time
• Confirm that conflicting settings aren't enabled:
  • "Disable calling mobile phone numbers" might block forwarding to cell phones
  • "Disable calling VoIP phones" might block forwarding to IP phones
• Verify permissions allow call forwarding for your extension
• Check if the Do Not Disturb setting is overriding your forwarding rules
• Test if call forwarding is working for other call types (internal vs. external)

Time-Based Forwarding Not Working

Problem

Calls aren't following your time-based forwarding rules.

Solution:

• Verify your time format follows the pattern HH:MM-HH:MM
  • Example: 9:00-12:00 13:00-17:00
• For holiday exceptions, use the format MMDD for single days or MMDD-MMDD for ranges
  • Example: 0704 (July 4th) or 1224-1227 (December 24-27)
• Check timezone settings to ensure they match your local time
• Ensure there are no conflicting forwarding rules
• Verify that your system clock is accurate
• Make sure any holiday exceptions are entered for the current year

Hot Desking Issues

Problem

Hot desking is not functioning correctly.

Solution:

• Verify the destination extension is valid and registered
• Check that you have permission to use hot desking
• Ensure the destination extension allows hot desking
• Confirm the hot desking timeout is configured appropriately
• Verify you're entering the correct format for the hot desking destination
• Check if the destination extension has conflicting settings

Contact and Address Book Problems

Cannot Save a Contact

Problem

Unable to add or update contact information.

Solution:

• Ensure all required fields are completed (First Name, Last Name, and at least one phone number)
• Check that the phone number format is valid
• Verify you have permission to add or edit contacts
• Try refreshing the page before attempting to save again
• Clear your browser cache and cookies
• Check if you've reached any contact storage limits

Cannot Find a Contact

Problem

Unable to locate a specific contact in the address book.

Solution:

• Use the search box to search by name, number, or other details
• Check if category filters are limiting your view
• Verify the contact hasn't been deleted
• Ensure you have permission to view the contact (personal vs. shared)
• Try different search terms (first name, last name, or partial matches)
• Check if the contact might be in a different address book

Cannot Edit a Shared Contact

Problem

Unable to modify shared contacts in the address book.

Solution:

• Verify you have permission to modify shared contacts
• Contact your system administrator for access if needed
• Check if another user is currently editing the same contact
• Ensure you're not trying to create duplicate entries
• Try refreshing the page before attempting to edit
• Log out and log back in to refresh your session permissions

Import/Export Issues

Problem

Problems with importing or exporting contacts.

Solution:

• For imports, ensure your CSV format is correct:
  • Headers and values should be separated by semicolons (;)
  • Example format: First Name;Last Name;Phone Number
• Check the "First Line Contains Headers" option if your CSV includes a header row
• For exports, verify you have permission to export contacts
• Try with a smaller number of contacts if handling large datasets
• Check that your CSV file isn't corrupted or too large
• Ensure your browser isn't blocking file downloads

Chat Messaging Challenges

Messages Not Sending

Problem

Unable to send text messages in the chat feature.

Solution:

• Check your network connection
• Verify that the contact's number is correct
• Ensure SMS/MMS services are enabled for your account
• Try sending a simple text message without attachments to isolate the issue
• Refresh the chat interface
• Check if the recipient is available to receive messages

Unable to View or Download Files

Problem

Cannot access files shared in chat conversations.

Solution:

• Check if your browser supports the file format
• Ensure you have sufficient permissions to download files
• For large files, check your internet connection
• Try downloading the file to your device instead of previewing it
• Clear your browser cache and try again
• Check if your browser is blocking downloads

Chat Features Not Appearing

Problem

Chat functionality is limited or missing.

Solution:

• Verify that chat functionality is enabled for your account
• Contact your system administrator about your permissions
• Ensure you're using a compatible browser and version
• Check if the contact you're trying to chat with has chat capabilities enabled
• Try logging out and back in to refresh your session
• Update your browser to the latest version

Chat History Not Loading

Problem

Previous chat messages aren't visible.

Solution:

• Check pagination settings to see if older messages are on different pages
• Verify message retention settings haven't caused old messages to be deleted
• Ensure you have permission to view the complete chat history
• Try refreshing the page or restarting the application
• Clear your browser cache and cookies
• Check your network connection

Audio and Video Quality Issues

Poor Audio Quality During Calls

Problem

Call audio is choppy, echoing, or unclear.

Solution:

• Check your internet connection quality and speed
  • A minimum of 100 Kbps up/down is recommended for voice calls
  • Try connecting to a different network if possible
• Try different audio devices
  • Test with a headset instead of speakers to reduce echo
  • Select a different microphone in your device settings
• Close other applications that might be using bandwidth
• Ensure you don't have the same device selected for both alerts and conversation if experiencing echo
• Check for background noise in your environment
• Reduce the number of active applications on your device

Video Quality Issues

Problem

Video is blurry, freezing, or not displaying.

Solution:

• Check your internet connection - video calls require more bandwidth than audio
  • A minimum of 300 Kbps up/down is recommended for video
• Verify camera settings and permissions
  • Ensure your browser has permission to access your camera
  • Select a different camera if you have multiple options
• Improve lighting conditions
  • Ensure you have adequate, even lighting on your face
• Close other applications using your camera or bandwidth
• Reduce your video resolution if possible
• Try disabling hardware acceleration in your browser settings

Headset Button Not Working

Problem

Cannot control calls using headset buttons.

Solution:

• Ensure your headset is fully compatible with the Vodia PBX system
• Check that you've successfully paired the headset by clicking the headset icon
• Try disconnecting and reconnecting the headset
• Update your headset firmware if available
• Test the headset with another application to verify functionality
• Check if your headset requires specific drivers or software
• Verify that the headset is properly recognized by your operating system

Call History and Reporting Issues

Call Records Missing

Problem

Cannot see expected calls in the call history.

Solution:

• Check date range filters - adjust to include the time period you're looking for
• Verify call type filters aren't excluding the calls you want to see
• Use the search function to look for specific callers or numbers
• Ensure you have permission to view the call types you're looking for
• Check if calls might be categorized differently than expected
• Verify that call recording was enabled for the period in question

Export Not Working

Problem

Unable to export call history to CSV.

Solution:

• Ensure you have permission to export data
• Try selecting fewer records if attempting to export a large dataset
• Check if your browser is blocking downloads
• Verify that the export format is compatible with your software
• Clear your browser cache and cookies
• Try using a different browser
• Check for any system export limits that might be configured

Call Categories Not Available

Problem

Unable to categorize calls or see categories.

Solution:

• Verify call categorization is enabled for your account
• Ensure you have permission to assign categories
• Check if categories need to be created by an administrator first
• Confirm you're looking at the correct call type (some call types may not support categories)
• Verify that you're accessing the right section of the interface
• Try refreshing the page or logging out and back in

Cellphone Integration Problems

Cellphone Not Ringing

Problem

Calls aren't being forwarded to your mobile phone.

Solution:

• Verify the cellphone number is entered correctly (including country code)
• Check that scheduling options are configured properly
  • Ensure current time falls within your specified hours
• Ensure the extension is set to forward calls to cellphone
• Check if call filtering is blocking the forwarding
  • Verify the caller isn't on your "Numbers to Never Forward" list
• Make sure your extension is properly registered
• Check if DND mode is active and overriding your forwarding settings

Menu Not Appearing on Cellphone

Problem

Special menu isn't available when answering calls on mobile.

Solution:

• Verify that the "Offer special menu" option is enabled
• Check that you're answering the call on the configured cellphone
• Ensure the call actually came through the PBX forwarding system
• Try enabling DTMF tones on your cellphone
• Verify that your cellular provider supports DTMF tones
• Check if the call route allows for the menu to be presented

Call Quality Problems on Cellphone

Problem

Poor audio quality on forwarded calls to mobile.

Solution:

• Ensure you have good cell reception
• Check that your cellphone's audio settings are properly configured
• Verify the call path isn't going through multiple forwarding steps
• Test with a different mobile network if possible
• Check if your cellphone has any active noise cancellation features
• Try disabling VoLTE or HD Voice if available

Navigation and Interface Issues

Sidebar Appears Too Narrow

Problem

Cannot see content properly in the Navigation Sidebar.

Solution:

• Use the resize handle at the bottom right to expand it
• Adjust your browser zoom level
• Try using a larger display or higher resolution
• Reset interface settings to defaults
• Clear browser cache and reload the page
• Try a different browser or device

Cannot See Certain Contacts or Elements

Problem

Expected items are missing from the interface.

Solution:

• Check if a group filter or search is active
• If sections are collapsed, click their headers to expand them
• Verify display settings in User Preferences
  • Ensure "Show extensions," "Show queues," etc. are enabled
• Check if you have the necessary permissions to view those elements
• Verify item sort settings in your preferences
• Try refreshing the page or logging out and back in

Interface Not Responding

Problem

PBX interface becomes slow or unresponsive.

Solution:

• Try refreshing the browser page
• Clear browser cache and cookies
• Close and reopen your browser
• Check system resources (CPU, memory) to ensure your device can handle the application
• Try a different browser if problems persist
• Close other resource-intensive applications
• Check your network connection speed and stability

Recording Management Issues

Recording Won't Play

Problem

Unable to play back call recordings.

Solution:

• Check that your browser supports audio playback
• Ensure your browser's sound is not muted
• Try refreshing the page
• If the problem persists, the recording file may be damaged or missing
• Try downloading the recording and playing it in a separate media player
• Clear your browser cache and reload the page
• Update your browser to the latest version

Missing Recordings

Problem

Can't find recordings that should be in the system.

Solution:

• Clear any active search filters
• Check the date range you're viewing
• Verify that call recording was enabled for that extension during the call
• Contact your system administrator if recordings are still missing
• Check recording storage limits and retention policies
• Verify you have permission to access the recordings

Cannot Add Notes to Recordings

Problem

Unable to annotate call recordings.

Solution:

• Verify you have permission to add notes to recordings
• Check if the recording is locked or in a read-only state
• Try refreshing the page before attempting to add notes
• Ensure you're clicking the correct "Take note" option
• Check if the recording system is in maintenance mode
• Try logging out and back in to refresh your session

Conference Call Problems

Cannot Create a Conference

Problem

Unable to schedule or set up a conference call.

Solution:

• Check that you have permission to create conferences
• Verify that your conference room selection is valid
• Ensure you've completed all required fields
• Check if you've reached the maximum number of allowed conferences
• Try selecting a different conference room
• Contact your system administrator if permissions appear to be incorrect

PIN Access Issues

Problem

Participants unable to join with their PINs.

Solution:

• Verify that the correct PIN codes were distributed
• Check that participants are entering the correct PIN (moderator vs. participant)
• Ensure the conference is scheduled for the current time
• Verify that the conference hasn't been deleted or rescheduled
• Check if the maximum number of participants has been reached
• Try regenerating new PIN codes if possible

Conference Call Quality Issues

Problem

Poor audio quality during conference calls.

Solution:

• Ask participants to mute their microphones when not speaking
• Verify all participants have adequate internet connections
• Check if any individual participant is causing audio issues
• Recommend headsets instead of speaker phones when possible
• Reduce the number of video participants if using video conferencing
• Verify the conference bridge has sufficient resources

Calendar Integration Problems

Problem

Conference invitations not working with calendar applications.

Solution:

• Verify the .ics file was properly downloaded
• Check if your calendar application supports .ics imports
• Ensure the invitation contains valid date and time formats
• Try manually adding the conference details to your calendar
• Check if your email client is configured to handle calendar invitations
• Try using a different calendar application

Queue Management Challenges

Real-time Data Not Updating

Problem

Queue statistics aren't refreshing in real-time.

Solution:

• Check your network connection
• Verify WebSocket connections aren't blocked by firewalls
• Try refreshing the page
• Ensure your browser supports real-time updates
• Check if your session has timed out
• Log out and log back in to reestablish the connection

Agent Status Issues

Problem

Agent status indicators are incorrect or not updating.

Solution:

• Verify the agent is properly logged in to the queue
• Check if the agent has manually set a status that overrides automatic status
• Ensure the agent's device is properly registered
• Try refreshing the Queue Management view
• Verify the agent hasn't exceeded any automatic logout thresholds
• Check if the agent is properly connected to the network

Cannot Generate Reports

Problem

Unable to create or download queue performance reports.

Solution:

• Verify you have permission to access reporting features
• Check that you've selected valid date ranges and metrics
• Ensure your browser isn't blocking file downloads
• Try exporting smaller date ranges if handling large datasets
• Clear your browser cache and try again
• Check if the reporting system is in maintenance mode

Graph Data Visualization Issues

Problem

Queue performance graphs not displaying correctly.

Solution:

• Try a different browser
• Update your browser to the latest version
• Check if JavaScript is enabled in your browser
• Verify you've selected appropriate metrics and time periods
• Clear your browser cache and reload the page
• Try reducing the date range or number of metrics displayed

Wallboard Display Issues

Wallboard Not Showing Data

Problem

The Wallboard is blank or not displaying current statistics.

Solution:

• Verify you are still logged in (the system will redirect to the login page if your session expires)
• Check your internet connection
• Refresh the page
• Ensure your browser supports WebSocket connections
• Verify you have permission to view the Wallboard
• Check if the Wallboard is configured to display data for the current time period

Queues Missing from Wallboard

Problem

Not all expected queues appear on the Wallboard.

Solution:

• Verify the queue is properly configured in the ACD settings
• Ensure your user account has permission to view the queue
• Check if the queue is active and handling calls
• Verify the queue hasn't been hidden in Wallboard settings
• Contact your system administrator to confirm queue visibility settings

Wallboard Display Elements Misaligned

Problem

Layout issues with the Wallboard display.

Solution:

• Try adjusting your browser zoom level
• Use a larger screen or higher resolution if possible
• Try a different browser
• Clear your browser cache and reload
• Check if your browser window is wide enough to display all columns
• Verify that you haven't customized display settings that affect layout

Fax Feature Difficulties

Document Won't Upload

Problem

Unable to upload PDF for faxing.

Solution:

• Ensure your PDF is not corrupted
• Check that the file size is reasonable (large files may take longer to process)
• Try converting your document to a standard PDF format if it was created in a specialized application
• Verify your browser supports file uploads
• Try a different browser if problems persist
• Check if your browser is blocking file uploads

Fax Won't Send

Problem

Unable to transmit fax after document upload.

Solution:

• Verify that you've entered a valid fax number
• Ensure your system has proper fax capabilities configured
• Check your network connection
• Verify you have permission to send faxes
• Check if there are any system limits on fax transmissions
• Try sending a smaller document or fewer pages

Poor Quality Fax

Problem

Transmitted fax has poor image quality.

Solution:

• For best results, use high-contrast, clear documents
• Text documents typically produce better results than photographs or complex graphics
• Standard letter/A4 sized documents work best
• Ensure your original document is high quality
• Try increasing resolution settings if available
• Consider simplifying complex graphics before sending

Statistics Visualization Problems

Graphs Not Displaying

Problem

User Availability or MOS graphs not appearing.

Solution:

• Make sure you have an active internet connection
• Verify your session hasn't timed out (you may need to log in again)
• Check if you have the necessary permissions to view statistics
• Try refreshing the page
• Clear your browser cache and reload
• Ensure JavaScript is enabled in your browser

MOS Scores Missing

Problem

Call quality scores not appearing in the MOS graph.

Solution:

• Verify you've made calls during the selected time period
• Check if call quality monitoring is enabled for your extension
• Ensure your calls were long enough to generate MOS data
• Try expanding the time range to include more calls
• Verify your calls used codecs that support MOS measurement
• Contact your administrator to confirm MOS data collection is enabled

Inaccurate Availability Data

Problem

User Availability graph shows incorrect status information.

Solution:

• Check if your extension registration had issues during the time period
• Verify that you properly set and cleared your status (DND, etc.)
• Ensure your time zone settings are correct
• Try refreshing the statistics view
• Log out and back in to ensure fresh data collection
• Contact your administrator if your status history appears to be incorrect

Additional Help and Support

If you continue to experience issues after trying these troubleshooting steps, please contact your system administrator or Vodia Networks support at:

• Email: info@vodia.com
• Website: vodia.com

When contacting support, please provide:

• The specific error message or issue you're experiencing
• Steps you've already taken to troubleshoot
• Your Vodia PBX version number
• Your browser type and version
• Any relevant screenshots or system logs

Common PBX Troubleshooting Patterns

The table below summarizes common troubleshooting patterns that apply across multiple features:

Issue Pattern	First Steps	Second Steps	Advanced Troubleshooting
Interface not displaying correctly	Refresh browser	Clear browser cache	Try different browser
Feature not working	Check permissions	Verify configuration	Contact administrator
Poor quality (audio/video/fax)	Check internet connection	Verify device settings	Test with alternative device
Data not updating	Check network connection	Verify WebSocket connections	Log out and back in
Missing records or information	Check filters and search	Verify date/time settings	Confirm retention policies

tip

When troubleshooting any PBX issue, start with the simplest solution first. Most problems can be resolved with a browser refresh, checking permissions, or verifying your network connection.