Настройка Telegram Gateway

Коротко: Telegram Gateway — канал для отправки кодов верификации через Telegram. Работает без установки бота пользователем.

Кому подходит

Роль: Клиент, Менеджер рассылок
Уровень: Новичок

Что это

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

Что вы получите

Настроенное сообщение для отправки через Telegram Gateway.

Перед началом

У вас есть имя отправителя Telegram Gateway со статусом Активно.
У вас есть контакты или таргет.

Шаги

Шаг 1. Откройте настройки Telegram Gateway

В форме создания рассылки выберите канал Telegram Gateway.

Шаг 2. Настройте содержимое

Поля payload:

Поле	Что указать
code	Код, который нужно отправить (4–8 цифр)
code_length	Длина генерируемого кода (4–8)
ttl	Время жизни кода в секундах (30–3600)

Можно использовать либо code, либо code_length:

Если указан code — параметр code_length игнорируется.
Если code не указан — используется code_length.

Шаг 3. Выберите имя отправителя

В поле Отправитель выберите имя со статусом Активно.

Шаг 4. Включите флаг isOtp

Установите isOtp: true — флаг, что сообщение содержит OTP. Содержимое будет скрыто в логах.

Шаг 5. Настройте вебхук

Укажите webhook URL для получения статусов доставки.

Шаг 6. Сохраните

Нажмите Сохранить.

Дополнительные эндпоинты

Для Telegram Gateway доступны:

Отправка кода — через основной API отправки сообщений.
Проверка статуса — /messages/verification.
Отзыв сообщения — /messages/revoke.

Подробнее: Проверка 2FA-запроса.

Результат

Сообщение через Telegram Gateway настроено.

Сколько это стоит? Telegram Gateway тарифицируется за сообщение. Подробнее: Обзор тарифов.

Частые проблемы

Симптом	Причина	Решение
Код не доставляется	Неверный senderId	Проверьте имя отправителя
Ошибка TTL	Значение вне диапазона	Используйте 30–3600
Ошибка code_length	Значение вне диапазона	Используйте 4–8

См. также

Нужна помощь?

OTP-коды: support@otpcod.ru
Multi API: support@multiapi.ru
Мой диалог: support@mydialogi.ru