Add a Voice Agent Widget to Your Website

How it works

• The widget is a small JavaScript file loaded from our servers that renders a button (or inline panel) on your page.
• When a visitor clicks the button, the widget connects to the voice agent and streams audio directly in the browser using WebRTC.
• No phone number is needed — everything happens inside the visitor's browser.
• All configuration is stored on our side. Changes in the Spokiva admin panel apply automatically without re-embedding.

Where to find your embed code

1. Log in to the Spokiva admin panel .
2. Open your workflow (the voice agent you built).
3. Open Settings → Configure Widget.
4. Turn on Enable Embedding.
5. Optionally enter the Allowed Domains where the widget may run (leave empty to allow any website).
6. Click Save Configurations.
7. Copy the Embed Code shown below the button.

The embed script

Copy the whole block and paste it just before the closing </body>tag of your website's HTML.

<!-- Spokiva Widget -->
<script>
  (function(d, s, id) {
    var js, fjs = d.getElementsByTagName(s)[0];
    if (d.getElementById(id)) return;
    js = d.createElement(s); js.id = id;
    js.src = 'https://call.neptuneinfotech.com/embed/spokiva-widget.js?token=emb_YOUR_TOKEN&environment=production&apiEndpoint=https://call.neptuneinfotech.com';
    js.setAttribute('data-spokiva-context', JSON.stringify({
      page_url: window.location.href,
      today: new Date().toISOString().slice(0, 10)
    }));
    js.async = true;
    fjs.parentNode.insertBefore(js, fjs);
  }(document, 'script', 'spokiva-widget'));
</script>

Widget types

Embed modes

Passing visitor details to the agent

Pass information about the current visitor to the agent. It becomes available inside your prompts as {{initial_context.<name>}}.

js.setAttribute('data-spokiva-context', JSON.stringify({
  page_url: window.location.href,
  today: new Date().toISOString().slice(0, 10),
  user_email: '[email protected]',   // your own fields
  plan: 'premium'
}));

For details your page learns after load, call window.SpokivaWidget.setContext({ ... }) before starting the conversation.

Allowed domains & security

The Allowed Domains list controls which websites may load the widget. Leave it empty to allow any website, or add domains one at a time (e.g. example.com or *.example.com). This is a security control: anyone with your token can use it only on domains you allow.

Browser and mic permission

• The site must be served over HTTPS for microphone access to work in modern browsers.
• The call starts on a user click because browsers only grant mic access after a user action.
• Desktop and mobile browsers are supported.

Changing configuration after embedding

You do not need to re-embed the script to change button text, color, position, widget type, or embed mode. Save the new configuration in the admin panel and it applies automatically — the widget fetches its configuration at load time.

Troubleshooting