Вход
Регистрация

Отправка OTP-кодов через Telegram Gateway

Telegram Gateway — это механизм маршрутизации, позволяющий отправлять одноразовые пароли (OTP) и коды подтверждения в мессенджер Telegram.

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

Как подключить: 2 простых шага

По умолчанию функция отключена. Для начала работы ее необходимо активировать.

Шаг 1: Активация в настройках API-проекта

  1. Войдите в личный кабинет и перейдите в раздел SMS.
  2. В боковом меню выберите Интеграция → API
  3. Откройте настройки API-проекта, который вы используете для отправок.
  4. Найдите блок «Замена авторизационных SMS на сообщения Telegram Gateway».
  5. В выпадающем списке «Режим работы Telegram Gateway» выберите один из режимов:
    • Только Telegram
    • Telegram или SMS

(Опционально) Настройка времени жизни сообщения
В этом же блоке вы можете указать «Время жизни сообщения (в секундах)». Если задать это значение, сообщение с кодом автоматически исчезнет из чата пользователя в Telegram по истечении указанного времени.

Шаг 2: Отправка через API

После активации режима отправка сообщений происходит через стандартный API для одиночных SMS. Вам не нужно вносить изменения в существующую интеграцию.

Подробное описание метода `message/send`, его параметров и примеры кода находятся в основной документации по API.
Основная документация по API отправки SMS

Принцип работы (после активации)

  1. API-запрос: Вы отправляете стандартный запрос на отправку сообщения.
  2. Анализ сообщения:Система анализирует текст на наличие числового кода подтверждения длиной от 4 до 8 символов.
  3. Проверка получателя:Платформа по номеру телефона проверяет, является ли получатель активным пользователем Telegram.
  4. Отправка в Telegram:Если код найден и пользователь активен в Telegram, ему отправляется системное уведомление.
  5. Резервный канал:Если доставка в Telegram невозможна, система автоматически переключается на отправку через SMS (если включен режим `Telegram или SMS`).

Режимы работы

  • Telegram или SMS (рекомендуется)
    Система в первую очередь пытается доставить сообщение в Telegram. В случае неудачи, сообщение будет автоматически отправлено как стандартное SMS. Тарифицируется только один успешный канал доставки.
  • Только Telegram
    Отправка осуществляется исключительно в Telegram. Если доставить сообщение через этот канал невозможно, оно не будет отправлено по резервному каналу и получит соответствующий статус недоставки.

Технические требования и особенности

  • Формат кода:Система идентифицирует как OTP-сообщения только те, что содержат числовой код длиной от 4 до 8 символов.
  • Текст без кода:Если в тексте сообщения не будет найден код, оно будет отправлено как обычное SMS, игнорируя настройки Telegram Gateway.
  • Получение статусов доставки (Webhook):Вы можете отслеживать статусы доставки сообщений, отправленных через Telegram Gateway, с помощью Webhooks. В уведомлении будет указан канал, по которому было доставлено сообщение (`telegram` или `sms`). Это позволяет вашей системе в реальном времени получать обратную связь.
Поддержка