Skip to main content
This guide assumes Node.js 18+. The skills use native fetch and ESM and intentionally avoid third-party dependencies.

Choose an installation path

Set required environment variables

You need:
  • NOTIFYER_API_BASE_URL
  • NOTIFYER_API_TOKEN (JWT from setup-notifyer/scripts/login.js)
export NOTIFYER_API_BASE_URL="https://api.insightssystem.com"
export NOTIFYER_API_TOKEN="eyJ..."  # set after login
For deeper detail (auth modes, origins, and safety), see Auth & environment.

Log in and capture a token

cd skills/setup-notifyer
node scripts/login.js --email you@example.com --password "YourPassword@1"
The output includes authToken. Export it:
export NOTIFYER_API_TOKEN="eyJ..."
If you’re also running the Notifyer Chat frontend locally for UI testing, use the pinned dev URL http://localhost:5173/ as documented in chat.notifyer_frontend/README.md.

Run a pre-flight health check

Before running any automation or chat script, validate the account is in a healthy state.
cd skills/setup-notifyer
node scripts/doctor.js --pretty
doctor.js validates, in one command:
  • Base URL is set and HTTPS
  • Token is valid (/auth/me)
  • WhatsApp connection is usable (isConnected + degraded detection)
  • Subscription is in an allowed state

Verify identity + WhatsApp connection

node scripts/get-me.js --pretty
node scripts/get-connection-status.js --pretty

Next steps (pick your goal)

If you’re stuck, see Troubleshooting.