How to Set Up the Chat Widget

The Chat Widget lets visitors on your website chat with your AI directly — without leaving the page. It connects to the same workflow and Help Desk as your support chat.

Availability: STARTER and above, or an active 14-day trial. Expired FREE accounts see an upgrade prompt.

How to generate and install the widget

1. Go to Dashboard → Integrations → Add Integration → Chat Widget Script
2. Select the Support chat to embed (the AI and workflow behind the widget)
3. Choose a Position (left or right side of the screen)
4. Choose a Type (standard bubble or expanded bubble)
5. If you're on BUSINESS or ENTERPRISE (or an active trial), optionally enable Smart Page Context — this gives the AI awareness of which page the visitor is on. See Smart Page Context for details.
6. Optionally set Hide Branding for this support chat (see below)
7. Click Copy Script
8. Paste the script into your website's HTML, just before the closing </body> tag
9. Publish your website

The widget is now live. Visitors can click it to start a conversation with your AI.

Hide Branding

On the same Chat Widget Script screen, Hide Branding controls VoxeDesk chrome for that support chat.

• Off (branding shown): the website widget keeps VoxeDesk branding, and the secure customer verification and protected-action confirmation pages also show VoxeDesk branding.
• On (branding hidden): the website widget hides VoxeDesk branding, and those same secure pages use the merchant identity Voxe already has for the support chat (your business name, or a store hostname fallback). If that identity cannot be resolved, the pages keep VoxeDesk branding rather than showing a blank name.

This setting is the source of truth for widget and secure-page branding. You do not configure it on a separate branding page.

Re-copying the script after changes

If you change the support chat, position, or widget type, copy the script again and re-publish your site. Those values are part of the pasted embed.

Smart Page Context settings are applied dynamically when using the current Voxe widget script. You do not need to replace the script after enabling, disabling, or changing Smart Page Context fields. If your site still uses an older embed, copy the current script once to pick up the Voxe runtime.

What's next

• How to Manage Customer Questions — add suggested questions to the widget home screen
• Smart Page Context — give the AI awareness of which page visitors are on
• How System Messages Work — customize how the AI greets and helps visitors