Channels & Integrations · Channels

Voice assistant (Orb)

A talking orb for any website. Visitors tap it and speak, and your AI agent answers out loud, places orders and hands off to your team.

The voice assistant is a round, animated orb that sits in the corner of your website. A visitor taps it and talks, and your AI agent answers out loud, in the visitor’s own language and dialect, from the same knowledge it uses in chat. It is a product of its own, separate from the chat widget: its own settings, its own code and its own corner, so both can run on one page. Open it from Settings › Channels › Voice Assistant (Orb).

Add-on

Voice is an add-on, charged by the minute from voice points. If the card says Request access, click it to message us and we switch it on for your workspace.

Settings › Voice assistant, with the real orb in the preview on the right.
1Back to Channels, and this guide.
2Install status: where the orb was last seen, or why it is hidden.
3Live switch, name and the AI agent that answers.
4Preview: the real orb with your saved settings.

How it works

Visitor taps the orb

On a domain you allowed

Your AI agent answers

Out loud, in their dialect

Live lookups & orders

Products, stock, checkout

Inbox

Transcript, recording, summary

Visitors can interrupt it mid-sentence, like a real conversation, or type instead of speaking.
Prices, stock and order details are looked up live, never guessed.
Every call becomes a conversation in your Inbox, with the transcript, a recording (if on) and an AI summary.
Your team can reply to the visitor from the Inbox; the reply appears inside the orb’s panel.

Create your assistant

1
Open the Voice Assistant (Orb) card
In Settings › Channels, under Live Chat, click Customize.
2
Choose the AI agent
Pick the agent that should answer and give the assistant a name (for example the website it is for), then Create voice assistant.
3
Make it yours
Brand colour, light or dark panel, corner, the words under the orb, the greeting and up to four quick questions.
4
Allow your website
Under Where it runs, add your domain, one per line: shop.com covers www.shop.com; *.shop.com covers every subdomain.
5
Save changes
The preview on the right reloads with what you saved.

Section	What you set
Assistant	Live on your website / Off, the name, and the AI agent that answers.
Look	Brand colour, Light or Dark panel, Right or Left corner, and the distance from the side and bottom (0-400 px) to keep it clear of a chat widget.
Words	Label under the orb, widget language (English or Arabic, for its buttons), greeting, the line under it, and up to four quick questions.
Where it runs	The domains allowed to show it. Empty means it shows only in the preview.
Recording	Record calls so your team can listen back from the Inbox.
Orders on the call	Let the assistant take the address and place the order after the customer confirms, with an optional maximum order value.

Add it to your website

Under Add it to your website, pick the platform your site runs on: the page shows the steps and your code with your own assistant ID filled in. The code is one line:

HTML, before </body>

<script src="https://inboxi.app/api/voice/embed.js" data-widget="vw_YOUR_ID" async></script>

Platform	Where to paste it
Any website	In the template shared by every page, just before </body>.
WordPress	Install the free WPCode plugin › Code Snippets › Header & Footer › Footer, then Save Changes.
Shopify	Online Store › Themes › ⋯ › Edit code › layout/theme.liquid, just before </body>, then Save.
Salla / Zid	Your theme’s custom code (JavaScript) setting. No custom code on your plan? Message us and we add it with you.
Wix	Settings › Custom Code › + Add Custom Code, All pages, Body - end, then Apply and publish.
Webflow	Site settings › Custom code › Footer code, then publish.
Google Tag Manager	A Custom HTML tag with the code, triggered on All Pages, then Submit and Publish.

Next.js: root layout

import Script from 'next/script';

// inside <body> of app/layout.tsx (or pages/_app.tsx)
<Script src="https://inboxi.app/api/voice/embed.js" data-widget="vw_YOUR_ID" strategy="afterInteractive" />

Someone else manages your site? Click Copy instructions for your developer and send them the whole thing: the code, the Next.js version and the security settings below.

Check that it is installed

The status at the top of the settings page tells you where the orb is, within a minute of someone opening your site:

Status	Meaning
Installed	The orb loaded on your site. The page shows the site and when it was last seen.
Not allowed on …	The code is on a site that is not in Where it runs, so the orb stays hidden there. Click Add and Save.
Not detected yet	Nobody has opened a page with the code yet. Open your site, then click Check again.

Sites with a security policy (CSP)

Some sites send Content-Security-Policy or Permissions-Policy headers that block outside scripts or the microphone. Then the orb does not appear, or appears but cannot hear the visitor. Add Inboxi to what you already have:

Response headers

Content-Security-Policy:
  script-src  … https://inboxi.app;
  connect-src … https://inboxi.app;
  frame-src   … https://inboxi.app;

Permissions-Policy: microphone=(self "https://inboxi.app")

microphone=() in Permissions-Policy turns the microphone off for every frame on the page, including the orb. Replace it with the line above.

Greet signed-in customers by name

If your visitors sign in, pass their name so the assistant greets them instead of asking:

html

<script src="https://inboxi.app/api/voice/embed.js" data-widget="vw_YOUR_ID"
        data-name="Ahmed" data-email="ahmed@shop.com" async></script>

<!-- or later, from your own code -->
<script>InboxiVoice.identify({ name: 'Ahmed', email: 'ahmed@shop.com', phone: '+966500000000' });</script>

Guide mode: show visitors around your site

With Guide mode on, the assistant becomes a guide to your website. It knows the page the visitor has open, opens other pages when they ask ("show me your restaurant projects"), and scrolls to and lights up the part it is talking about, while it talks. Turn it on in Settings › Voice assistant › Guide mode and Save.

The orb folds into a small caption above it, so the visitor sees your page, not a panel, while the assistant moves around.
Tours. Ask "explain this page" and it walks through the page part by part, scrolling to each one as it speaks, then asks before going on.
Tabs, questions, sliders and videos. It opens a tab or an FAQ question to read the real answer, moves a slider or plays a video. It never guesses numbers, prices or durations: if the page does not say, it says so.
Pages and projects. It opens only pages of your own site that it knows, and tells clients and projects apart.
It never fills forms, never presses buy, send, book or delete buttons, and never leaves your site.

Setting	What it does
Let the assistant show visitors around your website	Turns Guide mode on for this assistant.
The assistant greets the visitor first	When a call starts it speaks first: a welcome and what it can do, as your agent’s instructions say.
Pages the assistant knows	Every page found on your site (sitemap and links). Untick a page it must never open, or give it a clearer name (Rename).
Read ahead	Click Read the whole site now: it opens every page in the background, notes its parts and describes what its pictures show, so the assistant knows the whole site ("which project has an app?") before the visitor opens a page. Takes a few minutes, and refreshes itself every few days. See what it read under a page shows the parts it found.
Recent calls	What the assistant did on each call: pages it opened, parts it showed, what it said. Use it to see where a page confused it.

Help it read your pages

The assistant reads your page headings (h2, h3) as its parts. Two attributes give you more control:

html

<!-- Name a part that has no heading -->
<section data-inboxi-section="Pricing"> … </section>

<!-- Keep something out of what the assistant reads -->
<div data-inboxi-ignore> … </div>

Give each part of a page its own heading, and real links (<a href>) to your pages and projects, so it can find them.
Use real tabs and accordions (role="tab", aria-expanded or <details>) so it can open them.
Sites built with Next.js or React keep the call going when the assistant opens a page. Classic sites reload, and the visitor taps once to hear the assistant again (a browser rule).

Troubleshooting

What you see	What to do
No orb on the site	Check the status on the settings page. Make sure the assistant is switched on, your domain is listed, and the code is on the page (view the page source and search for embed.js).
Orb shows, but the browser never asks for the microphone	Your site’s Permissions-Policy blocks it. See Sites with a security policy above.
“Not enough voice points”	Top up from Settings › Voice points, or turn on auto-recharge.
The orb covers my chat button	Move one of them: change the corner, or raise “Distance from the bottom”.
Guide mode says it opened a page but nothing moved	Check the page is in Pages the assistant knows and not unticked, and that the site loads the latest code (hard refresh).
It skips a part of a page while explaining	Give that part its own heading, or name it with `data-inboxi-section`.

More about calls, recordings and billing: Voice assistant in AI Agents.