English | Português (Brasil)
Explore WhatsApp Web automation in a React Native mobile application.
A project in the WPPConnect ecosystem, maintained by WPPConnect Team.
Getting started | Documentation | Contributing | Support WPPConnect
Experimental application; device and service compatibility require validation.
For contributors experimenting with the mobile integration of WA-JS in a WebView. The repository contains a React Native 0.69 development application (private: true, version 0.0.1). No App Store or Play Store release is confirmed here; build from source and verify device compatibility.
- React Native Android/iOS targets and embedded browser integration.
- WA-JS type definitions and local application state/navigation.
Requires Node.js/npm and the native SDKs for React Native 0.69. Android needs an Android SDK/emulator or connected device; iOS needs macOS, Xcode and CocoaPods. Use the toolchain compatible with this older React Native version, rather than assuming current templates work.
git clone https://github.com/wppconnect-team/mobile.git
cd mobile
npm install
npm run startKeep Metro running. In another terminal use npm run android, or on macOS install the iOS pods with cd ios && pod install and run npm run ios from the repository root. The first result is the app opening in your device/emulator; WhatsApp authentication and feature support require separate verification.
Review src, android and ios for WebView and native settings. The scripts include tests, lint and TypeScript checking. The previous promise of future store releases is not a release commitment.
| Project | Purpose | When to use it |
|---|---|---|
| WPPConnect/WA-JS | Expose WhatsApp Web functions through the browser-side WPP API. |
Run browser-side code in WhatsApp Web. |
| Wppconnect Extension | Send configured messages and attachments through a Chrome extension for WhatsApp Web. | Use a Chrome UI over WA-JS. |
WPPConnect is maintained by an open-source community. Your support helps fund maintenance, infrastructure, documentation, and the people working on the ecosystem.
If WPPConnect helps your project or business, consider making a one-time contribution or becoming a recurring supporter.
Support WPPConnect on Open Collective
Contributions are voluntary. See the official page for current financial information. You can also help with code, tests, documentation, translations and well-described issue reports.
Additional official beneficiaries in .github/FUNDING.yml: joaosouz4dev, manfe.
Contributions of code, tests, examples, documentation and translations are welcome. For larger changes, discuss the approach in an issue first. Include the project/runtime versions, a minimal reproduction and sanitized logs when reporting a problem. Update both README.md and README.pt-BR.md in the same change when installation, configuration, features, examples, licensing or funding changes.
After installing the development dependencies, use the repository checks relevant to your change:
npm run tsc
npm run lint
npm testAccount-dependent examples and tests require separate validation with an authorized test account. Never attach credentials or session files to an issue.
Use repository issues for reproducible bugs and feature proposals. For usage questions, join the community through the official channels:
Report vulnerabilities privately according to SECURITY.md.
This project is independent and is not affiliated with or endorsed by WhatsApp or Meta. Follow applicable terms and obtain authorization for account and messaging operations.
Apache License 2.0 (Apache-2.0).
Copyright 2021 WPPConnect Team.
The original legal document and existing copyright notices are preserved. Third-party components retain their own terms.