WhatsApp for Home Assistant

The most robust, private, and localized WhatsApp integration for Home Assistant. Connect your automations to the world's most popular messaging platform.

Component	Version	Status
App (Stable)		engine
App (Edge)		engine-dev
Integration (Stable)		interface
Integration (Beta)		testing
Activity

🚀 Get Started

Add Integration

Integration Repo App Repo

NOTE: This project is 100% free and open-source. There are no hidden costs, premium versions, or paid features. Donations are strictly voluntary and support the hardware/time needed for development.

🔗 Webhook Integration

Forward your WhatsApp messages to any HTTP endpoint in real-time. This project isn’t just for Home Assistant; you can use the built-in Webhook to bridge WhatsApp to:

Node-RED for complex automation flows.
Generic HTTP Servers (Python, Node.js, PHP, etc.) for logging or custom bots.
Unified Chat Platforms like Rocket.Chat or Slack.

View the Webhook Guide

Legal Disclaimer / Haftungsausschluss

Using automated messaging on WhatsApp may violate their Terms of Service and lead to a permanent account ban. The developers of this project assume no liability for any blocked or banned accounts. Use at your own risk.

Official Policy: WhatsApp Terms of Service

🏗️ Technical Architecture

This project is built for performance and absolute privacy.

graph TD
    %% Define Styles
    classDef wa fill:#25D366,stroke:#075E54,stroke-width:2px,color:#fff,font-weight:bold;
    classDef ha fill:#111b21,stroke:#25D366,stroke-width:1px,color:#e9edef;
    classDef logic fill:#128C7E,stroke:#075E54,stroke-width:1px,color:#fff;
    classDef network fill:#000,stroke:#25D366,stroke-width:1px,dasharray: 5 5;

    subgraph UserInterface ["User Layer"]
        User((User))
        HA_UI[HA Dashboard]
    end

    subgraph HACore ["Home Assistant Core"]
        direction TB
        WH[WhatsApp Integration]
        Core[Automation Engine]
        Notify[Notify Service]
    end

    subgraph AppBridge ["App Architecture (Local)"]
        direction TB
        API[Express API Server]
        BL[Baileys Node.js Engine]
        Auth[Local Auth Session]
    end

    subgraph External ["WhatsApp Cloud"]
        WA[WhatsApp Servers]
    end

    %% Flows
    User <-->|Control & Status| HA_UI
    HA_UI <-->|Web Interface| Core
    Core <-->|Triggers| WH
    Notify -->|Send Message| WH
    WH <-->|REST API :8066| API
    API <-->|Local Events| BL
    BL <-->|Persistent Session| Auth
    BL <-->|Websocket / MD| WA
    WA <-->|End-to-End Encrypted| Recipient((Phone))

    %% Assign Styles
    class WA,User,Recipient wa;
    class WH,Core,Notify,API,Auth ha;
    class BL logic;
    class External network;

Privacy First: Your WhatsApp connection is local. No external servers (other than WhatsApp’s official ones) ever see your message content.

Tip: Want to use Rocket.Chat? Check out our Rocket.Chat Bridge Guide to connect WhatsApp to your team workspace!

Stable: Production-ready. Follows semantic versioning (e.g., v1.x.x).
Beta: Feature-complete testing versions. Recommended for testing new features.
Edge/Dev: Experimental builds from the latest code.

🕵️ Discovery: Find Group IDs instantly with the search_groups service.
Modern: Fully supports the 2026 Home Assistant notify standards.
Rich Content: Interactive Buttons, Polls, Reactions, and Media support.
Easy Setup: Automatic Add-on installation and configuration for Home Assistant OS users.
Localized: Deep German (DE) and English (EN) support.

Maintained by FaserF.

This project is not affiliated, associated, authorized, endorsed by, or in any way officially connected with WhatsApp Inc. or any of its subsidiaries or its affiliates.