WhatsApp Integration
Sur Home Assistant 2026.11 ou une version ultérieure ? L’ouvrir dans la Marketplace
- Installations
- Non affichées : domaine partagé whatsapp
- Étoiles GitHub
- 53
- Connexion
- Fonctionne en local
- Maintenance
- Mise à jour au cours des 6 derniers mois
- Version
- v2.1.6,
- Catégorie
- Messagerie et notifications, Messageries instantanées
- Type
- Intégration de la Marketplace
- Marque
- Prérequis
- Nécessite la Marketplace (HACS sur Home Assistant 2026.10 et les versions antérieures)
- Domaine
whatsapp- Problèmes
- Signaler un problème
Annuaire indépendant, créé par le développeur de Vulpo. Non affilié à Home Assistant ni à l’Open Home Foundation.
À propos
WhatsApp Integration connecte Home Assistant à WhatsApp comme appareil associé, de la même manière que WhatsApp Web. Elle fonctionne en local et s’appuie sur une passerelle distincte, soit l’application Home Assistant, soit un conteneur Docker autonome, pour envoyer et recevoir des messages. Les actions permettent d’envoyer du texte, des documents, des vidéos, des fichiers audio, des contacts, des messages de liste, des boutons, des réactions et des événements de groupe, ainsi que de modifier ou révoquer des messages envoyés. Les messages entrants, les clics sur des boutons et les votes de sondage peuvent déclencher des automatisations. Elle propose aussi la modération de groupe avec captchas, avertissements et un bouclier anti-raid, ainsi qu’un pont qui reflète les messages vers Telegram. Des capteurs suivent les messages envoyés, reçus et échoués, des interrupteurs activent la modération, le pont et la réponse automatique, et des avis de correction signalent les problèmes de connexion ou de session. La configuration se fait dans l’interface.
Résumé automatique du README et du code de FaserF/ha-whatsapp, traduit automatiquement. Une erreur, ou tu maintiens ce projet et tu veux ton propre texte ici ? Prendre contact
Prise en charge
Fonctionne en local Communique avec tes appareils sur ton propre réseau. Aucun cloud de fournisseur entre les deux.
Détection automatique Home Assistant la repère sur le réseau et propose de l’ajouter.
Depuis la Marketplace S’installe depuis la Marketplace, anciennement HACS.
Maintenance active Son auteur a publié une version ou poussé une modification au cours des six derniers mois.
Fournit
- Interrupteurs
- Capteurs
Mise en place
Installe-la depuis la Marketplace et redémarre Home Assistant, puis ajoute-la dans Paramètres > Appareils et services.
Connecter WhatsApp Integration
- URL de l’hôte de l’application
- Jeton d’API (depuis l’interface de l’application)
Installer l’application officielle
- Version de l’application
Scanner le code QR
- Demander un nouveau code QR
- Associer avec un numéro de téléphone à la place
Associer avec un numéro de téléphone
- Numéro de téléphone (avec indicatif du pays, par exemple 49151...)
Clé d’accès WhatsApp requise
- Essayer l’option 2 : approuver la clé d’accès sur le téléphone (expérimental)
Session existante trouvée
- Comment veux-tu continuer ?
Après la mise en place
- Déboguer les charges utiles (journaliser les événements entrants)
- Intervalle d’interrogation (secondes)
- Masquer les données sensibles dans les journaux
- Marquer les messages comme lus (envoyer les coches bleues)
- Clé d’API
- Nombre de nouvelles tentatives (en cas d’échec)
- Traiter les messages de soi-même (solution de repli héritée ; l’événement message_sent est recommandé)
- Émuler les boutons via des sondages (convertit send_buttons en sondages natifs et déclenche des événements de bouton lors du vote)
- Réinitialiser la session (déconnexion et effacement des données)
Textes issus du code de FaserF/ha-whatsapp. Les textes que le dépôt ne fournit pas en français ont été traduits automatiquement.
Entités
- Capteurs binairesConnexion, Moteur de modération WhatsApp, État du pont Telegram
- BoutonsTest de diagnostic, Redémarrer la session WhatsApp
- NotificationsWhatsApp Integration
- CapteursMessages envoyés, Messages reçus, Messages échoués, Version de WhatsApp, Numéro de téléphone, Discussions, Avertissements de modération actifs, État du bouclier anti-raid, Vérifications de captcha en attente
- InterrupteursMoteur de modération, Pont Telegram, Réponse automatique
Actions
- Envoyer un messageEnvoie un message texte à un numéro WhatsApp.Champs : Message, Numéro de destination, Compte, ID du message à citer, ID du message auquel répondre, Expiration (secondes)
- Envoyer un documentEnvoie un document (PDF, Zip, Doc, etc.) à un numéro WhatsApp.Champs : Numéro de destination, URL, Nom du fichier, Légende
- Envoyer une vidéoEnvoie un fichier vidéo à un numéro WhatsApp.Champs : Numéro de destination, URL, Légende
- Envoyer un fichier audioEnvoie un fichier audio ou un message vocal.Champs : Numéro de destination, URL, Message vocal (PTT), Compte
- Révoquer un messageSupprime un message envoyé pour tout le monde.Champs : Numéro de destination, ID du message
- Modifier un messageModifie le texte d’un message envoyé.Champs : Numéro de destination, ID du message, Nouveau texte
- Envoyer un message de listeEnvoie une liste interactive (menu d’actions).Champs : Numéro de destination, Titre, Texte du corps, Libellé du bouton, Sections (JSON)
- Envoyer un contactEnvoie une carte de contact (VCard).Champs : Numéro cible, Nom affiché, Numéro du contact
- Configurer le webhookDéfinit l'URL du webhook vers laquelle l'application envoie les événements.Champs : URL du webhook, Activé, Jeton
- Envoyer une réactionRéagit à un message avec un emoji.Champs : Réaction, Numéro cible, Identifiant du message
- Mettre à jour la présenceMet à jour ton statut de présence (par exemple en train d'écrire).Champs : Présence, Numéro cible
- Envoyer des boutonsEnvoie un message avec des boutons interactifs.Champs : Numéro cible, Message, Boutons, Pied de message
- Envoyer un événementEnvoie un message interactif d'événement de groupe WhatsApp.Champs : Compte, Numéro cible / Identifiant du groupe, Nom de l'événement, Description, Date et heure, Lieu, Lien pour rejoindre, Est annulé, Expiration (secondes)
Dépannage
- DiagnosticsTélécharge un fichier de diagnostics à joindre à un rapport de bug.
Extrait du 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…
S’affiche dans Vulpo :
carte Bascule rapide, carte Bouton, carte Graphique, Apple Watch, centre de contrôle.Informations
- Installations
- Non affichées : domaine partagé whatsapp
- Étoiles GitHub
- 53
- Connexion
- Fonctionne en local
- Maintenance
- Mise à jour au cours des 6 derniers mois
- Version
- v2.1.6,
- Catégorie
- Messagerie et notifications, Messageries instantanées
- Type
- Intégration de la Marketplace
- Marque
- Prérequis
- Nécessite la Marketplace (HACS sur Home Assistant 2026.10 et les versions antérieures)
- Domaine
whatsapp- Problèmes
- Signaler un problème
