# open-wa/wa-automate-nodejs

💬 🤖  The most reliable tool for chatbots with advanced features. Be sure to 🌟 this repository for updates!

Repository: https://github.com/open-wa/wa-automate-nodejs
Canonical: https://ross.abutalabs.com/products/wa-automate-nodejs
Homepage: https://openwa.dev/
Language: TypeScript
License: NOASSERTION
License Family: other
Topics: typescript, chatbots, nodejs, framework, api
Last push: 2026-08-18T20:47:40+00:00

## Health v2 (maintenance only)
Score: 78/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 98, release rhythm 40, longevity 100
- inputs: {"age_days": 2576, "days_push": 15, "days_rel": 561, "gap_med": 28, "n_releases_24m": 8}
- flags: no_license
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 3649, forks 722 (observed 2026-08-28T04:08:13.006499+00:00)

## What it is
A Node.js/TypeScript toolkit that turns a WhatsApp account into an HTTP API, bot runtime, webhook bridge, plugin host, and MCP server by automating WhatsApp Web. It offers an Easy API CLI, an embeddable createClient runtime, a SocketClient for remote consumers, and multi-session support.

## Use cases
- build a whatsapp chatbot in nodejs
- expose whatsapp as a local http api
- send whatsapp notifications from my crm
- bridge whatsapp messages to webhooks
- run multiple whatsapp sessions for automation
- connect whatsapp to an ai agent via mcp
- build a customer support inbox for whatsapp

## When to choose
- you need a WhatsApp API or bot backend running quickly in Node.js
- you want webhook bridges to CRMs, helpdesks, or low-code tools
- you need multi-session automation with named accounts
- you want to expose WhatsApp to AI agents through MCP

## When to avoid
- you need an officially supported WhatsApp Business API with no ban risk
- you require a stable, non-alpha version - stick to v4.76.0 since v5 is alpha
- your app cannot run a headless browser runtime for WhatsApp Web
- you need mobile-app automation rather than WhatsApp Web

## Facets
- artifact type: library
- maturity: active
- function: api-framework, http-server, webhook, mcp, chatbot, cli, plugin-system, sdk
- domain: messaging-platforms, chatbots, developer-tools, apis
- platform: cli, cross-platform
- tags: whatsapp, whatsapp-web-automation, easy-api, socket-client, multi-session, unofficial-api, webhook-bridge, ai-agents, automation, nodejs, docker

## Member repositories
- open-wa/wa-automate-nodejs (main) score 78

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:08:13.006499+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-29T18:31:42.178734+00:00, confidence not recorded.
  - readme: https://github.com/open-wa/wa-automate-nodejs (fetched 2026-08-28T04:08:13.006499+00:00, sha a257ef19d458)
  - homepage: https://openwa.dev/ (fetched 2026-08-29T09:26:26.426900+00:00, sha 7f53e411321d)
  - site_page: https://openwa.dev/docs/reference/client/client (fetched 2026-08-29T09:26:26.436528+00:00, sha 3e16b575ae66)
  - site_page: https://openwa.dev/docs/getting-started/quickstart (fetched 2026-08-29T09:26:26.438911+00:00, sha 1d05cb5a5c26)
  - site_page: https://openwa.dev/docs (fetched 2026-08-29T09:26:26.441110+00:00, sha 72f98810048a)
  - site_page: https://openwa.dev/docs/getting-started/custom-code (fetched 2026-08-29T09:26:26.443401+00:00, sha b3034360112d)
  - site_page: https://openwa.dev/docs/client-and-integrations/socket-client (fetched 2026-08-29T09:26:26.445390+00:00, sha cae12ceec743)
  - site_page: https://openwa.dev/docs/concepts/how-it-works (fetched 2026-08-29T09:26:26.447322+00:00, sha 27423602d5d0)
  - site_page: https://openwa.dev/docs/guides/session-events (fetched 2026-08-29T09:26:26.449115+00:00, sha 71f73a7bf87d)
  - site_page: https://openwa.dev/docs/guides/multiple-sessions (fetched 2026-08-29T09:26:26.451043+00:00, sha 04a255f00bcc)
- Data as of 2026-08-30T08:39:29.467469+00:00.