Install in sixty seconds.

One script tag in the <head> of your store is the whole install. On Shopify that means editing theme.liquid from the Theme Editor; everywhere else it is wherever your CMS lets you paste raw HTML. No SDK to npm-install, no build step to wire up.

Step I

Grab your token.

Go to Dashboard → Install. Click "Generate token". Tokens are per-store and rate-limited to 40 req/min (bumpable on request).

Step II

Paste the script tag.

Drop the tag anywhere your CMS lets you edit raw HTML. The storefront head works best. We have tested it on Shopify, WordPress, Webflow, and a handful of hand-rolled HTML sites without anything breaking.

Step III

Send a test query.

Open the widget on your site, ask anything. The first 25 queries are on us, no card needed. Usage shows up in Dashboard within seconds.

The snippet · Copy · Paste · Ship

One tag. That's the install.

<script
  src="https://cdn.supportpilots.com/widget/v1/widget.js"
  data-token="sp_live_YOUR_TOKEN_HERE"
  data-title="Ask our support team"
  data-position="right"
  async
></script>

Replace the token; everything else is optional. The widget renders inside a shadow-DOM island, which is the reason it will not inherit your page styles, read cookies set on your origin, or interfere with anything in your checkout flow.

Data attributes

Widget parameters

data-token string, required: Your per-store install token from Dashboard.
data-position string, optional: bottom-right · bottom-left · top-right · top-left
data-theme string, optional: auto (default) · light · dark
data-locale string, optional: en (default). Locale-ready, more ship post-launch.

Direct endpoint

Server-to-server

POST  https://api.supportpilots.com/v1/query
Content-Type: application/json
Authorization: Bearer sp_live_...

{
  "prompt": "Where is my order?",
  "context": { "order_id": "1047" }
}

Rate limit 40 req/min per token, bumpable. 1 credit = 1 query. See the full price list. Fallback provider activates automatically if primary is slow.

Onward · Vol. IV

25 free queries. No card. No clock.

Verify your email and the install token is waiting for you in the dashboard. Paste it into your store, open the widget, and the first 25 queries are already on the house, no card on file, no time limit on when you use them.

Start for free Read the full reference