# 2FA: Telegram бот

Two-factor authentication allows you to effectively protect your account from unauthorized access, thereby protecting personal data - access to transaction history, project settings and financial information. \
\
We have three options for two-factor authentication: login with a one-time password sent by email, login confirmation via Telegram, and use of a code from the Google Authenticator app or another code app.

## Telegram bot features:

* authorization confirmation
* receive payments notifications
* receiving notifications about handler errors (on payments in the "Not completed" and "Rejected" statuses). Fires when >=5 invalid GET-requests CHECK or PAY.
* For payments in the "Rejected" status, notifications are received only if an "Incorrect or empty merchant response" was received from the handler.

**Adding the Telegram UnitPayBot bot.**

1\) Launch the bot using the link <https://t.me/unitpaybot> or find *@UnitPayBot* in Telegram.

<div align="center"><img src="/files/-M9y2DofaHzW7J8sHiEC" alt="" width="375"></div>

2\) Click the START button.

<img src="/files/-M9y2Doga8Q6bFtZpAIL" alt="" width="375">

3\) The bot will offer to share your phone number.

<img src="/files/-M9y2DohGzcZz3jQ42-W" alt="" width="375">

4\) Share your phone number

*By default, Telegram does not share phone numbers to bots.*

Click Share my number and then confirm your intention by clicking on SHARE MY CONTACT.

<img src="/files/-M9y2Doiarvt1XJ0e49w" alt="" width="375">

5\) Your number will be saved.

<img src="/files/-M9y2Dojjv7Ag21xPOEc" alt="" width="375">

Now you can use Telegram instead of SMS codes. This method will be saved in your account **as the main one**.

**How to make Telegram method as the main one?**

1. Log in
2. Go to your account settings
3. Link your phone number in the “Security settings” section
4. Select a method for confirming Telegram actions
5. Click “Save changes”

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

**How do I confirm my actions via Telegram?**

In the Unitpay interface, you will see a notification that a request has been sent to the Telegram account linked to the phone number.

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

This is what the request looks like in the Telegram app for mobile devices.

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

How to receive payments notifications in Telegram?

*Ensure you have added UnitPayBot*

1. Go to your Project settings
2. Tick checkbox 'Notify by Telegram'

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

3\. Click 'Save' button

**How do I confirm my registration or log in using the Telegram bot?**

Already **during registration** or when **logging in** to your account, you or your employee can choose an alternative way to confirm actions or switch back. **After adding the UnitPayBot bot** (see above), click Confirm in Telegram.

You can always change the notification channel to receive codes by email by clicking “ Get code via email.”

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


---

# 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://help.unitpay.ru/en/unitpay-management/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.