Articles on: VPS Hosting

How to Integrate Telegram with Hermes

This guide will walk you through connecting your Telegram bot to your Hermes AI agent. Once integrated, you can interact with your AI directly from Telegram.


Prerequisites


Before you begin, ensure you have:

  • An active Hermes VPS 
  • A Telegram account
  • Your Hermes agent already set up (if not, complete the Hermes Agent Setup Guide first)


If you're new to Hermes, feel free to check out this guideline.


Step 1 : Create a Telegram Bot via BotFather


  1. Open Telegram and search for @BotFather.


  1. Send the command /newbot to start creating a new bot.


  1. Choose a name for your bot (e.g., My Assistant AI).


  1. Choose a username for your bot. Important: The username must end with the word bot (e.g., my_assistanceAI_bot).


  1. Save your bot token. BotFather will send you a message with your bot's token (e.g., 1234567890:ABCdefGHIjklMNOpqrsTUVwxyz). Keep this token secure, you'll need it in Step 3.


💡 Tip: Click the bot link BotFather provides (e.g., t.me/my_assistantAI_bot) to open your bot and send it a test message later.


Step 2 : Get Your Numeric Telegram ID


To ensure only you can control your Hermes agent, you need your personal numeric Telegram User ID:


  1. Search for @userinfobot in Telegram.


  1. Send any message to receive your exact numeric ID (e.g., 987654321). Then, copy your numeric ID.


Step 3 : Configure Hermes on Your VPS


  1. SSH into your Hermes VPS.
  2. Run setup command: hermes gateway setup
  3. When prompted, select platform and choose Telegram from the list.


  1. Enter bot token and paste the token you saved from @BotFather.


  1. Enter your user ID and paste the numeric ID you got from @userinfobot.


  1. Continue through the remaining prompts, configure other settings according to your preferences.


⚠️ Important: Telegram bot will not respond until this configuration is successfully completed.


Step 4 : Test Your Connection


  1. Open Telegram and find your bot (use the link from BotFather or search its username).



  1. Send /start or send any message to the bot. Wait for a response. If everything is configured correctly, your Hermes agent will reply.


You have successfully integrate Telegram with Hermes.




Need Further Assistance?


If you face any issues or need assistance, don’t hesitate to reach out — our support team is always ready to help!


🔧 Need help? Submit a Support Ticket
💬 Chat with us on Live Chat via our website

Updated on: 24/07/2026

Was this article helpful?

Share your feedback

Cancel

Thank you!