Web widget

The web widget is the chat bubble that lives on your website. It's the fastest channel to launch — there are no third-party accounts to link, just a snippet to paste — and it's the one most people start with. It's also the richest: real-time streaming, full branding, and visitor context out of the box.

Setting it up

1. In Channels, create a Web widget channel and give it a name (e.g. "Website chat").
2. Make it yours — set the branding (below).
3. Copy the embed snippet and paste it into your site's HTML, just before the closing </body> tag. It carries two IDs — your tenant and the channel you just created:

<script
  src="https://api.vivollo.com/chat-widget/widget.js?tenantId={TENANT_ID}&channelId={CHANNEL_ID}"
  data-vivollo-chat-widget
></script>

That's it. The bubble appears, and your agent is live on your site.

If you want more control — opening the chat from your own button, setting the language, or passing in context — load the script and drive it yourself through the Vivollo API:

<script src="https://api.vivollo.com/chat-widget/widget.js"></script>
<script>
  Vivollo.create({
    tenantId: "{TENANT_ID}",
    channelId: "{CHANNEL_ID}",
  });
</script>

Making it yours (white-label)

The widget is designed to look like your product, not Vivollo's. You can set:

• Primary color — the header and button color, matched to your brand.
• Company name — shown in the widget header.
• Logo and agent avatar — your marks, so it feels like your team.
• Greeting — the opening message visitors see, which you can provide in multiple languages.
• Auto-detect language — when on, the widget greets each visitor in their own language based on their browser, with no extra work from you.

Replies that feel instant

The web widget streams responses token by token — words appear as the agent "types" them, the same way a person would, rather than the customer staring at a spinner and then getting a wall of text. Typing indicators and read receipts round out the live feel. Under the hood it's a real-time connection; to you and your visitor, it just feels immediate.

It knows who's visiting

Because the widget runs on your own site, it can quietly gather helpful context as the conversation starts: the visitor's device, their approximate location, how they found you, and the pages they browsed. All of this shows up in the context panel and is available to the agent — so it can greet a returning visitor warmly or answer "is this in stock?" knowing which page they were just on.

This is gathered with privacy built in — no raw IP is stored, and sensitive bits in URLs are stripped before anything is saved. The full story is in The visitor journey.

Sessions and returning visitors

The widget remembers a visitor between page loads and visits, so a conversation picks up where it left off instead of resetting every time they navigate. Returning visitors are recognized, and their history travels with them.

Why start here

The web widget gives you the whole Vivollo experience — branding, streaming, visitor context, rich messages — with the least setup. Get it live, talk to your own agent through it, and you'll understand the platform faster than any amount of reading. Then add messaging channels like WhatsApp when you're ready to meet customers where they already are.