> ## Documentation Index
> Fetch the complete documentation index at: https://document.botsmith.pro/llms.txt
> Use this file to discover all available pages before exploring further.

# Deploy Your BotSmith Agent as a Telegram Bot Account

> Connect BotSmith to Telegram by creating a bot with BotFather, entering your bot token, and setting up a webhook so users can chat with your agent.

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.

<Tip>
  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.
</Tip>

## Step 2: Connect to BotSmith

<Steps>
  <Step title="Open the Integrations tab">
    In the BotSmith chatbot editor, click the **Integrations** tab.
  </Step>

  <Step title="Open Telegram configuration">
    Find the **Telegram** card and click **Setup**.
  </Step>

  <Step title="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`).
  </Step>

  <Step title="Save the integration">
    Click **Save Integration**.
  </Step>

  <Step title="Enable the integration">
    Toggle **Enable Integration** on.
  </Step>

  <Step title="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>
</Steps>

## 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.