Custom domain

Serve the chat widget, the inline iframe, and the hosted chat link from your own domain (e.g. chat.yourbrand.com) — white-label, with automatic HTTPS.

View as Markdown

On a paid plan you can serve your agent from your own domain — e.g. chat.yourbrand.com instead of app.bookbag.ai. The embed script, the inline iframe, and the hosted chat page all work on your domain, so the widget is fully white-label. HTTPS is provisioned automatically.

Where to set it

Open your agent → Settings → Custom domains. Add a domain, verify it with a DNS record, then point it to Bookbag with a CNAME.

Set it up

1
Add your domain
In Settings → Custom domains, enter e.g. chat.yourbrand.com and click Add domain.
2
Verify ownership (TXT)
Add the shown TXT record — host _bookbag.<your-domain> with value bookbag-verification=bb-<your-agent> — at your DNS provider, then click Verify. Bookbag checks the record live.
3
Point traffic (CNAME)
Add a CNAME from your domain to cname.bookbag.ai. Once it propagates, your domain serves the widget.
4
Use it
The dashboard shows your white-label embed snippet and hosted-chat URL on the domain. HTTPS is issued automatically on first visit.

What runs on your domain

Embed script — <script src="https://chat.yourbrand.com/widget/embed" data-agent-id="…"></script>.
Inline iframe — https://chat.yourbrand.com/widget/frame.
Hosted chat — visiting https://chat.yourbrand.com/ opens your agent's chat directly.

tip

Bookbag only issues a TLS certificate for a domain after you've verified it, so no one else can point a domain at us and serve your agent.

Website widget