VP Social Login - Configuring Telegram login

Telegram works differently from the other providers: instead of an OAuth client, you create a Telegram bot, tell it your site domain, and paste the bot's username and token into the plugin.

Create a bot with BotFather

  1. Open @BotFather in Telegram.
  2. Send /newbot and follow the prompts: choose a display name, then a username ending in bot.
  3. BotFather replies with your bot's token — keep it safe.
Creating a Telegram bot with BotFather using the newbot command
Create a bot with /newbot and copy its token.

Set your site domain

Telegram only allows logins from a domain you've registered for the bot:

  1. In @BotFather, send /setdomain.
  2. Choose your bot.
  3. Enter your site's domain.
Setting the site domain for the bot with the setdomain command in BotFather
Register your domain with /setdomain.

Use the bare domain only — for example your-site.com, not https://your-site.com and not a path. The wrong format is the most common reason Telegram login silently fails to return.

Enter the details in Joomla

Open System - VP Social Login → Telegram, switch Enabled on, then fill in:

  • Bot username — without the @ (for example your_login_bot).
  • Bot token — the token from BotFather.

Click Save.

Telegram tab of the System - VP Social Login plugin with bot username and token
Enable Telegram and enter the bot username and token.

Test it

Log out, open your login page, and click Continue with Telegram. Telegram asks you to confirm, then returns you to the site signed in.

Telegram never shares an e-mail address. VP Social Login gives Telegram accounts a stable internal address automatically, so sign-in and linking keep working — there's nothing extra to configure.

If you've authorised the bot for your domain before, Telegram may sign you in without a prompt — that's expected, it remembers the authorisation.