كيف يعمل التحقق من الهاتف على Telegram
لا يرى بوت Telegram رقم هاتف المُرسِل أبدًا، لذلك يختلف التحقق من رقم هناك عنه في WhatsApp. إليك المسار، والفحوص التي تقف خلفه، وما يعود إلى تطبيقك.
كان WhatsApp أول قناة في Phone-Verif، لكن ليس الجميع هناك. وأصبح Telegram الآن قناة ثانية: API نفسها والنتيجة نفسها، وهو مفعّل افتراضيًا. أما الآليات الكامنة فمختلفة، ومن المفيد فهمها قبل عرضه.
في WhatsApp، الإثبات هو رسالة يرسلها الشخص: تصل من رقمه، وهذه هي فكرة Reverse OTP. أما بوت Telegram فلا يملك مثل هذه الإشارة. فهو يتعرّف على الأشخاص بمعرّف حساب رقمي، ويبقى رقم هاتفهم خاصًا ما لم يختاروا مشاركته. لذلك يتعين على البوت أن يطلب الرقم، ويجب أن يأتي الإثبات من مكان آخر غير المُرسِل.
ما الذي يفعله الشخص
لا يوجد رمز للقراءة أو الكتابة. المسار كله نقرتان داخل Telegram.
1. افتح الرابط
تعرض صفحتك رمز QR أو زرًا. وكلاهما يقود إلى البوت لدينا مع رمز الجلسة محمولًا في الرابط.
2. اضغط على ابدأ
يسلّم الضغط على ابدأ ذلك الرمز إلى البوت، فيربط حساب Telegram هذا بالجلسة.
3. شارك الرقم
يعرض البوت زرًا واحدًا، "مشاركة رقم هاتفي". والنقر عليه يرسل بطاقة جهة الاتصال الخاصة بـ Telegram للحساب.
4. تم
يؤكد البوت، وتصبح الجلسة موثّقة، ويتلقى تطبيقك webhook ونتيجة الحالة.
لماذا تُعدّ جهة الاتصال المشاركة إثباتًا
يستطيع أي شخص أن يرسل إلى بوت سلسلة أرقام، لذلك تُرفض الأرقام المكتوبة تمامًا: يرد البوت بعرض الزر مجددًا. ولا تُقرأ إلا بطاقة جهة الاتصال، وعليها أن تجتاز أربعة فحوص قبل أن تكتمل الجلسة.
إنها جهة اتصاله الخاصة
يطابق معرّف المستخدم على البطاقة الحساب الذي يرسلها. أما بطاقة شخص آخر من دفتر العناوين فتفشل هنا.
تأتي من الحساب الصحيح
المُرسِل هو الحساب الذي ضغط على ابدأ في هذه الجلسة، فلا يمكن لبطاقة أن تُكمل جلسة فتحها شخص آخر.
لم تُعاد توجيهها
تُرفض البطاقة المُعاد توجيهها من محادثة أخرى، حتى لو كانت بطاقة المُرسِل نفسه.
إنها حديثة
أُرسلت البطاقة بعد فتح الجلسة، فلا يمكن إعادة تشغيل بطاقة قديمة.
البطاقة التي تفشل في أي فحص لا تغيّر شيئًا: يسأل البوت مجددًا وتبقى الجلسة مفتوحة. ويُرفض الرقم الموجود في القائمة المحظورة على Telegram تمامًا كما على WhatsApp.
كل جلسة تنتهي مرة واحدة
النقر المزدوج على الزر يرسل بطاقتي جهة اتصال، وقد يرسل تسليم أُعيدت محاولته البطاقة نفسها مرتين. لذلك يُطالَب بإتمام الجلسة بصورة ذرّية: تفوز بطاقة واحدة، وتكون هناك نتيجة واحدة وwebhook واحد ورصيد واحد مُنفَق.
ولا يمكن إكمال الجلسة إلا على قناة واحدة. فهي مفتوحة افتراضيًا على WhatsApp وSMS والبوت، وبمجرد أن تكملها إحداها ترفض القنوات الأخرى رمزها. أما الجلسة المقفلة على Telegram أو WhatsApp فترفض القناة الأخرى من البداية. ويعيد رابط البوت التوجيه بالطريقة نفسها لأي رمز، فلا يمكن استخدامه لمعرفة الرموز النشطة.
رقم واحد، هوية واحدة
يكتب Telegram وWhatsApp أرقام الهواتف بصيغ مختلفة، لذلك يُوحَّد الرقم إلى الصيغة نفسها قبل أي شيء آخر. وهذا مهم لأن الهويات تُفهرَس به.
الشخص الذي يتحقق عبر WhatsApp اليوم وعبر Telegram غدًا يحصل على user_id نفسه. إنه مستخدم واحد لا اثنان، ويُبلغ flow=login عن is_new_user وفق ذلك.
ونعتمد على ذلك بأنفسنا. فـ Telegram Connect وWhatsApp Connect في صفحة تسجيل الدخول لدينا يقودان إلى الحساب نفسه للرقم نفسه، أيًّا كان ما استخدمه الشخص أولًا.
ما الذي يعود
يقرأ تكاملك استجابة الحالة نفسها ويتلقى webhook نفسه كما في WhatsApp، ويكلّف التحقق الأرصدة نفسها. وتعمل مسارات phone وlogin و2fa كلها.
ويُضاف شيء واحد. ففي flow=phone، تحمل جلسة Telegram الموثّقة أيضًا كائن telegram يضم user_id وusername وfirst_name وlast_name للحساب. أما login و2FA فيستبعدانه: فهما يردّان بمعرّف مستخدم أو بتطابق، والمعرّف العلني يحدد الشخص تمامًا كما يفعل الرقم.
ما الذي لا يثبته
تُظهر الجلسة الموثّقة أن حساب Telegram هذا يملك هذا الرقم. لكنها لا تقول شيئًا عمّن يحمل بطاقة SIM اليوم، وهذا حد تشترك فيه مع كل قناة مبنية على حساب، كما يوضح مقال SIM swap.
ويعتمد فحص الملكية أيضًا على معرّف المستخدم الذي يبلّغ عنه Telegram في بطاقة جهة الاتصال. ولا تصف وثائق Bot API الخاصة بـ Telegram كيف يُملأ هذا الحقل، لذا فأنت هنا تثق بالمنصة، كما تثق برقم المُرسِل في WhatsApp.
وهناك حدود عملية أيضًا. فالشخص يحتاج إلى Telegram، ولا توجد للجلسة المقفلة على Telegram بدائل احتياطية عبر SMS.
إضافته
الجلسات مفتوحة على Telegram افتراضيًا، فلا حاجة إلى إضافة أي معامل. أرسل provider=telegram لقفل الجلسة على البوت، أو provider=whatsapp لاستبعاد البوت.
curl -X POST "https://api.phone-verif.com/start-verification" \
-H "X-API-Key: $PHONE_VERIF_API_KEY"تتضمن الاستجابة كتلة telegram إلى جانب whatsapp وsms، ما لم يكن Telegram غير متاح. رمّز qr_code_url في رمز QR، واستخدم direct_link لزر على الهاتف المحمول.
{
"whatsapp": { "...": "..." },
"sms": { "...": "..." },
"telegram": {
"qr_code_url": "https://t.phone-verif.com/tg/<token>",
"direct_link": "https://t.me/PhoneVerif_com_bot?start=<token>"
}
}يمكنك تجربته دون حساب في العرض التجريبي لـ Telegram. ويغطي دليل التكامل واجهة API كاملة.