Prerequisites
- Your widget integration is deployed on your website
- Access to the site in a desktop and mobile browser
- A set of realistic test questions your users would ask
1. Basic Functionality
Widget Appearance
- Visit your website and confirm the widget appears in the correct position
- Verify colors, text, and sizing match your dashboard configuration
- Click the widget to open it and confirm the greeting message displays
- Close and reopen the widget to verify it transitions smoothly
Agent Communication
- Send a simple message like “Hello, can you help me?”
- Verify the agent responds within a few seconds
- Ask a question that should be answered from your knowledge base (e.g., “What is your return policy?”)
- Confirm the response references your uploaded content accurately
2. Interaction Mode Testing
Tell Mode
Ask information questions your users would typically ask. Verify responses are accurate, relevant, and drawn from your knowledge base.Show Mode
Request step-by-step guidance (e.g., “Show me how to create an account”). Verify the agent provides clear steps and highlights relevant UI elements on your page.Do Mode
Ask the agent to perform an action (e.g., “Help me fill out this form”). Verify the agent executes the task correctly and provides feedback on its progress.3. Edge Cases
- Unclear input — send vague or incomplete messages and verify the agent asks for clarification
- Off-topic questions — ask something unrelated to your business and verify the agent handles it gracefully
- Long messages — send a lengthy message to test input handling
- Follow-up questions — ask “Can you tell me more about that?” after a response to verify context is maintained
- Network interruption — disconnect and reconnect your network to verify the widget recovers
4. Device and Browser Testing
Desktop Browsers
Test on the supported browsers:- Chrome 90+
- Firefox 88+
- Safari 14+
- Edge 90+
Mobile Devices
- Test on iOS (Safari) and Android (Chrome) at minimum
- Verify the widget is usable on smaller screens
- Test touch interactions (tapping to open, scrolling messages, typing)
- Test in both portrait and landscape orientation
5. Debugging
Browser Console
Open your browser’s developer tools (F12 or Cmd+Shift+I) and check the Console tab. The widget logs diagnostic information that can help identify issues:- Connection errors to the API or AI agent endpoint
- SSE stream failures
- Configuration loading issues
Common Issues
| Problem | What to check |
|---|---|
| Widget not appearing | Script tag placement, mtx-id and mtx-key values, CSP or ad blocker interference |
| Widget not responding | Agent and application status in dashboard, network tab for failed requests |
| Slow responses | Network connectivity, test agent in the Marketrix playground |
| Appearance mismatch | Dashboard widget settings, browser cache (try hard refresh) |
| Mobile layout issues | Device visibility setting in dashboard, test on actual devices |
6. Pre-Launch Checklist
Before going live, confirm:- Widget appears correctly on all target pages
- Agent responds accurately to common questions
- All enabled interaction modes work as expected
- Widget works on desktop and mobile
- Quick action chips (if configured) function correctly
- Human handoff (if enabled) escalates properly
- No JavaScript errors in the browser console
Next Steps
- Monitor and troubleshoot — handle issues as they arise
- Refine your agent — improve responses based on real user interactions
- Update your knowledge base — keep content accurate and current