--- title: "WhatsApp Bridge" description: "WhatsApp Bridge is a Marketplace integration for Home Assistant. It has 51 installs sharing analytics, works locally and was last updated November 6, 2026." canonical: "https://vulpo.app/integrations/marketplace/raulpetruta-ha-wa-bridge" url: "https://vulpo.app/integrations/marketplace/raulpetruta-ha-wa-bridge.md" last-updated: "2026-11-14" version: "1.4" --- # WhatsApp Bridge > WhatsApp Bridge is a Marketplace integration for Home Assistant. It has 51 installs sharing analytics, works locally and was last updated November 6, 2026. From the [repository description](https://github.com/raulpetruta/ha-wa-bridge): > Home Assistant custom integration to send and receive WhatsApp messages through a local Baileys bridge running in Docker. [Open in My Home Assistant](https://my.home-assistant.io/redirect/marketplace_repository/?owner=raulpetruta&repository=ha-wa-bridge&category=integration) On Home Assistant 2026.10 or older? [Open it in HACS](https://my.home-assistant.io/redirect/hacs_repository/?owner=raulpetruta&repository=ha-wa-bridge&category=integration) ## Supports - **Works locally**: Talks to your devices on your own network. No vendor cloud in between. - **Device triggers**: Its devices can start automations directly. - **From the Marketplace**: Installed through the Marketplace, formerly HACS. - **Actively maintained**: Its 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 URL**: WebSocket URL of the Node.js bridge, for example ws://localhost:3000. - **API token**: Shared secret configured for the bridge (api\_token add-on option or API\_TOKEN environment variable). Also asked when signing in again. ### After setup - **Name**: Shown on the notify entity, for example Family. - **Phone number**: Country code plus number, without +. Leave empty when using a group. - **Group name**: Exact WhatsApp group name. Leave empty when using a number or group ID. - **Group ID**: Stable group ID from get\_groups. Leave empty when using a number or group name. - **Target** Texts from the code of [raulpetruta/ha-wa-bridge](https://github.com/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](https://github.com/raulpetruta/ha-wa-bridge#readme), [MIT License](https://spdx.org/licenses/MIT.html). Shortened. ## At a glance - Kind: Marketplace integration - Category: [Messaging and notifications](https://vulpo.app/integrations/category/messaging-and-notifications.md), Chat apps - Number: 51 installs sharing analytics; 150 GitHub stars - Connection: Works locally - Upkeep: Updated in the last 6 months - Needs: Needs the Marketplace (HACS on 2026.10 and older) - Latest version: v3.1.1, last updated November 6, 2026 - Domain: `wa_bridge` - Source: - Issues: 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 these numbers](https://vulpo.app/integrations/about) Last updated 2026-11-14. Source: https://vulpo.app/integrations/marketplace/raulpetruta-ha-wa-bridge --- - HTML version of this page: https://vulpo.app/integrations/marketplace/raulpetruta-ha-wa-bridge - Site index for agents: https://vulpo.app/llms.txt - Everything in one document: https://vulpo.app/llms-full.txt - All pages: https://vulpo.app/sitemap.xml