WhatsApp Integration voor Home Assistant (Marketplace-integratie)

Installaties: Niet getoond: gedeeld domein whatsapp
GitHub-sterren: 53
Verbinding: Werkt lokaal
Onderhoud: Bijgewerkt in de afgelopen 6 maanden
Versie: v2.1.6, 27 oktober 2026
Categorie: Berichten en meldingen, Chatapps
Soort: Marketplace-integratie
Merk: WhatsApp
Vereist: Vereist de Marketplace (HACS op 2026.10 en ouder)
Domein: whatsapp
Bron: github.com/FaserF/ha-whatsapp
Problemen: Probleem melden

Onafhankelijk overzicht, gemaakt door de ontwikkelaar van Vulpo. Niet gelieerd aan Home Assistant of de Open Home Foundation.

Over dit item

WhatsApp Integration verbindt Home Assistant met WhatsApp als gekoppeld apparaat, op dezelfde manier als WhatsApp Web. Het werkt lokaal en gebruikt een aparte gateway, de Home Assistant app of een losse Docker-container, om berichten te verzenden en te ontvangen. Acties omvatten het verzenden van tekst, documenten, video, audio, contacten, lijstberichten, knoppen, reacties en groepsgebeurtenissen, en het bewerken of intrekken van verzonden berichten. Binnenkomende berichten, klikken op knoppen en stemmen in peilingen kunnen automatiseringen starten. Ook biedt het groepsmoderatie met captcha's, waarschuwingen en een anti-raidbeveiliging, en een brug die berichten naar Telegram spiegelt. Sensoren houden verzonden, ontvangen en mislukte berichten bij, schakelaars zetten moderatie, de brug en de automatische beantwoorder aan of uit, en reparatiemeldingen wijzen op problemen met de verbinding of sessie. De installatie gebeurt in de gebruikersinterface.

Automatische samenvatting van de README en de code van FaserF/ha-whatsapp, automatisch vertaald. Klopt er iets niet, of ben je de maintainer en wil je hier je eigen tekst tonen? Neem contact op

Ondersteunt

Werkt lokaal Praat met je apparaten op je eigen netwerk. Geen cloud van de aanbieder ertussen.
Wordt vanzelf gevonden Home Assistant vindt het op het netwerk en biedt aan om het toe te voegen.
Uit de Marketplace Wordt geïnstalleerd via de Marketplace, voorheen HACS.
Actief onderhouden De auteur heeft in de afgelopen zes maanden een release of wijziging gepubliceerd.

Levert

Schakelaars
Sensoren

Instellen

Installeer de integratie vanuit de Marketplace en herstart Home Assistant. Voeg de integratie daarna toe onder Instellingen > Apparaten en diensten.

WhatsApp Integration verbinden

Add-on host-URL
API-token (uit de Add-on-interface)

Officiële add-on installeren

Add-onversie

QR-code scannen

Nieuwe QR-code aanvragen
In plaats daarvan koppelen met telefoonnummer

Koppelen met telefoonnummer

Telefoonnummer (met landcode, bijvoorbeeld 49151...)

WhatsApp-passkey vereist

Probeer optie 2: passkey goedkeuren op de telefoon (experimenteel)

Bestaande sessie gevonden

Hoe wil je verdergaan?

Na het instellen

Debug-payloads (binnenkomende gebeurtenissen loggen)
Pollinginterval (seconden)
Gevoelige gegevens in logs maskeren
Berichten als gelezen markeren (blauwe vinkjes verzenden)
API-sleutel
Aantal nieuwe pogingen (bij een fout)
Toegestane Users/groepen (kommagescheiden telefoonnummers of groeps-ID's. Leeg laten voor geen whitelist)
Berichten van jezelf verwerken (oude terugvaloptie; de gebeurtenis message_sent wordt aanbevolen)
Knoppen nabootsen via peilingen (zet send_buttons om naar native peilingen en activeert knopgebeurtenissen bij een stem)
Sessie resetten (uitloggen en gegevens wissen)

Teksten uit de code van FaserF/ha-whatsapp. Teksten waarvoor de repository geen Nederlandse vertaling heeft, zijn automatisch vertaald.

Entiteiten

Binaire sensorenVerbinding, WhatsApp-moderatie-engine, Status Telegram-brug
KnoppenDiagnostische test, WhatsApp-sessie herstarten
MeldingenWhatsApp Integration
SensorenVerzonden berichten, Ontvangen berichten, Mislukte berichten, WhatsApp-versie, Telefoonnummer, Chats, Actieve moderatiewaarschuwingen, Status anti-raidbeveiliging, Openstaande captcha-verificaties
SchakelaarsModeratie-engine, Telegram-brug, Automatische beantwoorder

Acties

Bericht verzendenVerzendt een tekstbericht naar een WhatsApp-nummer.Velden: Bericht, Doelnummer, Account, Bericht-ID om te citeren, Antwoord op bericht-ID, Verlooptijd (seconden)
Document verzendenVerzendt een document (PDF, Zip, Doc, enzovoort) naar een WhatsApp-nummer.Velden: Doelnummer, URL, Bestandsnaam, Bijschrift
Video verzendenVerzendt een videobestand naar een WhatsApp-nummer.Velden: Doelnummer, URL, Bijschrift
Audio verzendenVerzendt een audiobestand of spraakbericht.Velden: Doelnummer, URL, Spraakbericht (PTT), Account
Bericht intrekkenVerwijdert een verzonden bericht voor iedereen.Velden: Doelnummer, Bericht-ID
Bericht bewerkenBewerkt de tekst van een verzonden bericht.Velden: Doelnummer, Bericht-ID, Nieuwe tekst
Lijstbericht verzendenVerzendt een interactieve lijst (actiemenu).Velden: Doelnummer, Titel, Berichttekst, Knoplabel, Secties (JSON)
Contact verzendenVerzendt een contactkaart (VCard).Velden: Doelnummer, Weergavenaam, Contactnummer
Webhook configurerenStelt de webhook-URL in waarnaar de Addon gebeurtenissen pusht.Velden: Webhook-URL, Ingeschakeld, Token
Reactie verzendenReageert met een emoji op een bericht.Velden: Reactie, Doelnummer, Bericht-ID
Aanwezigheid bijwerkenWerkt je aanwezigheidsstatus bij (bijvoorbeeld typen).Velden: Aanwezigheid, Doelnummer
Knoppen verzendenVerzendt een bericht met interactieve knoppen.Velden: Doelnummer, Bericht, Knoppen, Voettekst
Gebeurtenis verzendenVelden: Account, Doelnummer / Groeps-ID, Naam van gebeurtenis, Beschrijving, Datum en tijd, Locatie, Deelnamelink, Is geannuleerd, Verloop (seconden)

Probleemoplossing

DiagnostiekDownloadt een diagnostiekbestand om aan een bugmelding toe te voegen.
ReparatiemeldingenMeldingen die het kan tonen onder Instellingen > Reparaties:Verbinding met WhatsApp Addon mislukt, WhatsApp-sessie verlopen, WhatsApp-verbinding onderbroken, WhatsApp Passkey vereist, actie nodig

Uit de 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…

Uit de README van FaserF/ha-whatsapp, MIT License. Ingekort.