WhatsApp Bridge Integration for Home Assistant 🚀

This is the custom integration for the Bahmcloud WhatsApp Bridge. It allows you to manage multiple WhatsApp accounts as Home Assistant services, making it incredibly easy to send automated messages via YAML or Node-RED.

🛠️ Installation

1. Prerequisite: The Add-on

Before installing this integration, ensure that the WhatsApp Bridge Add-on is installed and running.

[Link to your Add-on Repository]
Open the Add-on Web UI and scan the QR code to link your WhatsApp account.

2. Install the Integration

Copy the folder whatsapp_bridge_integration into your Home Assistant config/custom_components/ directory.
Restart Home Assistant.
Go to Settings -> Devices & Services.
Click Add Integration and search for "WhatsApp Bridge Integration".

📖 How to use

Once installed, the integration provides a new service (action) that you can use in any automation.

Send a Message via YAML

You can call the service directly in your automations:

action: whatsapp_bridge_integration.send_message
data:
  number: "491701234567"
  message: "The washing machine is finished! 🧺"

Use in Node-RED

Add a Call Service (or Action) node.

Domain: whatsapp_bridge_integration

Service: send_message

Data:

{
  "number": "491701234567",
  "message": "{{payload}}"
}

👥 Multi-Account Support (Coming Soon)

We are currently working on a UI-based configuration flow so you can save "Account Aliases" (like "Dad", "Work", "Security") and select them from a dropdown menu without typing the phone number every time.

##⚠️ Important Notes Phone Numbers: Always use the international format without + or 00 (e.g., 49... for Germany).

Local Network: The integration communicates locally with the Add-on on port 3000.

Developed by Bahmcloud

1.8 KiB Raw Blame History