Skip to main content
BotSmith can power a Telegram bot. You create a bot through Telegram’s official BotFather tool, paste the bot token into BotSmith, and then trigger webhook setup from the integration panel. From that point on, your BotSmith agent handles every message sent to your Telegram bot automatically.

​
Step 1: Create a Telegram Bot

  1. Open Telegram and search for @BotFather (look for the verified account with a blue checkmark).
  2. Start a chat and send the command /newbot.
  3. BotFather asks for a display name — enter any friendly name (for example, Acme Support Bot).
  4. BotFather then asks for a username — it must be unique and end in bot (for example, acme_support_bot).
  5. BotFather replies with your bot’s API token, a string that looks like 123456789:ABCdefGhIJKlmNoPQRstuVWXyz. Copy it.
Use /setdescription in BotFather to add a short bio that users see when they first open your bot, and /setuserpic to upload a profile photo. These small touches make your bot look professional.

​
Step 2: Connect to BotSmith

1

Open the Integrations tab

In the BotSmith chatbot editor, click the Integrations tab.
2

Open Telegram configuration

Find the Telegram card and click Setup.
3

Enter your bot details

Fill in the following fields:
  • Bot Token — Paste the API token you received from BotFather.
  • Bot Username (optional) — Enter your bot’s username without the @ symbol (for example, acme_support_bot).
4

Save the integration

Click Save Integration.
5

Enable the integration

Toggle Enable Integration on.
6

Set up the webhook

Click the ⚡ webhook setup button (the lightning bolt icon next to your saved integration). BotSmith registers a webhook with Telegram so it can receive messages in real time. You will see a confirmation toast when the webhook is set up successfully.

​
Step 3: Test the Integration

  1. Open Telegram and search for your bot’s username (for example, @acme_support_bot).
  2. Open the chat and tap Start or send the /start command.
  3. Send a message to the bot.
  4. Your BotSmith agent should reply within a few seconds.
If the bot does not respond, check that:
  • Your chatbot is set to Active in BotSmith settings.
  • The integration is toggled on in the integrations panel.
  • The webhook was set up successfully (look for the success notification after clicking the lightning bolt button).
  • You pasted the correct bot token (check for extra spaces or line breaks).

​
Managing the Bot

  • Disable — Toggle the Telegram integration off in BotSmith at any time. The bot remains visible on Telegram but stops responding to messages.
  • Re-enable — Toggle it back on to resume responses.
  • Update the token — If you reset your bot token in BotFather, paste the new token in this integration panel, save, and click the webhook setup button again.