Skip to content
Hermes for Designers

Telegram gateway

Why Telegram?

Section titled “Why Telegram?”

Your Mac isn’t always open. The Telegram gateway lets you talk to Hermes from your phone, anywhere, anytime.

  • Send tasks from your phone
  • Get notifications when long jobs finish
  • Chat with Hermes while away from your desk
  • Deliver files (reports, invoices, images) directly to Telegram

Setup

Section titled “Setup”
  1. Create a Telegram bot: talk to @BotFather, send /newbot, get a bot token
  2. Configure Hermes:
Terminal window
hermes config set telegram.token YOUR_BOT_TOKEN
hermes config set telegram.enabled true
hermes gateway start
  1. Start a chat with your bot on Telegram. That’s it.
💡
Designer Tip:

Set up the gateway once, use it forever. Hermes messages you when long tasks finish. No need to watch the screen.

When it’s useful

Section titled “When it’s useful”
Scenario How
Running a cron job Hermes sends the result to Telegram when done
Long build/deploy Get notified on your phone when it completes
Quick question on the go Ask Hermes from Telegram, it has your full context
Delivering client work Send generated reports/invoices straight to a chat
▶
Try This:

Once set up, send your bot a message: “what’s on my kanban board?” Hermes responds with your current tasks.

Troubleshooting

Section titled “Troubleshooting”
  • Bot not responding? Check hermes gateway status: is it running?
  • Messages not arriving? Verify the bot token is correct in config
  • See Troubleshooting for more

Next steps

Section titled “Next steps”