# Telegram Private Bot

Cielo provides a number of Telegram bots that can be used to receive custom alerts. Free users can access **one** bot, Pro users **two**, and Whale users **nine**. These bots are accessed by all Cielo users who share a corresponding plan. Due to limitations in Telegram’s architecture, however, the demand placed on these bots can occasionally cause alerts to be dropped or delayed.

To resolve this, Cielo Pro + Whale users can create private bots that are exclusive to their personal use. This will ensure that alerts are delivered promptly and consistently. Just as experienced onchain users can create a custom RPC to access a faster blockchain connection, creating a private Cielo bot ensures a consistent alert stream.

{% hint style="info" %}
Private Telegram bots are available *in addition* to your existing Cielo bots e.g. if you are a Pro user, the two bots you currently have can now be complemented by two additional private bots.
{% endhint %}

## Creating a Private Bot <a href="#creating-a-custom-bot" id="creating-a-custom-bot"></a>

Creating a private bot is quick and easy. Here’s how:

1. Go to [BotFather](https://t.me/BotFather) on Telegram, click the menu button and select */newbot*
2. Give your bot a name e.g. *Cielo Private Bot 1*
3. Choose a username for your bot. This must be a unique name that is not currently used on Telegram and must end with ‘bot’
4. Copy the token that BotFather displays in red. It will read something like *7024425312:AGHJo0WgmLqkaWzMgxO7tdqhvXzxVUJQR2c.* **Note:** Do not share this token publicly or other users may be able to access your bot
5. Now visit the Telegram menu for an existing Cielo bot e.g. *Cielo Premium Bot #1* (The only bot this will not work with is the free bot titled *Cielo Wallet Tracker*)
6. After loading the main menu, select *Custom Bots* > *Add custom bot*
7. Paste in the API token you just created in BotFather
8. Repeat this process with as many bots as you wish to add
9. Click the menu button marked *Custom bots* to see a list of all private bots you have active
10. Open the Cielo web app, go to [My Wallets](https://app.cielo.finance/my-wallets) and you can start assigning wallets to your private bot(s).

<figure><img src="/files/KBVnDM7AzfRX8hj2Bf8b" alt="" width="375"><figcaption><p>Select "Add custom bot" from the menu of an existing Cielo Telegram bot.</p></figcaption></figure>

You can create as many private bots as your current Cielo plan permits. Visit [Alerts](https://app.cielo.finance/settings/alerts) in the Cielo web app and you will see all of your private bots listed.

Type */start* in your private bot to load the Cielo menu. You can also add private bots to Telegram groups and topics just as you can with a regular Cielo bot.

<figure><img src="/files/bjfU84RLIrn8V1SDMlpK" alt=""><figcaption><p>After creating a private bot, it will appear in <strong>My Wallets</strong> as a bot you can assign alerts to.</p></figcaption></figure>

To make it easier to keep track of your Cielo bots, including private bots, it is recommended that you create a dedicated Telegram folder and assign all bots to it.

{% hint style="info" %}
The alerts you assign to your private bot must be made using the Cielo web app. In every other respect, however, your private bot will operate as normal with the added bonus of greater speed and reliability.
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.cielo.finance/discord-+-telegram-bots/telegram-private-bot.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
