Предполётный чек-лист для получения кодов входа Telegram на тестовый номер

Что должно быть готово перед заказом номера Telegram?

Сначала пройдитесь по этому списку: большинство неудачных тестов Telegram сводится к одному из пунктов.

• Чёткая цель. Вы тестируете бота, Mini App, виджет входа или рабочий процесс поддержки, которыми управляет ваша команда, и вам нужен новый аккаунт Telegram, не связанный с личным телефоном сотрудника.
• Целевая страна. Решите, к какому рынку должен относиться аккаунт. Язык по умолчанию и некоторые экраны онбординга зависят от страны номера.
• Средства на кошельке или sandbox. Пополненный предоплаченный кошелёк либо тестовый аккаунт, который поддержка перевела в sandbox для пробных прогонов.
• Ключ API, если вы автоматизируете. Создайте ключ с префиксом or_live_ в консоли разработчика.
• Чистое устройство или эмулятор. Telegram доставляет коды внутрь приложения в любую уже открытую сессию, поэтому устройство без активных сессий делает путь через SMS предсказуемым.
• Время. Каждая активация открыта 20 минут; не запускайте её, пока тестировщик не готов вводить номер.

Когда Telegram на самом деле отправляет SMS-код?

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

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

Какие страны можно выбрать для Telegram и почему это важно?

Сервис telegram сейчас доступен в 199 странах, включая Индию, Германию, Бразилию, Нигерию, Индонезию, Великобританию, Украину, Казахстан, Узбекистан, Турцию, Испанию, Мексику, Филиппины, Вьетнам и Египет.

Подбирайте страну под тестовый сценарий. Бота, отвечающего по-португальски, стоит проверять с бразильского аккаунта; команде поддержки, обслуживающей Центральную Азию, может понадобиться казахстанский номер. Telegram также может относиться к номерам некоторых стран осторожнее, чем к другим, так что если один маршрут постоянно не срабатывает, разумной запасной опцией будет соседний рынок. Доступность меняется в течение дня, поэтому узнавайте её из API, а не из сохранённого списка.

Как автоматизировать получение кода Telegram через API?

1. При желании проверьте стоимость: GET /api/v1/prices?country=<id>&service=telegram.
2. Создайте заказ: POST /api/v1/activations с телом {"service": "telegram", "country": "<id>"}, где идентификатор страны берётся из GET /api/v1/countries (например, br или de).
3. Передайте полученный номер своему тестовому раннеру, который введёт его в клиенте Telegram или эмуляторе.
4. Дождитесь кода. Если используете вебхук, слушайте activation.sms_received; иначе опрашивайте GET /api/v1/activations/{id} с разумным интервалом.
5. Если прогон прерван, очистите за собой через POST /api/v1/activations/{id}/cancel.

Для вебхуков проверяйте X-OTPRoute-Signature: пересчитайте HMAC-SHA256 от <t>.<raw body> с секретом эндпоинта, отклоняйте старые метки времени и запоминайте обработанные идентификаторы активаций, чтобы повторно доставленное событие игнорировалось. На аккаунт доступно до 5 эндпоинтов вебхуков и 300 запросов в минуту. Параллельные прогоны разобраны в руководстве по CI-конвейеру.

Можно ли выполнить те же шаги вручную в панели?

Да. Войдите, откройте OTP Gateway, выберите Telegram и страну, проверьте цену и закажите номер. Скопируйте номер на экран ввода телефона в Telegram, выберите соответствующий код страны и запросите код. Когда SMS придёт, оно появится рядом с заказом, готовое к вставке.

Код Telegram не пришёл. Что проверить?

• Есть ли уже открытая сессия? Если номер использовался раньше, Telegram мог отправить код внутри приложения. Новая активация это исключает.
• Закончилось ли окно? Дайте 20-минутному таймеру дойти до конца. Вы платите, только если код пришёл; при истечении времени или отмене вся сумма возвращается автоматически.
• Принимается ли маршрут? Telegram может отказывать некоторым виртуальным номерам. Это вне нашего контроля, и именно поэтому существует правило возврата.
• Повторите с паузой. Закажите заново позже или в другой стране; не заказывайте в плотном цикле, это не помогает ни доставке, ни вашему лимиту запросов.
• Проверьте код страны на устройстве. Несовпадение выбранной страны и номера — частая ошибка при ручных тестах.

Когда для Telegram лучше подходит Dedicated Number?

Одноразовый номер OTP Gateway годится для тестов регистрации. Если аккаунту Telegram придётся входить снова в следующем месяце, например командному аккаунту, который ведёт канал поддержки, или административному входу бота, ему нужен номер, который ваша команда по-прежнему контролирует. Dedicated Numbers в США и Канаде, от $1.95/месяц, остаются вашими, пока продлеваются, и пересылают входящие SMS в панель и на ваш вебхук как number.sms_received. Сравнение временных и выделенных номеров объясняет компромисс.

Как выглядит ответственное тестирование с Telegram?

Соблюдайте условия использования Telegram. Создавайте один аккаунт на реального человека или бизнес-цель, используйте его для собственных продуктов, ботов и операций и никогда — для спама, массового создания аккаунтов или обхода блокировки. Каждый ваш заказ для Telegram также подпадает под политику допустимого использования OTP Route. Telegram — товарный знак его владельца, и OTP Route не связан с ним.

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

Могу ли я получить код подтверждения Telegram, не используя личный телефон?

Да. Закажите номер Telegram в OTP Gateway от OTP Route, введите его в приложении и прочитайте SMS-код в панели или через API.

Какой идентификатор сервиса Telegram в API?

Это telegram. Сочетайте его с идентификатором страны из GET /api/v1/countries при создании активации.

Сколько стоит SMS-подтверждение Telegram для тестирования?

От $0.20 за код; точная цена зависит от страны и возвращается в реальном времени эндпоинтом цен.

Почему Telegram отправил код внутрь приложения, а не по SMS?

Telegram доставляет коды входа в существующую сессию, если она есть. Чтобы протестировать путь через SMS, используйте новый номер и устройство без открытой сессии.

Можно ли повторно использовать одноразовый номер, чтобы позже снова войти в Telegram?

Нет, номера OTP Gateway рассчитаны на один код. Для повторных входов используйте Dedicated Number в США или Канаде.

Спишутся ли деньги, если Telegram отклонит номер?

Нет. Если код не пришёл на номер в течение 20 минут или вы отменили активацию, вся сумма возвращается на ваш кошелёк.

Названия сервисов являются товарными знаками их владельцев. OTP Route не связан с ними. Используйте номера законно, соблюдайте условия каждого сервиса и нашу Политику допустимого использования.