Telegram Code

Telegram is filtered in Iran but widely used, and it does not depend on Google or Apple. Users without Telegram need another method, such as e-mail or magic link.

1Create and connect a bot#

1. In Telegram, talk to @BotFather, send /newbot, and pick a name and username for your bot (for example MyAppLoginBot). BotFather gives you a bot token.
2. In Abrova Console, open Abrova Auth › Sign-in methods, turn on Telegram, and paste the bot token.

Abrova Auth checks the token with Telegram and connects the bot. The token is stored encrypted and never shown again. Use the bot for Abrova Auth only: Abrova takes over its incoming messages.

2How the user signs in#

1. 1The user enters a phone numberIn international format, for example +989121234567. Your app calls requestTelegramCode.
2. 2First time only: the user connects the botIf this number has not talked to your bot yet, the answer has sent: false and a botUrl. Open it: the user presses Start and taps "Share my phone number".
3. 3The code arrives in TelegramA 6-digit code, valid for 5 minutes. After the first time, codes arrive right away (sent: true).
4. 4The user types the codeYour app calls verifyTelegramCode with the number and the code.

The bot accepts only the user's own number, shared with Telegram's button. A forwarded contact of someone else is refused.

3Code#

// Flutter
final auth = AbrovaAuth.instance;
final r = await auth.requestTelegramCode('+989121234567');
if (!r.sent && r.botUrl != null) {
  await launchUrl(Uri.parse(r.botUrl!)); // url_launcher: the user starts the bot and shares the number
}
// ... the user types the code from Telegram:
await auth.verifyTelegramCode('+989121234567', code);

// iOS
let r = try await AbrovaAuth.shared.requestTelegramCode(phone: "+989121234567")
if !r.sent, let url = r.botURL { await UIApplication.shared.open(url) }
try await AbrovaAuth.shared.verifyTelegramCode(phone: "+989121234567", code: code)

// Android
val r = AbrovaAuth.shared.requestTelegramCode("+989121234567")
if (!r.sent) startActivity(Intent(Intent.ACTION_VIEW, Uri.parse(r.botUrl)))
AbrovaAuth.shared.verifyTelegramCode("+989121234567", code)

// Web and React Native
const { sent, botUrl } = await auth.requestTelegramCode({ phone: '+989121234567' });
if (!sent && botUrl) window.open(botUrl); // React Native: Linking.openURL(botUrl)
await auth.verifyTelegramCode({ phone: '+989121234567', code });

The first successful code for a number creates the user. Later codes for that number sign in to the same user.

Rules#

getMethods() returns the bot's username as telegramBot when Telegram is on, if you want to show it ("Codes come from @MyAppLoginBot").

Errors#