# Telegram BOT

### Description

Telegram is a messenger that allows you to text across devices.

Bots are applications in Telegram that allow you to use some of the functionality of the site without going to it.

There are currently two bots available: one for users and one for managers

\
**User bot features:**

Creating and Conducting Exchanges

Create and pay invoices (disabled by default)

View currency reserves

Request to replenish currency reserves (disabled by default)

View exchange rates

View and add reviews (disabled by default)

Answers to questions (FAQ)

Report to tech support (not available by default for non-registered users (Guest group))

User panel (registration, login, password change and recovery)

Lists of user's exchanges and invoices

Card and identity verification (disabled by default)

Affiliate Program Statistics

Find a transaction by hash

Links to monitoring files (via menu command only)

Receive alerts

Language selection (if enabled)

\
**Manager bot functions:**

View and change transaction statuses

Answers to tech support requests

Processing verification requests

Moderation of reviews

Receive alerts (as configured)

Language selection (if enabled)

***

### **Bot Creation**

To create a bot, you need to find a bot in Telegram with the username [BotFather](https://t.me/BotFather) and start a chat with him.

Click Start and in the menu that appears (or in the bot's welcome message) select the first command /newbot\
![](https://money-top.com/~~/DOC/EN/style/i/tlg_1.png)\
\
BotFather will ask you to enter the bot's name. It will be displayed in the header of the chat with your bot.\
![](https://money-top.com/~~/DOC/EN/style/i/tlg_2.png)\
\
After that BotFather will ask you to enter the bot's login. The login must be without spaces and must end in bot, for example moneytopbot

If the login is already taken, you will be asked to enter another one.\
![](https://money-top.com/~~/DOC/EN/style/i/tlg_3.png)\
\
If everything went well, you will receive a bot token. You can copy a token by simply clicking/tapping on it.

The token must be entered in the admin panel Settings - Configuration - Telegram BOT - User bot token / Manager bot token

If you are going to use both bots (users and managers), you need to create two bots with different logins and tokens.\
![](https://money-top.com/~~/DOC/EN/style/i/tlg_4.png)\
\
You can check that the token is correct and your bot is registered using the link <https://api.telegram.org/bot\\><Token>/getMe

Instead of \<Token> enter your token

It will look something like this: <https://api.telegram.org/bot5997799257:AAE-Mlk6e0IcOKSFKhH5VGGI6-YEZCgy25M/getMe>

The browser will display the username and name of your bot:

`{"ok":true,"result":{"id":5997799257,"is_bot":true,"first_name":"MoneyTop","username":"mtoptestbot","can_join_groups":true,"can_read_all_group_messages":false,"supports_inline_queries":false}}`<br>

Next you need to activate the bot. To do this, click the appropriate button under the token input field and wait until activation is completed.

Message Webhook was set - means successful activation.

If you use both bots, you need to activate them separately.\
![](https://money-top.com/~~/DOC/EN/style/i/tlg_5.png)\
\
Next to the token input field for bot users there is a field Bot login, you need to enter the login there (without @) or click on the Get button to automatically determine the bot login.< /p>\
![](https://money-top.com/~~/DOC/EN/style/i/tlg_6.png)\
\
After this, be sure to save the settings<br>

Now you can open bots (buttons next to tokens). The user bot must be fully functional, and the manager bot must be granted access to the chat ID.

By going to the manager bot, you will receive a message with your chat ID\
![](https://money-top.com/~~/DOC/EN/style/i/tlg_7.png)\
\
Copy your chat ID (click or tap) and enter it in the Telegram CHAT ID field in the admin panel. You can enter multiple IDs in this field, separated by commas.

Save the settings and send the bot a message of any content so that it can double-check your access. If everything is in order, the bot will not write about an access error and the bot menu will open.

***

### **Manager bot settings**

Additional manager bot settings:

**Alerts** - short messages to all active chats with the bot

**Changing files** - Notify when files change on the server

**Reserve requests** - Notify about reserve requests (exchanger). [Details here](https://doc.money-top.com/en/exchange-settings/aeo-other/reserve-requests)

**Contacts** - Notify when a message is sent from the feedback form

**Technical support** - Notify about requests for technical support

**Verification** - Notify about verification request

**Withdrawal** - Notify about a withdrawal request (affiliate)

**Managers** - Notify about adding a review about the manager's work

**Reviews** - Notify when a review is added (exchanger)

**Currency rates** - Alerts about failures to receive rates. [Details here](https://doc.money-top.com/en/other/training/failure-to-receive-rates)

**Exchange errors** - Notify about exchange errors

**Processing by operator** - Notify about new requests with type Processing by operator

**Processing by operator has been paid** - Notify about paid applications with the type Processing by operator

**Exchange completed (automatic)** - Notify about successfully completed exchanges

**Funds received (semi-automatic)** - Notify about paid applications with the Semi-automatic type

**Automatic trading errors** - Notify about errors during automatic trading. [Details here](https://doc.money-top.com/en/exchange-settings/aeo-other/auto-trades)

**Number of reviews per page** - how many elements will be shown on one page of the list of user reviews

**Number of support requests per page** - how many items will be shown on one page of the list of support requests

**Number of transactions per page (3 in a row)** - how many elements will be shown on one page of the transaction list. It is optimal to enter a number that is a multiple of three.

**Number of verifications per page** - how many elements will be shown on one page of the list of verification requests

***

### **User bot settings**

Additional user bot settings:

**Uploading files** - where files uploaded through the bot will be stored. Uploading files is possible for verification and in support requests.

**To file storage** - if it is enabled, all files uploaded through the bot will be added to the storage. If the storage is disabled (no token entered), the files remain in Telegram. For storage settings, see the "File storage" tab.

**Leave in Telegram** - files will be uploaded to Telegram servers. The storage period for files is unknown.

**Link to review** - send a link (button) to add a review in notifications about a successful exchange, if reviews are enabled. If disabled, unregistered users will not be able to leave reviews through the bot, and registered users will only be able to leave reviews through the list of their transactions.

**Number of reviews per page** - how many reviews will be shown on one page of the list of user reviews. Reviews are shown immediately in full, without shortening their texts.

**Number of questions (help) per page** - how many elements will be shown on one page of the list of answers to questions in the Help module. Questions are displayed in a list and the answer is opened by clicking on the question.

**Number of support requests per page** - how many items will be shown on one page of the list of support requests.

**Number of transactions per page (3 in a row)** - how many elements will be shown on one page of the transaction list. It is optimal to enter a number that is a multiple of three.

**Number of invoices per page (2 in a row)** - how many elements will be shown on one page of the list of accounts (invoices). It is optimal to enter a number that is a multiple of two.

**Number of affiliate deductions per page** - how many elements will be shown on one page of the user’s affiliate deductions list.

**Text on the bot's main page** - this text will be displayed on the bot's main page. {siteurl} - display the address of the exchanger's website, {sitename} - display the name of the exchanger.<br>

**Alerts for users**

If a user performs actions through a bot, he will receive all notifications related to these actions.

If a user logs into his account through a bot, he will receive all notifications on it, no matter where he performs actions (in the bot or on the website) related to them.

***

### **Utilities**

Frequently asked questions: <https://tlgrm.ru/faq>

Important! Telegram has limited HTML text formatting.\
If you change the texts of the notifications you send, take this into account. Otherwise, you will not receive these notifications.\
HTML tags supported:\
`<b>Bold</b>, <strong>Bold</strong>`\
`<i>Inclined</i>, <em>Inclined</em>`\
`<a href="http://money-top.com/">URL</a>`\
`<code>Code</code>`\
`<pre>Formatted block</pre>`
