Skip to main content

Deploy Your Agent

Put your agent in front of customers. The fastest path is Web Chat → Deploy: a Direct Link for testing, an Embed Script for your site, and a choice of Page Embed vs floating Chatbot. Other channels (WhatsApp, Instagram, Slack, and more) are connected under Integrations—use each channel’s dedicated guide rather than duplicating setup here.

Open Deploy

  1. Open Agents and select your agent.
  2. Under SPOTLIGHT, click Web Chat.
  3. Click the Deploy tab (next to Appearance).

Use Deploy to embed the widget on your site or share a link. Web Chat is already enabled for new agents, so you can use this tab without turning the integration on first.

Direct Link is a URL that opens the chat in a new window—no HTML changes required.

  • Use Copy link to share it, or the eye control to Open in new tab.
  • Send a few messages and confirm answers match AI Settings and Knowledge Base. This is the fastest way to test before you embed.

Embed Script

Embed Script is the snippet for your own website. The product instructs you to place it just before the closing </body> tag.

The shape of the snippet is:

<script defer src="https://live.chatmaven.ai/chat-bot-embed.js" data-bot-id="YOUR_BOT_ID" data-api-url="https://liveapi.chatmaven.ai"></script>

Always copy the exact line from your Deploy tab with Copy script. data-bot-id is unique per agent. Do not type the ID by hand.

Embed Your Agent (Page Embed vs Chatbot)

Under Embed Your Agent, choose how the experience sits on the page:

StyleTypical use
Page EmbedChat occupies a section of a page (for example a dedicated support block).
ChatbotFloating launcher bubble, usual for full-site coverage.

Use Preview to try the selected style in the browser, and Copy Code to copy that snippet. Paste it before </body> as well.

After you deploy

Visitor chats from Web Chat show up in Inbox on the Web Chat channel. Confirm the widget in an incognito window on the live site.

For Shopify storefronts, prefer the Theme App Extension / App embeds path, or paste the same script in theme.liquid. See Embedding the chatbot on your store.

On WordPress, paste the Embed Script in your theme footer or a custom HTML block (before </body>). Use the same data-bot-id from Deploy.

Other channels

Enable each channel on Agents → Integrations, then follow its guide:

ChannelGuide
Web ChatWeb Chat (Agents)
WhatsAppWhatsApp integration
InstagramInstagram integration
SlackSlack
LINELINE

Apps & CRM (Zapier, Make, Shopify, Calendly, Gmail, and others) are listed under Integrations overview. For the Integrations grid itself, see Integrations.

Developers

To call ChatMaven from your own systems, create keys under API Keys and review Webhooks and the API reference. Use the credentials and endpoints shown in those guides—do not invent extra public SDKs or content-upload URLs.

Next steps

Your agent is live when the embed or channel is connected and test messages appear in Inbox. Continue with Getting Started with ChatMaven for the rest of the docs, or Getting started with AI agents for day-to-day agent settings.


FAQ and troubleshooting

The snippet is on the page but the widget never loads.

Check for CSP, ad blockers, and console errors. Confirm the script URL is reachable and data-bot-id matches this agent. Mixed HTTP sites will block the HTTPS script—serve your page over HTTPS.

Compare the copied snippet with Deploy. Page Embed and Chatbot use different placement; preview the style you chose, then paste Copy Code again.

Shopify-specific issues?

Use Embedding the chatbot on your store. Placement in theme app embeds or theme.liquid before </body> is the usual fix.