Requests per day

Chat messages answered by your assistants.

Recent activity

The latest requests made with your keys.

Create a new key

Give it a name you'll recognise, like the website it's for.

Your keys

Create an API key first, then customise its chatbot here.

Go to API keys

Complete your payment

Your plan activates automatically as soon as Ko-fi tells us you've paid. Keep this page open.

1. Copy your reference code
   Copy
2. Pay on Ko-fi

   Enter as the amount and paste the reference code into the message box. Tick "Make this monthly" to renew automatically. You can pay with PayPal or a card.

   Pay on Ko-fi ↗
3. Done

   Come back here. Paying with the same email as this account () also matches your payment if you forget the code.

Payment history

Quick start

The starter kit contains index.html, server.js and readme.txt.

1. Download & unzip the starter kit

   You'll need Node.js 18 or newer installed. No npm packages are required.

2. Add your API key

   Open server.js and paste your key, or set it as an environment variable:

   YSWAI_API_KEY=ysw_sk_your_key_here node server.js

3. Start your server

   Run the command below in the starter-kit folder, then open http://localhost:3000.

   node server.js

4. Customise (optional)

   Change the greeting in Chatbot settings, or override it directly in index.html:

   window.YSWAI_WIDGET = {
     endpoint: "/api/chat",
     configEndpoint: "/api/widget-config",
     greeting: "Welcome to Rosie's Bakery! What can I get you?",  // overrides dashboard
     botName: "Rosie",
     accent: "#16a34a"
   };

REST API reference

Authenticate every request with Authorization: Bearer <your key>. Base URL:

// Request body
{ "messages": [ { "role": "user", "content": "Do you deliver on Sundays?" } ],
  "greeting": "optional – the first message shown to the visitor" }

// Response
{ "reply": "Yes! We deliver every day from 9am to 6pm.", "model": "llama3.2", "tokens": 182 }

{ "bot_name": "Rosie", "greeting": "Hi! 👋 How can I help?", "model": "llama3.2" }