Troubleshooting
Quick solutions to common issues you might encounter in CallVault.Fathom Connection Issues
Calls Not Syncing Automatically
Symptoms: New Fathom calls don’t appear in CallVault. Solutions:1
Check Webhook Configuration
- Go to Settings > Integrations
- Verify the webhook URL is correct in your Fathom account
- Make sure the Webhook Secret matches in both places
2
Verify Events Are Enabled
In Fathom’s webhook settings, ensure these events are enabled:
- My Recordings
- Transcripts
- Summaries
3
Test Connection
Click Test Connection in CallVault to verify the API key works.
4
Use Manual Sync
As a fallback, use the SYNC tab to manually fetch recent calls.
”Invalid API Key” Error
Symptoms: Connection fails, API errors appear. Solutions:- Go to Fathom Settings
- Find the API section
- Regenerate your API key
- Copy the new key
- Go to Settings > Integrations in CallVault
- Click Edit on Fathom connection
- Paste the new API key
- Save and test the connection
”Webhook Not Receiving Events” Error
Symptoms: Webhook configured but events don’t arrive. Solutions:- Verify the webhook URL is exactly as shown in CallVault (no trailing slashes, correct domain)
- Check that your Fathom plan supports webhooks
- Try removing and re-adding the webhook in Fathom
- Check Fathom’s webhook delivery logs if available
AI Chat Issues
”I Couldn’t Find Information About That”
Symptoms: AI says it can’t find something you know exists. Solutions:1
Check Indexing
Go to Settings > AI and verify your transcripts are indexed. If “Unindexed Calls” is greater than 0, click Index Transcripts.
2
Broaden Your Search
Try more general terms. Instead of exact phrases, use key concepts.
3
Remove Filters
If you have date, speaker, or category filters set, try removing them.
4
Check Call Is Synced
Verify the call you’re searching for is actually in your library.
AI Responses Are Slow
Symptoms: Long wait times for responses. Solutions:- Complex questions naturally take longer
- Large libraries require more search time
- Try narrowing with filters to reduce search scope
- Check your internet connection
- Try a faster model (GPT-4o-mini)
AI Gives Wrong Information
Symptoms: Responses don’t match what’s in transcripts. Solutions:- Click the source citation to verify in the original transcript
- Rephrase your question more specifically
- Use the “Add Context” feature to attach specific calls
- Try a different AI model for better accuracy
Chat Session Not Saving
Symptoms: Conversations disappear after closing. Solutions:- Ensure you’re logged in (sessions are tied to your account)
- Check for browser extensions that might block storage
- Try a different browser
- Clear browser cache and try again
Transcript Issues
Transcripts Not Appearing After Sync
Symptoms: Sync completes but transcripts are empty or missing. Solutions:- Check if the original recording has a transcript in Fathom
- Try re-syncing the specific call
- Wait a few minutes for processing to complete
- Check the SYNC tab for any error messages
Speaker Names Are Wrong
Symptoms: Generic labels like “Speaker 1” or incorrect attribution. Solutions:- Open the call detail
- Go to the Transcript tab
- Click on the speaker name to edit it
- Enter the correct name and save
- For bulk changes, use the Change Speaker dialog
Transcript Has Errors
Symptoms: Typos, wrong words, garbled text. Solutions:- This is usually from speech-to-text accuracy issues
- Open the transcript and edit inline
- For major issues, check the original in Fathom
- Consider re-syncing if Fathom has a better version
Organization Issues
Folders Not Showing
Symptoms: Created folders aren’t visible. Solutions:- Check if “Hidden Folders” toggle is on in the sidebar
- Refresh the page
- Try creating a new folder
- Check if you have permission (for team accounts)
Tags Not Applying
Symptoms: Tags don’t stick to calls. Solutions:- Ensure you’re clicking Save after adding tags
- Refresh and check if they persisted
- Try adding tags from the call detail dialog
- Check for any error messages
Drag and Drop Not Working
Symptoms: Can’t drag calls to folders. Solutions:- Make sure you’re clicking and holding on the call row
- The sidebar with folders must be visible
- Try the right-click menu as an alternative
- Use bulk actions toolbar instead
Account Issues
Can’t Log In
Symptoms: Login fails, “invalid credentials” error. Solutions:- Try resetting your password
- Check you’re using the correct email
- If using Google login, make sure you’re using the same Google account
- Clear browser cookies and try again
- Try a different browser
Can’t See Certain Settings Tabs
Symptoms: Billing, Users, or Admin tabs are missing. Solutions: These tabs are role-restricted:- Billing, Users - Require TEAM or ADMIN role
- Admin - Requires ADMIN role
- Contact your team admin to upgrade your permissions
Theme Not Saving
Symptoms: Theme resets to default. Solutions:- Go to Settings > Account
- Set your preferred theme
- Make sure to save changes
- Check for browser extensions that might override themes
Performance Issues
App Is Slow
Symptoms: Pages take long to load, actions are delayed. Solutions:- Check your internet connection
- Try refreshing the page
- Close other browser tabs
- Clear browser cache
- Try a different browser
Large Library Performance
Symptoms: Slowness with many transcripts. Solutions:- Use filters to narrow what’s displayed
- Use folders to organize and focus on subsets
- Use search to find specific calls instead of scrolling
- Consider archiving old calls you don’t need
Export Issues
Export Not Downloading
Symptoms: Click export but nothing happens. Solutions:- Check for popup blockers
- Look in your downloads folder
- Try a different browser
- For large exports, wait longer for processing
- Try exporting fewer calls at once
Export Is Missing Content
Symptoms: Downloaded file is incomplete. Solutions:- Ensure the transcript fully loaded before exporting
- Try exporting as a different format
- Check if the original transcript is complete
- Re-sync the call and try again
Still Having Issues?
If none of these solutions work:- Try logging out and back in
- Clear your browser cache completely
- Try a different browser (Chrome, Firefox, Safari)
- Check if the issue happens on a different device
Get Help
Log in and use AI Chat to ask questions about your specific situation.
