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

# 📱 Telegram Bot

### 🖼️ Template Setup

* Open the Telegram app and search for the `BotFather` user.
* Start a chat with BotFather and use the `/newbot` command to create a new bot.
* Follow the instructions to choose a name and username for your bot.
* Once the bot is created, BotFather will provide you with a unique token for your bot.

<Tabs>
  <Tab title="docker">
    ```bash theme={null}
    docker run --name telegram-bot -e OPENAI_API_KEY=sk-xxx -e TELEGRAM_BOT_TOKEN=xxx -p 8000:8000 embedchain/telegram-bot
    ```

    <Note>
      If you wish to use **Docker**, you would need to host your bot on a server.
      You can use [ngrok](https://ngrok.com/) to expose your localhost to the
      internet and then set the webhook using the ngrok URL.
    </Note>
  </Tab>

  <Tab title="replit">
    <Card>
      Fork <ins>**[this](https://replit.com/@taranjeetio/EC-Telegram-Bot-Template?v=1#README.md)**</ins> replit template.
    </Card>

    * Set your `OPENAI_API_KEY` in Secrets.
    * Set the unique token as `TELEGRAM_BOT_TOKEN` in Secrets.
  </Tab>
</Tabs>

* Click on `Run` in the replit container and a URL will get generated for your bot.
* Now set your webhook by running the following link in your browser:

```url theme={null}
https://api.telegram.org/bot<Your_Telegram_Bot_Token>/setWebhook?url=<Replit_Generated_URL>
```

* When you get a successful response in your browser, your bot is ready to be used.

### 🚀 Usage Instructions

* Open your bot by searching for it using the bot name or bot username.
* Click on `Start` or type `/start` and follow the on screen instructions.

🎉 Happy Chatting! 🎉