SMS-провайдер
Здесь заведение выбирает, через кого уходят SMS гостям: статусы заказа доставки, коды входа на сайт и в бота, промокоды, рассылки. Провайдер один на весь логин (сеть): его используют все точки.
Пока провайдер не выбран, SMS не уходят вовсе — отправка отказывает с ошибкой «SMS-провайдер не настроен. Подключите SMS-интеграцию в кабинете.»
Где находится
Внешние сервисы → SMS-провайдер (/external-sms-provider). Заголовок страницы —
СМС Провайдер.
Какие провайдеры бывают
В списке Тип два вида провайдеров. Первым всегда стоит собственный провайдер Mison.
| Провайдер | Что нужно для подключения | Кто платит за SMS |
|---|---|---|
| Mison SMS | Ничего: ни договора с оператором, ни ключей. Выбрали и сохранили | Заведение платит Mison: каждое SMS списывается с баланса точки |
| Playmobile | Свой договор заведения с Playmobile, логин и пароль из кабинета оператора | Заведение платит оп ератору напрямую. Mison отправку не тарифицирует и остаток не видит |
| SMSFLY | Свой договор заведения с SMSFLY, логин и пароль из кабинета оператора | Так же — напрямую оператору |
После выбора провайдера под полем Тип появляется справка: короткое описание, ссылка на сайт оператора (для Playmobile — playmobile.uz, для SMSFLY — smsfly.uz) и ссылка Документация.
Mison SMS: цена и баланс
У Mison SMS в справке под полем показывается живая цена — «N сум за одно SMS», текущий Баланс точки и сколько примерно SMS на него хватит. Цена зависит от точки и страны номера, поэтому смотрите её именно здесь, а не в прайсе.
Как списываются деньги:
- Деньги берутся с баланса той точки, от имени которой отправлено сообщение. Если точка не определена, списание идёт с первой активной точки логина.
- Оплачивается не сообщение, а сегмент. Латиница — 160 символов в одном сегменте и по 153 в каждом, если сегме нтов несколько; кириллица — 70 и 67. Длинное сообщение на кириллице легко становится двумя-тремя SMS.
- Сначала деньги списываются, потом сообщение уходит оператору. Если оператор сообщение не принял, деньги возвращаются на баланс. Если принял, но абонент его не получил (телефон выключен и т. п.), возврата нет.
- В минус баланс не уходит: когда денег не хватает, отправка останавливается с ошибкой «Недостаточно средств на балансе для отправки SMS».
- Когда на балансе остаётся меньше, чем на 50 сообщений, владельцу приходит уведомление «Заканчивается баланс для SMS» — не чаще раза в сутки на точку.
- SMS уходят только на номера стран, по которым у Mison есть канал отправки. На номер другой страны сообщение не отправляется и не оплачивается. Номер без кода страны считается местным для страны точки.
Playmobile и SMSFLY: свой договор
Этот вариант для заведений, у которых уже есть договор с оператором. Логин и пар оль выдаёт сам оператор в своём кабинете — Mison их не выдаёт и не восстанавливает.
Поля для имени отправителя (nickname) в форме нет. Для Playmobile Mison всегда передаёт отправителя 3700; для SMSFLY отправитель в запросе не передаётся. Если заведению нужно своё имя отправителя, это вопрос договора с оператором, а не настройки в кабинете.
Форма раздела
| Элемент | Что делает |
|---|---|
| Тип | Выбор провайдера из справочника |
| Справка под полем | Описание провайдера, у Mison SMS — цена и бала нс, ссылки на сайт оператора и Документация |
| Поля провайдера | Появляются только у провайдеров со своим договором — логин и пароль от кабинета оператора. Обязательные поля отмечены красной звёздочкой. Пароль вводится скрытым полем. У Mison SMS полей нет |
| Отмена | Уходит на страницу Интеграции без сохранения |
| Сохранить | Сохраняет провайдера для всего логина |
Как подключить Mison SMS
- Откройте Внешние сервисы → SMS-провайдер.
- В поле Тип выберите Mison SMS.
- Проверьте в справке под полем цену и Баланс точки. Если баланс нулевой, SMS не уйдут, пока его не пополнят.
- Нажмите Сохранить.
Как подключить Playmobile или SMSFLY
- Возьмите у заведения логин и пароль от кабинета оператора (Playmobile или SMSFLY).
- Откройте Внешние сервисы → SMS-провайдер.
- В поле Тип выберите оператора.
- Заполните появившиеся поля логина и пароля — без пробелов в начале и в конце.
- Нажмите Сохранить.
Если обязательное поле пустое, сохранение не пройдёт с ошибкой вида «Playmobile: заполните «…»» — в кавычках название незаполненного поля.
Провайдера можно сменить в любой момент: выберите другой Тип и сохраните. Настройка перезаписывается, второй провайдер рядом не заводится. Новые SMS пойдут через нового провайдера сразу после сохранения.
Как проверить, что SMS уходят
Всё, что отправлялось, видно в разделе История SMS (/sms-messages, пункт в разделе
уведомлений, право «История SMS»). Туда попадают и отправленные сообщения, и отказы —
с причиной.
| Колонка | Что показывает |
|---|---|
| Дата | Когда сообщение создано |
| Телефон | Номер получателя |
| Событие | Повод: «Заказ принят», «Курьер выехал», «Код входа», «Рассылка», «Промокод» и т. д. Под событием — номер заказа, если SMS по заказу |
| Текст | Текст сообщения. Если не ушло — красным под текстом причина |
| SMS | Сколько сегментов заняло сообщение |
| Сум | Сколько списано. Только у Mison SMS |
| Статус | Отправляется, Отправлено, Не отправлено, Возврат |
Над таблицей — карточки Отправлено и Не отправлено, а у Mison SMS ещё Баланс (с оценкой, на сколько SMS хватит) и Потрачено. Фильтр — по периоду и статусу, поиск по строке.
История показывает сообщения только текущей точки. Чтобы увидеть SMS другой точки, переключитесь на неё.
Статусы:
- Отправлено — оператор принял сообщение.
- Не отправлено — отправку не начинали или оператор отказал (нет денег, нет канала для страны, неверный номер, ошибка провайдера). Причина — под текстом.
- Возврат — у Mison SMS деньги списали, но оператор сообщение не принял, и сумма вернулась на баланс.
Ещё одна проверка — раздел Проверка настроек (/setup-health), модуль
SMS-уведомления. Он проверяет по пунктам: SMS-провайдер подключён, Ключи провайдера
заполнены (для своего договора), На балансе есть деньги (для Mison SMS),
Есть включённые SMS-события.
Где потом используются SMS
Провайдер сам ничего не отправляет — он только канал. Что и когда отправлять, задаётся в других разделах:
| Раздел | Что там |
|---|---|
Настройки уведомлений (/notification-settings) | Галочки в группе SMS клиенту: о каких статусах заказа писать гостю. В заголовке группы видно подключённого провайдера, а у Mison SMS — цену и баланс. SMS уходит только гостям без Telegram-бота: остальным сообщение идёт в бот бесплатно |
| Смс шаблоны | Тексты сообщений с подстановками |
| Смс рассылка | Журнал ручных отправок клиентам |
Кроме того, через этого же провайд ера уходят коды входа гостя на сайт и в Telegram-бота и SMS с промокодами.
Если провайдер подключён, но в Настройках уведомлений не включено ни одного SMS-события, гостям о заказах ничего не придёт. Проверка настроек в этом случае пишет «Ни одно событие не отправляет SMS — провайдер настроен впустую».
Частые вопросы
Гостям не приходят SMS, в истории пусто. Проверьте, что в разделе SMS-провайдер провайдер сохранён, а в Настройках уведомлений включены SMS-события. Без провайдера отправка отказывает с ошибкой «SMS-провайдер не настроен. Подключите SMS-интеграцию в кабинете.»
В истории «Не отправлено» с причиной «insufficient_balance: Недостаточно средств на балансе для отправки SMS». У Mison SMS закончился баланс точки. Деньги за такое сообщение не списаны. После пополнения баланса новые SMS пойдут сами.
Причина «no_route: Нет активного SMS-канала для страны …». Номер гостя из страны, по которой у Mison нет канала отправки. Такие SMS не отправляются и не оплачиваются.
Причина «unknown_country: Не удалось определить страну номера» или «invalid_phone: Некорректный номер телефона». Номер в карточке гостя записан с ошибкой: короче 9 цифр либо с кодом страны, которую Mison не знает. Исправьте номер гостя.
«Достигнут суточный лимит SMS на этот номер». Защита от накрутки: на один номер уходит не больше 15 SMS в сутки по всему логину. Обычно это гость, который раз за разом запрашивает код входа. Через сутки отправка восстановится.
«Достигнут лимит SMS по одному заказу». По одному заказу уходит не больше 10 SMS за всё время — страховка от зацикленной смены статусов.
«Такое уведомление по этому чеку уже отправлено». Одно и то же событие по одному заказу уходит один раз: повторная смена статуса второе SMS не шлёт.
Причина «Playmobile: не указаны login и password в настройках интеграции» (или то же для SmsFly). В разделе SMS-провайдер не заполнены логин и пароль оператора. Заполните и сохраните.
Причина вида «Playmobile: код и описание» или «SmsFly: код и описание». Ошибку вернул сам оператор: неверный логин или пароль, закончились деньги на счёте у оператора, текст не прошёл модерацию. Расшифровку кода смотрите в кабинете оператора — у своего договора Mison остаток и настройки оператора не видит.
При сохранении ошибка «SMS-провайдер не найден». Выбранный тип не относится к SMS-провайдерам. Обновите страницу и выберите тип заново.
Сколько стоит одно SMS у Mison SMS? Смотрите справку под полем Тип после выбора Mison SMS или карточку Баланс в Истории SMS. Цена может отличаться у разных точек и стран, текстом её не фиксируем.