Install the snippet
Copy the embed script from the dashboard and paste it before your closing body tag. The widget initialises asynchronously so it never blocks the rest of your page.
Theming and configuration
Set launcher colour, header title, initial greeting, theme (Light / Dark / Auto), position (bottom-right / bottom-left), and default mode (Chat or Voice). The preview in the dashboard updates live as you tweak values.
Domain allow-list
Add the domains you want the widget to run on. The script refuses to initialise on any site outside the allow-list, so a leaked snippet can't be dropped on an unrelated page.
No backend to host
The agent, knowledge store, sub-agents, and conversation history all live in Embage. The widget is a thin frontend — your deployment is literally one script tag plus the domains you allow.
// Customising widget appearance
window.embageConfig = {
agentKey: "ag_live_948201a8f",
theme: "dark",
primaryColor: "#7c3aed",
position: "bottom-right",
initialMode: "chat", // "chat" | "voice"
};Related docs