# Сообщения

Коды подтверждения и сообщения участникам уходят только через ваши аккаунты: аккаунт у SMS-провайдера, почтовый ящик,
бот MAX и сообщество ВКонтакте. SMS вы оплачиваете своему провайдеру по его тарифу, письма уходят через ваш ящик или
сервис рассылок по их правилам, а MAX и ВКонтакте за сообщения денег не берут.

В разделе «Сообщения» кабинета: «Каналы», «Почта», «MAX» и «ВКонтакте» — ваши аккаунты; «Автосообщения» — что уходит
участникам и с каким текстом; «Настройки» — пауза, тихие часы и частота рекламы; «Журнал» и «Очередь» — что ушло,
каким каналом, дошло ли, а что пропущено и почему.

Раздел видит вся команда мерчанта. Подключать и менять SMS-каналы, почту, MAX и ВКонтакте могут владелец и
администратор. Включать автосообщения, менять их тексты и правила отправки — владелец, администратор и маркетолог; они
же выключают автосообщения и ставят сообщения на паузу. Роли описаны на странице [«Кабинет магазина»](/docs/merchants/).

## SMS-каналы

Канал — ваш аккаунт у SMS-провайдера: SMSC.ru или SMS Aero. Через каналы уходят коды подтверждения и SMS участникам,
только на мобильные номера России. «Сообщения» → «Каналы» → «Подключить канал»:

- «Провайдер» и данные для входа: у SMSC.ru — «Логин» и «Пароль» (пароль аккаунта или отдельный пароль для API), у
  SMS Aero — «E-mail аккаунта» и «API-ключ» из личного кабинета SMS Aero.
- «Имя отправителя» — зарегистрированное и согласованное у провайдера: до 11 латинских букв, цифр, пробелов и знаков
  «.», «_», «-» или до 15 цифр. SMSC без него подставит имя из настроек аккаунта, SMS Aero без него SMS не отправляет.
- «Сначала отправлять коды в Telegram» — код придёт в Telegram, если у клиента он есть, иначе по SMS; повторный код —
  всегда по SMS. Банкам, операторам связи, маркетплейсам и госорганам закон запрещает общаться с клиентами через
  иностранные мессенджеры (41-ФЗ).
- «Название» — для себя, например «Основной» или «Резервный».

Перед сохранением платформа спрашивает провайдера, работает ли аккаунт: данные, которые он не принял, не сохраняются,
а пароль и ключ хранятся зашифрованными. «Проверить» узнаёт, подходят ли логин и пароль, и баланс. «Проверочное SMS»
отправляет «Проверка канала: сообщения доходят.» на мобильный номер сотрудника — только так проверяется имя
отправителя; таких сообщений не больше 10 в час вместе с проверочными письмами. Запросы к провайдерам ограничены,
чтобы через кабинет никто не подбирал пароли: если кабинет пишет «Снова можно будет через … мин.», подождите.

Каналов может быть до пяти. Код пробует включённые каналы по порядку, не больше трёх: если канал не отправил код, он
уходит через следующий; SMS участникам идут так же. Второй аккаунт выручает, когда у первого кончились деньги или
провайдер не отвечает. Порядок меняют «Ещё» → «Выше» и «Ниже», там же — «Изменить», «Новые данные для входа»,
«Отключить» (данные для входа сохраняются) и «Удалить».

### Когда провайдер отказывает

В колонке «Состояние» — «Работает», «Не проверен», «Отказывает» или «Отключён». Под «Отказывает» — причина:

| Причина | Что сделать |
|---|---|
| провайдер не принял логин или пароль (ключ) | проверьте их или введите заново: «Ещё» → «Новые данные для входа» |
| на счёте у провайдера не хватает денег | пополните баланс у провайдера |
| провайдер не отправляет от этого имени отправителя | согласуйте имя у провайдера или укажите другое в «Изменить» |
| аккаунт не принимает запросы с адресов платформы | разрешите их в настройках аккаунта: адреса подскажет поддержка |
| провайдер не ответил или ответил ошибкой | попробуйте позже |

Канал, который отказал из-за логина, имени отправителя или доступа, больше не пробуют, пока вы не исправите причину:
повторные неверные входы заставили бы провайдера заблокировать адрес платформы. Исправив, нажмите «Проверить»; имя
отправителя подтвердит «Проверочное SMS». Канал без денег не выключается: коды уходят через следующий канал, а этот
снова заработает, когда вы пополните баланс. Если не работает ни один канал, коды не уходят: тогда веб-касса может
регистрировать клиентов без кода («Регистрация на кассе» в «Программах»), а оплату баллами можно не подтверждать
кодом (в «Правилах программы»).

## Почта

Почта — ваш почтовый ящик: участники получают письма с вашего адреса, через сервер вашей почты (SMTP). Подойдёт ящик
на домене компании — например, в Яндекс 360 или VK WorkSpace — или сервис рассылок со SMTP. Письма с бесплатных
ящиков чаще попадают в спам, и в день их можно отправить немного. «Сообщения» → «Почта» → «Подключить почту»:

- «Сервер исходящей почты (SMTP)» — имя сервера из справки вашей почты, например smtp.yandex.ru, а не IP-адрес.
- «Порт» и «Шифрование»: на порту 465 — TLS (SSL), на 587 и 25 — STARTTLS, на 2525 — как в справке почты. Без
  шифрования и без логина платформа к серверу не подключается.
- «Логин» — обычно адрес ящика целиком. «Пароль» — пароль приложения, если почта его требует: Яндекс, Mail.ru и Gmail
  пускают почтовые программы только с ним.
- «Адрес отправителя» — обычно адрес того же ящика; «Имя отправителя» — например, «Кофейня Зерно».

Платформа сначала спрашивает сервер, принимает ли он логин и адрес отправителя: что он не принял, не сохраняется.
Затем отправьте «Проверочное письмо» на свой адрес — так видно, доходят ли письма и не попадают ли в спам. Сервер,
порт или логин меняет «Изменить подключение», и пароль при этом вводится заново.

Блок «Домен отправителя» показывает, есть ли у домена записи SPF и DMARC: «Есть», «Нет» или «Не удалось узнать». Они
говорят почтовым сервисам, что письма с вашего адреса настоящие; без них письма чаще попадают в спам. Как их
добавить, написано в справке вашей почты; если почта предлагает подпись писем DKIM, включите и её. Платформа смотрит
только, есть ли записи, — что в них разрешено, проверяет сервис получателя. Добавив записи, нажмите «Проверить».

Служебные автосообщения уходят сначала письмом, а если адреса нет или письмо не прошло, по SMS. Реклама письмом уходит
только на адрес, который клиент сам подтвердил кодом из письма, и с его согласия на рекламные письма; в конце такого
письма есть ссылка «Отписаться». Через этот ящик уходят и коды, которыми клиент подтверждает адрес в кабинете
покупателя. Тема письма — название программы и о чём письмо, например «Кофейня Зерно: скоро сгорят баллы».

Сколько писем в день уходит с одного ящика, решают правила вашей почты. Если рекламу письмом будут получать многие,
подключите сервис рассылок со SMTP или выберите в «Настройках» сначала SMS, иначе в день рассылки могут не дойти и
коды подтверждения адреса. Дошло ли письмо до ящика, почта не сообщает: если клиент не нашёл письмо, пусть проверит
папку «Спам».

## MAX

> MAX — скоро: работу с настоящим ботом проверяем на первом пилотном магазине. Ниже — как это будет устроено.

Бот программы в мессенджере MAX. Кнопка «Моя карта» в его чате открывает кабинет покупателя прямо в MAX: карту с
кодом для кассы, баллы и историю. Нужны бот в «MAX для партнёров» (business.max.ru) — создать его может только
организация или ИП, подтверждённые на платформе MAX, — открытый [кабинет покупателя](/docs/merchants/card/) и
работающий SMS-канал. Подключайте отдельного бота: сервис, с которым бот уже работает (рассылки, CRM), перестанет
получать его сообщения.

1. В «MAX для партнёров» откройте настройки бота и нажмите «Получить токен».
2. В кабинете: «Сообщения» → «MAX» → «Подключить бота». Введите «Токен бота» и выберите в поле «Программа» ту, чей
   кабинет покупателя бот будет открывать.
3. Скопируйте «Адрес мини-приложения» и вставьте его в «MAX для партнёров»: бот → раздел «Мини-приложение». Проверить
   адрес платформа не может: откройте бота сами и нажмите «Моя карта».
4. Опубликуйте новую версию согласия на обработку персональных данных в «Документах согласий»: шаблон уже называет
   идентификатор в MAX.

Если в строке «Сообщения боту» написано «Не доходят», нажмите «Проверить». «Ещё» → «Выключить» останавливает бота,
подключения покупателей сохраняются. «Удалить» стирает токен и все подключения; сам бот в MAX остаётся — уберите его
QR-код у кассы.

QR-код из блока «Для покупателей» ставят у кассы. Покупатель открывает чат бота, нажимает «Начать», затем «Моя карта»
и один раз входит — по коду из SMS и коду, который бот пришлёт в чат; дальше карта открывается без кода. Без
приложения MAX этот QR-код не поможет — оставьте рядом QR-код кабинета покупателя. Кто уже вошёл в кабинет покупателя
в браузере, подключает MAX в профиле кнопкой «Подключить MAX». О каждом подключении на номер карты уходит SMS «К карте
подключён MAX. Не вы?» за ваш счёт: по ссылке владелец номера отключит чужой MAX и завершит все входы в кабинет. После
трёх подключений MAX и ВКонтакте к карте за сутки новые без кода не принимаются. Что пишут боту, никуда не
пересылается: бот отвечает, что с вопросами — в магазин.

Тем, кто подключил MAX, служебные сообщения и реклама уходят сначала в MAX; прочитано ли сообщение, платформа не
знает. Коды для оплаты баллами на кассе уходят в MAX тем, кто подключил его, войдя в кабинет внутри MAX по коду из
SMS. Коды входа и вступления в кабинет покупателя, регистрации и смены номера в MAX не уходят — только через
SMS-каналы (в Telegram, если так настроен канал).

Реклама в MAX — только с согласием «Реклама в MAX»: опубликуйте «Согласие на рекламу в MAX» в «Документах согласий».
Бот спросит о нём тех, кто подключит MAX после этого, кабинет покупателя предложит его вступающим, а в профиле его
можно дать или отозвать. Тех, кто подключил MAX раньше, бот не спрашивает: вопрос рассылкой сам был бы рекламой. Под
рекламой есть кнопка «Не присылать рекламу», слово «стоп» в чате бота отзывает согласие.

## ВКонтакте

> Работу с настоящим сообществом проверяем перед пилотом.

Сообщество программы во ВКонтакте. Покупатель подключает ВКонтакте к карте в профиле кабинета покупателя, и сообщения
программы приходят ему в чат сообщества — бесплатно, после MAX и раньше письма и SMS, с кнопкой «Моя карта».

1. Подойдёт сообщество, где вы администратор. Откройте «Управление» → «Сообщения», включите «Сообщения сообщества», а
   в разделе «Настройки для бота» — «Возможности ботов»: без них сообщения уходят без кнопок, а реклама не уходит.
2. «Управление» → «Работа с API» → «Ключи доступа» → «Создать ключ» с правами «Управление сообществом» и «Сообщения
   сообщества». Лучше создать для платформы отдельный ключ.
3. В кабинете: «Сообщения» → «ВКонтакте» → «Подключить сообщество». Введите «Ключ доступа» и выберите в поле
   «Программа» ту, участникам которой сообщество будет писать.
4. Опубликуйте новую версию согласия на обработку персональных данных: шаблон уже называет идентификатор ВКонтакте, а
   в свой текст допишите «идентификатор пользователя ВКонтакте (если я подключу его к карте)».

Платформа добавит в сообщество сервер «Loyalty» («Управление» → «Работа с API» → «Callback API»). Не удаляйте его и
ключ платформы и не меняйте настройки сервера, иначе покупатели не подключат ВКонтакте; если изменили — нажмите
«Проверить». Секретный ключ этого сервера видят администраторы сообщества и сервисы с правом «Управление
сообществом»: давайте эти права только тем, кому доверяете данные покупателей.

Покупатель нажимает в профиле «Подключить ВКонтакте» — откроется чат сообщества по ссылке, которая действует 15 минут, —
и отправляет любое сообщение; сообщество отвечает «Готово». QR-код из блока «Для покупателей» тоже открывает чат: кто
напишет туда, получит в ответ адрес кабинета покупателя (не чаще раза в сутки). О каждом подключении на номер карты
уходит SMS «К карте подключён ВК. Не вы?» за ваш счёт, поэтому без работающего SMS-канала ВКонтакте не подключится. На
остальные сообщения покупателей платформа не отвечает — они остаются в сообщениях сообщества для ваших сотрудников.

Реклама во ВКонтакте — только с согласием «Реклама во ВКонтакте» («Согласие на рекламу во ВКонтакте» в «Документах
согласий»). Сообщество спросит о нём тех, кто подключит ВКонтакте после публикации, если текст не длиннее 2000 знаков.
Отказаться можно кнопкой «Не присылать рекламу» под рекламой или словом «стоп». Коды во ВКонтакте не уходят.

## Коды подтверждения

Кодами подтверждают телефон нового участника, оплату баллами, смену телефона, вход в кабинет покупателя и адрес почты
(этот код уходит письмом). Код умещается в одну SMS и не называет магазин — его показывает имя отправителя, например
«Код для списания 1 500 баллов: …». Каждый код, который принял провайдер, оплачивается с вашего счёта у него.

Блок «Лимиты кодов» на «Каналах» показывает «Кодов сегодня» и «Кодов в этом месяце», например «37 из 500», и строку
«Отправка кодов». Сутки и месяц — по московскому времени. По умолчанию лимит — 500 кодов в сутки и 15 000 в месяц;
«Изменить лимиты» меняет их в пределах, которые задаёт платформа.

- При 80 % лимита строка становится жёлтой, а владельцы мерчанта получают письмо. Когда лимит исчерпан, коды не
  уходят до конца суток или месяца, и владельцы снова получают письмо.
- Кабинет покупателя расходует не больше половины лимита на сутки и на месяц: вторая половина остаётся кассам.
- Если клиенты подтверждают слишком мало кодов, это похоже на накрутку SMS: кто-то запрашивает коды на чужие номера,
  а платите вы. Платформа останавливает отправку и пишет владельцам: сначала на 15 минут, каждая следующая остановка
  в течение суток дольше — час, 6 часов, сутки. «Возобновить отправку кодов» снимает остановку раньше, но если это
  накрутка, коды снова будут тратить ваши деньги, а следующая остановка продлится дольше.

## Автосообщения

Автосообщения платформа отправляет сама. Включают их на странице «Сообщения» → «Автосообщения», для каждой программы
отдельно; по умолчанию все выключены.

| Сообщение | Когда уходит | Вид |
|---|---|---|
| «Приветствие» | после вступления в программу | служебное |
| «Первая покупка» | один раз, после первой покупки, за которую начислены баллы | служебное |
| «Новый уровень» | когда участник перешёл на уровень выше: по покупкам или его зафиксировал сотрудник | служебное |
| «Списание баллов» | после каждой покупки, оплаченной баллами | предупреждение |
| «День рождения» | раз в год, вместе с баллами ко дню рождения | реклама |
| «Давно не были» | через 30, 60 или 90 дней без покупок | реклама |
| «Баллы скоро сгорят» | за 3, 7 или 14 дней до того, как сгорят баллы | служебное |

Реклама уходит только тем, кто согласился её получать, не больше одного сообщения в день и трёх за 7 дней. Служебное
уходит и тем, кто не соглашался, поэтому рекламы в нём быть не должно. Обе ждут конца тихих часов. Предупреждение
уходит сразу, в любое время — и во время паузы.

«Включить» показывает, как участник прочтёт сообщение и сколько SMS оно займёт. С этой минуты сообщение уходит после
каждого такого события, за прошлые — нет. «Выключить» останавливает и новые сообщения, и те, что уже ждут отправки.
Пока не подключены ни SMS-канал, ни почта, включённые сообщения не уходят. Сообщение с пометкой «Появится позже»
платформа пока не отправляет, но текст можно подготовить заранее.

### Тексты

| Сообщение | Стандартный текст |
|---|---|
| «Приветствие» | Добро пожаловать в программу лояльности! Спасибо, что вы с нами. |
| «Первая покупка» | Спасибо за первую покупку! Начислено баллов: {points}. |
| «Новый уровень» | Поздравляем! Ваш новый уровень — {tier}. |
| «Списание баллов» | Списано баллов: {points}. Не вы? {link} |
| «День рождения» | Ко дню рождения дарим баллов: {points}. Ждём вас! |
| «Давно не были» | Давно вас не видели! Заходите снова — мы вас ждём. |
| «Баллы скоро сгорят» | {date} сгорят баллы: {points}. |

Стандартный текст действует, пока вы не написали свой. «Изменить» открывает текст и строку «Так прочтёт участник».
Во всех сообщениях есть переменные `{program}` — название программы, `{first_name}` — имя участника (если его нет,
пусто) и `{balance}` — баллов на счёте без тех, что станут доступны позже. Кроме них: `{points}` — баллов в событии
(в «Баллы скоро сгорят» — сколько сгорит в этот день), `{tier}` — название уровня, `{date}` — ближайший день
сгорания, например 08.10.2026, и `{link}` — ссылка «Не вы?», которую из «Списания баллов» убрать нельзя.

Текст — до 300 знаков, с переносами строк, без невидимых символов (например, мягких переносов из Word); фигурные
скобки — только для переменных. В одной SMS кириллицей 70 знаков, в каждой части длинной — 67. «История» хранит все
версии, «Стандартный текст» возвращает текст платформы. Обещаете в рекламе подарок за покупку — укажите срок акции и
где прочитать её условия: этого требует закон о рекламе. Рекламные SMS у операторов обычно дороже служебных, а новый
текст служебного сообщения провайдер может попросить согласовать заново — уточните у него.

### Что важно знать о каждом

- «Приветствие» и «Первая покупка» не уходят участникам, загруженным из другой системы. Если кассир регистрирует без
  кода, приветствие уйдёт на номер, который он ввёл. «Первая покупка» не уходит и тому, кто вступил меньше часа назад,
  если включено приветствие.
- «Новый уровень» — своё сообщение на каждое повышение; о понижении сообщения нет.
- «День рождения» уходит, только если программа начисляет баллы ко дню рождения («Бонусы» на странице «Правила
  программы», см. [«Программа лояльности»](/docs/merchants/program/)). Баллы приходят после полуночи, поздравление —
  утром и только согласившимся на рекламу; остальным баллы придут без сообщения.
- «Давно не были» — кнопка «Сроки»: 30, 60 и 90 дней со дня последней покупки, можно несколько. Новая покупка
  начинает отсчёт заново. Тем, кто ни разу не покупал, тем, у кого срок прошёл до включения, и в день, когда участник
  уже получил другую рекламу, оно не уходит. Выбирайте срок длиннее обычного промежутка между покупками.
- «Баллы скоро сгорят» — кнопка «За сколько дней»: 3, 7 или 14; одному участнику — не чаще раза в 7 дней. В день
  включения его сразу получат все, у кого баллы сгорают в пределах срока, — это может быть много SMS. Замороженным и
  заблокированным оно не уходит, а пока сообщения на паузе или нет работающего канала, такие сообщения не готовятся.

Эти два сообщения платформа проверяет каждый день в 10:00 по часовому поясу программы.

### Ссылка «Не вы?»

«Списание баллов» уходит после каждой оплаты баллами, сразу и в любое время суток; кто подтверждал оплату кодом, получит
два сообщения: код и уведомление. Ссылка «Не вы?» действует 30 дней и открывает страницу: сколько баллов списано, когда
и где. Если баллы тратил не участник, он нажимает «Это не я — заморозить карту»: участник получает статус «Заморожен»
(копит баллы, но не тратит), выходит из кабинета покупателя на всех устройствах, а владельцы мерчанта получают письмо.
Баллы сами не возвращаются: в карточке участника есть «Действия» → «Скорректировать баллы» и «Снять заморозку или
блокировку» ([«Участники»](/docs/merchants/members/)). Сообщения «MAX подключён к карте» и «ВКонтакте подключён к карте»
выключить нельзя: о каждом подключении мессенджера хозяину номера уходит SMS со ссылкой «Не вы?».

## Настройки отправки

«Сообщения» → «Настройки». «Поставить на паузу» останавливает рекламу и служебные сообщения; что подойдёт к отправке
во время паузы, не уйдёт и после неё. Предупреждения и коды подтверждения пауза не останавливает. Если в строке
«Сейчас» написано «Остановлены платформой», снять остановку может только платформа — обратитесь в её поддержку.
Строка «Все сообщения платформы» значит, что платформа временно остановила отправку для всех: очередь ждёт.

| Правило | У платформы | Что можно изменить |
|---|---|---|
| «Тихие часы» | с 21:00 до 9:00 по часовому поясу программы | начать раньше и закончить позже |
| «Реклама одному клиенту» | не больше 1 в день и 3 за 7 дней | реже: 1 или 2 за 7 дней |
| «Служебные сообщения и реклама» | сначала письмом, затем по SMS | сначала по SMS, затем письмом |

Правила меняет «Изменить правила»; мягче, чем у платформы, они быть не могут. Новые правила действуют для сообщений,
которые подойдут к отправке с этой минуты. Сообщения уходят в таком порядке:

| Что | Порядок |
|---|---|
| служебные сообщения и реклама | MAX → ВКонтакте → письмо → SMS; при «Сначала по SMS» — SMS раньше письма |
| «Списание баллов» | SMS → письмо → MAX → ВКонтакте |
| коды подтверждения | SMS-каналы по порядку; код оплаты баллами на кассе — сначала в MAX (см. «MAX» выше) |

Следующий способ берёт сообщение, если предыдущим отправить нельзя — нет адреса или номера, мессенджер не подключён,
нет согласия на рекламу этим способом — или отправка не удалась. SMS, которое принял провайдер, но которое не дошло
до телефона, другим способом не повторяют.

## Журнал и очередь

«Сообщения» → «Журнал» — коды, проверочные сообщения и сообщения клиентам за 13 месяцев: когда, что, кому, как, итог
и стоимость, если провайдер её назвал. Текстов журнал не хранит, номера и адреса скрыты наполовину.

| Итог | Что значит |
|---|---|
| «Доставлено» | провайдер сообщил, что SMS дошло до телефона |
| «Не доставлено» | провайдер сообщил, что не дошло, и почему: истёк срок, телефон недоступен, неверный номер |
| «Отправлено» | ушло, но дошло ли — неизвестно: провайдер ещё не ответил или такое сообщение не отслеживается |
| «Не отправлено» | ни один канал не взял сообщение — с причиной последнего отказа |

О доставке SMS платформа несколько раз спрашивает провайдера в течение суток; коды, письма и сообщения в мессенджерах не
отслеживаются. «Подробнее» показывает каналы по порядку: кто принял, кто отказал и почему. Строка — одна попытка одним
способом (письмо, SMS, мессенджер): сообщение, которое не прошло письмом и ушло по SMS, занимает две строки. Искать
можно по номеру телефона или e-mail целиком; поиски без результата ограничены, а каждый поиск записывается в журнал
аудита.

«Сообщения» → «Очередь» — автосообщения за 13 месяцев и чем закончилось каждое. Над таблицей — сколько сообщений ждёт
сейчас и что останавливает отправку; сообщения одного участника — кнопка «Сообщения» в карточке участника. Сообщение
ждёт конца тихих часов, своего времени или повтора: если провайдер или почта не ответили, платформа пробует снова
через 5, 30 и 120 минут, а потом ставит «Не отправлено». Правила проверяются в момент отправки, и сообщение
«Пропущено», если:

- оно подошло к отправке во время паузы — вашей или остановки платформой;
- клиента заблокировали, обезличили или объединили с другим, или программа в архиве;
- автосообщение выключили, пока сообщение ждало, или пропал повод: клиент снова купил, потратил баллы или их срок
  перенесла покупка, карту заморозили;
- клиент уже получил столько рекламы, сколько можно за день или за 7 дней;
- у клиента нет мобильного номера России или согласия на рекламные SMS, а письмо отправить было нельзя.

«Не отправлено» значит, что ни один канал не мог взять сообщение — проверьте «Каналы» и «Почту», — или провайдер не
ответил и после повторов. Отправить такое сообщение ещё раз вручную нельзя.

## Через API

Каналы, лимиты кодов, автосообщения, правила отправки, журнал и очередь доступны и через Management API — для CRM и
интеграторов ([документация для разработчиков](/docs/)). Проверочные SMS и письма и досрочное возобновление отправки
кодов — только в кабинете.
