WhatsApp Bridge for Home Assistant (Marketplace integration)

On Home Assistant 2026.10 or older? Open it in HACS

Installs: 51 sharing analytics
GitHub stars: 150
Connection: Works locally
Upkeep: Updated in the last 6 months
Version: v3.1.1, November 6, 2026
Category: Messaging and notifications, Chat apps
Kind: Marketplace integration
Needs: Needs the Marketplace (HACS on 2026.10 and older)
Domain: wa_bridge
Source: github.com/raulpetruta/ha-wa-bridge
Issues: Report an issue

Shows in Vulpo Entity card (read-only).

Independent directory, made by the developer of Vulpo. Not affiliated with Home Assistant or the Open Home Foundation.

About

Home Assistant custom integration to send and receive WhatsApp messages through a local Baileys bridge running in Docker.

Description from raulpetruta/ha-wa-bridge

Shows in Vulpo

Entity card (read-only).

Download Vulpo

Supports

Works locallyTalks to your devices on your own network. No vendor cloud in between.
Device triggersIts devices can start automations directly.
From the MarketplaceInstalled through the Marketplace, formerly HACS.
Actively maintainedIts author released or pushed a change in the last six months.

Setting it up

Install it from the Marketplace and restart Home Assistant, then add it under Settings, Devices and services.

Connect to WhatsApp Bridge

Bridge WebSocket URLWebSocket URL of the Node.js bridge, for example ws://localhost:3000.
API tokenShared secret configured for the bridge (api_token add-on option or API_TOKEN environment variable).

Also asked when signing in again.

After setup

NameShown on the notify entity, for example Family.
Phone numberCountry code plus number, without +. Leave empty when using a group.
Group nameExact WhatsApp group name. Leave empty when using a number or group ID.
Group IDStable group ID from get_groups. Leave empty when using a number or group name.
Target

Texts from the code of raulpetruta/ha-wa-bridge.

From the README

Disclaimer This project is not affiliated, associated, authorized, endorsed by, or in any way officially connected with WhatsApp or any of its subsidiaries or its affiliates. The official WhatsApp website can be found at whatsapp.com. "WhatsApp" as well as related names, marks, emblems and images are registered trademarks of their respective owners. Also it is not guaranteed you will not be blocked by using this method. WhatsApp does not allow bots or unofficial clients on their platform, so this shouldn't be considered totally safe.
Send Messages: Use the wa_bridge.send_message service in HA.
Notify: Use the standard notify.whatsapp service, or save a chat as a notify entity and call notify.send_message.
Group Messaging: Send messages to WhatsApp groups by name or by group ID.
Mentions: Tag people in a group message with a mentions list on wa_bridge.send_message. A bare phone number is enough. The bridge adds @number when it is not already in the text.
Group ID Support: Target groups by their stable ID instead of name — automations won't break when a group is renamed.
Get Groups: Retrieve all WhatsApp groups with their IDs using the wa_bridge.get_groups service.
Set Group Subject: Dynamically update a group's name using the wa_bridge.set_group_subject service — perfect for automating group names based on schedules or sensor values.
Set Group Picture: Update a group's picture using the wa_bridge.set_group_picture service.

From the README of raulpetruta/ha-wa-bridge, MIT License. Shortened.