Messaging Gateway β Connect All Chat Platforms
Messaging Gateway β Connect All Chat Platforms β easy-to-understand guide based on official docs
Imagine having one personal assistant who can hear you whether you call, text, or shout from another room β thatβs what the Hermes Messaging Gateway does for your AI agent. Itβs a single background worker that connects your bot to every chat app you already use, so you donβt need to open a special dashboard to talk to it.
What Is the Gateway?
The gateway is one process that runs quietly on your computer or server. It listens on all the platforms you configure β Telegram, Discord, WhatsApp, Slack, email, and many more β and handles every conversation from one place. You donβt need to set up a separate bot for each app. You just tell the gateway which platforms to connect, and it takes care of the rest.
It also manages background tasks like scheduled cron jobs and voice message delivery. So if you ask your agent to remind you tomorrow at 9 AM, the gateway makes sure that happens even if youβre not actively chatting.
Which Platforms Are Supported?
Hermes supports an impressive list β over 25 platforms. Here are some of the most common ones:
- Telegram, Discord, Slack β full-featured with voice, images, files, threads, reactions, typing indicators, and streaming
- WhatsApp (both personal and Cloud API) β great for everyday messaging
- Email β handy for longer, more formal requests
- Signal, Matrix, Mattermost β good for privacy-focused users
- Home Assistant β lets your agent control smart home devices
- Browser chat β if you just want to test quickly without installing anything
Each platform has different capabilities. For example, Telegram and Discord support voice replies, while SMS and email are text-only. The table in the docs shows exactly what works where, so you can pick the right platform for your needs.
How to Set It Up
Setting up the gateway is straightforward. You install Hermes, then run the gateway command:
hermes gateway start
Then you add your platform tokens (like a Telegram bot token or a Slack app token) in the config file. Once saved, restart the gateway, and your agent is live on all those platforms.
For example, to add Telegram:
hermes config set telegram.bot_token "123456:ABC-DEF..."
Then restart:
hermes gateway restart
Thatβs it. Your agent now responds in Telegram, and you can repeat the same for any other platform.
Why Use One Gateway Instead of Many Bots?
- Single setup β configure once, use everywhere
- Consistent memory β conversations are stored together, so your agent remembers context across platforms
- Less maintenance β one process to update and monitor
- Voice everywhere β if a platform supports voice, the gateway handles TTS replies and voice transcription automatically
A Practical Tip
Start with just one platform you use daily (like Telegram or Discord). Get comfortable with the gateway, then add more. You can always check whatβs connected by running:
hermes gateway status
This shows you which platforms are active and if any have errors.
Summary
The Messaging Gateway is your agentβs universal remote β it connects your AI to every chat app you love, with minimal setup and maximum flexibility. Whether youβre chatting from your phone, desktop, or smart home hub, your Hermes agent is always just one message away. Try it with one platform today, and youβll wonder how you ever managed without it.
π Official Docs
This article is based on the official Hermes Agent documentation:Official docs βΊ user-guide/gateway