Skip to content
Технічне
6 хв читання6 листопада 2026 р.

Як працює верифікація номера телефону в Telegram

Telegram-бот ніколи не бачить номер телефону відправника, тому верифікація тут працює інакше, ніж у WhatsApp. Ось сам процес, перевірки за ним і те, що повертається у ваш застосунок.

Ліворуч: чат із ботом, у якому видно повідомлення та синю кнопку для передання номера телефону. Стрілка вказує праворуч на білий щит із синьою позначкою на синьому тлі, що означає: переданий номер верифіковано

WhatsApp був першим каналом Phone-Verif, але не всі сидять саме там. Telegram тепер другий канал: той самий API, той самий результат, і він увімкнений типово. Механіка всередині інша, і її варто зрозуміти, перш ніж пропонувати цей канал.

У WhatsApp доказом є повідомлення, яке надсилає людина: воно приходить з її номера, і на цьому тримається ідея Reverse OTP. У Telegram-бота такого сигналу немає. Він розпізнає людей за числовим ідентифікатором акаунта, а номер телефону лишається приватним, доки людина сама не вирішить ним поділитися. Тож боту доводиться питати, а доказ має надійти не від самого відправника.

Що робить людина

Код читати чи вводити не потрібно. Весь процес — два дотики всередині Telegram.

1. Відкрити посилання

На вашій сторінці з'являється QR-код або кнопка. Обидва ведуть до нашого бота, а токен сесії передається в посиланні.

2. Натиснути Start

Натискання Start передає цей токен боту, який зв'язує цей акаунт Telegram із сесією.

3. Поділитися номером

Бот показує єдину кнопку «Поділитися моїм номером телефону». Після дотику вона надсилає власну контактну картку Telegram для цього акаунта.

4. Готово

Бот підтверджує, сесія стає верифікованою, а ваш застосунок отримує webhook і результат статусу.

Чому переданий контакт вважається доказом

Будь-хто може надіслати боту набір цифр, тому номери, введені вручну, відхиляються одразу: бот у відповідь знову показує кнопку. Зчитується лише контактна картка, і перш ніж сесію буде завершено, вона має пройти чотири перевірки.

Це власний контакт людини

Ідентифікатор користувача на картці збігається з акаунтом, який її надсилає. Чужа картка з адресної книги тут не проходить.

Вона надійшла з потрібного акаунта

Відправник — це акаунт, який натиснув Start у цій сесії, тож картка не може завершити сесію, відкриту кимось іншим.

Її не було переслано

Картку, переслану з іншого чату, буде відхилено, навіть якщо це власна картка відправника.

Вона свіжа

Картку надіслано вже після відкриття сесії, тому стару картку повторно використати не вдасться.

Картка, що не пройшла будь-яку з перевірок, нічого не змінює: бот просить ще раз, а сесія залишається відкритою. Номер зі списку блокування відхиляється в 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.