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

# Telegram

> Connect a Telegram bot so customers can chat with your agent in Telegram

Telegram uses a bot you create with [@BotFather](https://t.me/BotFather). You paste the **Bot Token**. Botcadence registers the webhook with Telegram automatically.

## Prerequisites

* A Telegram bot and token from [@BotFather](https://t.me/BotFather)
* Permission to create channels

## Connect

<Steps>
  <Step title="Create a bot">
    In Telegram, open [@BotFather](https://t.me/BotFather), create a bot, and copy the token (it looks like `123456789:AA...`).
  </Step>

  <Step title="Open Channels">
    In the project sidebar, select **Channels**. Select **Telegram**.
  </Step>

  <Step title="Paste Bot Token">
    On **Connect Telegram Bot**, enter **Bot Token**. Keep it secret.
  </Step>

  <Step title="Wait for verification">
    The wizard verifies the token. When it succeeds, you see **Telegram Channel Connected!** The identifier becomes the bot username (often `@your_bot`).
  </Step>
</Steps>

## Verify

<Check>
  Open the bot in Telegram and send a message. It appears in [Conversations](/docs/operate/conversations).
</Check>

## Use it

Inbound Telegram chats use the workflow and tools on this channel. You can disconnect later from Channels if the type allows it.

If the product shows a webhook status panel, use it only to confirm Telegram is reaching Botcadence. You do not paste a webhook URL in BotFather for the default flow.

## Limits

* Bot username should start with `@` and use letters, numbers, and underscores.
* Revoking the token in BotFather disconnects the channel until you paste a new token.

## Troubleshooting

<AccordionGroup>
  <Accordion title="Token verification fails">
    Copy the token again from BotFather. Do not add spaces. Confirm the bot was created successfully.
  </Accordion>

  <Accordion title="Messages do not arrive">
    Send `/start` to the bot first. Confirm the channel is enabled. Wait a minute after connect for the webhook to register.
  </Accordion>
</AccordionGroup>