> For the complete documentation index, see [llms.txt](https://help.unitpay.ru/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.unitpay.ru/en/unitpay-management/telegram.md).

# 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>
