Перейти к содержимому

Use case

Для Telegram-проектов

Подтверждение пользователей, когда Telegram — основной или предпочтительный канал доставки.

Краткий ответ

Для Telegram-проектов укажите канал telegram в API Cascade или используйте каскад. Код уходит на номер пользователя; проверка — через /otp/verify.

Кратко

Cascade может слать OTP в Telegram (и каскадом в другие каналы). Это исходящая доставка на номер пользователя, не бот-эмуляция входа в чужой Telegram.

Главное

  • Канал telegram ≠ аренда номера для регистрации в Telegram.
  • Ключ API только на сервере.
  • Fallback: WhatsApp или SMS.

Задача

Нужен OTP для продукта, где пользователи живут в Telegram (боты, мини-аппы, сервисы с TG-аудиторией).

Как использовать Cascade

  1. Получите Bearer-ключ.
  2. Вызовите POST /otp/send с телефоном; при необходимости задайте канал telegram.
  3. Пользователь читает код в Telegram.
  4. Проверьте POST /otp/verify.

Если Telegram недоступен — каскад может увести в WhatsApp/SMS (см. биллинг токенов на /pricing).

Важно не перепутать

Нужно Подходит Cascade?
OTP вашему пользователю в TG Да
Аренда номера, чтобы завести аккаунт Telegram Нет — см. /faq/kak-ne-putat-s-sms-activate

FAQ: /faq/mozhno-li-telegram. Интеграция: /use-cases/developers, /docs.