Skip to main content

How to Build and Embed a Web Assistant (Chat or Voice) in Alta

Build an inbound chat or voice widget in Alta's Web Assistant Builder — pick a widget type, refine the prompt, style it for your brand, and paste the embed snippet onto your site.

Written by Katie Supporté

Summary

Alta's Web Assistant is an embeddable widget you drop onto your marketing site or app. Visitors can either chat with an AI assistant or call it by voice — and conversations land in Alta with the same summarization, labeling, and routing as the rest of your inbound. This article walks through the full builder, end to end.

Who this is for: Anyone setting up an inbound capture surface in Alta — typically Marketing, RevOps, or whoever owns the website.


Before you start

  • You'll need permission to create assistants in your Alta workspace.

  • Have your site URL handy — the builder uses it to generate a starter prompt for you.

  • If you want a custom look, have your brand hex colors and (optionally) an avatar image (PNG, JPEG, WebP, or an animated GIF, up to 2 MB) ready.

  • To install the widget, you'll need access to your site's HTML — directly, or via your CMS / tag manager.


Step 1 — Create a new Web Assistant

  1. Go to Assistants in the Alta sidebar.

  2. Create a new assistant. Give it a name in the top bar — heads up: the name in the header is used as assistantName in messages, so name it something a visitor would see comfortably (for example, "Alta Concierge", not "test-2"). If you leave it empty, Alta names it "Untitled chat assistant" or "Untitled voice assistant".

  3. Pick a widget type:

    • Chat Widget (recommended) — "Visitors chat with your assistant on your site." Visitors type in a chat panel. Save & Continue in the top bar picks this one.

    • Voice Widget — "Visitors talk to your assistant by voice on your site." Visitors click the launcher and start a voice conversation.

Once you pick a type, Alta drops you into the builder. Chat Widgets have four steps; Voice Widgets have five.


Step 2 — Chat Widget: the four builder steps

Every section starts closed, so click a section title to open it. Hover the ⓘ next to a setting to see what it does. The preview on the right follows the step: it opens the chat on Conversation, plays the arrival behavior on Appearance, and shows the closed launcher on Results and Install.

1. Conversation

"What your assistant says, does and knows."

  • Widget name — the name visitors see.

  • Chat Prompt — generate a prompt from your site URL, then refine the Opening Line and instructions. Click Prompt guide next to the field to open our guide to writing a chat prompt.

  • Knowledge — Knowledge base files the assistant uses to answer questions, and Presentations: slide decks (PDFs from your knowledge base) the assistant can show in the chat, when enabled for your account.

  • Tools — account tools the assistant can use. Add a calendar tool (Google Calendar, Calendly, HubSpot and others) so the assistant can offer times and book meetings in the chat.

  • Quick replies — up to 3 tappable chips above the message box.

  • Visitor details — Ask for email before the chat (off for new chats). When it's on, edit the email screen's title, description, placeholder and button. Below it, Show a details form before booking.

  • Advanced — the model (new chats use Claude Sonnet 5) and when idle chats end.

2. Appearance

"How the chat looks and when it opens."

  • Layout — Floating Panel (default for new chats) or Floating Widget, and the position. For Floating Panel you also set Opens as (Compact or Expanded) and the Role shown next to the name. When a visitor arrives: stay closed, pop up a message (Floating Panel only), or open the chat after a delay. On phones the chat always stays closed, so it never covers the page. New chats start as a Compact Floating Panel that opens the chat 6 seconds after the page loads.

  • Brand — primary, button text and background colors, the calendar colors, and the font.

  • Avatar images — the widget and launcher avatars.

  • Privacy link — an optional line with a link at the bottom of the chat.

3. Results

"What you get after each chat."

How chats are summarized, the outcome of each chat, custom output fields and tags. Each outcome is a row: change its color, or click Edit to change its description.

4. Install

"Add the snippet to your site and test it."

Copy the embed snippet (see the snippet details under 5. Embed Code below), choose where visitors see the widget (when enabled for your account), and set the Test page URL used by the Preview button on the dashboard card. The main button on this step is Save & finish.

Step 3 — Voice Widget: the five builder steps

Each step has a Save and a Save & Continue button in the top right. On the last step the main button says Save & finish. The stepper in the top bar lets you click between steps directly, and your unsaved edits stay in place when you do. Alta only asks about unsaved changes when you leave the builder.

1. Call Flow / Chat Flow

"Use your site URL to generate a {chat/call} prompt, then refine opening line and instructions. Add knowledge base files to improve answers."

This is where you point Alta at your website and let it scaffold a prompt for you. From there, you refine the opening line (what the assistant says first), the instructions (how it should behave), and attach any knowledge base files you want it to draw from — product one-pagers, FAQs, sales decks, etc. New chats start with the opening line "Hi! I'm Alex. How can I help you today?", which you can change.

2. Configurations

Chat: "Choose the tools, details form and model, and when idle chats end."

This is the runtime engine room. Voice Widget configurations include voice selection and voicemail behavior. Chat Widget configurations cover when idle chats end, the details form shown before booking, the tools the assistant can use during a conversation, and the model. New chats use Claude Sonnet 5.

3. Call Outputs / Chat Outputs

"Configure how conversations are summarized and labeled when they end."

This is where you decide what Alta does with a finished conversation: how it gets summarized, what labels or outcomes get applied, and what shows up in your inbox.

4. Visual Style

"Set widget placement, colors, preview link, whether to skip email capture, and avatar images for the launcher and panel."

Two collapsible sections here.

Display Settings:

  1. Display Mode — Floating Panel (a larger panel at the side of the page) or Floating Widget (a smaller chat window above the launcher). New chats start as Floating Panel. Voice widgets use Floating Widget.

  2. Position — pick where the launcher sits: Bottom Right (default), Bottom Left, Top Right, or Top Left.

  3. Opens as and Role — Floating Panel only. Opens as picks Compact (a small card that grows once the visitor writes) or Expanded. Role is shown next to the name in the panel header.

  4. When a visitor arrives — chat only: keep the chat closed, pop up a message next to the launcher (Floating Panel only), or open the chat a set number of seconds after the page loads. On phones the chat always stays closed, whatever you pick. Play a sound adds a soft chime when the message pops up and when the visitor sends or receives a chat message.

  5. Font — Inter or Poppins.

  6. Preview URL — a custom URL Alta opens when you click Preview on the assistant's dashboard card. Use a page on your own site so you can see the widget in its real context. It must be a full URL, for example https://yoursite.com/page, or empty.

  7. Primary Color — "Accent color for the widget chrome and primary actions."

  8. Button Text — "Text color on primary buttons in the widget."

  9. Background — "Main panel background for the widget."

  10. Skip Email Screen — toggle to start the conversation without asking for an email. New chats start with it on, so visitors go straight to the chat. Turn it off when you want lead capture before the conversation starts.

Avatar Images:

  1. Widget Avatar — the avatar shown inside the open chat / call panel. Upload a PNG, JPEG, WebP, or an animated GIF, up to 2 MB.

  2. Launcher Avatar — the avatar on the closed launcher bubble that sits in the corner of your site. Upload a PNG, JPEG, WebP, or an animated GIF, up to 2 MB.

  3. Chat avatar style — appears for a chat assistant in Floating Panel display mode once you upload a Widget Avatar. Circle (default) shows your avatar in a round frame. Full width fills the top of the chat, like the built-in animated avatar. Use a transparent PNG, WebP, or GIF of a person or character for the best result.

If you don't upload a Widget Avatar, a chat assistant in Floating Panel mode shows Alta's built-in animated avatar.

Privacy Link:

  1. Show privacy link — on by default. It adds a line at the bottom of the chat screen. Edit the Link text and use the Add link button to turn any part of it into a clickable link (you choose both the wording and the URL). While the toggle is on, the text must contain at least one valid link before you can save; leave the text empty to fall back to the default ("This is an AI-based chat. By continuing, you agree to our terms of use."). Turn the toggle off to hide the link.

5. Embed Code

"Add this snippet to your marketing site or app to load the assistant widget."

Final step: copy the embed snippet and paste it into your site's HTML (or your CMS / tag manager).

The snippet looks like this:

<script>  (function () {    var a = (window.alta = window.alta || []);    if (a.invoked) return;    a.invoked = true;    ['identify', 'track', 'page', 'group', 'alias', 'reset'].forEach(function (m) {      a[m] = a[m] || function () { a.push([m].concat([].slice.call(arguments))); return a; };    });    var s = document.createElement('script');    s.src = 'https://widgets.altahq.com/alta.js?key=YOUR_SITE_KEY';    s.setAttribute('data-assistant-id', 'YOUR_ASSISTANT_ID');    (document.head || document.documentElement).appendChild(s);  })();</script>

Paste this one block. It lets your site call alta.identify, alta.track, alta.page, alta.group, alta.alias and alta.reset immediately, and it loads alta.js for you. Those calls are forwarded once the script arrives. The key is included when your account has website tracking. data-assistant-id is the assistant this snippet shows.

Click the copy icon on the snippet to grab the version with your real assistant ID (and site key, when you have one) pre-filled. You'll see an "Embed code copied" confirmation toast.


Tips and common pitfalls

  • Pick the widget name carefully. The name in the top-bar header becomes assistantName in the prompt — visitors will see it.

  • Set the Preview URL to a real page. The Preview button on the dashboard card uses whatever you put here. If you skip it, you won't be able to test the widget against a live page from inside Alta.

  • Colors must be valid hex. The color pickers expect a 6-digit hex value (for example, #0066FF). If you paste an invalid value, Alta falls back to the default for that slot.

  • Skip Email Screen trade-off. Turning it on lowers the bar to start a conversation but means you'll only have whatever the assistant captures inside the conversation itself. Leave it off if downstream routing needs a guaranteed email.

  • Avatar uploads only accept image files. PNG, JPEG, WebP, and animated GIF are supported, up to 2 MB. Other formats, or larger files, are rejected by the upload dialog. To use a video as your avatar, convert it to a GIF first.

  • One snippet per page. A second copy does nothing, because the first one has already set up the queue and loaded the assistant.

  • It does not block the page. The snippet adds alta.js and keeps going, so it is safe to drop in <head> or right before </body>.

  • Save before you leave. You can move between builder steps without losing edits, but leaving the builder with unsaved changes opens the Leave Page confirmation dialog.


Related

Did this answer your question?