62 lines
1.8 KiB
Markdown
62 lines
1.8 KiB
Markdown
# 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
|
|
1. Copy the folder `whatsapp_bridge_integration` into your Home Assistant `config/custom_components/` directory.
|
|
2. Restart Home Assistant.
|
|
3. Go to **Settings** -> **Devices & Services**.
|
|
4. 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:
|
|
|
|
```yaml
|
|
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:
|
|
|
|
```JSON
|
|
{
|
|
"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
|
|
|
|
--- |