# 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

---