camouchat-whatsapp 0.7.2

High-stealth WhatsApp Web automation plugin for CamouChat. WA-JS powered, async-first, multi-account with AES-256 encrypted storage.

CamouChat WhatsApp 🟢

High-stealth WhatsApp automation plugin for the CamouChat ecosystem. Built on top of camouchat-browser and WA-JS, providing a structured, API-driven pipeline for multi-account automation with end-to-end encrypted message storage.

[!IMPORTANT] This package requires a one-time binary fetch for the underlying Camoufox browser engine after installation. See Setup below.

Key Features

• WA-JS Integration: Uses the internal WhatsApp Web API via wa-js — not fragile DOM selectors.
• Multi-Account Isolation: Each account runs in a sandboxed profile with isolated cookies, storage, and fingerprints.
• E2E Encryption: All stored messages are encrypted at rest using AES-256-GCM.
• Async-First: Fully asyncio-native for high-throughput multi-session workloads.
• Humanized Behavior: Mouse movements, typing cadence, and delays mimic organic user behavior.
• Rate Limiting: Built-in configurable rate-limit support to prevent account bans.

Installation

Using uv (Recommended)

uv add camouchat-whatsapp "camoufox[geoip]"

Using pip

pip install camouchat-whatsapp "camoufox[geoip]"

Setup

[!WARNING]
uv sync / pip install alone are not enough. You must fetch the Camoufox browser binary separately.

With uv

uv run python -m camoufox fetch

With pip

python -m camoufox fetch

This downloads the latest hardened Firefox binary used internally by Camoufox.

Quick Start

import asyncio

from camouchat_browser import BrowserConfig, BrowserForge, CamoufoxBrowser, ProfileManager
from camouchat_core import Platform
from camouchat_whatsapp import (
    Login,
    WebSelectorConfig,
    WapiSession,
    InteractionController,
    MessageModelAPI,
    on_newMsg,
)

async def main():
    # 1. Profile
    pm = ProfileManager()
    profile = pm.create_profile(platform=Platform.WHATSAPP, profile_id="my_account")

    print("Location of saved DIR cookies : ", profile.cache_dir)

    # 2. Browser
    config = BrowserConfig.from_dict({
        "platform": Platform.WHATSAPP,
        "headless": False,
        "locale": "en-US",
        "fingerprint_obj": BrowserForge(),
    })
    browser = CamoufoxBrowser(config=config, profile=profile)
    page = await browser.get_page()

    # 3. Login (reuses saved session automatically)
    ui = WebSelectorConfig(page=page)
    login = Login(page=page, UIConfig=ui)
    await login.login(method=0)

    # 4. Message event hook
    wapi = WapiSession(page=page)
    interaction = InteractionController(page=page, ui_config=ui, wapi=wapi)

    cm = wapi.chat_manager

    @on_newMsg(wapi_session=wapi)
    async def handle_message(msg: MessageModelAPI):
        print(f"New message from {msg.jid_From}: {msg.body}")

        # open chat & send msg .
        print(f"Opening Chat... [{msg.author}]")
        chat_id = msg.jid_From # jid is internal WhatsApp used ID system , and _from tells from which chat this came on, so jid_from -> msg came from which chat.
        chat = await cm.get_chat_by_id(chat_id=chat_id)
        await cm.open_chat(chat= chat)

        if msg.body == "!ping":
            await interaction.send_api_text(
                chat_id=msg.jid_From,
                text="🏓 Pong!",
                quoted_msg_id=msg.id_serialized,
            )

    await handle_message()   # start listening
    await asyncio.sleep(3600)  # keep alive


if __name__ == "__main__":
    try :
        asyncio.run(main())
    except KeyboardInterrupt :
        pass
    except Exception  :
        import tracemalloc
        tracemalloc.print_exc()

Anti-Ban Best Practices

• Use residential proxies and enable GeoIP matching.
• Run only one visible browser (others auto-switch to headless).
• Respect rate limits — avoid burst-sending messages.
• Use test accounts before deploying on real numbers.

Documentation

• WA-JS Integration
• API Models & Managers
• Controllers (Login, Interaction, Media)
• Storage & Filtering
• Core SDK
• Browser Plugin

⚖️ Security & Ethics

CamouChat's strict policy regarding acceptable automation, anti-spam, and stealth disclaimers can be found in our central ecosystem hub:

👉 SECURITY.md

---

Acknowledgements & Third-Party Code

CamouChat WhatsApp uses portions of the wa-js library developed by the WPPConnect Team.

wa-js provides the internal WhatsApp Web JavaScript bridge that powers reliable, selector-free automation. It is distributed under the Apache License 2.0.

See the NOTICE file for full compliance details.

License

MIT License. See LICENSE for details.