WeCom — Company AI Assistant

Imagine having a super-smart colleague who lives inside your company’s WeChat—ready to answer questions, send files, and handle tasks 24/7. That’s exactly what Hermes Agent lets you build with WeCom (Enterprise WeChat).

Why WeCom + Hermes?

WeCom is Tencent’s business messaging app—think WhatsApp for companies. Hermes connects your AI assistant directly to it, so your team can chat with the bot just like they’d chat with a coworker. No complicated webhooks, no public server, no IT headaches. The connection stays open in the background, like a phone line that never hangs up.

Step 1: Create Your AI Bot (The Easy Way)

The fastest path is scanning a QR code. Run this in your terminal:

hermes gateway setup

Select WeCom, and Hermes will show a QR code. Scan it with your WeCom mobile app, and the wizard automatically creates the bot with the right permissions. It even saves the credentials for you.

No QR code? No problem. The wizard falls back to manual entry:

1. Log in to the WeCom Admin Console
2. Go to Applications → Create Application → AI Bot
3. Copy the Bot ID and Secret
4. Run hermes gateway setup again and paste them when prompted

⚠️ Keep the Secret private. Anyone with it can impersonate your bot.

Step 2: Tell Hermes About Your Bot

You have two options. The interactive way (recommended):

hermes gateway setup

Follow the prompts for credentials, access control, and notifications.

Or edit the config file directly. Open ~/.hermes/.env and add:

WECOM_BOT_ID=your-bot-id
WECOM_SECRET=your-secret
# Optional: only allow these users
WECOM_ALLOWED_USERS=user1,user2
# Optional: where to send notifications
WECOM_HOME_CHANNEL=chat_id

Step 3: Start the Gateway

One command, and you’re live:

hermes gateway

That’s it. Your bot is now online.

What Can It Do?

• DM and group chat — you decide who can talk to it
• Per-group permissions — allowlist specific users per group
• Media support — send and receive images, files, voice, video
• Reply threading — it replies in the same conversation thread, so context stays clear
• Auto-reconnect — if the connection drops, it quietly retries in the background

One Thing to Know

The WeCom adapter sends each answer as one complete message—it doesn’t type character-by-character like ChatGPT. Think of it as sending a well-written email instead of a live chat. That’s fine for most business tasks.

Final Thoughts

Setting up a company AI assistant sounds scary, but Hermes makes it feel like scanning a QR code at a coffee shop. Start with a small group, test it with real questions, then expand access.

Practical tip: Before opening it to everyone, use WECOM_ALLOWED_USERS to test with just two or three colleagues. Once they love it, widen the circle. Your bot will earn its place in the team chat in no time.