Connect Hermes to Yuanbao

Yuanbao is a Tencent enterprise messaging platform. Its Hermes adapter maintains an HMAC-authenticated WebSocket for direct and group conversations, supports media through Tencent object storage, and can route scheduled results to a designated home channel.

Establish identities and routing

Create a Yuanbao bot with the platform administrator, then run hermes gateway setup and choose Yuanbao. Store the App ID and App Secret privately. Direct destinations use a direct: prefix; groups use group:. Preserve these prefixes when configuring a home channel or sending from another Hermes surface.

Use separate DM and group access policies. The first-message auto-home behavior is convenient for a private installation, but a managed deployment should set the intended home channel explicitly so an early tester cannot claim notification delivery.

Setup checklist

Create a Yuanbao bot with the required platform permissions.
Install WebSocket, HTTP, and media dependencies.
Configure App ID and App Secret securely.
Set DM and group policies independently.
Pin the intended home channel and verify its prefix.
Test media size and type limits before promising file workflows.

Pitfalls

An online bot can still reject messages when HMAC authentication or route permissions fail. A group code is not interchangeable with a direct account ID. Object-storage upload failures are separate from WebSocket health. Auto-reconnect can hide repeated credential failures unless logs are monitored. Do not expose actual platform hosts, account identifiers, or signed media URLs in public reports.

Verification steps

Start the gateway and confirm an authenticated WebSocket session.
Send one approved DM and one approved group mention.
Test denial for an unauthorized account and group.
Run /sethome only in the intended destination and verify a harmless scheduled result arrives there.
Send a small image and document in both directions.
Restart the gateway and check deduplication and reconnection logs.

See the official Yuanbao guide for current media, policy, routing, and troubleshooting details.