Skip to main content
Web Widgets and Website Chat

Create an Inbound Widget Campaign

Create an Inbound Widget campaign on VAW Native, Vapi, Retell AI or ElevenLabs, choose the voice and chat agents, and add a widget to an inbound phone campaign.

Written By voiceaiwrapper

Last updated 12 days ago

An Inbound Widget campaign runs a web widget as a campaign. It works on VAW Native and on your own Vapi, Retell AI or ElevenLabs account, lets you pick separate agents for voice and chat, and gives you the campaign's chat logs, call logs, analytics and client assignment.

Creating the campaign takes three short wizard steps. You then pick the agents and customise the widget.

Available on: plans that include Web widget. Without it, the Inbound Widget card in the campaign wizard shows Upgrade required, and clicking it opens an upgrade prompt.

Applies to: VAW Native, Vapi, Retell AI and ElevenLabs Pods (an engine or provider connection). Bolna and Ultravox Pods can't run widgets. For a single VAW Native agent, the agent's own widget is quicker. See Add a Widget to a VAW Native Agent.

Before you start

  • The agents you'll use. Build and test them first. On Retell AI, chat needs a separate chat agent. See Retell Chat Agents.
  • Room in your campaign limit. Each widget campaign counts as a campaign on your plan.

Step 1: Create the campaign

  1. Open your Pod and select Campaigns in the sidebar, then click Add Campaign. The Campaign Creation Wizard opens.
  2. On Campaign type, choose Inbound Widget ("Embed a web widget for voice/chat. You can set up phone inbound later."). Click Next.
  3. On General settings, type a Campaign Name. Click Next.
  4. On Review, check the type and name, then click Create Campaign.

A widget campaign has only these three steps. There's no schedule, phone number, webhook or success-metric step.

VoiceAIWrapper creates the campaign with a widget already attached and opens the campaign on its Web Widget tab. The widget starts with the default settings: Voice mode only and no agent picked, so set those first.

Step 2: Choose the interaction mode and agents

On the Web Widget tab, stay on the builder's Configuration tab.

  1. Under Interaction, pick an Interaction mode: Voice, Chat or Voice + Chat.
  2. In the Agents section, pick the Voice Agent. On Vapi the section is called Assistants and the field Voice Assistant.
  3. If chat is on, pick the Chat Agent (Vapi: Chat Assistant).
An Inbound Widget campaign on a Retell AI Pod, Web Widget tab, Configuration tab: Interaction mode set to Voice + Chat with the yellow 'Important: To enable chat mode for clients, you must:' note, and the Agents section with a Voice Agent selected and the Chat Agent dropdown open. If a picked agent needs a webhook sync, the 'Sync now' alert is visible under it.

What each engine needs:

EngineVoice agentChat agent
VAW NativeAny agent in this Pod.Optional. If you leave it empty, the voice agent handles chat too.
VapiAn assistant.An assistant whose server messages include the session.created and session.updated events.
Retell AIA voice agent.Required for chat: a separate Retell chat agent. Until you pick one, you'll see Retell Chat Agent Required.
ElevenLabsAn agent.An agent.

Sync the webhook (Vapi, Retell AI, ElevenLabs)

VoiceAIWrapper tracks widget calls and chats through a webhook on your provider agent. If the agent you pick doesn't point to VoiceAIWrapper yet, you'll see "Sync our webhook to use this agent." with the agent's Current webhook. Click Sync now to update it in your provider account. See Sync Webhooks So VoiceAIWrapper Can Track Calls.

Chat for clients

When chat is on, the builder reminds you of two things if this widget is for a client:

  • Turn on chat for the client in their client configuration.
  • Make sure the client's Stripe plan includes chat billing. Otherwise they won't be charged for chats. See Bill Chat Conversations.

Step 3: Save

Click Update Widget Configuration at the bottom of the builder. You'll see Widget updated successfully. If saving fails, you'll see Failed to update widget, or a specific message such as "That agent is not in this Pod." on VAW Native.

Step 4: Customise, test and embed

Add a widget to an inbound phone campaign

An Inbound Phone campaign can also have a widget, so one campaign answers phone calls and web visitors.

  1. Open the campaign and its Web Widget tab. You'll see No Web Widget Created Yet.
  2. Click Create Web Widget. The widget is created with default settings.
  3. Follow Steps 2 to 4 above.
An Inbound Phone campaign's Web Widget tab with no widget yet: the card 'No Web Widget Created Yet', the line 'Create web widget to embed on your website', the Create Web Widget button with 'This will create a widget with default settings that you can customize later' under it, the 'What is a Web Widget?' text and the preview image.

Outbound campaigns don't have a Web Widget tab.

After you launch

  • Campaigns list: the Widget Channel Status column shows Widget Active or No Widget for each campaign.
  • Chats tab: chat conversations from the widget, on VAW Native, Vapi, Retell AI and ElevenLabs.
  • Client tab: assign the campaign to a client so they see its conversations in their portal. See Assign a Campaign to a Client.

A widget keeps taking conversations whatever the campaign's status, including Draft, Paused and Ended. The one exception is a VAW Native campaign that's paused because of its client's billing. To take a widget offline, remove the embed code from the site or delete the campaign.

Frequently asked questions

The card shows why. Not supported for this provider or Ultravox does not support web call/chat means the Pod's engine can't run widgets; use a VAW Native, Vapi, Retell AI or ElevenLabs Pod. Upgrade required means your plan doesn't include Web widget.

Your plan doesn't include Web widget. Click Upgrade to see the plans that include it. See A Feature Is Locked or Asks Me to Upgrade.