Skip to content
Technika
6 min czytania6 listopada 2026

Jak działa weryfikacja telefonu na Telegramie

Bot Telegram nigdy nie widzi numeru telefonu nadawcy, więc weryfikacja numeru działa tam inaczej niż w WhatsApp. Oto przepływ, kontrole za nim stojące i to, co wraca do Państwa aplikacji.

Po lewej: czat z botem, na którym widać wiadomość i niebieski przycisk udostępniania numeru telefonu. Strzałka wskazuje w prawo na białą tarczę z niebieskim znacznikiem na niebieskim tle, co oznacza, że udostępniony numer został zweryfikowany

WhatsApp był pierwszym kanałem Phone-Verif, ale nie wszyscy z niego korzystają. Telegram jest teraz drugim kanałem: to samo API, ten sam wynik i domyślnie włączony. Mechanika pod spodem jest inna i warto ją zrozumieć, zanim zostanie zaoferowany.

W WhatsApp dowodem jest wiadomość wysłana przez użytkownika: przychodzi z jego numeru, na czym polega idea Reverse OTP. Bot Telegram nie ma takiego sygnału. Identyfikuje osoby po numerycznym identyfikatorze konta, a ich numer telefonu pozostaje prywatny, dopóki sami go nie udostępnią. Bot musi więc o niego poprosić, a dowód musi pochodzić z innego źródła niż nadawca.

Co robi użytkownik

Nie ma kodu do odczytania ani wpisania. Cały przepływ to dwa dotknięcia w Telegramie.

1. Otwarcie linku

Strona wyświetla kod QR lub przycisk. Oba prowadzą do naszego bota, a token sesji jest zawarty w linku.

2. Naciśnięcie Start

Naciśnięcie Start przekazuje ten token botowi, który wiąże to konto Telegram z sesją.

3. Udostępnienie numeru

Bot pokazuje jeden przycisk, „Udostępnij mój numer telefonu”. Jego dotknięcie wysyła wizytówkę kontaktową konta wygenerowaną przez Telegram.

4. Gotowe

Bot potwierdza, sesja zostaje zweryfikowana, a aplikacja otrzymuje webhook i wynik statusu.

Dlaczego udostępniony kontakt jest dowodem

Każdy może wysłać botowi ciąg cyfr, dlatego wpisane numery są od razu odrzucane: bot odpowiada, pokazując przycisk ponownie. Odczytywana jest tylko wizytówka kontaktowa, która musi przejść cztery kontrole, zanim sesja zostanie ukończona.

To jego własny kontakt

Identyfikator użytkownika na wizytówce odpowiada kontu, które ją wysyła. Cudza wizytówka z książki adresowej nie przejdzie tej kontroli.

Pochodzi z właściwego konta

Nadawcą jest konto, które nacisnęło Start w tej sesji, więc wizytówka nie może ukończyć sesji otwartej przez kogoś innego.

Nie została przekazana dalej

Wizytówka przekazana z innego czatu jest odrzucana, nawet jeśli jest własną wizytówką nadawcy.

Jest świeża

Wizytówkę wysłano po otwarciu sesji, więc nie można odtworzyć starej.

Wizytówka, która nie przejdzie którejkolwiek kontroli, niczego nie zmienia: bot prosi ponownie, a sesja pozostaje otwarta. Numer z czarnej listy jest odrzucany na Telegramie tak samo jak w WhatsApp.

Każda sesja kończy się raz

Podwójne dotknięcie przycisku wysyła dwie wizytówki, a ponowione dostarczenie może wysłać tę samą dwa razy. Ukończenie sesji jest więc przejmowane atomowo: wygrywa jedna wizytówka i powstaje jeden wynik, jeden webhook i zużywany jest jeden kredyt.

Sesję można też zakończyć tylko w jednym kanale. Domyślnie jest otwarta na WhatsApp, SMS i bota, a gdy jeden z nich ją zakończy, pozostałe odrzucają jej token. Sesja zablokowana na Telegramie lub WhatsAppie odrzuca drugi kanał od samego początku. Link do bota przekierowuje tak samo dla każdego tokena, więc nie można go użyć do ustalenia, które tokeny są aktywne.

Jeden numer, jedna tożsamość

Telegram i WhatsApp zapisują numery telefonów inaczej, więc numer jest normalizowany do tej samej postaci, zanim cokolwiek się wydarzy. Ma to znaczenie, ponieważ tożsamości są oparte na tym numerze.

Osoba, która dziś weryfikuje się w WhatsApp, a jutro w Telegramie, otrzymuje to samo user_id. To jeden użytkownik, a nie dwóch, a flow=login odpowiednio raportuje is_new_user.

Sami na tym polegamy. Telegram Connect i WhatsApp Connect na naszej stronie logowania prowadzą do tego samego konta dla tego samego numeru, niezależnie od tego, którego użytkownik użył jako pierwszego.

Co wraca

Integracja odczytuje tę samą odpowiedź ze statusem i otrzymuje ten sam webhook co w WhatsApp, a weryfikacja kosztuje tyle samo kredytów. Przepływy phone, login i 2fa działają wszystkie.

Dodano jedną rzecz. W flow=phone zweryfikowana sesja Telegram zawiera też obiekt telegram z polami konta: user_id, username, first_name i last_name. Logowanie i 2FA je pomijają: odpowiadają identyfikatorem użytkownika lub dopasowaniem, a nazwa użytkownika identyfikowałaby osobę tak samo jak numer.

Czego to nie dowodzi

Zweryfikowana sesja pokazuje, że to konto Telegram posiada ten numer. Nic nie mówi o tym, kto ma dziś kartę SIM, a to ograniczenie dzieli z każdym kanałem opartym na koncie, co wyjaśnia artykuł o SIM swap.

Kontrola własności zależy również od identyfikatora użytkownika, który Telegram podaje na wizytówce kontaktowej. Dokumentacja Bot API Telegrama nie opisuje, jak to pole jest wypełniane, więc tutaj ufa się platformie, tak jak numerowi nadawcy w WhatsApp.

Są też ograniczenia praktyczne. Użytkownik musi mieć Telegram, a sesja zablokowana na Telegramie nie ma rozwiązania awaryjnego przez SMS.

Dodanie kanału

Sesje są domyślnie otwarte na Telegram, więc nie trzeba dodawać żadnego parametru. Aby zablokować sesję na bocie, należy wysłać provider=telegram, a aby wykluczyć bota, provider=whatsapp.

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

Odpowiedź zawiera blok telegram obok whatsapp i sms, chyba że Telegram jest niedostępny. Wartość qr_code_url należy zakodować w kodzie QR, a direct_link wykorzystać do przycisku na urządzeniach mobilnych.

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

Można to wypróbować bez konta w demo Telegrama. Pełne API opisuje przewodnik integracji.