whatsapp-agent-platform.yaml 1.9 KB

1234567891011121314151617181920212223242526272829303132
  1. name: whatsapp-agent-platform
  2. repo: https://github.com/ahtishamdilawar/hermes-whatsapp-agent-platform
  3. sha: 3a57b1da04499279d1af6c7d979c9c2d8b658ce0
  4. version: "0.2.1"
  5. requires_hermes: ">=0.21.4"
  6. title: WhatsApp Agent Platform
  7. description: >-
  8. Community platform plugin (not affiliated with Meta or Nous Research) connecting a WhatsApp Agent to
  9. Hermes through Meta's WhatsApp Agent Platform API (/agent/v1): long-poll inbound (no public URL),
  10. text and media. Disclosure — sends the API key and message content, files included, only to Meta:
  11. api.whatsapp.com, plus lookaside.fbsbx.com for downloads (per WhatsApp's Third-Party Agents Terms,
  12. agent chats are not end-to-end encrypted); stores the poll cursor, recent message ids and the
  13. creator's id under HERMES_HOME; no other network egress, no telemetry, no self-update. Exception:
  14. Hermes fetches image URLs in replies (SSRF-guarded, no key), revealing the server's IP to that host.
  15. Files go only to the creator; Meta keeps uploads up to 30 days. Received files are cached under
  16. HERMES_HOME (deleted after ~24 h while the gateway runs) and may reach the configured model, vision
  17. or speech-to-text provider. WHATSAPP_AGENT_PLATFORM_MEDIA_ENABLED=false disables media. By default
  18. only the agent's creator (verified through Meta's API) can message Hermes;
  19. WHATSAPP_AGENT_PLATFORM_ALLOWED_USERS or WHATSAPP_AGENT_PLATFORM_ALLOW_ALL_USERS widens that
  20. explicitly. The agent API key is saved to the Hermes .env; the state file under HERMES_HOME is 0600
  21. and never contains the key.
  22. maintainer: ahtishamdilawar
  23. tier: community
  24. category: platform
  25. docs_url: https://github.com/ahtishamdilawar/hermes-whatsapp-agent-platform/blob/3a57b1da04499279d1af6c7d979c9c2d8b658ce0/README.md
  26. platforms: []
  27. capabilities:
  28. provides_tools: []
  29. provides_hooks: []
  30. provides_middleware: []
  31. requires_env:
  32. - WHATSAPP_AGENT_PLATFORM_API_KEY