Telegram

RootAuth supports Telegram login. After it is enabled, users can select Telegram on the login or sign-up page and complete authentication through Telegram without entering a password.

Path: Log in to the RootAuth console → open the target application → click Configuration in the top navigation bar → Application Management - Authentication Configuration → select Providers

 

1. Before You Start

Before configuring Telegram login, make sure you have completed the following:

1. You have a Telegram account.
2. You have contacted @BotFather in Telegram and created a bot.
3. You have configured the Web Login domain for the bot in @BotFather.
4. You have obtained the Client ID and Client Secret from Telegram.

Telegram verifies the authorization domain. Make sure the domain configured in BotFather matches the domain of the callback URL shown in RootAuth.

 

2. Enable Telegram in RootAuth

In the provider list, find Telegram and click Enable.

In the configuration dialog, turn on Telegram login and fill in the following information:

Field	Description
Client ID	Obtained from Telegram BotFather
Client Secret	Obtained from Telegram BotFather
Callback URL	Generated by RootAuth. Copy it and configure it in Telegram BotFather.
Login mode	Used for login and sign-up by default
Account binding	Automatically links accounts with the same Telegram ID by default

After completing the fields, click Save.

After the configuration is saved, Telegram is shown as Enabled, and the action button changes to Manage. To update the configuration later, click Manage.

 

3. How Users Log In with Telegram

After Telegram login is enabled, the login or sign-up page displays a Telegram login button.

When a user clicks Telegram, they are taken through Telegram's official authorization flow. Depending on the user's current Telegram session, Telegram may show an authorization dialog or redirect the user to an authorization page.

After the user confirms authorization, RootAuth automatically completes the following steps:

1. Receives the user's public information returned by Telegram.
2. Checks whether an existing account matches the Telegram ID.
3. If an account already exists, logs the user in directly.
4. If no account exists, creates a new account and completes login.

 

4. View a User's Telegram Authentication Method

After a user logs in or signs up with Telegram, you can view the authentication record in the user details.

Go to User Management, open the target user's details, and check the Authentication Methods section.

The Telegram authentication method displays:

Field	Description
Authentication method	Telegram
Identifier	Telegram ID
Last used	The most recent time the user logged in with Telegram

If the application unbinds the user's Telegram account through the API, this authentication method is removed from the user details.

 

5. Integration Options

Telegram login supports two integration options:

Integration option	Description
Hosted	Use the login and sign-up pages hosted by RootAuth. After Telegram is enabled, the Telegram login button is displayed automatically.
API	Build your own Telegram login entry in your application, then use APIs to complete login, binding, or unbinding.

For integration details, see the Developer Integration documentation.

 

6. Disable Telegram Login

To disable Telegram login, open the Telegram management dialog, turn off the switch, and save the configuration.

After Telegram login is disabled:

1. The Telegram login button is no longer shown on the login or sign-up page.
2. The saved Telegram configuration is retained.
3. Existing users' Telegram binding records are not deleted.