Подтверждение дисконтной карты по SMS, звонку, Telegram, WhatsApp или Max в 1С

Теперь нет никакой проблемы в случае, если при покупке выяснится, что клиент забыл дома дисконтную карту, оформленную ранее. В дополнение к возможности ручного и автоматического считывания штрихкода карты добавляется верификация карты по номеру телефона — звонком или сообщением в СМС, WhatsApp, Telegram или Max.

Кнопка Считать карту по телефону появляется в:

• Заказе клиента,
• Реализации товаров и услуг,
• РМК.

Настройки верификации карты лояльности

По кнопке Считать карту по телефону открывается форма подтверждения карты.

В настройках (кнопка с шестеренкой) заполняются параметры подключения к провайдерам. Настройки доступны только пользователям с полными правами, у остальных пользователей кнопка настроек скрыта. Заданные параметры действуют на всю базу: кассир работает с тем провайдером и учетными данными, которые задал администратор, — заполнять настройки на каждом рабочем месте не нужно.

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

• СМС-центр и SMSPilot — сервис звонит клиенту. Клиенту поступает звонок, отвечать на него не нужно: кодом служат последние цифры номера, с которого звонят. Покупатель смотрит на экран телефона и называет их продавцу.
• GREENSMS — сервис звонит клиенту, код приходит в программу. Клиенту звонят, а код подтверждения расширение получает от сервиса — кассиру достаточно сверить его с тем, что назвал покупатель.
• СМС.РУ — клиент звонит сам. Кассиру показывается номер, покупатель звонит на него со своего телефона, и карта подтверждается автоматически, вводить код не нужно.
• СМС-центр, звонок клиента (WaitCall) — клиент звонит сам, без кода. Кассир видит номер, покупатель звонит на него сам и сбрасывает после первого гудка. Кода в этой схеме нет: подтверждением служит сам факт звонка. Карта подставляется в документ автоматически, примерно через 30 секунд после звонка; если звонка нет три минуты, расширение предлагает повторить. Учетные данные те же, что у обычного подтверждения звонком через СМС-центр. Услугу подключают в личном кабинете сервиса.

Состав полей учетных данных подстраивается под выбранный сервис: обеим схемам СМС-центра и сервису СМС.РУ нужны логин и пароль, SMSPilot просит только ключ API, GREENSMS — только токен, лишние поля скрываются. Ссылка под полями ведет на сайт того сервиса, который выбран. Если сервис отказал — не принял ключ, кончились деньги на счете, не подошел формат номера, — кассир видит причину прямо на экране, а не общее «проверьте баланс»; та же причина попадает в журнал верификаций и в журнал регистрации.

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

Два способа звонка можно держать включенными одновременно. Рядом с выбором сервиса включается второй способ — со своим сервисом, логином и паролем. Так у одного провайдера используется схема, где сервис звонит клиенту, а у другого — где клиент звонит сам: берется то, что дешевле по тарифу, а второй способ выручает, когда основной сервис недоступен. В форме ввода телефона кассиру доступны обе команды — Позвонить и Позвонить (второй способ), — и он выбирает подходящую прямо на кассе.

Настройки отправки сообщений в WhatsApp. Поддерживаются провайдеры Wappi и GreenApi.

В первую очередь нужно зарегистрироваться на сайте провайдера и зайти в личный кабинет.

В личном кабинете с помощью сканирования QR-кода потребуется привязать к аккаунту мобильное приложение Вотсап, с которого клиентам будут отправляться сообщения с кодами подтверждения.

Также здесь нам понадобятся две настройки — Токен API и ID профиля (их потом нужно будет вставить в настройки обработки в 1С).

Для целей тестирования можно активировать бесплатный пробный период (5 дней).

Для отправки сообщений в Telegram используется сервис Green-api: на форме настроек вводятся токен (apiTokenInstance), идентификатор профиля (idInstance) и api url.

В настройках отправки сообщений в Max (используется провайдер GreenApi) нужно указать:

• токен (apiTokenInstance),
• идентификатор профиля (idInstance),
• api url.

С версии 635.5.15.5 на вкладках Max и Телеграм есть ещё одно, необязательное поле — «Адрес хранилища файлов». Green-API принимает текстовое сообщение и файл на разных хостах, и для части инстансов Max (и потенциально Телеграма) адрес хранилища не получается верно вычислить из адреса api автоматически — тогда код подтверждения клиенту доходит, а картинка карты уходит на несуществующий хост и не доставляется. Если у вас именно так, скопируйте значение поля Media URL из личного кабинета Green-api и вставьте его в поле адреса хранилища на нужной вкладке. Поле пустое — поведение прежнее, адрес хранилища вычисляется автоматически.

В настройках также можно выбрать действие по умолчанию при нажатии клавиши Enter после ввода номера телефона:

• Ничего не делать — отрабатывает стандартный механизм разработки, то есть пользователь вводит номер телефона и мышкой кликает по кнопке, соответствующей определенному действию (поиск карты, отправка кода подтверждения в вотсап, по смс или звонок на телефон);
• Отправлять смс или Отправлять вотсап — после ввода номера телефона и нажатия Enter код подтверждения будет отправлен по смс или на вотсап соответственно настройке;
• Искать карту — после ввода номера телефона и нажатия Enter будет найдена карта лояльности клиента.

Добавлена отдельная настройка для выбора типа номеров — РФ и Казахстан или РБ.

Отдельной настройкой задается вид карты — он используется, когда карту заводят прямо из формы подтверждения.

Для возможности отправки смс необходимо выполнить соответствующие настройки в программе.

Для доступа к подтверждению скидок по смс необходимо добавить продавцам роль Отправка SMS.

Полные права кассирам и продавцам при этом не нужны: форма ввода телефона, экранная клавиатура и отчет по остатку бонусов открываются по базовым правам пользователя.

Есть возможность спрятать стандартную кнопку считывания карты лояльности (во избежание ручного ввода штрихкода). Для активации этой функции добавьте из архива разработки отдельное расширение Запрет подбора карт по штрихкоду (у расширения нужно отключить Безопасный режим).

Искать карту по номеру телефона без ввода кода подтверждения могут только пользователи с ролью Верификация карт без отправки сообщения. Роль выдается адресно: полных прав для обхода подтверждения недостаточно, у остальных пользователей кнопка Найти карту скрыта. Общая настройка Искать карту сама по себе обход подтверждения не открывает.

Роль назначается через профиль группы доступа: Администрирование (в УТ, КА и ERP — НСИ и администрирование) — Настройки пользователей и прав — Профили групп доступа. Если в настройках выбрано действие по умолчанию Искать карту, а роли у кассира нет, поиск не выполняется: программа сообщает, какой роли не хватает. В этом случае либо выдайте роль, либо выберите действие по умолчанию с подтверждением кодом — смс, звонок или мессенджер.

Проверка канала до того, как о сбое узнает кассир

Неработающий канал обычно обнаруживается в худший момент: кассир вводит номер, клиент ждет код, а сообщение не уходит. Причина при этом чаще всего простая — истекшая авторизация аккаунта в сервисе рассылки, опечатка в токене, незаполненные настройки отправки смс в самой базе. Чтобы такое находилось заранее, в форме настроек есть кнопки Проверить связь и Пробное сообщение.

Проверить связь спрашивает у сервиса, готов ли канал открытой вкладки отправлять сообщения, и переводит ответ на понятный язык. Для WhatsApp, Телеграма и Max расширение обращается к Green API или Wappi и показывает состояние аккаунта: авторизован, не авторизован и нужно отсканировать код в личном кабинете, заблокирован сервисом, находится в спящем режиме, еще запускается. Заодно показывается номер, с которого уходят сообщения, — сразу видно, что подключен именно тот аккаунт, который нужен.

На вкладке звонков проверяется другое. Код по смс отправляется типовой подсистемой самой базы, поэтому проверка показывает, настроена ли она и каким именем подписываются сообщения; на общий вердикт это влияет только тогда, когда код по смс действительно используется — при подтверждении звонком ненастроенная типовая отправка сообщений канал неготовым не объявляет. Отдельно проверяются учетные данные каждого включенного способа звонка: расширение обращается к выбранному сервису и сообщает, приняты они или нет — с названием сервиса и причиной отказа.

Пробное сообщение отправляет настроенный текст на указанный номер тем же путем, которым уходит код подтверждения. Это проверка всей цепочки целиком, а не только связи с сервисом: если сообщение дошло, канал работает.

Проверка идет по значениям, введенным на форме, — сохранять их для этого не нужно. Администратор вставляет токен и сразу видит, принят ли он.

Текст сообщения, которое получает покупатель

Что именно придет клиенту, задается в форме настроек — поле Текст сообщения, одно на все каналы: смс, WhatsApp, Телеграм и Max. Магазин пишет собственную формулировку: с названием компании, с обращением, с указанием, кому назвать код.

В текст подставляются данные документа и найденной карты:

• [Код] — проверочный код;
• [Организация] — организация документа;
• [Магазин] — магазин документа (в УТ — склад);
• [Клиент] — владелец найденной карты.

Например, из шаблона «[Организация]: ваш код [Код]. Сообщите его продавцу» покупатель получит «ООО Ромашка: ваш код 4821. Сообщите его продавцу». Подстановка, для которой в документе нет значения, убирается из текста вместе с лишним пробелом.

Сообщение без подстановки [Код] сохранить нельзя: покупатель получил бы текст без кода и подтвердить карту не смог. В базе, где настройки еще не задавали, поле открывается заполненным — формулировку остается поправить под себя. Пробное сообщение уходит этим же текстом с образцовыми значениями, поэтому результат подстановки виден до того, как сообщение получит покупатель.

Для поиска карты по номеру вводим телефон и нажимаем Найти карту. Если в базе будет найдена карта, она автоматически подставится в документ или в РМК, без необходимости введения проверочного кода.

Дополнительно пользователи с полными правами могут снять блокировку номеров телефонов (по которым было более 3 неудачных попыток верификации).

Защита от подбора кода и лишних сообщений

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

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

Расход считается по факту: если провайдер сообщение не принял, отправка клиенту не засчитывается. Написание номера на защиту не влияет — «+7 (900) 999-90-01» и «9009999001» для нее один и тот же номер.

Журнал верификаций: видно, кто и что делал с картами

До сих пор верификация не оставляла следа: карта подставилась в документ — и все. Если у клиента «код не пришел», а кассир уверяет, что отправлял, разбираться было не по чему. Теперь каждое действие записывается, и администратор смотрит его отчетом.

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

Отчет «Журнал верификаций» открывается кнопкой из формы настроек и имеет три варианта:

• Лента событий — все подряд по времени, с фильтрами по кассиру, каналу и номеру телефона;
• Сводка по каналам и кассирам — сколько кодов ушло каждым каналом и сколько отправил каждый кассир;
• Отказы и блокировки — только неуспешные попытки: где отказал канал, кто попал под лимит, чей номер заблокирован.

Отчет и сам журнал доступны только полноправному пользователю. Кассир пишет в журнал, но не читает его: номер телефона хранится полностью, и видеть чужие обращения продавцу незачем.

Чтобы журнал не рос бесконечно, в настройках задается срок хранения — «Хранить события, дней», по умолчанию 180. Записи старше срока убираются попутно, не чаще одного раза в сутки, чтобы очистка не мешала работе кассы. Ноль означает «хранить все». Рядом — кнопка «Очистить журнал» для разовой уборки вручную.

Журнал живет в собственном регистре расширения. Это значит, что при удалении расширения из базы он удаляется вместе с ним — если данные нужны на будущее, отчет стоит выгрузить заранее.

Поиск карты лояльности по телефону

После подбора товаров в Заказ клиента, Реализацию или РМК нажимаем кнопку Считать карту по телефону.

Открывается окно, в котором нужно ввести номер телефона клиента (10 цифр) и нажать кнопку, соответствующую одному из способов верификации:

• Найти карту (доступно пользователям с ролью Верификация карт без отправки сообщения),
• Отправить сообщение в Max,
• Отправить сообщение в WhatsApp,
• Отправить сообщение в Telegram,
• Отправить смс,
• Позвонить.

Дополнительно реализован альтернативный ввод номера телефона — с помощью экранной клавиатуры:

Карта клиента в мессенджере вместо пластика

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

Карта уходит тем каналом, которым отправлялся код подтверждения: WhatsApp, Телеграм или Max. Если код по этому номеру еще не отправляли, расширение спросит канал. СМС картинку не передает, поэтому этот канал отклоняется с пояснением.

Каким будет код на карте, выбирает администратор в настройках расширения полем Код на карте клиента: линейный штрихкод или QR-код. Изображение строится штатным механизмом печати штрихкодов — тем же, которым программа печатает ценники и этикетки. К картинке добавляется подпись: магазин или организация документа, номер карты и ее владелец.

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

Где ищется номер телефона

Номер сверяется не только с телефоном, записанным в самой карте лояльности, но и с контактной информацией клиента. Карта находится, если телефон записан:

• в карточке контрагента или партнера — владельца карты;
• в карточке физического лица, на которое выпущена карта;
• в карточке контактного лица клиента;
• у контрагента, связанного с этим физическим лицом (и наоборот);
• в самой карте лояльности.

Формат записи значения не имеет: скобки, дефисы, пробелы, код страны и комментарий рядом с номером на поиск не влияют — сравниваются цифры номера. Это важно для карт, выпущенных на кассе: у них телефон обычно указан только в карточке клиента. Карты с пометкой удаления не подставляются, а поиск выполняется даже тогда, когда у кассира нет прав на справочники клиентов.

Клиенту придет сообщение такого содержания:

Ваш код — ХХХХ. Сообщите его продавцу.

Покупатель называет код менеджеру, тот вводит его в соответствующее поле и нажимает Применить код.

В результате дисконтная карта добавляется в РМК, по карте отображается остаток бонусных баллов. Теперь осталось только рассчитать скидку.

Применилась скидка по карте лояльности:

Если проверочный код, введенный менеджером, не совпадает с кодом в сообщении (или с последними 6 цифрами входящего звонка), выводится предупреждение:

Если неправильный код ввести больше трех раз, номер блокируется для подтверждения дисконтной карты. Разблокировка доступна пользователям с полными правами.

Если покупателю выдано несколько карт лояльности (и все они действуют), то перед отправкой сообщения появляется окно, в котором необходимо выбрать нужную карту:

Если карты по номеру нет

В Управлении торговлей карту можно завести прямо из формы подтверждения — выводится вопрос:

По кнопке Ок открывается форма создания карты лояльности: телефон заполняется автоматически, вводим данные клиента. При необходимости можно указать дату рождения.

В фоновом режиме будет создан партнер и его бонусная карта:

В Рознице карты заводятся штатным способом — в разделе Маркетинг, справочник Информационные карты; из формы подтверждения выводится сообщение, что карта с таким телефоном не зарегистрирована.

Идентификатор чата Max запрашивается у Green-API перед отправкой, поэтому сообщения доходят и до тех получателей, у которых закрыты настройки приватности. Если номер в Max не зарегистрирован, кассир получает об этом понятное сообщение.

Для корректной работы расширения при подключении необходимо снять Безопасный режим.