کد تلگرام

تلگرام در ایران فیلتر است اما پرکاربرد است، و به Google یا Apple وابسته نیست. کاربرانی که تلگرام ندارند به روش دیگری مثل ایمیل یا لینک یک‌بارمصرف نیاز دارند.

۱ساخت و وصل کردن ربات#

1. در تلگرام با @BotFather صحبت کنید، /newbot را بفرستید و یک نام و username برای ربات‌تان انتخاب کنید (مثلاً MyAppLoginBot). BotFather یک bot token به شما می‌دهد.
2. در کنسول ابرووا، Abrova Auth › روش‌های ورود را باز کنید، تلگرام را روشن کنید و bot token را جای‌گذاری کنید.

Abrova Auth توکن را با تلگرام بررسی می‌کند و ربات را وصل می‌کند. توکن رمزگذاری‌شده ذخیره می‌شود و دیگر نمایش داده نمی‌شود. از ربات فقط برای Abrova Auth استفاده کنید: ابرووا پیام‌های ورودی آن را در دست می‌گیرد.

۲کاربر چطور وارد می‌شود#

1. ۱کاربر شماره تلفن را وارد می‌کندبا قالب بین‌المللی، مثلاً +989121234567. اپ شما requestTelegramCode را صدا می‌زند.
2. ۲فقط بار اول: کاربر ربات را وصل می‌کنداگر این شماره هنوز با ربات شما صحبت نکرده باشد، پاسخ sent: false و یک botUrl دارد. آن را باز کنید: کاربر Start را می‌زند و روی «Share my phone number» ضربه می‌زند.
3. ۳کد در تلگرام می‌رسدیک کد ۶ رقمی با اعتبار ۵ دقیقه. بعد از بار اول، کدها بلافاصله می‌رسند (sent: true).
4. ۴کاربر کد را تایپ می‌کنداپ شما verifyTelegramCode را با شماره و کد صدا می‌زند.

ربات فقط شماره‌ی خودِ کاربر را می‌پذیرد که با دکمه‌ی تلگرام به اشتراک گذاشته شده باشد. مخاطبِ فورواردشده‌ی شخص دیگر رد می‌شود.

۳کد#

// 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 });

اولین کد موفق برای یک شماره، کاربر را می‌سازد. کدهای بعدی برای آن شماره به همان کاربر وارد می‌شوند.

قواعد#

وقتی تلگرام روشن است، getMethods() نام کاربری ربات را به‌صورت telegramBot برمی‌گرداند، اگر بخواهید آن را نشان دهید («کدها از @MyAppLoginBot می‌آیند»).

خطاها#