Integration Guide

Embed the Synaptiq Widget

Add an AI-powered chat agent to your website with a single line of code. The widget handles lead qualification, meeting booking, and pipeline generation autonomously.

Quick Start

Paste this snippet before the closing </body> tag on any page where you want the chat widget to appear.

HTML

<script
  src="https://app.synaptiq.ai/widget.js"
  data-tenant="YOUR_TENANT_ID"
></script>

Replace YOUR_TENANT_ID with the tenant ID from your Synaptiq dashboard. The widget loads asynchronously and won't block your page rendering.

Installation

1
Get your tenant ID
Log into your Synaptiq dashboard and copy your tenant ID from the Settings page.
2
Add the script tag
Paste the embed code above into your site's HTML, just before the closing body tag. It works on any website — static HTML, WordPress, Shopify, React, or any other platform.
3
Customize (optional)
Add data attributes to control position, theme, and greeting message. See configuration options below.

Configuration Options

Customize the widget using data-* attributes on the script tag.

Attribute	Default	Description
data-tenant	(required)	Your unique tenant ID. Routes conversations to your AI agent configuration.
data-position	bottom-right	Widget position. Options: `bottom-right`, `bottom-left`.
data-theme	dark	Color theme. Options: `dark`, `light`.
data-greeting	Hey there! How can I help you today?	The initial message shown when the chat opens.

Example

<script
  src="https://app.synaptiq.ai/widget.js"
  data-tenant="acme-corp-123"
  data-position="bottom-left"
  data-theme="light"
  data-greeting="Hi! Looking to automate your sales pipeline?"
></script>

JavaScript API

Control the widget programmatically via the window.SynaptiqWidget global object, available after the script loads.

SynaptiqWidget.open()

Opens the chat window programmatically.

SynaptiqWidget.close()

Closes the chat window.

SynaptiqWidget.setTenant(id)

Updates the tenant ID at runtime. Useful for multi-tenant applications where the tenant context may change after page load.

SynaptiqWidget.destroy()

Removes the widget from the page and cleans up all event listeners.

// Open the widget when a CTA button is clicked
document.getElementById('talk-to-ai')
  .addEventListener('click', function() {
    SynaptiqWidget.open();
  });

Technical Notes

Lightweight

The embed script is under 10KB (uncompressed). No external dependencies. Zero impact on your site's Core Web Vitals.

Cross-Origin

The widget works on any domain. CORS headers are configured automatically. The tenant ID is passed as an X-Tenant-Id header on all API requests.

No Cookie Dependency

Session state is held in memory. The widget does not set cookies on the host domain. Lead and conversation IDs are tracked via response headers.