Creating Prompts

Prompts are the questions your widget displays to website visitors. A well-crafted prompt shown at the right moment dramatically increases both response rates and the quality of feedback you receive. This page covers everything from creating your first prompt to advanced trigger patterns and voice note attachments.

What Is a Prompt?

A prompt is a feedback question tied to your project. When the Voiseback widget loads on a page that matches the prompt's trigger pattern, it shows that question to the visitor. Each prompt has:

• Title — an internal label for your own reference. Visitors never see this.
• Question text — the actual question displayed in the widget (e.g., "What do you think of our new pricing?").
• Trigger pattern — a URL-matching rule that controls which pages this prompt appears on.
• Voice note (optional) — an audio recording of you asking the question, adding a personal touch.
• Active status — a toggle to enable or disable the prompt without deleting it.

Creating a Prompt

To create a new prompt:

1. Navigate to Dashboard → Prompts in the sidebar.
2. Click New Prompt.
3. Fill in the Title and Question text.
4. Set a Trigger pattern (see below for pattern syntax).
5. Optionally add a voice note by clicking Record or Upload.
6. Click Save to create the prompt.

Once created, click the prompt card to edit additional settings like the bubble configuration and show delay.

Editing and Deleting Prompts

Click any prompt card on the Prompts page to open it for editing. You can update:

• Voice note — record a new one, upload a file, or remove the existing note.
• Active status — toggle the prompt on or off without deleting it.
• Bubble configuration — customize the floating button appearance (see below).
• Show delay — control how long before the widget appears after page load.
• Custom trigger only — hide the floating button and open the widget using element triggers or the JavaScript API. See Widget Configuration for details.

To delete a prompt, open it and click the Delete button. This action is permanent — all settings are removed, but existing replies collected by the prompt are preserved.

Trigger Patterns

Trigger patterns determine which pages on your website display a particular prompt. The pattern is matched against the URL pathname (the part after your domain). Voiseback supports three types of patterns:

Wildcard: Show on All Pages

Use a single asterisk to show the prompt on every page of your site:

*

This is useful for general feedback prompts like "How is your experience so far?" that apply site-wide.

Exact Match: Show on One Specific Page

Enter a full pathname to target a single page:

/pricing

This pattern matches only https://yoursite.com/pricing and nothing else. Use exact matches for page-specific feedback like "Is our pricing clear?" on the pricing page or "How was your checkout?" on a confirmation page.

Wildcard Suffix: Show on a Section of Pages

Append /* to a path prefix to match all pages under that section:

/blog/*

This matches /blog/my-post, /blog/2024/announcements, and any other path starting with /blog/. It does not match /blog by itself (without a trailing slash and additional path).

Trigger Pattern Reference

Prompt Matching Priority

When a visitor loads a page, Voiseback checks each active prompt's trigger pattern against the current URL. The first matching prompt (in the order they appear on your Prompts page) is displayed. If no prompt matches, the widget does not appear on that page.

When multiple prompts could match the same URL, the first matching active prompt is used. Use specific trigger patterns (like /pricing instead of *) to ensure the right prompt appears on each page.

Voice Note Attachments

Adding a voice note to your prompt replaces the static text question with a playable audio message from you. This creates a more personal, conversational experience and often increases response rates.

Recording a Voice Note

1. In the prompt editor, click Record Voice Note.
2. Grant microphone access when your browser requests it.
3. Speak your question clearly. Keep it under 30 seconds for best results.
4. Click Stop to finish recording. Preview the audio and re-record if needed.
5. Save the prompt to upload the voice note.

Uploading an Audio File

Alternatively, click Upload Audio to select a pre-recorded audio file from your computer. Supported formats include MP3, WAV, WebM, and OGG.

Bubble Configuration

The widget bubble is the floating button visitors click to open the feedback panel. You can customize it per-prompt in the prompt editor:

• Enable / disable — turn the bubble on or off. When disabled, visitors can still open the widget via element triggers or the JavaScript API.
• Bubble text — a short message displayed next to the icon, up to 100 characters (e.g., "Share your thoughts"). Leave empty for an icon-only button.
• Visual style — choose how the bubble is presented:
  • Emoji + text — shows both an emoji and your bubble text.
  • Emoji only — compact button with just the emoji.
  • Text only — displays your bubble text without an emoji.
• Emoji — pick from 8 preset emojis (💬 👋 💡 ✨ 🎯 💭 📣 🙋) to set the bubble icon.
• Colors — set a custom background and text color for the bubble to match your brand.
• Dismissable — when enabled, visitors can close the bubble and it stays hidden for that session.

Prompt Settings

Each prompt has additional settings that control its display behavior:

• Show delay — wait 0–30 seconds after page load before showing the widget. A short delay (3–5 seconds) lets visitors orient themselves before being prompted. Set to 0 for immediate display.
• Position — the widget can appear in the bottom-right or bottom-left corner of the screen. This is configured in your Appearance settings under Integrate → Appearance.
• Custom trigger only — hides the floating button on pages where this prompt is active. The widget can only be opened via element triggers or the JavaScript API. Useful when you have your own button to launch the widget.

Finding Your Prompt ID

You need a prompt ID when using the JavaScript API or element triggers to open a specific prompt. There are two ways to find it:

• Copy trigger code — each prompt card on the Prompts page has a copy button that copies the trigger code including the prompt ID.
• URL bar — when editing a prompt, the prompt ID is the last segment of the URL in your browser's address bar.

Best Practices

• Be specific. "What was the hardest part of setting up your account?" beats "Any feedback?"
• Match the context. Use trigger patterns to show relevant prompts — ask about pricing on the pricing page, ask about checkout after purchase.
• Encourage voice responses. Frame prompts conversationally: "Tell us in your own words..." or "Walk us through your experience..."
• Add a voice note. Prompts with a voice note attached see higher voice response rates. A real human voice invites a spoken reply.
• One question per prompt. Avoid combining multiple questions. Create separate prompts with different trigger patterns instead.

Next Steps

• Widget Installation — install the widget to start showing your prompts to visitors.
• Troubleshooting & FAQ — common issues and quick fixes for widget display, audio recording, and AI processing.