Reading time 5 minLevel Beginner

Chatbox

Put Ada on your own website. The same assistant, tools and team Inbox as your WhatsApp support desk, in a chat widget you add with one script tag.

Chatbox is your support desk’s chat widget for your own website. Ada answers in it just as she does on WhatsApp: from what she knows about your business, from your own tools, asking before any change, and handing the chat to your team when she should. Web chats land in the same Inbox in the support console, with a Web badge.

Chatbox is part of the Team plan.

Before you start

Set up the support desk in the console: your business, a verified website, and Ada switched on. The widget only runs on the website you verified and its subdomains, so nobody can put your chat on their site.

Add it to your site

In the console, open Support desk › Chatbox.
Choose a colour, the button label, a greeting and up to four suggested questions. The preview beside the settings shows the widget as visitors will see it.
Choose Go live.
Under Install, copy the script tag and paste it before </body> on every page:
```
<script src="https://chat.glxymesh.com/v1/widget.js" data-org="your-org" async></script>
```
On WordPress, add it to your theme’s footer or with a “headers and footers” plugin. On Shopify, paste it into theme.liquid just before </body>.
Open your site. Once the widget has loaded, the Chatbox page says Found on your domain.

No website editor? Use Share link and QR: https://chat.glxymesh.com/your-org opens the chat on its own page, for a link in your bio, an email footer or a QR code at the counter.

What visitors can ask

Anyone can ask about what Ada knows: your products, hours, policies and FAQs. Before she looks up anything about the visitor themselves (an order, a booking, an account), she asks them to confirm their email with a 6-digit code, then uses your tools with that email. A change, such as moving a delivery, still needs the visitor to tap Yes.

If your site already knows who the customer is, it can tell Chatbox, and Ada skips the email check. See Signed-in customers.

When your team takes over

Ada hands a chat to your team when the visitor asks for a person, is upset, mentions a complaint, legal action or a chargeback, or when she can’t help after two tries. It appears in the support console’s Inbox with what the visitor asked, the page they’re on and what Ada looked up.

When nobody on the team is free, Ada keeps answering and asks the visitor for an email; if they leave the page, your teammate’s reply is also emailed to them, with a link back to the chat. You can choose to offer your WhatsApp number instead.

Live calls

Turn on Live calls on the Chatbox page and a phone button appears at the top of the chat. One tap starts a call in the visitor’s browser, with no app and no number to dial. Ada answers straight away, with the same knowledge and tools as in the chat.

She never leaves silence. Her words start while she is still thinking, and before she looks anything up she says so (“let me check that for you”). If a lookup is slow she keeps the visitor posted, and after ten seconds she puts the answer in the chat instead.
Changes still need a yes. Ada asks, and the question also appears on screen. A clear spoken “yes” or “no” answers it, and so does tapping. If the visitor talks about something else instead, or doesn’t answer within half a minute, nothing changes.
The chat stays open. Visitors can switch to the chat during a call, type, and switch back. Links and order details Ada mentions are put in the chat.
Everything is kept. What was said appears in the chat and in the support console’s Inbox as a call card with its transcript. The Inbox shows On call while a call is live.
A call ends after a minute in which the visitor says nothing; Ada asks whether they’re still there after thirty seconds.

Call minutes count as AI credits, as Ada’s replies do.

Signed-in customers

To let Ada know who a signed-in customer is, your server signs a short token for them and your page passes it to the widget.

On the Chatbox page, under Who can chat, choose Create secret and keep the secret on your server only. Anyone with it can speak as your customers.
When a customer is signed in, sign an HS256 JWT with that secret:

Claim Required What it is

sub yes Your own id for the customer

exp yes When the token stops working

email no Their email; Ada uses it to look up

name no How the team sees them
```
// Node, with the jsonwebtoken package
const token = jwt.sign({ sub: user.id, email: user.email, name: user.name }, process.env.CHATBOX_SECRET, {
  algorithm: 'HS256',
  expiresIn: '1h',
});
```

Claim	Required	What it is
`sub`	yes	Your own id for the customer
`exp`	yes	When the token stops working
`email`	no	Their email; Ada uses it to look up
`name`	no	How the team sees them

Pass it to the widget on the page, either on the script tag or once the page knows who is signed in:

<script src="https://chat.glxymesh.com/v1/widget.js" data-org="your-org" data-identity="TOKEN" async></script>

window.GlxymeshChat.identify(token);

Choose Signed-in customers only to keep the chat to customers your site has signed in.

Call	What it does
`window.GlxymeshChat.open()`	Opens the chat, as from a button
`window.GlxymeshChat.close()`	Closes it
`window.GlxymeshChat.identify(t)`	Signs the visitor in with a token

Hide the widget on pages such as checkout with Hide on these pages (/checkout/*).