This guide assumes Node.js 18+. The skills use native fetch and ESM and intentionally avoid third-party dependencies.
Choose an installation path
If your agent supports the AgentSkills ecosystem, install directly from the repository:# Interactive — choose which skills to install
npx skills add whatsable/agent-skills-by-notifyer
If your goal is “just make my agent fully capable in Notifyer”, use --all so it can load setup-notifyer, automate-notifyer, and chat-notifyer as needed.
git clone https://github.com/Whatsable/agent-skills-by-notifyer
cd agent-skills-by-notifyer
Each skill is self-contained under skills/<skill-name>/.
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.