[Add-on] WAHA — WhatsApp HTTP API for Home Assistant

Share your Projects!
1

Hi everyone,

I wanted to share a Home Assistant add-on I built that lets you send and receive WhatsApp messages directly from your automations — no cloud service,
no subscription, runs entirely on your own hardware.

What is it?

WAHA (WhatsApp HTTP API) is a self-hosted REST API for WhatsApp. This add-on wraps WAHA as a native Home Assistant add-on so you can:

  • Send WhatsApp messages from any automation
  • Receive incoming WhatsApp messages as HA webhook triggers
  • Control everything via REST API from rest_command
  • Run it on a Raspberry Pi 4/5 or any x86 machine

No paid subscription. No external service. Everything stays on your network.

Installation

  1. Go to Settings → Apps → Install App → Respositories(triple dot - top right) → Add

  2. Add https://github.com/sushiljain1989/hassio-addons

  3. Find WAHA WhatsApp in the store and click Install

  4. Start the add-on(See Docs)

Send a WhatsApp message from an automation

Add to configuration.yaml:

rest_command:
send_whatsapp:
url: "http://localhost:3000/api/sendText"
method: POST
headers:
Content-Type: application/json
X-Api-Key: "your-api-key"
payload: '{"chatId": "{{ phone }}@c.us", "text": "{{ message }}", "session": "default"}'

Then use it in any automation:

  • alias: "Notify on motion"
    trigger:
    • platform: state
      entity_id: binary_sensor.garden_motion
      to: "on"
      action:
    • service: rest_command.send_whatsapp
      data:
      phone: "491234567890"
      message: "Motion detected in the garden!"

Receive WhatsApp messages as HA triggers

Set the webhook URL in the add-on config:

WHATSAPP_HOOK_URL=http://homeassistant:8123/api/webhook/whatsapp_incoming
WHATSAPP_HOOK_EVENTS=message

Then create a webhook automation in HA and trigger it from any incoming WhatsApp message.

Supported hardware

┌──────────────┬────────────────────────────────┐
│ Architecture │ Device │
├──────────────┼────────────────────────────────┤
│ aarch64 │ Raspberry Pi 4, Raspberry Pi 5 │
├──────────────┼────────────────────────────────┤
│ amd64 │ x86 PC, Intel NUC, VM │
└──────────────┴────────────────────────────────┘

Links

:warning: Important Notice

This add-on uses an unofficial WhatsApp API and violates WhatsApp's Terms of Service. Your account may be banned. It is intended for personal,
non-commercial use only. Please read the full disclaimer in the repository before installing.

Happy to answer questions. Feedback and suggestions welcome!

1 Like
2

Interesting Project, which phone number does the recipient get shown? I don't see any linking to my own number in the setup process.

3

@lucianoj

  1. Open the dashboard
  2. Create session
  3. Start session
  4. Generate QR
  5. Scan with your Whatsapp
4

image
image1275×389 23.3 KB

5

@EndUser are you using Raspberry 4/5 or something else?

6

I transferred HA last week to a Beelink Mini PC .

7

That no longer exists. The term Add-on has stopped being used for several months now.
Users may want to use your software but be confused by your instructions and then require help from you to get them going.
I suggest fixing all this here, and if it is in the Git there also.

1 Like
8

@Sir_Goodenough I have updated the git doc.
@EndUser I would suggest you to follow the manual steps.

1 Like