Quickstart

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

Choose an installation path

Install via AgentSkills CLI (recommended)
Manual clone (scripts only)

If your agent supports the AgentSkills ecosystem, install directly from the repository:

# Interactive — choose which skills to install
npx skills add whatsable/whatsapp-business-agent-skills

# Install all 3 skills at once (no prompt)
npx skills add whatsable/whatsapp-business-agent-skills --all

# Install only one skill
npx skills add whatsable/whatsapp-business-agent-skills --skill chat-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/whatsapp-business-agent-skills
cd whatsapp-business-agent-skills

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)

Workspace setup & infra: setup-notifyer
Automation primitives: automate-notifyer
Live chat ops: chat-notifyer

If you’re stuck, see Troubleshooting.

Get Started

Notifyer System

WhatsAble

Choose an installation path

Set required environment variables

Log in and capture a token

Run a pre-flight health check

Verify identity + WhatsApp connection

Next steps (pick your goal)

​Choose an installation path

​Set required environment variables

​Log in and capture a token

​Run a pre-flight health check

​Verify identity + WhatsApp connection

​Next steps (pick your goal)

Choose an installation path

Set required environment variables

Log in and capture a token

Run a pre-flight health check

Verify identity + WhatsApp connection

Next steps (pick your goal)