Skip to content

Docs

Add the chat widget to your website

The VoxelEon chat widget is a single script tag — no SDK installation, no build step. Paste it before the closing </body> tag of every page you want the widget on.

1. Get your website token

In your VoxelEon dashboard, go to Settings → Inboxes → Add Inbox → Website, create a website channel, and copy the install snippet shown there — it already has your website token filled in. The snippet below is the same one, for reference.

2. Paste the snippet

Replace YOUR_WEBSITE_TOKEN with the token from your dashboard.

<script>
  (function(d,t) {
    var BASE_URL="https://app.voxeleon.com";
    var g=d.createElement(t),s=d.getElementsByTagName(t)[0];
    g.src=BASE_URL+"/packs/js/voxeleon-sdk.js";
    g.async = true;
    s.parentNode.insertBefore(g,s);
    g.onload=function(){
      window.voxeleonSDK.run({
        websiteToken: 'YOUR_WEBSITE_TOKEN',
        baseUrl: BASE_URL
      })
    }
  })(document,"script");
</script>

3. (Optional) Configure the widget

Set window.voxeleonSettings before the install script to customize position, style, and launcher text.

<script>
  window.voxeleonSettings = {
    position: 'right',       // 'left' or 'right'
    type: 'standard',        // 'standard' or 'expanded_bubble'
    launcherTitle: 'Chat with us',
    darkMode: 'auto'         // 'light', 'dark', or 'auto'
  };
</script>

4. (Optional) Identify logged-in users

If a visitor is already signed in on your site, pass their identity to the widget so conversations are attributed to the right customer.

window.$voxeleon.setUser('user-id-123', {
  email: 'jane@example.com',
  name: 'Jane Doe',
});

5. (Optional) Listen for widget events

The widget dispatches events on window you can hook into, e.g. window.addEventListener('voxeleon:ready', () => { ... }).

voxeleon:readyThe widget has finished loading.
voxeleon:openedThe visitor opened the chat window.
voxeleon:closedThe visitor closed the chat window.
voxeleon:on-messageA new message was sent or received in the conversation.
voxeleon:on-start-conversationThe visitor started a new conversation.

Need help?

Email hello@voxeleon.com and we'll help you get the widget live.