Website Widget

The website widget is how visitors interact with your AI agent. A small floating button opens a chat interface powered by your agent. You control the appearance, position, and behavior through the Config > Connections sub-tab.

Find integrations in your agent's Connections tab under "Website Widget." Click + Create Integration.

Choose the embed format that works best for your website.

Script Tag (Recommended)

Works on any website. Paste before the closing </body> tag.

<script
  src="https://simplyasking.io/widget/v2/agent.js"
  data-agent-id="YOUR_AGENT_ID"
  data-api-key="YOUR_API_KEY"
  data-theme="dark"
  data-position="bottom-right"
  async
></script>

How It Works

The widget uses Shadow DOM to render directly on your page. Your site's CSS won't affect the widget, and the widget's CSS won't affect your site. No iframe needed. Conversations persist across page navigations within the same browser session. After 30 minutes of inactivity, a new session starts automatically.

Customize appearance through data attributes or the branding panel in Chat Test.

Theme

Position

Branding Options

Each integration has its own API key. Manage keys from Config > Connections.

Auto-Open

Automatically open the chat widget after a delay.

data-auto-open="5000"  // Opens after 5 seconds

Page Awareness

Send page context to the agent for more relevant responses.

JavaScript API

Control the widget programmatically.

// Open the widget
window.SimplyAsking.open();

// Close the widget
window.SimplyAsking.close();

// Toggle open/close
window.SimplyAsking.toggle();

// Send a message programmatically
window.SimplyAsking.sendMessage("What are your business hours?");

// Listen for events
window.SimplyAsking.on('message', (msg) => {
  console.log('New message:', msg);
});