Skip to content
Tehnic
6 min de citit6 noiembrie 2026

Cum funcționează verificarea numărului de telefon pe Telegram

Un bot Telegram nu vede niciodată numărul de telefon al expeditorului, așa că verificarea de acolo diferă de cea de pe WhatsApp. Iată fluxul, verificările din spate și ce primește aplicația dumneavoastră.

Stânga: o conversație cu un bot, cu un mesaj și un buton albastru pentru partajarea unui număr de telefon. O săgeată indică spre dreapta, către un scut alb cu o bifă albastră pe fundal albastru, semnificând că numărul partajat a fost verificat

WhatsApp a fost primul canal pentru Phone-Verif, dar nu toată lumea îl folosește. Telegram este acum un al doilea canal: același API, același rezultat și activ în mod implicit. Mecanica de dedesubt este diferită și merită înțeleasă înainte de a-l oferi.

Pe WhatsApp, dovada este un mesaj trimis de persoană: ajunge de la numărul ei, ceea ce stă la baza conceptului Reverse OTP. Un bot Telegram nu are un astfel de semnal. Identifică oamenii printr-un ID numeric de cont, iar numărul lor de telefon rămâne privat, cu excepția cazului în care aleg să îl partajeze. Așadar, botul trebuie să îl ceară, iar dovada trebuie să vină din altă parte decât de la expeditor.

Ce face persoana

Nu există niciun cod de citit sau de tastat. Întregul flux înseamnă două atingeri în Telegram.

1. Deschide linkul

Pagina dumneavoastră afișează un cod QR sau un buton. Ambele duc la botul nostru, cu tokenul sesiunii inclus în link.

2. Apasă Start

Apăsarea butonului Start transmite tokenul botului, care leagă acest cont Telegram de sesiune.

3. Partajează numărul

Botul afișează un singur buton, „Partajează numărul meu de telefon”. Atingerea lui trimite cartea de contact proprie Telegram pentru acel cont.

4. Gata

Botul confirmă, sesiunea devine verificată, iar aplicația dumneavoastră primește webhookul și rezultatul de stare.

De ce un contact partajat contează ca dovadă

Oricine poate trimite unui bot un șir de cifre, așa că numerele tastate sunt refuzate din start: botul răspunde afișând din nou butonul. Doar o carte de contact este citită, iar aceasta trebuie să treacă patru verificări înainte ca sesiunea să se poată finaliza.

Este propriul contact

ID-ul de utilizator de pe carte corespunde contului care o trimite. Cartea altcuiva, dintr-o agendă, eșuează aici.

Provine de la contul potrivit

Expeditorul este contul care a apăsat Start pentru această sesiune, deci o carte nu poate finaliza o sesiune deschisă de altcineva.

Nu a fost redirecționată

O carte redirecționată dintr-o altă conversație este refuzată, chiar dacă aparține expeditorului.

Este recentă

Cartea a fost trimisă după deschiderea sesiunii, deci una veche nu poate fi reluată.

O carte care eșuează la oricare verificare nu schimbă nimic: botul cere din nou, iar sesiunea rămâne deschisă. Un număr aflat pe lista de blocare este refuzat pe Telegram la fel ca pe WhatsApp.

Fiecare sesiune se încheie o singură dată

O dublă atingere a butonului trimite două cărți de contact, iar o livrare reîncercată poate trimite aceeași carte de două ori. De aceea, finalizarea unei sesiuni este revendicată atomic: o singură carte câștigă, rezultând un singur rezultat, un singur webhook și un singur credit consumat.

O sesiune se poate încheia, de asemenea, pe un singur canal. Implicit, este deschisă pentru WhatsApp, SMS și bot, iar imediat ce unul dintre ele o finalizează, celelalte îi refuză tokenul. O sesiune blocată pe Telegram sau pe WhatsApp refuză celălalt canal de la început. Linkul botului redirecționează la fel pentru orice token, deci nu poate fi folosit pentru a afla care tokenuri sunt active.

Un număr, o identitate

Telegram și WhatsApp scriu numerele de telefon diferit, așa că numărul este normalizat la aceeași formă înainte de orice altceva. Contează, pentru că identitățile se bazează pe el.

O persoană care se verifică astăzi pe WhatsApp și mâine pe Telegram primește același user_id. Este un singur utilizator, nu doi, iar flow=login raportează is_new_user în consecință.

Ne bazăm și noi pe acest lucru. Telegram Connect și WhatsApp Connect de pe propria noastră pagină de autentificare duc la același cont pentru același număr, indiferent pe care l-a folosit persoana prima dată.

Ce primiți înapoi

Integrarea dumneavoastră citește același răspuns de stare și primește același webhook ca pe WhatsApp, iar o verificare costă aceleași credite. Fluxurile phone, login și 2fa funcționează toate.

Se adaugă un singur element. Pe flow=phone, o sesiune Telegram verificată conține și un obiect telegram cu user_id, username, first_name și last_name ale contului. Login și 2FA îl omit: răspund cu un ID de utilizator sau cu o potrivire, iar un handle ar identifica persoana la fel ca un număr.

Ce nu dovedește

O sesiune verificată arată că acest cont Telegram deține acest număr. Nu spune nimic despre cine are cartela SIM astăzi, o limită pe care o împarte cu orice canal construit pe un cont, așa cum explică articolul despre SIM swap.

Verificarea dreptului de proprietate depinde, de asemenea, de ID-ul de utilizator raportat de Telegram pe cartea de contact. Documentația Bot API a Telegram nu descrie cum este completat acest câmp, deci aici vă bazați pe platformă, așa cum vă bazați pe numărul expeditorului pe WhatsApp.

Există și limite practice. Persoana are nevoie de Telegram, iar o sesiune blocată pe Telegram nu are fallback prin SMS.

Adăugarea lui

Sesiunile sunt deschise pentru Telegram în mod implicit, deci nu trebuie adăugat niciun parametru. Trimiteți provider=telegram pentru a bloca o sesiune pe bot sau provider=whatsapp pentru a exclude botul.

curl -X POST "https://api.phone-verif.com/start-verification" \
  -H "X-API-Key: $PHONE_VERIF_API_KEY"

Răspunsul conține un bloc telegram alături de whatsapp și sms, cu excepția cazului în care Telegram nu este disponibil. Codificați qr_code_url în codul QR și folosiți direct_link pentru un buton pe mobil.

{
  "whatsapp": { "...": "..." },
  "sms": { "...": "..." },
  "telegram": {
    "qr_code_url": "https://t.phone-verif.com/tg/<token>",
    "direct_link": "https://t.me/PhoneVerif_com_bot?start=<token>"
  }
}

Îl puteți încerca fără cont în demonstrația Telegram. Ghidul de integrare acoperă întregul API.