Telegram Gateway: коды подтверждения вместо SMS за $0.01 — гайд для бизнеса

По прайсу коды через Telegram дешевле SMS: Telegram Gateway берёт $0.01 за доставленный код подтверждения, и сам Telegram называет это «до 50 раз дешевле», чем SMS. Подключается сервис через HTTP API с токеном доступа, так что без разработчика не обойтись. Помешать могут три вещи. Первая — оплата: кредиты покупаются заранее через платформу Fragment, все транзакции которой идут через блокчейн TON, покупка окончательная, а остаток сгорает через 3 года. Вторая — клиенты без Telegram или с плохим доступом к нему. Третья — вопросы закона и учёта, которые российской компании нужно закрыть до запуска. Поэтому большинству подойдёт смешанная схема: сначала код уходит в Telegram, а если он не дошёл, клиент получает SMS.

Что такое Telegram Gateway и чем он отличается от входа через Telegram и бота

Telegram Gateway — официальный сервис Telegram для проверки номеров телефона. Компания передаёт номер клиента, и код приходит владельцу номера в Telegram на телефон или компьютер. Клиенту нужен только интернет, тариф с SMS не требуется.

Вход через Telegram решает другую задачу: пользователь входит на сайт своим аккаунтом Telegram. Gateway подтверждает конкретный номер, который клиент ввёл у вас при регистрации, оформлении заказа или смене пароля. От бота Gateway отличается так же: бот может написать человеку только после того, как тот сам начал с ним диалог, а Gateway отправляет код по номеру телефона.

Сервис запустили в октябре 2024 года и заявили доступным по всему миру, анонсировал его Павел Дуров. По его словам, Telegram сам тратит около $10 млн в месяц на проверку пользователей при регистрации и входе. Цену Gateway Дуров назвал «беспрецедентно низкой» и сказал, что не обязательно ждёт от сервиса заметной выручки.

Сколько стоит код и с чем сравнивать $0.01

Официальная цена — $0.01 за код. В октябрьском сравнении SMS, WhatsApp и Telegram от Broadnet сказано, что она одинакова во всех странах. При этом по условиям сервиса Telegram сам определяет цену сообщения и вправе менять её с учётом бизнеса, регуляторных факторов и экономической ситуации. Цена фиксируется в момент отправки.

По текущей цене 10 000 доставленных кодов стоят $100, а 100 000 — $1 000. В рубли не пересчитываем: итог зависит от курса на день оплаты кредитов.

Для сравнения есть только цены на момент запуска Gateway в 2024 году. У Twilio базовая ставка была $0.03 и $0.05 за успешную проверку плюс местная плата за SMS, у Message Central — $0.05 за код. На ноябрь 2026 эти цифры не проверены, проверенных цен российских SMS-агрегаторов у нас тоже нет. Поэтому ориентируйтесь на свой договор: во сколько вам сейчас обходится один SMS-код.

За какие коды платят, а за какие нет

Источники на первый взгляд противоречат друг другу. По условиям сервиса плата начисляется при отправке и не возвращается в зависимости от доставки или прочтения. А официальная страница обещает автоматический возврат за коды, не доставленные в срок, который задал бизнес.

Объяснение есть в документации API. 26 февраля 2025 года там уточнили работу параметра ttl: если сообщение не доставлено за указанное время, плата за запрос возвращается автоматически. Отсюда наш вывод: возврат работает, когда ttl задан. Прямо Telegram этого не формулирует. Был ли возврат по конкретному запросу, показывает поле is_refunded в объекте RequestStatus.

Точной суммы за проверку в документации нет. Провайдер Routee поясняет, что при положительной проверке заранее списывается плата за одно сообщение. Значит, если отправлять код с тем же request_id, проверка и отправка вместе оплачиваются один раз. Вызов sendVerificationMessage без request_id создаёт новый платный запрос, а повторная отправка по уже использованному request_id вернёт ошибку. Возвращается ли плата за проверку, если код, отправленный по её request_id, не доставлен за время ttl, в найденных источниках не сказано.

Как устроена оплата: кредиты, Fragment и Gram

Отправлять коды можно только после пополнения баланса кредитами. Обработку платежей за кредиты Telegram передал платформе Fragment, которой владеет и управляет Fragment Corp. Поэтому действуют ещё и условия Fragment и её политика конфиденциальности. По условиям Fragment, все транзакции на платформе проходят через блокчейн TON. Broadnet тоже пишет, что Telegram принимает оплату кредитов в TON. Монета этой сети теперь называется Gram (тикер GRAM). Об оплате кредитов Gateway картой в найденных источниках ничего нет.

Что важно знать до первого пополнения:

• Покупка кредитов окончательная, деньги за неё не возвращаются. По стороннему обзору условий Fragment, платёж там окончателен с момента записи в блокчейн.
• Кредиты действуют 3 года с даты покупки, после этого остаток сгорает.
• Баланс — это авансом оплаченные кредиты, а не ваши деньги на депозите у Telegram. Если вы потеряете доступ к аккаунту, кредиты сгорят без компенсации.
• Проверять, что оплата зачислена на нужный аккаунт Gateway, должны вы сами. Переводить средства между аккаунтами Gateway сейчас нельзя.
• Налоги и другие обязательные платежи по покупкам в Gateway компания рассчитывает, декларирует и платит сама.

Минимальную сумму пополнения и скидки за объём мы не нашли. Для первого пополнения разумно взять небольшую сумму: отчёт за первые недели покажет, какая доля кодов реально доходит через Telegram.

Как подключить Telegram Gateway

1. Заведите аккаунт Telegram Gateway. Описание сервиса опубликовано на core.telegram.org/gateway, справочник API — на core.telegram.org/gateway/api. Нужна ли проверка компании, в наших источниках не описано.
2. Возьмите токен доступа в настройках аккаунта Gateway. Он передаётся в каждом запросе, например в заголовке «Authorization: Bearer <token>». Храните токен только на сервере, а не в коде сайта или приложения.
3. Отправляйте запросы на адрес gatewayapi.telegram.org/METHOD, где METHOD — название метода. Методов четыре: checkSendAbility проверяет, можно ли отправить код; sendVerificationMessage отправляет код; checkVerificationStatus показывает статус доставки и проверяет введённый клиентом код, если передать параметр code; revokeVerificationMessage отзывает сообщение.
4. Отладьте сценарий на своём номере: коды самому себе бесплатны.
5. Пополните баланс небольшой суммой и сначала включите Gateway для части клиентов.

Параметры метода sendVerificationMessage для отправки кода после успешной проверки. Формат передачи параметров уточните в справочнике API.

• phone_number — номер клиента в формате E.164, например +7XXXXXXXXXX. Обязательный параметр.
• request_id — значение из ответа checkSendAbility. С ним отправка бесплатна.
• code_length — длина кода, если его генерирует Telegram. Вместо этого можно передать code — свой код из 4–8 цифр, тогда code_length игнорируется.
• ttl — срок доставки в секундах, от 30 до 3600.
• callback_url — адрес вашего сервера для отчётов о доставке.
• payload — ваши данные, например номер заказа, до 128 байт.
• sender_username — канал, от имени которого придёт код (подробнее ниже).

Ответ приходит в виде объекта RequestStatus. В нём есть request_cost (сколько списано), remaining_balance (остаток кредитов), delivery_status, verification_status и ваш payload. Если указан callback_url, API отправит этот объект на ваш сервер HTTP POST-запросом в формате JSON. Тогда статус доставки не обязательно опрашивать через checkVerificationStatus.

Как код выглядит у клиента и зачем нужно согласие

Параметр sender_username позволяет отправлять код от имени вашего Telegram-канала. Канал должен быть верифицирован и принадлежать тому же аккаунту, которому выдан токен Gateway API.

Номера пользователей Telegram скрыты, поэтому клиент должен сам указать вам номер и согласиться получать от вас сообщения в Telegram. Это согласие стоит запрашивать прямо в форме ввода номера.

Схема «сначала Telegram, потом SMS»

1. Клиент вводит номер, сервер вызывает checkSendAbility. Если отправить код нельзя, плата не берётся.
2. Если отправить нельзя, сразу отправляйте SMS через текущего агрегатора.
3. Если можно, вызывайте sendVerificationMessage с полученным request_id, ttl и callback_url, а клиенту показывайте подсказку «Код отправлен в Telegram».
4. Если отчёт на callback_url показывает, что за время ttl код не доставлен, отправляйте SMS. Вернётся ли в этом случае плата за проверку, в источниках не описано, поэтому сверяйте поля request_cost и is_refunded.
5. Оставьте на экране кнопку «Получить код по SMS» для тех, кто не может открыть Telegram.

Ключевая настройка схемы — ttl. При большом значении клиент долго ждёт кода. При маленьком в SMS попадут те, у кого Telegram просто медленно открылся. Подбирайте значение по отчёту в интерфейсе Gateway: там видны статусы сообщений, конверсия и расходы.

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

Ниже — вопросы для проверки, а не готовые ответы.

• Закон. Можно ли вашей компании отправлять коды через иностранный мессенджер, особенно если вы банк, госорган, оператор связи или маркетплейс. Мы не смогли это проверить и не утверждаем, что запрет есть или что его нет. Нужна консультация юриста.
• Оплата. Может ли ваше юрлицо покупать кредиты через Fragment, где транзакции проходят в блокчейне TON, и как отразить такую покупку в учёте. По стороннему обзору, условия Fragment допускают ограничения сервиса в отдельных странах. Обсудите это с юристом и бухгалтером до пополнения.
• Доступность Telegram. Данных о том, как коды Gateway доходят до российских пользователей при замедлениях и сбоях, нет. Например, 9–10 ноября Telegram работал со сбоями. С первого дня считайте, какая доля кодов уходит в SMS.
• Содержание сообщений. За контент, который нарушает местные законы или условия Telegram, аккаунт закрывают сразу. Другие нарушения условий могут привести к временному или постоянному запрету пользоваться Gateway или приложениями Telegram.

Ещё одна платная функция API: рассылки ботом за Stars

В обзоре Telegram API за 2026 год от Upload-Post названы две платные функции. Первая — Gateway, вторая — платные рассылки: бот может отправлять до 1 000 сообщений в секунду, а каждое сообщение сверх бесплатного лимита стоит 0,1 Telegram Star. Получается, 1 000 платных сообщений обойдутся в 100 звёзд. Размер бесплатного лимита, требования к боту и способ пополнения его баланса мы не проверяли.

Ориентир в рублях: на Starnbuy 100 звёзд стоят 138 ₽, 1 000 звёзд — 1 376 ₽ (страница покупки звёзд).

Итог: кому Gateway подходит, а кому лучше остаться на SMS

Подходит интернет-магазинам, сервисам и ботам с большим потоком регистраций и подтверждений при трёх условиях: клиенты активно пользуются Telegram, есть разработчик, который настроит схему с запасным SMS, и компания может законно оплатить кредиты.

Лучше остаться на SMS в трёх случаях: юрист не подтвердил, что в вашей отрасли можно отправлять коды через иностранный мессенджер; компания не может законно оплатить кредиты; заметная часть клиентов не пользуется Telegram. Кроме того, при небольшом числе кодов экономия может не окупить интеграцию.

Частые вопросы

Придёт ли код, если у клиента Telegram только на компьютере?

Да. Код приходит в Telegram на телефон или компьютер, нужен только интернет.

Можно ли отменить уже отправленный код?

Только пока он не доставлен. Метод revokeVerificationMessage не удаляет сообщение, которое уже доставили или прочитали.

Можно ли перенести кредиты на другой аккаунт Gateway?

Нет, переводы между аккаунтами сейчас недоступны. Поэтому заранее решите, на какой аккаунт пополнять баланс, и защитите доступ к нему: при потере доступа кредиты сгорают.

Можно ли использовать свои коды, а не коды Telegram?

Да. Передайте свой код из 4–8 цифр в параметре code, тогда code_length не учитывается.

Источники

• core.telegram.org
• upload-post.com
• broadnet.me
• binance.com
• ccn.com
• mpost.io
• corbado.com
• telegram.org