# WPPConnect

WPPConnect is an open source project developed by the JavaScript community with the aim of exporting functions from WhatsApp Web to the node, which can be used to support the creation of any interaction, such as customer service, media sending, intelligence recognition based on phrases artificial and many other things, use your imagination

Repository: https://github.com/wppconnect-team/wppconnect
Canonical: https://ross.abutalabs.com/products/wppconnect
Homepage: https://wppconnect.io
Language: TypeScript
License: NOASSERTION
License Family: other
Topics: sulla, bot, chat, framework, ai, chatbot, message, whatsapp, whatsapp-bot, whatsapp-api, puppeteer, zap-api, open-source, nodejs, automate, wa, wppconnect, api, typescript, wpp
Last push: 2026-08-26T15:07:56+00:00
Link (homepage): https://wppconnect.io
Link (site_page): https://wppconnect.io/docs
Link (site_page): https://wppconnect.io/docs/tutorial/intro
Link (site_page): https://wppconnect.io/docs/projects

## Health v2 (maintenance only)
Score: 99/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 99, release rhythm 98, longevity 100
- inputs: {"age_days": 2047, "days_push": 7, "days_rel": 15, "gap_med": 6.0, "n_releases_24m": 45}
- 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 3401, forks 560 (observed 2026-08-28T04:08:02.849293+00:00)

## What it is
WPPConnect is a Node.js/TypeScript library that exports WhatsApp Web functionality via Puppeteer, enabling message sending, session management, contact/group access, and bot building. The ecosystem also includes WPPConnect Server, a ready-to-use REST API with webhooks built on top of the library.

## Use cases
- send whatsapp messages from nodejs
- build a whatsapp chatbot
- whatsapp customer service automation
- send media and documents via whatsapp api
- manage multiple whatsapp sessions
- expose whatsapp as a rest api with webhooks
- receive and reply to whatsapp messages programmatically

## When to choose
- you need programmatic WhatsApp automation in Node.js without the official Business API
- you want a self-hosted REST server with webhooks for WhatsApp sessions
- you need multi-session support and media sending (text, image, video, audio, docs, stickers)

## When to avoid
- you require an officially supported, ToS-compliant WhatsApp integration for production at scale
- you are not using JavaScript/Node.js or a compatible ecosystem
- you cannot tolerate breakage from unofficial WhatsApp Web changes

## Facets
- artifact type: library
- maturity: active
- function: http-server, webhook, chatbot, workflow-automation, sdk
- domain: messaging-platforms, chatbots, developer-tools, apis
- platform: cross-platform
- tags: whatsapp, whatsapp-bot, whatsapp-api, puppeteer, unofficial-api, messaging-automation, customer-service, typescript, automation, nodejs, docker

## Member repositories
- wppconnect-team/wppconnect (main) score 99
- wppconnect-team/wppconnect-server (backend) score 100

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:08:02.849293+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:38:41.190444+00:00, confidence not recorded.
  - readme: https://github.com/wppconnect-team/wppconnect (fetched 2026-08-28T04:08:02.849293+00:00, sha fa53b8a973f5)
  - homepage: https://wppconnect.io (fetched 2026-08-29T09:33:00.431277+00:00, sha 44e949d2ffea)
  - site_page: https://wppconnect.io/docs (fetched 2026-08-29T09:33:00.440957+00:00, sha 1ad0435f0764)
  - site_page: https://wppconnect.io/docs/tutorial/intro (fetched 2026-08-29T09:33:00.443114+00:00, sha b4f6791fd8a0)
  - site_page: https://wppconnect.io/docs/projects (fetched 2026-08-29T09:33:00.444822+00:00, sha 76aaad78fa09)
- Data as of 2026-08-30T08:39:29.467469+00:00.
