Skip to main content
Embed User Intuition directly in your website or app to collect contextual feedback at the moment of experience. The widget captures in-the-moment insights that retrospective surveys miss.

When to Use the Widget

The widget is ideal for:
  • Customer onboarding research: Capture first impressions during signup
  • Post-purchase feedback: Understand the buying experience immediately after checkout
  • In-app experience research: Collect feedback while users are actively engaged
  • Triggered feedback: Show the widget based on specific user actions or events
  • Continuous listening: Always-available feedback channel within your product

How to Get the Widget Code

From your Study Dashboard:
1

Open Actions menu

Navigate to the Invites tab and click Actions
2

Select Copy Widget Code

Click Copy Widget Code from the dropdown
3

Copy the code

A modal appears with the widget code—copy it to your clipboard
4

Implement

Add the code to your application

Widget Code Overview

The widget is provided as a React component. Here’s the basic structure:
import { UserIntuitionWidget } from '@userintuition-ai/web';

return (
  <UserIntuitionWidget
    assistantId="your-assistant-id"
    publicKey="your-public-key"
    mode="voice"
    theme="dark"
    position="bottom-right"
    title="Have Feedback?"
    subtitle="Take a 10 min survey to help shape our roadmap"
    // ... additional configuration
  />
);

Configuration Options

Core Settings

ParameterTypeDescription
assistantIdstringYour unique study identifier (provided)
publicKeystringYour public API key (provided)
inviteIdstringOptional invite ID for tracking

Appearance

ParameterTypeOptionsDescription
modestring"voice", "chat", "video"Interview mode
themestring"light", "dark"Color theme
positionstring"bottom-right", "bottom-left"Widget position
sizestring"full", "compact"Widget size
borderRadiusstring"small", "medium", "large"Corner rounding

Content

ParameterTypeDescription
titlestringMain headline (e.g., “Have Feedback?”)
subtitlestringSupporting text (e.g., incentive description)
startButtonTextstringCTA button text (default: “Start”)
endButtonTextstringEnd button text (default: “End Call”)

Styling

ParameterTypeDescription
baseBgColorstringBackground color (hex)
accentColorstringAccent color (hex)
ctaButtonColorstringButton color (hex)
ctaButtonTextColorstringButton text color (hex)

Behavior

ParameterTypeDescription
showWidgetbooleanShow or hide the widget
delayIntervalnumberDelay before showing (milliseconds)
voiceShowTranscriptbooleanShow transcript in voice mode
showConversationAreabooleanShow conversation history
ParameterTypeDescription
consentRequiredbooleanRequire consent before starting
consentTitlestringConsent dialog title
consentContentstringConsent text/terms
consentStorageKeystringLocal storage key for consent

Implementation Examples

Basic Implementation

<UserIntuitionWidget
  assistantId="7ca1b3c9-fda8-4e54-ab76-9f251786f4be"
  publicKey="c39b8807-d06e-4fdb-b769-8964b082c776"
  mode="voice"
  theme="dark"
  position="bottom-right"
  title="Have Feedback?"
  subtitle="Share your thoughts in a quick 10-minute chat"
/>
<UserIntuitionWidget
  assistantId="your-assistant-id"
  publicKey="your-public-key"
  mode="voice"
  consentRequired={true}
  consentTitle="Terms and Conditions"
  consentContent="By clicking 'Agree,' I consent to the recording, storage, and sharing of my communications with third-party service providers, as described in our Terms of Service."
/>

With Delayed Display

<UserIntuitionWidget
  assistantId="your-assistant-id"
  publicKey="your-public-key"
  showWidget={true}
  delayInterval={5000}  // Show after 5 seconds
/>

Triggering Strategies

Time-Based Triggers

Show the widget based on time conditions:
  • Delay on page load: delayInterval={10000} (10 seconds)
  • Show after signup: Trigger one week after account creation
  • Date range: Show to all users between specific dates

Event-Based Triggers

Control the showWidget prop based on user actions:
const [showFeedback, setShowFeedback] = useState(false);

// Show after purchase
const handlePurchaseComplete = () => {
  setShowFeedback(true);
};

return (
  <UserIntuitionWidget
    showWidget={showFeedback}
    // ... other props
  />
);

CDP Integration

Connect with your Customer Data Platform to trigger based on:
  • User segments
  • Behavioral events
  • Customer lifecycle stage
  • Support ticket creation
Coming Soon: More dynamic triggering options including advanced CDP integrations and rule-based display logic.

Best Practices

Use triggering thoughtfully. Showing the widget too frequently can annoy users and reduce response quality.
Time the widget to appear when users have relevant context. Post-checkout is perfect for purchase experience research.
Position the widget where it won’t block important UI elements. Bottom-right is standard and expected.
Use the subtitle to tell users why their feedback matters and how long it will take.
Ensure the widget displays correctly on mobile, tablet, and desktop.

Frequently Asked Questions

Yes. The widget is responsive and works on mobile devices.
The primary implementation is React-based. Contact support for vanilla JavaScript options.
You can pass custom parameters through the inviteId or implement tracking on your side before showing the widget.
Yes. Users can close the widget without participating.
The widget is lightweight and loads asynchronously to minimize performance impact.