The web widget is a powerful tool for engaging website visitors, but it requires correct installation and configuration to work properly. This guide covers the most common web widget issues.
Issue: The widget does not appear on my website
Verify the snippet is installed correctly — it should be placed just before the closing </body> tag. Check that the snippet is loading on the correct pages. Use your browser's developer tools (F12 > Console) to check for JavaScript errors. Ensure your Content Security Policy (CSP) is not blocking the widget script.
Issue: The widget appears but clicking it does nothing
Check the browser console for errors. Ensure the widget ID in the snippet matches your assistant ID in the dashboard. Verify that the assistant assigned to the widget is active and has a phone number assigned.
Issue: Microphone permission is not being requested
The browser requires the page to be served over HTTPS for microphone access. Ensure your website uses HTTPS. Also check that the user has not permanently blocked microphone access for your domain in their browser settings.
Issue: Widget works in Chrome but not in other browsers
Check browser compatibility. The widget requires WebRTC support, which is available in all modern browsers. Safari requires iOS 14.3+ or macOS 11+. Ensure users are on a supported browser version.
Issue: The widget is blocking content on my website
Adjust the widget position in the dashboard settings. You can move it to the bottom-left, change its size, or add a custom offset to prevent it from overlapping important content. You can also configure it to only appear on specific pages.