Seamless Telegram login

Privy enables developers to quickly integrate Login with Telegram into their applications. With the Privy Telegram integration, users can log in with Telegram and link Telegram accounts.

From a web environment, Privy enables Telegram login via the Telegram Login widget. Privy also enables seamless Telegram login directly from within a Telegram bot or within Telegram Mini-Apps!

​

Configure Telegram

​

Configure Telegram login

Follow this guide to create a telegram bot. After creating a Telegram bot, you must set your domain using the /setdomain command in the @BotFather chat. You will need to provide the following to Privy via the Privy Dashboard upon completion:

• Bot token (eg: 1234567890:AzByCxDwEvFuGtHsIr1k2M4o5Q6s7U8w9Y0)
• Bot handle (eg: @MyBot_bot)

Note that when configuring Telegram login:

• Your domain must be configured as your bot’s allowed domain.
• If you have CSP enforcement, you’ll need to update these directives:
  • script-src must allow https://telegram.org in order to be able to download Telegram’s widget script.
  • frame-src must allow https://oauth.telegram.org in order to be able to render Telegram’s widget iframe.

​

Essential: Secure your bot secret

​

Integration interfaces

​

[optional] Enable Telegram in your client-side loginMethods

You must enable Telegram in the Privy Dashboard to enable login with Telegram.

If you additionally have loginMethods configured client-side in your PrivyProvider config, make sure you add "telegram" to that list as well. Client-side login method configuration is only necessary if you want to restrict logins to a subset of those configured in the Dashboard.

  <PrivyProvider
    appId={process.env.NEXT_PUBLIC_PRIVY_APP_ID || ""}
    config={{
      loginMethods: ["email", "google", "telegram"],
      ...
    }}
  >

​

Seamless login with Telegram

You can integrate Privy to enable login directly from within a Telegram bot or Telegram mini-app.

• If enabled, Privy will automatically log your user in when your user initiates login from within Telegram. You do not have to call login from the usePrivy hook in this case!
• To enable seamless login, send your website URL using , InlineKeyboardButton.web_app or InlineKeyboardButton.login_url or use a direct link (ex: t.me/xxx_bot/xxx)
• For reference, see these docs:
  • https://core.telegram.org/bots/api#keyboardbutton
  • https://core.telegram.org/bots/api#inlinekeyboardbutton

bot.send_message(chat_id, 'Log in to demo!', {
  reply_markup: {
    inline_keyboard: [
      [
        {
          text: 'Login',
          login_url: {url: 'https://your-website-url'}
        },
        {
          text: 'Mini App',
          web_app: {url: 'https://your-website-url'}
        }
      ]
    ]
  }
});

​

Login with Telegram

Once Telegram is enabled, you will automatically see Telegram in the Privy login modal. You can also list 'telegram' when configuring login methods client-side, in the PrivyProvider.

​

Link Telegram

You can use the linkTelegram and unlinkTelegram methods from the usePrivy hook to add or remove Telegram accounts from a user. See the SDK reference for more details:

const {linkTelegram, unlinkTelegram} = usePrivy();

​

Link Telegram seamlessly within a Telegram Mini app

You can use the linkTelegram methods from the usePrivy hook within a Telegram Mini App to add to a user seamlessly by passing launchParams as a parameter. See the SDK reference for more details:

// Sample library to retrieve launchParams
import {retrieveLaunchParams} from '@telegram-apps/bridge';

const {linkTelegram} = usePrivy();
const launchParams = retrieveLaunchParams();
linkTelegram({launchParams});

​

TelegramAccount type

The user object contains information about all of the accounts a user has linked with Privy.

Use the fields:
- **`user.linkAccounts`** to get a list of all the user's linked accounts
- **`user.telegram`** to get the user's Telegram account

TelegramAccount extends LinkedAccount