Troubleshooting
Solutions for common issues when integrating the hooman.live widget.
Video Call Popup Opens Blank Then Closes
Symptoms:
- Popup window opens but appears blank or white
- Window closes automatically after about 1 second
- Console shows:
"Permissions policy violation: camera/microphone is not allowed" - Error:
"Permission denied"
Cause
Your website has restrictive Permissions-Policy HTTP headers that deny camera and microphone access. This is common with many hosting platforms that set secure defaults.
If your headers include camera=() or microphone=() (empty parentheses), the browser will block access to these devices.
Solution (Next.js)
Update your next.config.ts to allow camera and microphone access:
// next.config.ts
import type { NextConfig } from "next";
const nextConfig: NextConfig = {
async headers() {
return [
{
source: '/:path*',
headers: [
{
key: 'Permissions-Policy',
value: 'camera=(self), microphone=(self), geolocation=()',
},
],
},
];
},
};
export default nextConfig;Solution (Other Frameworks)
Ensure your web server sends this HTTP header in responses:
Permissions-Policy: camera=(self), microphone=(self)Configure this in your web server (Apache, Nginx) or hosting platform settings.
How to Check Your Headers
Open your browser's Developer Tools, go to the Network tab, refresh the page, click on the main document request, and look for the permissions-policy header in the response.
Widget Not Appearing
Symptoms:
- Page loads but no widget button appears in the corner
- No visible errors on the page
Checklist
- Check the embed key: Ensure the
data-keyattribute starts withlck_ - Check the console: Open Developer Tools and look for errors containing "hooman.live"
- Verify script URL: Ensure the script URL is accessible and not blocked
- Check for CSP issues: Content Security Policy may block the script
- Check project status: Ensure the project is active in your dashboard
Popup Blocked by Browser
Symptoms:
- Call appears to start but no video window opens
- Browser shows popup blocked notification
- Console warning about popup being blocked
Cause
Browser popup blockers prevent the video call window from opening. This typically happens when the popup is not triggered by a direct user action.
Solutions
- For users: Allow popups for your website in browser settings
- For developers: The widget handles popup opening correctly, but aggressive popup blockers may still interfere
- Browser extensions: Some ad blockers also block popups - users may need to whitelist your domain
WebSocket Connection Failed
Symptoms:
- Widget appears but shows as offline or unavailable
- Console shows WebSocket connection errors
- Rep presence doesn't update
Possible Causes
- Network issues: Firewall or proxy blocking WebSocket connections
- Invalid embed key: The key may be invalid or for a different project
- Server unavailable: The hooman.live server may be temporarily unavailable
Camera or Microphone Not Working
Symptoms:
- Video call connects but shows black video or no audio
- Other party can't see or hear you
Checklist
- Browser permissions: Ensure you clicked "Allow" when prompted for camera/microphone
- System permissions: Check your operating system settings allow the browser to access camera/microphone
- Hardware: Verify your camera and microphone work in other applications
- Other applications: Close other apps that might be using the camera/microphone
Still Need Help?
If you're still experiencing issues, please contact support with:
- Your embed key (you can share this safely)
- Browser and version (e.g., Chrome 120)
- Operating system (e.g., macOS 14, Windows 11)
- Console errors (screenshot or text)
- Steps to reproduce the issue