Widget

The chat bubble for your site. Get the full Humaner experience with one script.

Astral

Casual support

where's my order?

hey! shipped yesterday. tracking's in your email.

Add it to your site

1
GO to Integrations tab
Inside Widget personnalize your UI and copy the embed snippet.
2
Paste it right before </body>
That's it, feels good nah ?
3
Lock it to your domains
Do not forget to add allowed domains so nobody can embed yours.

index.html · before </body>

<script
  src="https://app.humaner.ai/widget.js"
  data-agent="ag_demo123"
  data-color="#e0e1df"
  data-position="bottom-right"
  async>
</script>

Refresh your site. The bubble shows up where you set it.

Built-in Actions

The widget renders differents CTAs according to industries.

Component	Vertical	What it does
Product card	Retail	Image, name, price, and a "View product" button inline
Order status	Retail	Live shipment info pulled the moment they ask
Return form	Retail	Inline form that becomes a Human Desk ticket
Plan upgrade CTA	SaaS	Locked feature turns into an upgrade button in chat
Cancellation flow	SaaS	Reason, then a counter-offer, then confirmation
Class schedule	Wellness	Tomorrow's classes with a book button
Medical guardrail chip	Wellness	A visual "please consult a professional" chip
Room card + calendar	Hospitality	Availability picker and booking handoff

Options

Attribute	What it does
data-agent	Your public agent ID. Required
data-color	Accent color as a hex value, to match your brand
data-position	bottom-right or bottom-left
data-greeting	One-off greeting override. Otherwise uses the agent's greeting, personality default if blank

Help links

The Help tab shows your quick links. Pick Lucide icons for the usual sections — Getting started (wave), Features, Billing, Security, Integrations, Support, Documentation, FAQ, Bug — and toggle whether they animate on hover.

Proactive popup

A teaser bubble and a red badge can pop next to the closed launcher. Turn it on in Widget settings, call window.Humaner.message() from the page, or queue it with POST /api/v1/widget/proactive after you identify the visitor.

window.Humaner.identify("usr_hashed_123");
window.Humaner.message("Need a hand getting started?");

Full REST shape lives on the API page and the Proactive popup reference.