Skip to main content

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:
  1. Click the Test Your Agent button in the topbar.
  2. From the Agent Settings editor, click the Agent Preview button on smaller screens (where the inline preview aside isn’t visible).
  3. Press the keyboard shortcut (planned, not shipped yet).
The button label changes to Close Test Widget when the sheet is open. Click again to dismiss, or click outside the sheet, or press Escape.

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)
You can:
  • 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.
Test carefully. Some teams keep a dedicated test agent (a clone of the production agent that they only use for testing), so test traffic doesn’t pollute the real inbox or fire real notifications.

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

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.
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.
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.
Two checks: (1) your browser has microphone permission for app.wittify.ai, (2) the agent has a voice configured in Voice Settings. Voice calls require both.
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.