AgentStack Docs
AgentStack Docs
AgentStack documentation
Get started
Build your agent
Actions
Analytics
Channels
Connect customer channelsEmail channelEmail domainsSlack channelVoice CallsVoice sessions and recordingsHelp PageServe the Help Page from a path on your siteDeploy the chat widget
Help Desk
Help Center
Developers
Workspace
    Channels

    Deploy the chat widget

    Embed an agent as a chat bubble or iframe and protect the live widget with an allowed-domain list.

    Open Deploy to copy the embed code for your agent. The Chat Widget snippet loads embed.js and passes the agent's public ID. This snippet gives you the advanced widget features. Copy the snippet from your dashboard. The origin in the snippet is specific to your environment.

    Install the snippet in the shared layout or footer of your visitor pages. Then check that:

    • The script loads.
    • window.agentstack is defined.
    • The bubble opens a working chat panel.

    The Iframe option embeds the chat interface directly. It does not support the window.agentstack API, identity verification, or client-side actions. If you need these features, use the Chat Widget option instead. A private agent, or an agent pending deletion, does not render in the public embed. Before you use the widget, make the agent public.

    Use Allowed domains to restrict embedding. To allow embedding from any domain, leave the field empty. To restrict it, enter one hostname per line. A hostname also matches its subdomains. Do not use a scheme such as https://, a path, a port, or a wildcard such as *.example.com. The dashboard refuses to save these formats. The REST API stores them as plain text, and they never match a hostname.

    Test the setting on the final production hostname after you save it. Do not rely on a local preview.

    Serve the Help Page from a path on your site

    Forward three routes from your own site to AgentStack so the Help Page answers at your own address, without a custom domain.

    Help Desk

    Use Inbox, tickets, contacts, and leads to let teammates take over customer conversations safely.