--- title: "WhatsApp Gateway" description: "WhatsApp Gateway is an app for Home Assistant. It has 564 installs sharing analytics and was last updated October 27, 2026." canonical: "https://vulpo.app/integrations/apps/whatsapp" url: "https://vulpo.app/integrations/apps/whatsapp.md" last-updated: "2026-10-25" version: "1.4" --- # WhatsApp Gateway > WhatsApp Gateway is an app for Home Assistant. It has 564 installs sharing analytics and was last updated October 27, 2026. WhatsApp Gateway is an app that runs a Baileys-based Node.js backend to connect Home Assistant with WhatsApp. It works as a bridge: the WhatsApp custom component connects to it over HTTP, and the app talks to WhatsApp Web. Poll votes in WhatsApp fire a message-received event of type poll update, which automations can react to. The app also includes a group moderation, defender and command engine. Its web interface opens from the sidebar and can be protected with a username and password. It needs Home Assistant OS, runs on aarch64 and amd64, uses the host network and can access the Supervisor API. Automatic summary of the docs and configuration of FaserF/hassio-addons. Something wrong, or are you the maintainer and want your own text here? [Get in touch](https://vulpo.app/contact) [Open in My Home Assistant](https://my.home-assistant.io/redirect/supervisor_app/?app=605cee21_whatsapp&repository_url=https%3A%2F%2Fgithub.com%2FFaserF%2Fhassio-addons) Apps need Home Assistant OS. Container and Core installs cannot run them. ## Supports - **Opens in the sidebar**: Its own page opens inside Home Assistant. - **Actively maintained**: Its author released or pushed a change in the last six months. ## Setting it up Add its app repository under Settings, Apps, then install and start it. ## From the docs > Home Assistant WhatsApp Backend (Baileys/Node.js) From the docs of [FaserF/hassio-addons](https://github.com/FaserF/hassio-addons/blob/HEAD/whatsapp/DOCS.md), [MIT License](https://spdx.org/licenses/MIT.html). Shortened. ## Permissions - **Host network**: Uses the host's network directly instead of its own. - **Supervisor API**: Can talk to the Supervisor, which manages apps and the system. ## Network - `8066/tcp`: Internal API port the integration connects to. ## Configuration - **Log Level**: Controls the verbosity of the logs. - **Reset Session**: ⚠️ DANGER: Enabling this will delete your WhatsApp session data on the next startup. The toggle will automatically disable itself after reset. - **Mask Sensitive Data**: If enabled, phone numbers in logs will be partially hidden (e.g. 4917\*123). Useful when sharing logs. - **Send Timeout (ms)**: Time in milliseconds to wait for a WhatsApp acknowledgement before timing out (Default: 25000). - **Keep-Alive Interval (ms)**: How often (in ms) to check the connection to detect stale connections (Default: 30000). - **Webhook Enabled**: If enabled, incoming WhatsApp messages will be forwarded to the specified Webhook URL. - **Webhook URL**: The destination URL for forwarded messages (e.g. your Rocket.Chat app endpoint). - **Webhook Token**: A secret token sent with the webhook request (X-Webhook-Token header) to secure the communication. - **UI Authentication**: Enables Basic Authentication for the Web UI (Port 8066). Recommeded if exposed to the internet. - **UI Password**: The password for the Web UI (Username is always 'admin'). - **Media Folder**: Path to a public folder (e.g. /media/whatsapp) to save received media. If set, automatic cleanup is DISABLED. - **Mark Online**: Whether to mark the bot as online in WhatsApp. - **Admin Notifications**: If enabled, the bot will send connection status and failure notifications to the listed admin numbers. - **Admin Phone Numbers**: A comma-separated list of phone numbers (with country code, e.g. 491701234567) that should receive admin notifications. - **Welcome Message**: Whether to send a one-time welcome message to users who message the bot for the first time. ## At a glance - Kind: App - Number: 564 installs sharing analytics - Connection: Connection not stated - Upkeep: Updated in the last 6 months - Needs: Needs Home Assistant OS - Runs on: 64-bit ARM, x86-64 - Latest version: 2.1.7, last updated October 27, 2026 - Source: Independent directory, made by the developer of Vulpo. Not affiliated with Home Assistant or the Open Home Foundation. [About these numbers](https://vulpo.app/integrations/about) Last updated 2026-10-25. Source: https://vulpo.app/integrations/apps/whatsapp --- - HTML version of this page: https://vulpo.app/integrations/apps/whatsapp - Site index for agents: https://vulpo.app/llms.txt - Everything in one document: https://vulpo.app/llms-full.txt - All pages: https://vulpo.app/sitemap.xml