name: whatsapp-platform
label: WhatsApp
kind: platform
version: 1.0.0
description: >
  WhatsApp gateway adapter for Hermes Agent.
  Connects to WhatsApp via a local Node.js bridge (WhatsApp Web client) over
  an HTTP API and relays messages between WhatsApp chats and the Hermes agent.
  Supports DM/group policies, mention gating, free-response chats, and
  per-user allowlists.
author: NousResearch
requires_env:
  - name: WHATSAPP_ENABLED
    description: "Enable the WhatsApp adapter (requires the Node.js bridge running)"
    prompt: "Enable WhatsApp? (true/false)"
    password: false
optional_env:
  - name: WHATSAPP_ALLOWED_USERS
    description: "Comma-separated WhatsApp user IDs allowed to talk to the bot"
    prompt: "Allowed users (comma-separated)"
    password: false
  - name: WHATSAPP_ALLOW_ALL_USERS
    description: "Allow any WhatsApp user to trigger the bot (dev only)"
    prompt: "Allow all users? (true/false)"
    password: false
  - name: WHATSAPP_HOME_CHANNEL
    description: "Default chat ID for cron / notification delivery"
    prompt: "Home channel ID"
    password: false
  - name: WHATSAPP_HOME_CHANNEL_NAME
    description: "Display name for the WhatsApp home channel"
    prompt: "Home channel display name"
    password: false