JavaScript SDK

1. Install the SDK

Requires Node.js 20 or newer, with ESM (type: module in package.json). The package is named wayo-agent. Use the download until registry publication is complete.

npm install ./wayo-agent-javascript.tgz

npm install wayo-agent

2. Set your signing secret

In Settings → Developers, copy your signing secret. It is required by the SDK, for Chat, Webhook and REST alike.

$env:WAYO_SECRET="whsec_REPLACE_WITH_YOUR_REAL_SECRET"

export WAYO_SECRET="whsec_REPLACE_WITH_YOUR_REAL_SECRET"

3. Return your first reply

Start with this complete local example. It returns a connection test reply.

import { createServer } from "node:http";
import { Wayo } from "wayo-agent";
const wayo = Wayo.fromEnv();
wayo.onMessage(async message => "Wayo is connected.");
createServer(wayo.nodeHandler()).listen(8080, "127.0.0.1");

node standalone.mjs

Return plain text or an object containing a nonempty reply. Replace the test reply with your own inventory or business lookup. Register only one handler.

// Initialize wayo and register onMessage in a server-only module.
import { wayo } from "./business-integration.js";

export const POST = wayo.handler();
export const runtime = "nodejs";

4. Connect in Wayo

Deploy behind a public HTTPS address or expose your local server through an HTTPS tunnel. Localhost cannot be used as a Wayo endpoint.

https://your-business.example/

Choose Chat API, enter your final endpoint, and press Test connection. Expect “Wayo is connected.” Then replace the test reply with real data and test again before saving.

The same handler accepts Webhook POST and REST GET. See Requests & replies for their formats. Standalone examples are for development; use your usual production hosting for real traffic.