SMS и звонок¶
Телефон гостя нужен для двух разных задач. В админке это два отдельных блока настроек, и операторы у них могут быть разные:
| Задача | Где в админке | Кто подходит |
|---|---|---|
| Подтвердить номер: регистрация в приложении игрока, восстановление пароля, проверка телефона из карточки гостя | Настройки → «SMS / Авторизация звонком» | zvonok.com (основной), uCaller (резервный); SMSC.ru, SMS.RU, GreenSMS — бета |
| Отправить текст: SMS с паролем новой учётки и SMS-рассылки | Настройки → «Доставка паролей и email» | SMSC.ru, SMS.RU, GreenSMS |
Настройки одного блока на другой не влияют. Можно взять один аккаунт оператора для обоих или разные.
Что значит «БЕТА» у оператора
Подключение к оператору написано по его документации, но в работающем клубе его ещё не проверяли. Для рабочего клуба выбирайте zvonok.com (основной) и uCaller (резервный) — так подсказывает и сама админка.
Как гость подтверждает номер¶
У zvonok.com три способа — выбираются в поле «Способ доставки кода»:
| Способ | Что видит гость | Что нужно в кабинете zvonok |
|---|---|---|
| Гость звонит нам сам (основной) | Номер на экране. Гость звонит на него со своего телефона, звонок сразу сбрасывается, экран сам понимает, что номер подтверждён. Код вводить не нужно | кампания «Звонок на определённый номер» и её номер |
| Flash-звонок | Короткий входящий звонок. Код — последние цифры номера, с которого позвонили | кампания «Flash Call» |
| Робот диктует код | Звонок, робот зачитывает код вслух | отдельная кампания «Продиктовать код» |
Почему основной способ — «гость звонит сам»
Гостю не надо ничего вводить, а у части сотовых сетей входящие flash-звонки не доходят. Если позвонить не получается, у гостя есть запасные кнопки — см. Если звонок не дошёл.
Подключение zvonok.com¶
zvonok.com звонит только внутри кампании. Поэтому одного ключа мало: для каждого способа нужна своя кампания, и в админку вписывается её номер (ID). Кампании разных типов друг друга не заменяют.
В кабинете zvonok.com¶
- Зарегистрируйтесь на zvonok.com и пополните баланс (звонки оплачиваются оператору напрямую, тарифы — у него).
- Найдите ключ доступа к API — подсказка в админке указывает: настройки профиля → раздел API → «Ключ доступа».
- Создайте кампанию типа «Звонок на определённый номер» — это основной способ. Запишите её ID и номер, на который будут звонить гости (он есть в карточке кампании).
- По желанию — ещё кампании:
- «Flash Call» — если хотите способ flash-звонком или как запасной ход;
- «Продиктовать код» — для кнопки «Продиктовать код голосом» (см. ниже).
Если какие-то названия в кабинете zvonok выглядят иначе — ориентируйтесь на тип кампании, это определяет оператор, не мы. Вопросы по кабинету — в поддержку zvonok.com.
В админке¶
Настройки → «SMS / Авторизация звонком»:
| Поле | Что вписать |
|---|---|
| Оператор | zvonok.com (основной) |
| Способ доставки кода | Гость звонит нам сам (без ввода кода) — основной |
| Ключ доступа (public_key) | ключ API из кабинета zvonok |
| ID кампании «Звонок на определённый номер» | ID кампании из шага 3 |
| Номер, на который звонит гость | номер этой кампании. ‼️ Оператор его автоматически не передаёт — скопируйте руками, иначе гостю некуда будет звонить |
| ID кампании Flash Call | если создали такую кампанию |
| ID кампании «Робот диктует код» | если нужна голосовая кнопка |
Ниже — «Параметры кода»: длина кода, время жизни кода (60–600 секунд), число попыток. При звонке длину кода задаёт оператор, поэтому поле «Длина кода» тогда неактивно.
Режим разработки — выключить
Переключатель «Режим разработки» в том же блоке: пока он включён, звонки и SMS не отправляются на реальные номера, а гость подтверждает номер фиксированным кодом. Админка показывает жёлтое предупреждение «Режим разработки ВКЛЮЧЕН». Перед открытием клуба выключите его и сохраните.
Нажмите «Сохранить настройки».
Проверить подключение¶
Под полями оператора — кнопка «Проверить подключение». Она ничего не отправляет: спрашивает у оператора баланс и показывает ответ.
| Что видите | Что значит | Что делать |
|---|---|---|
| «Подключение работает — баланс N ₽» | ключ верный, оператор отвечает | дальше — пробный вход, см. ниже |
| «Ошибка подключения: Ключ доступа (public_key) не заполнен» | ключ не сохранён | впишите ключ, «Сохранить настройки», проверьте снова |
| «Ошибка подключения: Неожиданный ответ API…» | оператор не принял ключ | скопируйте ключ из кабинета zvonok заново |
| «Таймаут запроса к API провайдера» | сервер клуба не достучался до оператора | проверьте интернет на сервере клуба, повторите позже |
Проверяется сохранённое, а не то, что на экране
Кнопка берёт уже сохранённые настройки. Вписали новый ключ — сначала «Сохранить настройки», потом «Проверить подключение».
Кнопка проверяет только ключ и баланс. ID кампаний и номер она не проверяет — поэтому после неё обязательно сделайте пробную регистрацию: зарегистрируйтесь в приложении игрока со своего телефона и подтвердите номер.
Где видно, что звонки уходят¶
Админка → Гости → вкладка «Запросы авторизации»: каждое подтверждение номера — дата, телефон, оператор, назначение (регистрация или сброс пароля), «Отправлено» и «Подтверждён».
| Что видите | Что значит |
|---|---|
| Отправлено — Нет | оператор отказал: кончился баланс, неверный ключ, не задан ID кампании |
| Отправлено — Да, Подтверждён — Нет | звонок заказан, но гость не дозвонился или не ввёл код |
| Отправлено и Подтверждён — Да | всё работает |
Если звонок не дошёл¶
На экране подтверждения в приложении игрока могут быть две запасные кнопки. Обе включаются в том же блоке настроек.
Резервный оператор¶
Переключатель «Разрешить запасного оператора» → выберите оператора, способ и впишите его ключи (у каждого оператора свои — это отдельный комплект полей). Своя кнопка «Проверить подключение» — у резервного тоже.
Гость видит кнопку «Другой способ — звонок от другого оператора» (на экране «позвоните нам» — «Не могу позвонить — позвоните мне»). Резервный оператор всегда работает кодом: гостю звонят, и он вводит цифры.
Рекомендуемый резерв — uCaller:
- Зарегистрируйтесь на ucaller.ru, пополните баланс.
- В личном кабинете создайте сервис.
- Из карточки сервиса возьмите ID сервиса → поле «Service ID» и секретный ключ → поле «Secret Key».
uCaller звонит flash-звонком (код — последние 4 цифры номера) или роботом. Текстовые SMS он не отправляет.
Переключатель включён — заполните ключи
Если переключатель включён и оператор выбран, гость кнопку увидит. Без ключей звонок через резерв не уйдёт. Либо впишите ключи и проверьте подключение, либо выключите переключатель.
Продиктовать код голосом¶
Переключатель «Разрешить голосовой запасной ход». У гостя появляется кнопка «Продиктовать код голосом» — робот зачитывает код. Голосовой звонок дороже flash-звонка, поэтому по умолчанию выключено. Для zvonok нужна кампания «Продиктовать код» и её ID в поле «ID кампании «Робот диктует код»».
Текстовые SMS: пароли и рассылки¶
Настройки → «Доставка паролей и email» → «SMS-оператор для текстовых сообщений».
| Оператор | Что вписать |
|---|---|
| SMSC.ru | логин и пароль аккаунта smsc.ru |
| SMS.RU | API ID (api_id) — с главной страницы личного кабинета sms.ru |
| GreenSMS | логин и пароль аккаунта greensms.ru |
Имя отправителя SMS — только зарегистрированное у оператора. Пусто — SMS уйдёт с общего номера оператора (работает без модерации). Регистрация имени у оператора проходит модерацию, пока имя не одобрено, SMSC отклоняет SMS с ошибкой «message is denied».
Здесь же своя кнопка «Проверить подключение» (так же — баланс, без отправки) и настройка почты (SMTP) для отправки паролей письмом.
Если SMS с паролем не дошла
Переключатель «Показывать пароль админу даже после успешной отправки» в этом же блоке. Выключен — пароль виден администратору на экране, только если не дошли ни SMS, ни письмо.
Расходы под контролем¶
- Пробный расчёт (dry-run). SMS-рассылка в разделе «Рассылки» по умолчанию создаётся с включённым «Пробным расчётом»: SMS не отправляются, админка показывает число получателей и примерную стоимость. Чтобы отправить по-настоящему — выключите пробный расчёт в кампании.
- Лимит получателей. У одной SMS-рассылки есть предел получателей (по умолчанию 500). Больше — рассылка останавливается с понятной ошибкой: сузьте аудиторию.
- 1 SMS = 70 символов кириллицей; длинный текст — несколько SMS по цене каждой.
- Push-уведомления в приложении игрока — бесплатные: для гостей с приложением рассылку можно слать пушем вместо SMS. Telegram/VK клуба — тоже бесплатная альтернатива для акций.
- Следите за балансом у операторов (и для звонков, и для SMS): кончились деньги — звонки и SMS перестают уходить. Включите уведомления о низком балансе в кабинетах операторов.
Частые ситуации¶
| Что видите | Что значит | Что делать |
|---|---|---|
| Гость не получает звонок, а в «Запросах авторизации» — «Отправлено: Нет» | оператор отказал | «Проверить подключение»; проверьте баланс и ID кампании нужного типа |
| На экране гостя нет номера, куда звонить | не заполнено «Номер, на который звонит гость» | впишите номер кампании, сохраните |
| Код у всех один и тот же, звонков нет | включён «Режим разработки» | выключите, сохраните |
| Flash-звонок не доходит до конкретного гостя | его сотовая сеть режет такие звонки | включите резервного оператора и/или голосовую кнопку |
| Кнопка «Продиктовать код голосом» не работает с zvonok | нет кампании «Продиктовать код» | создайте её в кабинете zvonok, впишите ID |
| «Проверить подключение» показывает старую ошибку после правки | проверяются сохранённые настройки | «Сохранить настройки», потом проверить снова |
| SMS с паролем не приходят, звонки работают | текстовые SMS — другой блок и, возможно, другой оператор | «Доставка паролей и email» → «Проверить подключение»; проверьте имя отправителя |
| SMS не доходит до одного номера | у абонента может стоять блокировка SMS | смотрите статус отправки в кабинете оператора |