Hermes WhatsApp Agent Platform for Hermes Agent

Hermes Agent gateway plugin for Meta's WhatsApp Agent Platform using outbound long polling

What Hermes WhatsApp Agent Platform does

The plugin polls Meta's /agent/v1 API for updates and posts replies back, so no public URL or webhook is needed. The README compares it with the other WhatsApp options in Hermes: the Baileys bridge, which is an unofficial WhatsApp Web link, and the whatsapp_cloud plugin, which uses the Business Cloud API with a webhook. This plugin needs an agent created in WhatsApp and its API key.

By default only the agent's creator can chat with it. The plugin confirms the creator with Meta before handing a message to Hermes and drops anything else, and the README notes that Meta currently lets an agent send only to its creator. Supported features include text, quoted replies, read receipts, typing indicators, slash commands, and photos, voice notes, audio, video, documents and stickers inbound. The platform cannot edit messages and allows 12 sends per minute, so the README recommends turning off tool progress and interim messages in config.yaml. The plugin is in the official Hermes plugin catalog.

Key features

Outbound long polling, so no public URL is needed
Creator verification before any message reaches Hermes
Media in: photos, voice notes (transcribed by Hermes), audio, video, documents and stickers
Quoted replies, read receipts and typing indicator
Environment variables for allowed users, home channel and media toggle

When to use it

Chatting with your Hermes agent from the WhatsApp Agents feature
Receiving cron and scheduled messages from Hermes in WhatsApp
Sending photos or voice notes to your agent

Who it is for: Hermes Agent users who have access to Meta's WhatsApp Agents beta and want a first-party-API route to WhatsApp.

How it fits with Hermes Agent

It is a Hermes Agent gateway plugin, installable by name from the Hermes plugin catalog and configured through hermes gateway setup.

How to install Hermes WhatsApp Agent Platform

These commands are copied from the project's README. Check the repository for the latest steps before you run them.

hermes plugins install whatsapp-agent-platform
hermes gateway restart

Requirements: Hermes Agent 0.21.4 or newer (the PyPI hermes-agent 0.19.0 package is not supported) and a WhatsApp account with the Agents feature and an agent API key

Note: Under Meta's current beta, only the agent's creator can chat with the agent.

FAQ

What is Hermes WhatsApp Agent Platform?

Hermes WhatsApp Agent Platform is a Hermes Agent plugin that connects to Meta's WhatsApp Agent Platform API. It lets the agent's creator chat with Hermes inside WhatsApp.

Does Hermes WhatsApp Agent Platform work with Hermes Agent?

Yes, it requires Hermes Agent 0.21.4 or newer and installs with hermes plugins install whatsapp-agent-platform. It is a community plugin and the README states it is not affiliated with Meta, WhatsApp or Nous Research.

How do I install Hermes WhatsApp Agent Platform?

Run hermes plugins install whatsapp-agent-platform, create an agent in WhatsApp under Settings, Agents, and store its API key as WHATSAPP_AGENT_PLATFORM_API_KEY. Then run hermes gateway restart.