# Salesforce Chatter: Hermes Agent plugin

> Talk to Hermes from Salesforce Chatter: @mention the bot user in a post or comment, it Likes the message as an acknowledgement and replies in the same thread, keeping the thread as one session.

Canonical: https://hermeswatcher.com/plugins/salesforce-chatter  
Tier: Community  
Official page (Nous Research): https://hermes-agent.nousresearch.com/docs/plugins/salesforce-chatter  
Last updated in catalog: 2026-10-10

Talk to Hermes from Salesforce Chatter: @mention the bot user in a post or comment, it Likes the message as an acknowledgement and replies in the same thread, keeping the thread as one session. Images and files on the post are passed to the model; MEDIA files are attached back. Community plugin, not affiliated with Salesforce.

## Good to know before installing

Authenticates as a dedicated bot user with the OAuth 2.0 JWT bearer flow, reading the private key file at SF_CHATTER_PRIVATE_KEY_PATH; talks to the configured Salesforce login host and the org instance (attachment downloads follow Salesforce redirects); image URLs in the agent's replies are fetched from the gateway host over HTTPS (any public host; private, loopback and metadata addresses are refused) and uploaded to Chatter; polls the To Me feed every 60 s and, for allowlisted groups, runs a SOQL probe every 5 s by default (counts against the org API quota); writes Likes, comments, files in the bot user's Files and optional home-channel posts; keeps its ledger in plugin-data/salesforce-chatter/inbox.sqlite. dry_run defaults to true (no Salesforce writes, no outbound image fetch); with SF_CHATTER_ALLOWED_USERS unset nobody is answered. Optional, off by default: html_preview renders model-generated HTML to PNG with Chromium in a network-isolated Docker container (digest-pinned image, pulled if missing). No telemetry.

From the plugin's catalog listing.

## How to install

1. Install it. Hermes asks for any API keys it needs (this one needs `SF_CHATTER_LOGIN_URL`, `SF_CHATTER_CLIENT_ID`, `SF_CHATTER_USERNAME`, `SF_CHATTER_PRIVATE_KEY_PATH`, `SF_CHATTER_BOT_USER_ID`), then asks whether to turn it on.

```bash
hermes plugins install salesforce-chatter
```

2. Said no? Turn it on later:

```bash
hermes plugins enable salesforce-chatter
```

3. Restart Hermes so it loads the plugin.

Some plugins also need a sign-in or settings: see the official page. Memory plugins ask whether to become your memory provider instead. Steps follow the official plugins guide: https://hermes-agent.nousresearch.com/docs/user-guide/features/plugins

## Facts

- Category: Chat apps & voice
- Maintained by: zenplace-system (Community)
- Needs: `SF_CHATTER_LOGIN_URL`, `SF_CHATTER_CLIENT_ID`, `SF_CHATTER_USERNAME`, `SF_CHATTER_PRIVATE_KEY_PATH`, `SF_CHATTER_BOT_USER_ID` (API keys)
- Requires Hermes: `>=0.21.3`
- Version: 0.2.1
- In the catalog since: 2026-10-10

## Links

- [Full setup and settings (official page)](https://hermes-agent.nousresearch.com/docs/plugins/salesforce-chatter)
- [Source code](https://github.com/zenplace-system/hermes-plugin-salesforce-chatter#readme)
- [All plugins](https://hermeswatcher.com/plugins.md)

---

HermesWatcher is an independent guide. It is not affiliated with or endorsed by Nous Research. The [official Hermes Agent documentation](https://hermes-agent.nousresearch.com/docs) and [repository](https://github.com/NousResearch/hermes-agent) from Nous Research are the authority; each page here lists the official sources it was written from. If this site and the official docs disagree, trust the official docs. Index for agents: https://hermeswatcher.com/llms.txt