Skip to main content
Creating a widget is a quick process. You pick an assistant, choose a mode, and VozAgent generates the widget key and embed code for you. This article walks through each step.

​
Before You Start

You’ll need two things before creating a widget:
  1. An active assistant — Widgets are powered by your existing VozAgent assistants. If you don’t have one yet, head to Assistants and create one first.
  2. A Growth plan or higher — Widgets are available starting on the Growth plan. If you’re on a lower tier, you’ll see an Upgrade button instead of the Create option.
Only admin users can create widget keys. If you don’t see the Create button and you’re on a Growth plan or above, check with your organization admin.

​
Step 1: Go to the Widgets Page

Navigate to Widgets in your dashboard sidebar. You’ll see a list of all your active assistants. Each card shows the assistant’s name and whether a widget key already exists for it.

​
Step 2: Click Create

Find the assistant you want to embed on your website and click the Create button on its card. VozAgent will generate a widget key in Chat & Voice mode by default, which gives your visitors both text and voice interaction options. The widget key is created immediately, and you’ll see a success message confirming it.

​
Step 3: Open the Widget Detail View

Once the key is created, the assistant card will update to show:
  • A mode badge (Chat & Voice, Chat, or Voice)
  • The first 12 characters of the widget key
Click on the card to open the widget detail view, where you can customize the appearance, behavior, and embed code.

​
Understanding Widget Modes

When a widget key is created, it defaults to Chat & Voice mode. Here’s what each mode means for your visitors:

​
Chat Mode

Visitors interact through text messages only. This is the best choice if:
  • You want a simple, quiet experience for visitors
  • Your website audience prefers typing over talking
  • You want to avoid microphone permission prompts in the browser

​
Voice Mode

Visitors interact through their browser microphone. This works well if:
  • You want a phone-like experience on your website
  • Your assistant is primarily optimized for voice conversations
  • You want visitors to have a hands-free option

​
Chat & Voice Mode

Visitors can choose either text or voice. This is the most flexible option and is the default because it lets each visitor pick their preferred method.

​
One Widget Per Assistant

Each assistant can have only one widget key at a time. If you need to change the configuration, you can edit the existing widget rather than creating a new one. If you want a completely fresh start, you can delete the existing widget key and create a new one — but keep in mind that deleting a key immediately disables any embed code using that key.

​
What Happens Next

After creating your widget key, you’ll want to:
  1. Customize the appearance — Set the display name, accent color, avatar, and greeting message
  2. Configure behavior — Choose a primary goal (lead capture or support) and set up intake questions
  3. Install the embed code — Copy the code snippet and paste it into your website
All of these are covered in the next article.