Skip to content

The agent that grows with you

1.9 KB
Raw Blame
name: whatsapp-agent-platform
repo: https://github.com/ahtishamdilawar/hermes-whatsapp-agent-platform
sha: 3a57b1da04499279d1af6c7d979c9c2d8b658ce0
version: "0.2.1"
requires_hermes: ">=0.21.4"
title: WhatsApp Agent Platform
description: >-
  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. Disclosure — 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.
maintainer: ahtishamdilawar
tier: community
category: platform
docs_url: https://github.com/ahtishamdilawar/hermes-whatsapp-agent-platform/blob/3a57b1da04499279d1af6c7d979c9c2d8b658ce0/README.md
platforms: []
capabilities:
  provides_tools: []
  provides_hooks: []
  provides_middleware: []
  requires_env:
    - WHATSAPP_AGENT_PLATFORM_API_KEY