Documentation Index
Fetch the complete documentation index at: https://docs.wittify.ai/llms.txt
Use this file to discover all available pages before exploring further.
The Test Your Agent button lives on the end edge of the topbar on every Manage Agent page (Overview, Conversations, Leads, Settings, Campaigns). Click to slide in a real-time preview from the end edge of the screen. RTL flips the slide direction so it always feels native.
How to open it
Three ways:- Click the Test Your Agent button in the topbar.
- From the Agent Settings editor, click the Agent Preview button on smaller screens (where the inline preview aside isn’t visible).
- Press the keyboard shortcut (planned, not shipped yet).
What you see
The slide-in is a wide sheet (wider on desktop, full-width on mobile) holding the same agent preview surface used by the wizard. Inside, you’ll see your agent’s widget rendered exactly as your customers see it:- Launcher icon in the bottom corner of the preview area
- Floating chat panel above it with header, conversation area, footer
- Header with your branding (avatar / name / tagline)
- Powered by line in the footer
- Disclaimer if you wrote one in Appearance
- Rating UI at the end of the conversation if Reviews are enabled
- Voice call button (voice + hybrid agents only)
- Type in the chat input and get real responses from your agent
- Click the call button (voice + hybrid) to start a real test call against your voice config
- Switch language if you have multiple languages enabled
Why a sheet, not the production widget
The production Wittify chat widget mounted globally on every page of the Wittify dashboard is the Wittify marketing widget, “Chat with Sarah from Wittify”. It will always answer as Sarah and follow Wittify’s prompt, not yours. The Test Your Agent sheet uses your agent’s actual config (appearance, voice, prompt, knowledge base, integrations). That’s the only correct preview of what your customers will experience.What it tests against
The preview goes through the real production agent stack:- Appearance: your saved colors, logo, avatar, launcher, position, font, languages, banners, ratings.
- Knowledge Base: every file, FAQ, and URL the agent has been trained on. Trained items only, pending items don’t reach answers.
- Tickets & Leads: the lead form mounts inside the conversation if data collection is on, and submitting it creates a real record in Leads & Tickets.
- Integrations: the agent calls real tools when needed (Human Handoff, Calendar Booking, Order Tracking, Payment Collection). Webhooks fire if enabled.
- The actual model + prompt: every response goes through the real model with your real system prompt and temperature.
Important: this is not a sandbox
Records created during a test are real records:- A lead form submission becomes a real lead in your inbox.
- A handoff fires the real notification (email / Slack / Webhook).
- A webhook event hits your real server.
- A ticket goes to your real CRM.
Mobile behavior
On mobile the sheet slides in full-width, taking the entire screen. RTL languages flip the slide direction so it feels native (Arabic users see it slide from the start edge instead of the end edge). The topbar Test Your Agent button shrinks to an icon-only button on small screens, with a tooltip showing the full label.Widget language
The widget inside the sheet uses your agent’s default language as set in Appearance, regardless of which language the dashboard is in. So you can be in Arabic mode but test an English-default agent, the widget will still default to English. If your agent has multiple languages enabled, the language switcher at the top of the widget lets you toggle through them in the test sheet too.Common questions
My agent says 'I'm Sarah from Wittify' in the test sheet.
My agent says 'I'm Sarah from Wittify' in the test sheet.
You’re not in the Test Your Agent sheet, you’re talking to the global Wittify marketing widget. Look for the Test Your Agent button in the topbar (end edge), not the floating launcher in the bottom corner. Two different widgets, only the topbar one is yours.
The test conversation doesn't appear in Chat Conversations.
The test conversation doesn't appear in Chat Conversations.
It does. Test conversations and real conversations share the same inbox. Filter by your own browser session or the timestamp to find your test threads.
A test lead I submitted shows up in production. Can I delete it?
A test lead I submitted shows up in production. Can I delete it?
Yes. Open Leads & Tickets, tick the test record, click bulk Delete. Or use the detail sheet’s Delete action. Soft-deleted records stay 30 days in the Deleted sub-tab.
The voice call button doesn't work in the test sheet.
The voice call button doesn't work in the test sheet.
Can I test against an older version of the agent?
Can I test against an older version of the agent?
No. The test always uses the latest saved configuration. There’s no version history rollback yet.
Next
Agent Settings
Edit any wizard section and re-test.
Delete Agent
For when the agent is no longer needed.

