Частые вопросы о Cascade
Ответы простым языком: для бизнеса, разработчиков и команд, которые впервые сталкиваются с OTP.
Что такое Cascade?
Cascade — API и кабинет для исходящей доставки OTP-кодов на номер вашего пользователя через WhatsApp и Telegram. Это не аренда виртуальных номеров.
Что такое каскадная доставка?
Cascade позволяет настроить порядок доставки OTP через доступные мессенджеры. Если основной канал недоступен, система может использовать следующий настроенный канал. Списание происходит согласно условиям выбранного канала.
Cascade выдаёт виртуальные номера?
Нет. Cascade отправляет код на номер вашего пользователя и не сдаёт номера в аренду.
Сколько стоит доставка OTP?
WhatsApp и Telegram — 3 ₸ за успешную доставку. Пакеты снижают среднюю цену единицы баланса.
Есть ли абонентская плата?
Нет. Вы платите только за купленный баланс и успешные доставки по тарифу канала.
Какие каналы доступны сейчас?
Доступны WhatsApp и Telegram. Порядок каналов и каскад между ними настраиваются для каждого API-ключа в кабинете.
Как подключить API?
Зарегистрируйте компанию, создайте Bearer-ключ в кабинете и вызывайте https://cascade.kz/api только со своего сервера. Обычно это занимает около 3 минут.
Как работают send и verify?
Send отправляет одноразовый код на номер пользователя. Verify проверяет введённый код на стороне Cascade и возвращает результат вашей системе.
Когда списывается баланс?
Баланс списывается по правилам успешной доставки выбранного канала, а не просто за попытку отправки.
Где хранить API-ключ?
Только на сервере: в secret-хранилище или переменных окружения. Не передавайте ключ в браузер или мобильное приложение.
Сколько действует OTP-код?
Стандартный TTL шестизначного кода — 5 минут. Повторная отправка и лимиты описаны в документации.
Что делать, если код не пришёл?
Проверьте статус доставки в кабинете или через API, убедитесь что номер в международном формате и канал доступен. При необходимости повторите отправку с учётом cooldown.
Как пополнить баланс?
В кабинете можно купить пакет или пополнить баланс от 100 единиц. После регистрации начисляется 50 ₸, а первое пополнение от 1000 ₸ приносит ещё 1000 ₸ бонусом.
Чем Cascade отличается от рассылочного сервиса?
Фокус на OTP: доставка в WhatsApp и Telegram, каскад между мессенджерами, verify API, webhooks и оплата за успешную доставку.
Где посмотреть документацию и OpenAPI?
Документация — на /docs, справочник эндпоинтов — на /api, схема — /openapi.yaml.
Подробные материалы
-
Что такое authentication? — FAQ Cascade
Authentication — проверка личности пользователя. OTP как фактор: подтверждение номера через WhatsApp или Telegram в Cascade. -
Что такое One Time Password? — FAQ Cascade
One-Time Password — полное название OTP: одноразовый код с коротким TTL. Синоним OTP в Cascade FAQ. -
Что такое OTP? — FAQ Cascade
OTP (One-Time Password) — одноразовый код на телефон пользователя. Как работает send/verify, чем отличается от аренды номеров и как доставля... -
Что такое verification code? — FAQ Cascade
Verification code — код подтверждения в UI продукта. Обычно это OTP, который пользователь вводит после доставки на телефон. -
Можно ли купить виртуальный номер в Cascade? — FAQ
Нет. Cascade не продаёт и не сдаёт виртуальные номера. Только исходящий OTP на номер вашего пользователя. -
Чем Cascade отличается от виртуальных номеров? — FAQ
Виртуальные/disposable numbers — аренда. Cascade — исходящая доставка OTP на реальный телефон пользователя. -
Как хранить API-ключ безопасно? — FAQ Cascade
Только server-side secrets/env. Не вставляйте в фронтенд, мобильный билд и публичный git. -
Что если пользователь ввёл неверный код? — FAQ Cascade
Verify вернёт ошибку. Дайте ограниченное число попыток и предложите повторную отправку. -
Что такое Bearer-токен? — FAQ Cascade
Способ Authorization: Bearer <token> в HTTP-заголовке для доступа к API. -
Что такое поле channel? — FAQ Cascade
Явный канал: whatsapp, telegram или telegram. Если не указан — default компании из кабинета. -
Что такое каскадная рассылка? — FAQ Cascade
Если один способ доставки менее выгоден или менее эффективен, система использует другой. Сообщения остаются дешевле и чаще доходят. Cascade... -
Что такое поле purpose? — FAQ Cascade
Метка сценария (по умолчанию verification). Помогает разделять регистрацию, вход, платежи. -
Что такое REST API у Cascade? — FAQ Cascade
HTTPS JSON API с ресурсами /otp/send, /otp/verify, /links/*, /group/send. -
Подойдёт ли для финтеха? — FAQ Cascade
Как канал доставки кодов — да, но compliance и антифрод остаются на стороне вашего продукта. -
Подойдёт ли для QA? — FAQ Cascade
Да, для проверки сценариев регистрации/логина. Используйте тестовые номера команды и лимиты. -
Подойдёт ли для SaaS? — FAQ Cascade
Да: invite, login, recover access. См. /use-cases/saas и статьи блога. -
Есть ли API? — FAQ Cascade
Да. REST API с Bearer-авторизацией: send, verify, short links, group notify. См. /api и OpenAPI. -
Есть ли личный кабинет? — FAQ Cascade
Да. В кабинете — ключи, баланс/история отправок, настройки каналов и управление компанией. -
Есть ли OpenAPI? — FAQ Cascade
Да. У Cascade OTP API есть спецификация OpenAPI 3: https://cascade.kz/openapi.yaml — для клиентов и генерации кода. -
Где смотреть историю сообщений? — FAQ Cascade
В личном кабинете. Также см. пояснения на /api/history. -
Где сравнения с альтернативами? — FAQ Cascade
Раздел /compare. Неподтверждённые цифры конкурентов помечены. -
Где смотреть статус сервиса? — FAQ Cascade
Страница /status. При инцидентах смотрите также changelog. -
На каких языках сайт? — FAQ Cascade
Интерфейс: ru/en/kk. Переключение cookie/hl. Контент SEO сейчас в первую очередь на русском. -
Можно ли интегрировать в мобильное приложение? — FAQ Cascade
Да, но API-ключ держите на бэкенде. Приложение вызывает ваш сервер, сервер — Cascade. -
Как быстро приходят сообщения? — FAQ Cascade
Обычно секунды, но зависит от канала и сети. Мессенджеры часто быстрее воспринимаются пользователем. -
Как начать за 2–3 минуты? — FAQ Cascade
Регистрация → ключ → POST /otp/send → POST /otp/verify. Готово. -
Как выбрать канал доставки? — FAQ Cascade
Начните с мессенджера для цены и UX; мессенджеры — запасной. Либо default/auto-логика компании. -
Как отправить OTP? — FAQ Cascade
Вызовите POST /api/otp/send с полем phone и Bearer-токеном. Пользователь получит код в выбранном канале. -
Как получить API-ключ? — FAQ Cascade
Зайдите в кабинет компании, откройте раздел API-ключи, создайте ключ и скопируйте его. Храните только на сервере. -
Как пополнить баланс? — FAQ Cascade
Через кабинет компании (в т.ч. сценарии оплаты/Kaspi по продукту). См. /api/top-up и /pricing. -
Как проверить OTP? — FAQ Cascade
Вызовите POST /api/otp/verify с phone и code. При успехе сервер вернёт success: true. -
Как работает OTP в Cascade
Пошаговый поток: телефон → send → сообщение на канал → код → verify → успех. -
Как считать стоимость OTP? — FAQ Cascade
Считайте токены по каналу и пакеты на /pricing. мессенджеры дороже мессенджеров. -
Как связаться с поддержкой? — FAQ Cascade
См. /contacts и email поддержки из конфигурации продукта. -
Как связать OTP с сессией пользователя? — FAQ Cascade
На бэкенде свяжите phone/purpose с user id до send и после успешного verify. -
Какие есть use cases? — FAQ Cascade
Разработчики, SaaS, Telegram-проекты, маркетинг, QA, автоматизация, бизнес — /use-cases. -
Где полная документация? — FAQ Cascade
/docs и /docs, OpenAPI /openapi.yaml, разделы /api и /sdk. -
Какой формат номера телефона? — FAQ Cascade
Цифры, можно с + и пробелами. Нормализация приводит к виду 7700…; длина 10–15 цифр. -
Как работают короткие ссылки? — FAQ Cascade
Передайте link в /otp/send или используйте /links/* — ссылка укорачивается и может уйти в том же сообщении. -
Можно ли автоматизировать работу? — FAQ Cascade
Да — через REST API и серверные воркеры. Не автоматизируйте перебор кодов. -
Можно ли для арбитража? — FAQ Cascade
Если речь о доставке OTP вашим пользователям — да. Если о массовой регистрации на чужих сервисах через вирт. номера — Cascade не для этого.... -
Можно ли для CRM/ERP? — FAQ Cascade
Да, как канал подтверждений внутри процессов. См. /use-cases/business. -
Можно ли несколько API-ключей? — FAQ Cascade
Да, создавайте отдельные ключи под окружения/сервисы в кабинете. -
Можно ли отправить код и ссылку вместе? — FAQ Cascade
Да, передайте link в /otp/send — короткая ссылка добавится в то же сообщение. -
Можно ли повторно отправить код? — FAQ Cascade
Да, с учётом rate limit на номер. Не спамьте пользователя. -
Можно ли использовать Telegram? — FAQ Cascade
Да. Telegram поддерживается как канал доставки OTP при соответствующей настройке компании. -
Можно ли использовать WhatsApp? — FAQ Cascade
Да. WhatsApp — один из основных каналов Cascade для OTP и коротких ссылок. -
Нужен ли официальный SDK? — FAQ Cascade
Можно работать через HTTP. На /sdk есть примеры JS/TS/Python/PHP/Go/Java/C#/Rust. -
Нужен ли HTTPS? — FAQ Cascade
Да. API доступен по HTTPS; вызывайте только с сервера. -
Нужна ли своя БД для OTP? — FAQ Cascade
Cascade хранит код для verify. Вам нужны статусы бизнес-сценария, антифрод и аудит. -
Что значит ошибка 401? — FAQ Cascade
Неверный или отсутствующий API-токен. Проверьте Bearer и что ключ активен. -
Что значит ошибка 422? — FAQ Cascade
Валидация, баланс, канал или неверный/просроченный код — читайте message в ответе. -
Что значит ошибка 429? — FAQ Cascade
Слишком много попыток verify. Замедлите перебор и соблюдайте лимиты. -
Почему так дешево? — FAQ Cascade
Каскадная доставка предпочитает более выгодные каналы (мессенджеры), поэтому средняя стоимость ниже классических мессенджер-рассылок. Cascad... -
Почему выбирают Cascade? — FAQ Cascade
Цена от 3 ₸, быстрый старт ~3 мин, WhatsApp+Telegram+мессенджеры, простой API и кабинет. -
Что такое group notify? — FAQ Cascade
POST /group/send отправляет текст в WhatsApp-группу по названию или id. -
Можно ли подключить интернет-магазин? — FAQ Cascade
Да: коды при регистрации/входе и короткие ссылки на заказ или оплату. -
Подойдёт ли сервис стартапу? — FAQ Cascade
Да. Быстрый старт, понятный API и более низкая средняя стоимость за счёт мессенджеров. -
Какие есть rate limits? — FAQ Cascade
Есть ограничения на частоту send (около раза в минуту на номер) и на попытки verify. См. /api/rate-limits. -
Сколько стоит сообщение? — FAQ Cascade
Маркетинговый ориентир — от 3 ₸. Тариф: WhatsApp/Telegram = 3 ₸, мессенджеры = 3 ₸. Актуальные пакеты смотрите на /pricing. Cascade OTP What... -
Сколько занимает подключение? — FAQ Cascade
Обычно около 3 минут: регистрация, ключ, первый запрос send/verify. -
Сколько живёт код? — FAQ Cascade
Обычно expires_in около 300 секунд. После истечения нужна новая отправка. -
Есть ли webhook? — FAQ Cascade
В документации описаны исходящие webhooks. Смотрите /api/webhooks и INTEGRATION docs.
Проверьте Cascade на своём сценарии
Откройте кабинет и проверьте доставку на своём сценарии.