HermesWatcher
Search⌘K For brandsSetup help
StartStart hereSetup plannerInstall Hermes AgentChat from your phoneYour first 24 hours
Use casesWorkflow blueprintsCase studiesUse-case collectionsCommunity libraryPrompt library
LearnWhat is Hermes Agent?GuidesTopicsFAQCommand cheat sheetGlossarySOUL.md gallery
ToolsTools & integrationsAll messaging platformsSkills directoryPlugins directorySkills, plugins & MCP
TroubleshootReleases
Work with usServicesNewsletterFor brands: partner with usFor AI agentsContactAboutFollow @HermesWatcher on X ↗ (opens in a new tab)

WhatsApp Agent Platform

Community platform plugin (not affiliated with Meta or Nous Research) connecting a WhatsApp Agent to Hermes through Meta's WhatsApp Agent Platform API (/agent/v1): long-poll inbound (no public URL), text and media.

Good to know before installing

Sends the API key and message content, files included, only to Meta: api.whatsapp.com, plus lookaside.fbsbx.com for downloads (per WhatsApp's Third-Party Agents Terms, agent chats are not end-to-end encrypted); stores the poll cursor, recent message ids and the creator's id under HERMES_HOME; no other network egress, no telemetry, no self-update. Exception: Hermes fetches image URLs in replies (SSRF-guarded, no key), revealing the server's IP to that host. Files go only to the creator; Meta keeps uploads up to 30 days. Received files are cached under HERMES_HOME (deleted after ~24 h while the gateway runs) and may reach the configured model, vision or speech-to-text provider. WHATSAPP_AGENT_PLATFORM_MEDIA_ENABLED=false disables media. By default only the agent's creator (verified through Meta's API) can message Hermes; WHATSAPP_AGENT_PLATFORM_ALLOWED_USERS or WHATSAPP_AGENT_PLATFORM_ALLOW_ALL_USERS widens that explicitly. The agent API key is saved to the Hermes .env; the state file under HERMES_HOME is 0600 and never contains the key.

From the plugin's catalog listing.

How to install

  1. Install it. Hermes asks for any API keys it needs (this one needs WHATSAPP_AGENT_PLATFORM_API_KEY), then asks whether to turn it on.
    hermes plugins install whatsapp-agent-platform
  2. Said no? Turn it on later:
    hermes plugins enable whatsapp-agent-platform
  3. Restart Hermes so it loads the plugin.

Some plugins also need a sign-in or settings: see Full setup & settings. Memory plugins ask whether to become your memory provider instead. Steps follow the official plugins guide (opens in a new tab).

Category
Chat apps & voice
Maintained by
ahtishamdilawar (Community)
Needs
WHATSAPP_AGENT_PLATFORM_API_KEY API key
Needs Hermes
0.21.4 or newer
Version
0.2.0
In the catalog
2026-09-26, updated 2026-10-02
GitHub stars
11

Full setup & settings ↗Source code ↗

More in chat apps & voice

All chat apps & voice plugins

New Hermes Agent updates every day on X. Follow @HermesWatcher

← All plugins