raulpetruta

raulpetruta / ha-wa-bridge

Public

A custom integration to send and receive WhatsApp messages in Home Assistant naturally. It uses a local whatsapp-web.js bridge running in Docker.

102
2
100% credibility
Found Feb 09, 2026 at 24 stars 4x -- GitGems finds repos before they trend. Get early access to the next one.
Sign Up Free
AI Analysis
Python
AI Summary

A Home Assistant custom integration that connects WhatsApp to enable sending messages from the smart home system and triggering automations on incoming texts.

How It Works

1
🔍 Discover WhatsApp for your smart home

You hear about a simple way to chat with your Home Assistant setup using WhatsApp messages right from your phone.

2
Choose your setup path
📦
One-click add-on

If using Home Assistant OS, add it straight from the store and start it up.

🛠️
Quick helper service

Set up a small background helper using a ready-made package on your computer.

3
📥 Add the WhatsApp connector

Install the WhatsApp piece into Home Assistant using your favorite manager or by placing files, then refresh everything.

4
📱 Link with a QR scan

Open notifications in Home Assistant, scan the shown QR code with your phone's WhatsApp app, and watch it connect securely.

5
💬 Send your first message

Tell Home Assistant to send a fun text to a friend's phone, like 'Lights on from home!' and see it arrive instantly.

6
🤖 Set smart responses

Create rules so incoming texts like 'Turn on lights' automatically make your home obey.

🎉 Chat controls your home

Now you text your house naturally, sending commands or getting updates via WhatsApp anytime, anywhere.

Sign up to see the full architecture

5 more

Sign Up Free

Star Growth

See how this repo grew from 24 to 102 stars Sign Up Free
Repurpose This Repo

Repurpose is a Pro feature

Generate ready-to-use prompts for X threads, LinkedIn posts, blog posts, YouTube scripts, and more -- with full repo context baked in.

Unlock Repurpose
AI-Generated Review

What is ha-wa-bridge?

ha-wa-bridge is a custom integration for Home Assistant that lets you send and receive WhatsApp messages directly in your automations. It runs a local Docker bridge based on whatsapp-web.js, so you scan a QR code once to link your phone, then use simple services like `whatsapp.send_message` for numbers or groups. Built in Python for the HA side, it solves the hassle of wiring WhatsApp into smart home flows without cloud services or official APIs.

Why is it gaining traction?

It stands out with dead-simple setup via HACS custom integration or HA add-on, plus triggers that filter incoming messages by sender number, group name, or text content. Developers dig the two-way flow: fire off group alerts from HA or automate lights on "turn on" texts. No fuss with external accounts—everything stays local and private.

Who should use this?

Home Assistant users building family smart homes, like sending dinner reminders to WhatsApp groups or triggering vacuums on text commands. Ideal for HA tinkerers integrating custom HACS integrations with messaging, especially if you're already running Docker add-ons and want WhatsApp over push notifications.

Verdict

Try it if WhatsApp is your family's go-to chat—solid docs and features make setup quick, but with 25 stars and 1.0% credibility score, it's early-stage so test stability in a dev instance first. Pairs well with other custom integrations like n8n or Wazuh for broader automation.

(178 words)

Sign up to read the full AI review Sign Up Free

Similar repos coming soon.