WhatsApp Integration für Home Assistant (Marketplace-Integration)

Installationen: Nicht angezeigt: gemeinsame Domain whatsapp
GitHub-Sterne: 53
Verbindung: Funktioniert lokal
Pflege: In den letzten 6 Monaten aktualisiert
Version: v2.1.6, 27. Oktober 2026
Kategorie: Kommunikation und Benachrichtigungen, Chat-Apps
Art: Marketplace-Integration
Marke: WhatsApp
Voraussetzung: Braucht den Marketplace (HACS bis Home Assistant 2026.10)
Domain: whatsapp
Quelle: github.com/FaserF/ha-whatsapp
Probleme: Problem melden

Unabhängiges Verzeichnis, erstellt vom Entwickler von Vulpo. Steht in keiner Verbindung zu Home Assistant oder der Open Home Foundation.

Überblick

WhatsApp Integration verbindet Home Assistant als verknüpftes Gerät mit WhatsApp, so wie es auch WhatsApp Web tut. Sie arbeitet lokal und nutzt zum Senden und Empfangen von Nachrichten ein separates Gateway, entweder die Home Assistant App oder einen eigenständigen Docker-Container. Die Aktionen umfassen das Senden von Text, Dokumenten, Videos, Audio, Kontakten, Listennachrichten, Tasten, Reaktionen und Gruppenereignissen sowie das Bearbeiten oder Widerrufen gesendeter Nachrichten. Eingehende Nachrichten, Tastenklicks und Umfragestimmen können Automationen auslösen. Außerdem bietet sie Gruppenmoderation mit Captchas, Verwarnungen und einem Anti-Raid-Schutz sowie eine Bridge, die Nachrichten zu Telegram spiegelt. Sensoren erfassen gesendete, empfangene und fehlgeschlagene Nachrichten, Schalter schalten Moderation, Bridge und automatische Antworten um, und Reparaturhinweise melden Verbindungs- oder Sitzungsprobleme. Die Einrichtung erfolgt in der Benutzeroberfläche.

Zusammenfassung der README und des Codes von FaserF/ha-whatsapp, automatisch erstellt und übersetzt. Stimmt etwas nicht, oder betreust du das Projekt und möchtest hier deinen eigenen Text? Melde dich

Unterstützt

Funktioniert lokal Spricht mit deinen Geräten in deinem eigenen Netzwerk. Keine Cloud des Herstellers dazwischen.
Wird automatisch erkannt Home Assistant entdeckt sie im Netzwerk und bietet an, sie hinzuzufügen.
Aus dem Marketplace Wird über den Marketplace installiert, früher HACS.
Aktiv gepflegt Das Projekt hat in den letzten sechs Monaten eine neue Version oder Änderung veröffentlicht.

Stellt bereit

Schalter
Sensoren

Einrichtung

Installiere sie aus dem Marketplace und starte Home Assistant neu. Füge sie dann unter Einstellungen > Geräte & Dienste hinzu.

WhatsApp Integration verbinden

Add-on-Host-URL
API Token (aus Addon UI)

Offizielles Add-on installieren

Add-on-Version

QR-Code scannen

Neuen QR-Code anfordern
Stattdessen mit Telefonnummer koppeln

Mit Telefonnummer koppeln

Telefonnummer (mit Ländercode, z.B. 49151...)

WhatsApp Passkey benötigt

Option 2 versuchen: Passkey auf dem Handy freigeben (experimentell)

Bestehende Sitzung gefunden

Wie möchtest du fortfahren?

Nach der Einrichtung

Debug Payloads (Eingehende Events im HA Log protokollieren)
Abfrageintervall (Sekunden)
Sensible Daten in Logs maskieren
Nachrichten als gelesen markieren (blaue Haken senden)
API Schlüssel
Wiederholungsversuche (bei Fehlern)
Whitelist für Benutzer/Gruppen (Kommagetrennte Telefonnummern oder Gruppen-IDs. Leer lassen für keine Whitelist)
Nachrichten von sich selbst verarbeiten (Legacy-Fallback; message_sent Event empfohlen)
Buttons über Umfragen emulieren (Sendet Buttons automatisch als native Umfrage und feuert Button-Events bei Abstimmung)
Sitzung zurücksetzen (Abmelden und Addon-Daten löschen)

Texte aus dem Code von FaserF/ha-whatsapp. Texte, für die das Repository keine Übersetzung hat, wurden automatisch übersetzt.

Entitäten

BinärsensorenVerbindung, WhatsApp Moderations-Engine, Telegram Bridge Status
TastenDiagnose-Test, WhatsApp-Sitzung neu starten
BenachrichtigungsdiensteWhatsApp Integration
SensorenGesendete Nachrichten, Empfangene Nachrichten, Fehlgeschlagene Nachrichten, WhatsApp Version, Telefonnummer, Chats, Aktive Moderations-Verwarnungen, Anti-Raid Schutz-Status, Ausstehende Captcha-Verifizierungen
SchalterModeration Engine, Telegram-Brücke, Auto-Responder

Aktionen

Nachricht sendenSendet eine Textnachricht an eine WhatsApp-Nummer.Felder: Nachricht, Zielnummer, Konto, Zitierte Nachricht-ID, Antwort auf Nachricht-ID, Ablaufzeit (Sekunden)
Dokument sendenSendet ein Dokument (PDF, Zip, Doc usw.) an eine WhatsApp-Nummer.Felder: Zielnummer, URL, Dateiname, Bildunterschrift
Video sendenSendet eine Videodatei an eine WhatsApp-Nummer.Felder: Zielnummer, URL, Bildunterschrift
Audio sendenSendet eine Audiodatei oder Sprachnachricht.Felder: Zielnummer, URL, Sprachnachricht (PTT), Konto
Nachricht zurückrufenLöscht eine gesendete Nachricht für alle.Felder: Zielnummer, Nachricht-ID
Nachricht bearbeitenBearbeitet den Text einer gesendeten Nachricht.Felder: Zielnummer, Nachricht-ID, Neuer Text
Listen-Nachricht sendenSendet eine interaktive Liste (Aktionsmenü).Felder: Zielnummer, Titel, Haupttext, Button-Label, Sektionen (JSON)
Kontakt sendenSendet eine Visitenkarte (VCard).Felder: Zielnummer, Anzeigename, Kontaktnummer
Webhook konfigurierenRichtet die Webhook-URL ein, an die das Addon Ereignisse sendet.Felder: Webhook-URL, Aktiviert, Token
Reaktion sendenReagiert auf eine Nachricht mit einem Emoji.Felder: Reaktion, Zielnummer, Nachricht-ID
Status aktualisierenAktualisiert deinen Anwesenheitsstatus (z. B. schreibt...).Felder: Status, Zielnummer
Buttons sendenSendet eine Nachricht mit interaktiven Buttons.Felder: Zielnummer, Nachricht, Buttons, Fußzeile
Event sendenSendet eine interaktive WhatsApp-Gruppeneinladung.Felder: Konto, Zielnummer / Gruppen-ID, Event-Name, Beschreibung, Datum & Uhrzeit, Ort, Teilnahmelink, Ist storniert, Ablaufzeit (Sekunden)

Fehlerbehebung

DiagnosedatenLädt eine Diagnosedatei herunter, die du an einen Fehlerbericht anhängen kannst.
ReparaturhinweiseMögliche Hinweise unter Einstellungen > Reparaturen:Verbindung zum WhatsApp-Addon fehlgeschlagen, WhatsApp-Sitzung abgelaufen, WhatsApp-Verbindung unterbrochen, WhatsApp Passkey benötigt — Aktion erforderlich

Aus der README

Connect your Home Assistant instance directly to WhatsApp using the "Linked Devices" (Web) protocol. No Business API required. 🚀
Requires the Home Assistant App OR the Standalone Docker Gateway (whatsapp-gw) to function. This integration communicates with the Gateway (App or Standalone Container) to send and receive messages.
📲 Local & Private: Acts as a "Linked Device" (like WhatsApp Web). No cloud bridge, no external servers.
💬 Rich Messaging: Send Text, Images, Videos, Audio (PTT), Documents, and Locations.
📊 Interactive Content: Send Polls, Buttons, and List Menus to interact with users.
🔄 Two-Way Communication: React to incoming messages, button clicks, and poll votes.
🛡️ Modern Standards: Fully compatible with the Home Assistant notify standard (ADR-0010).
📝 Message Management: Edit or Revoke (delete) messages after sending.
🕵️ Discovery Tools: Built-in service to find Group IDs without checking logs.
🤖 Automation Triggers: Real-time events for everything happening on WhatsApp.
🛡️ Native Control: Built-in commands (ha-app-*) to check status, restart, or run diagnostics directly via WhatsApp.
🛡️ Group Moderation & Defender: Comprehensive group defender, welcome/goodbye messages with departure reasons, captchas (Group & Private DM resolution with Web UI status dashboard), configurable…

Aus der README von FaserF/ha-whatsapp, MIT License. Gekürzt.