Частые вопросы о Cascade
Ответы простым языком: для бизнеса, разработчиков и команд, которые впервые сталкиваются с OTP.
Что такое Cascade?
Cascade — API и кабинет для исходящей доставки OTP-кодов на номер вашего пользователя через WhatsApp и Telegram. Это не аренда виртуальных номеров.
Что такое каскадная доставка?
Сначала сообщение идёт в WhatsApp или Telegram. Если мессенджер недоступен, Cascade может отправить SMS. Списание только за успешную доставку.
Cascade выдаёт виртуальные номера?
Нет. Cascade отправляет код на номер вашего пользователя и не сдаёт номера в аренду.
Сколько стоит доставка OTP?
WhatsApp и Telegram — 3 ₸ за успешную доставку. SMS — 8 ₸. Пакеты снижают среднюю цену единицы баланса.
Есть ли абонентская плата?
Нет. Вы платите только за купленный баланс и успешные доставки по тарифу канала.
Какие каналы доступны сейчас?
Доступны WhatsApp, Telegram и SMS. SMS стоит 8 ₸ и открывается после первого пополнения баланса. Бонусы на SMS не тратятся.
Как подключить API?
Зарегистрируйте компанию, создайте Bearer-ключ в кабинете и вызывайте https://cascade.kz/api только со своего сервера. Обычно это занимает около 3 минут.
Как работают send и verify?
Send отправляет одноразовый код на номер пользователя. Verify проверяет введённый код на стороне Cascade и возвращает результат вашей системе.
Когда списывается баланс?
Баланс списывается по правилам успешной доставки выбранного канала, а не просто за попытку отправки.
Где хранить API-ключ?
Только на сервере: в secret-хранилище или переменных окружения. Не передавайте ключ в браузер или мобильное приложение.
Сколько действует OTP-код?
Стандартный TTL шестизначного кода — 5 минут. Повторная отправка и лимиты описаны в документации.
Что делать, если код не пришёл?
Проверьте статус доставки в кабинете или через API, убедитесь что номер в международном формате и канал доступен. При необходимости повторите отправку с учётом cooldown.
Как пополнить баланс?
В кабинете можно купить пакет или пополнить баланс от 100 единиц. После регистрации начисляется 50 ₸, а первое пополнение от 1000 ₸ приносит ещё 1000 ₸ бонусом.
Чем Cascade отличается от обычного SMS-шлюза?
Фокус на OTP: мессенджеры дешевле SMS, есть каскад каналов, verify API, webhooks и оплата за успешную доставку.
Где посмотреть документацию и OpenAPI?
Документация — на /docs, справочник эндпоинтов — на /api, схема — /openapi.yaml.
Подробные материалы
-
Что такое authentication? — FAQ Cascade
Authentication — проверка личности пользователя. OTP как фактор: подтверждение номера через WhatsApp, Telegram или SMS в Cascade. -
Что такое One Time Password? — FAQ Cascade
One-Time Password — полное название OTP: одноразовый код с коротким TTL. Синоним OTP в Cascade FAQ. -
Что такое OTP? — FAQ Cascade
OTP (One-Time Password) — одноразовый код на телефон пользователя. Как работает send/verify, чем отличается от аренды номеров и как доставля... -
Что такое SMS activation? — FAQ Cascade
SMS activation часто путают с OTP: аренда виртуального номера vs исходящая доставка кода вашему пользователю. Разбор для Cascade. -
Что такое verification code? — FAQ Cascade
Verification code — код подтверждения в UI продукта. Обычно это OTP, который пользователь вводит после доставки на телефон. -
Как не путать Cascade с SMS-Activate? — FAQ Cascade
SMS-Activate = аренда номеров. Cascade = исходящий OTP вашему пользователю. Как отличить за 10 секунд. -
Можно ли купить виртуальный номер в Cascade? — FAQ
Нет. Cascade не продаёт и не сдаёт виртуальные номера. Только исходящий OTP на номер вашего пользователя. -
Чем Cascade отличается от виртуальных номеров? — FAQ
Виртуальные/disposable numbers — аренда. Cascade — исходящая доставка OTP на реальный телефон пользователя. -
Как хранить API-ключ безопасно? — FAQ Cascade
Только server-side secrets/env. Не вставляйте в фронтенд, мобильный билд и публичный git. -
Что делать если SMS не пришла? — FAQ Cascade
Проверьте канал, баланс, формат номера, статус в истории; подождите и повторите; рассмотрите WhatsApp/Telegram. -
Что если пользователь ввёл неверный код? — FAQ Cascade
Verify вернёт ошибку. Дайте ограниченное число попыток и предложите повторную отправку. -
Что такое Bearer-токен? — FAQ Cascade
Способ Authorization: Bearer <token> в HTTP-заголовке для доступа к API. -
Что такое поле channel? — FAQ Cascade
Явный канал: whatsapp, telegram или sms. Если не указан — 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; SMS — запасной. Либо 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. SMS дороже мессенджеров. -
Как связаться с поддержкой? — 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 при соответствующей настройке компании. -
Можно ли использовать только SMS? — FAQ Cascade
Да, можно указать channel=sms. Учитывайте, что SMS дороже мессенджеров по токенам. -
Можно ли использовать 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
Каскадная доставка предпочитает более выгодные каналы (мессенджеры), поэтому средняя стоимость ниже классических SMS-рассылок. Cascade OTP W... -
Почему выбирают Cascade? — FAQ Cascade
Цена от 3 ₸, быстрый старт ~3 мин, WhatsApp+Telegram+SMS, простой 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 ₸, SMS = 8 ₸. Актуальные пакеты смотрите на /pricing. Cascade OTP WhatsApp Tel... -
Сколько занимает подключение? — FAQ Cascade
Обычно около 3 минут: регистрация, ключ, первый запрос send/verify. -
SMS-верификация через Cascade
Как подтверждать телефон по SMS с помощью Cascade OTP API и когда лучше WhatsApp или Telegram. -
Сколько живёт код? — FAQ Cascade
Обычно expires_in около 300 секунд. После истечения нужна новая отправка. -
Есть ли webhook? — FAQ Cascade
В документации описаны исходящие webhooks. Смотрите /api/webhooks и INTEGRATION docs.
Проверьте Cascade на своём сценарии
Откройте кабинет и проверьте доставку на своём сценарии.