Skip to content

Log in with Telegram using Privy

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

You need to request access to Telegram from the login methods page.

Configure Telegram login

Once you have access, 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
  • Bot name

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.

INFO

Since you need to set your bot's allowed domain you'll need to use a tunneling tool for local development such as Cloudflare tunel or ngrok.

Essential: Secure your bot secret

WARNING

Telegram login requires developers to create a Telegram bot with a bot secret. This bot secret controls the Telegram bot and is also used as a symmetric key for authentication. Control over this key enables a developer to sign over authentication data, meaning compromise of this key puts your users (and their accounts) at risk.

Securing this symmetric key is essential for the security of all of your app’s Telegram logins.

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.

jsx
  <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.

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

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.

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:

jsx
const {linkTelegram, unlinkTelegram} = usePrivy();

TelegramAccount type

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

jsx
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

FieldTypeDescription
type'telegram'N/A
telegram_user_idstringID of a user's telegram account.
first_namestringThe first name displayed on a user's telegram account.
last_namestring(Optional) The last name displayed on a user's telegram account.
usernamestring(Optional) The username displayed on a user's telegram account.
photo_urlstring(Optional) The url of a user's telegram account profile picture.