# Telegram

{% embed url="<https://www.loom.com/share/b08997601cf040db9bd9d88bbda88d01?sid=bc83a189-5d02-4bba-9158-18c3e4491899>" %}

1. Log in to [Dashboard](https://orimon.ai/login) -> navigate to the overview page of the bot that you want to change.
2. On the overview page, you will see several tabs. Look for the one labelled "Launch" and click on it.

<figure><img src="/files/78Vke399BhS8XtzzAuPM" alt=""><figcaption></figcaption></figure>

3. Select the "Telegram" tab. Click on the "**Enable**" switch to enable the integration.

<figure><img src="/files/XbCnNlJqUNwVZcib2IPR" alt=""><figcaption></figcaption></figure>

4. Click on the provided "BotFather" link or search for "BotFather" in Telegram.

<figure><img src="/files/ukgpTojbRNbbUL6PggcR" alt=""><figcaption></figcaption></figure>

4. Send the command `/start` to BotFather to initiate the conversation.

<figure><img src="/files/Mf82y1JTQkE84MnlpRee" alt=""><figcaption></figcaption></figure>

7. Choose the `/newbot` command to create a new bot.
8. Provide a name for your bot.
9. Choose a unique username for your bot. It must end with the word "bot".
10. BotFather will provide you with a token. Copy the token as you will need it for integration with Orimon.

<figure><img src="/files/9MjjszdXA5Mtv9X7nbTe" alt=""><figcaption></figcaption></figure>

11. Go back to the Orimon app and paste the token into the input field and press integrate.

<figure><img src="/files/7SAAYBHq11oVTlW2NDG9" alt=""><figcaption></figcaption></figure>

11. Your Telegram bot is now integrated and ready to use. You can search for your bot by its username or click on the link provided by BotFather to access your bot.

<figure><img src="/files/F238OLLarV6A2OlGXpiF" alt=""><figcaption></figcaption></figure>

11. To use your bot in a personal chat, start sending messages directly to the bot.

<figure><img src="/files/t6hICbAk9gxi2eJe7uut" alt=""><figcaption></figcaption></figure>

14. To use your bot in groups, add it to the desired group, promote it to admin, and then start talking to the bot by tagging it using `@botusername`.

<figure><img src="/files/nJfO7dQ6mvsY6oS6zvXI" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/As4Gv0220RV9547OdYEK" alt=""><figcaption></figcaption></figure>

Following these steps will enable you to integrate and use your bot on Telegram.

{% hint style="warning" %}
Please note that in order to use your bot in groups on Telegram, it is important to promote the bot to an administrator. Without promoting the bot to admin, it won't have the necessary permissions to function properly within groups. So, after adding the bot to a group, make sure to promote it to admin to ensure it can interact and respond to messages effectively.
{% endhint %}

{% hint style="info" %}
After integrating your bot with Telegram, you have the flexibility to enable or disable the bot's functionality. By toggling the enable/disable switch, you can control whether the bot responds to incoming messages on Telegram. If the bot is disabled, it will not respond to any messages.

Additionally, if you wish to integrate a different Telegram bot or update the token for any reason, you have the option to change the token. Simply enter the new token in the provided input field and save the changes. This allows you to switch between different Telegram bots or update the integration as needed.
{% 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://orimon.gitbook.io/docs/channels/telegram.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.