Настройки в личном кабинете @restoBot
- Sergei Khalikov
После успешной авторизации окно управления настройками бота выглядит так:
Все настройки в личном кабинете поделены на следующие разделы:
Поведение бота
Контактная информация
Настройки API iiko
Реферальная система
Настройки Telegram
Генерция QR-кодов
Диагностика
Поведение бота
В данном разделе можно настроить поведение бота: какие сообщения бот будет выводить гостю, какие вопросы бот будет задавать гостю при заполнении анкеты, какие из этих вопросов обязательны или нет. Так же в этом разделе можно прикрепить логотип заведения, который будет отображаться при первом знакомстве с гостем.
Логотип
Изображение, которое бот будет показывать гостю после приветвенного сообщения, когда гость перейдет в окно чата с ботом. Рекомендуемый размер - не более 512px по ширине и высоте.
Настройка сообщений.
В этом разделе настраиваются тексты сообщений, которые бот выводит в чат гостю в зависимости от тех или иных условий.
Приветственное сообщение - самое первое сообщение (после логотипа), которое выводится гостю сразу перед знакомством с ботом.
Сообщение о найденной информации. Сообщение, которое выводится гостю, если в базе гостей iikoCard ресторана по номеру телефона была найдена информция о госте. Гость должен подтвердить правильность найденных данных. В сообщении используется макроподстановка {summary}, которая содержит в себе все поля найденой анкеты гостя в IikoCard.
обязательное для заполнения поле
Сообщение о нехватке данных. Это сообщение будет выводиться гостю, если в найденой в iikoCard анкете гоcтя не заполнены поля, который являются обязательными для бота (см. раздел “Настройка вопросов Telegram бота“)
обязательное для заполнения поле
Привет. Что будем делать? Сообщение выводится гостю перед отображением нижнего меню с возможными действиями. В тексте сообщения возможно использовать макроподстановку {name}, которая содержит в себе имя текущего гостя.
обязательное для заполнения поле
Благодарность за ответы. Сообщение выводится гостю после заполнения им анкеты (т.е. гость ответил на все вопросы из блока “Настройка вопросов Telegram бота“). В сообщении используется макроподстановка {summary}, которая содержит в себе все поля анкеты гостя.
обязательное для заполнения поле
Кнопка “Все верно“. Надписи на кнопках, которые отображаются гостю для подтверждения информации из блока “Сообщение о найденной информации”.
обязательное для заполнения поле
Настройка вопросов Telegram бота
В этом разделе задаются поля анкеты гостя, которые бот будет запрашивать при регистрации гостя в системе лояльности. Каждое из полей (кроме имени) может быть включено или выключено. Если поле отключено, то у гостя оно не запрашивается. Если поле включено, то оно может быть обязательным (гость должен будет обязательно ввести данные в соответсвующее поле) и не обязательным (гость может пропустить ввод в данное поле).
Помимо включения/выключения полей можно задать и текст сообщения, которое будет выводиться гостю в чат перед заполнением соответсвующего поля анкеты.
Список полей анкеты гостя в iikoCard, которые может использовать @restoBot:
Имя
Фамилия
Отчество
День рождения
email
Пол
Контактная информация
В этом разделе можно заполнить контактную информацию по ресторану, к которому подключен @restoBot. Если заведений несколько, то добавить контактную информацию можно на каждое из них.
Контактная информация будет отображена гостю в чате бота по нажатию кнопки нижнего меню “Контакты“.
Доступные для заполнения поля:
Название заведения
Телефон
Адрес
e-mail
Telegram
Сайт
После создания записи с информацией по ресторану, к ней можно прикрепить фотографию.
Как заполнить контактную информацию по заведению:
Заполните все необходимые поля раздела “Контактные данные“.
Нажмите кнопку “Добавить“.
В табличную часть добавится строка с контактной информацией.
Двойной клик по строке переводит ее в режим редактирования данных.
Настройка API IIKO
В этом разделе собраны все настройки, касающиеся взаимодействия @restoBot и iiko.
iiko Api login - ключ iikoCloud API.
После введения нового ключа, для работы с остальными данными раздела “Настройка API IIKO“ обязательно нажать кнопку “Сохранить“
Хук для IIKO - идентификатор для создания webhook’а на стороне iiko.biz. Нужен для получения ботом уведомлений из системы лояльности (уведомления об изменении баланса гостя, информационные рассылки и тд). Идентификатор создается автоматически при создании учетной записи заведения. Кнопка “Показать“ показывает URL, который нужно использовать при создании webhook’а в iiko.biz
Ссылка на перс. данные. Здесь можно указать ссылку на страницу с условиями ресторана по обработке и/или хранению персональных данных гостей. Данная ссылка будет выведена гостю в чат перед началом сбора персональных данных. Дальнейшее взаимодействие гостя с ботом будет означать согласие с условиями, отраженными в документе по ссылке.
Организация. Выбор эталонной организации из iiko.biz. Список организаций формируется по нажатию кнопки “Обновить справочник организаций из iiko “на основании введенного выше ключа iikoCloud API.
После выбора организации, для работы с остальными данными раздела “Настройка API IIKO“ обязательно нажать кнопку “Сохранить“
Категории гостей.
Категория для всех. Категория, которая будет присваиваться в iikoCard всем гостям, которые зарегистрировались в боте @restoBot. Даже если гость ранее был заведен в iikoCard, ему все равно будет назначена эта категория после регистрации в боте.
Категория для новых. Категория, которая будет присваиваться в iikoCard всем гостям, которые регистрируются в боте и которые НЕ были ранее зарегистрированы в IikoCard.
“Категория для всех” может быть использована в iiko.biz для создния рассылок по базе гостей, которые зарегистрировались через бота, для создания различных маркетинговых акций по этой же базе гостей, для подсчета итогового количества гостей, которые зарегистрировались в боте и т.д.
“Категория для новых“ позволяет посчитать сколько новых гостей появилось в базе iikoCard благодаря использованию бота, настраивать маркетинговые акции для новых гостей и т.д.
UTM метки. Для каждой категории из Iiko.biz автоматически генерируется уникальная UTM-метка. Ее можно использовать в ссылке на регистрацию бота ресторана, встраивать в QR-коды. Гостю, который зарегистрировался в боте по ссылке с UTM-меткой, автоматически будет присвоена категория в iikoCard, соответсвующая данной UTM-метке.
UTM-метки удобно использовать для отслеживания источника привлечения гостей в бота.
Реферальная система
Реферальная система - функционал, благодаря которому гости ресторана могут привлекать в систему лояльности новых гостей путем рассылки пришлашений.
Включить в боте кнопку поделиться ссылкой. Для включения реферальной системы включите эту галочку. Нажмите “Сохранить“. После этого в меню бота будет доступна кнопка “Поделиться с друзьями“, по нажатию которой бот сгенерирует в чат сообщение с реферальной ссылкой гостя и предложит поделиться этой ссылкой с друзьями. Текст сообщения с предложением поделиться ссылкой настраивается здесь же. В сообщении можно использовать макроподстановку {reflink}, которая содержит в себе саму реферальную ссылку для регистрации.
Если друг гостя, который поделился ссылкой, регистрируется в боте по этой ссылке, то в iikoCard происходит “привязка“ друга к рекомендодателю. Для мотивации гостей приглашать своих друзей в систему лояльности ресторана, в iikoCard можно создать маркетинговую акцию, которая будет начислять рекомендодателю некие бонусы на первый заказ приведенного друга.
Устанавливать рекомендателя для уже существующих клиентов c не установленным рекомендателем. Включение этой опции позволяет “привязывать” по реферальной ссылке к рекомендодателю даже тех гостей, которые уже сущетсвуют в базе гостей iikoCard, но у которых в анкете не проставлен рекомендодатель.
Перезаписывать рекомендателя для уже существующих клиентов с уже установленным рекомендателем. Включение этой опции позволяет перезаписывать рекомендодателя у гостя, который открыл реферальную ссылку, даже если у него в анкете уже указан другой рекомендодатель.
Настройка Telegram
Telegram hook uid. Автоматически сгенеренный идентификатор. Устанавливается в webhook телеграмм по токену бота.
Telegram Токен - сюда необходимо ввести токен, полученный при создании бота в BotFather. (https://arbus.atlassian.net/wiki/x/y4ClRg, пункт5). После того, как ввели токен, обязательно нажать кнопку “Установить (set hook)“ и дождаться сообщения “Webhook was set”. После обязательно нажать “Сохранить“.
hook info - информация о текущем установленном webhook'е.
Telegram hook uid из первого поля обязательно дожен совпадать с hook uid из hook info. Если они будут отличаться, то сообщения из Telegram будут приходить в какой-то другой бот.
Генерация QR кодов.
По умолчанию карта гостя отображается в чате бота в виде незащищенного от копирования QR кода.
С помощью технологии TrustedGuest можно защитить QR от копирования.
Диагностика
Раздел для проверки корректности настроек с единственной кнопкой “Диагностика“.
Нажмите ее для запуска проверки. Если все настроено правильно, то появится такое сообщение:
Если в каком-то из разделов настроек присутствуют ошибки, в результатах диагностики будет об этом сообщено. В этом случае нужно исправить ошибки в соответствующих разделах.
Для корректного функционирования бота в результатах диагностики все параметры должны быть “ОК“.
Рассылки гостям
С помощью бота можно делать рассылки гостям. Настраиваются рассылки на портале iiko.biz. Для создания рассылки авторизуйтесь на портале iiko.biz, откройте раздел “Рассылки“, выберите из списка нужную организацию и нажмите кнопку Создать:
Подробно прочитать про настройки рассылок можно в соответсвующем руководстве пользователя iiko.
Для рассылки именно в телеграм-бот, нужно использовать вкладку Текст webhook
В разделе Выбор подписки следует выбрать webhook, созданый в разделе Настройка API iiko, параметр Хук для IIKO.
Вот как у гостя будет выглядеть сообщение из примера выше:
В тексте рассылки можно использовать emoji и макроподстановки:
{UserName} - в сообщении будет заменено на имя гостя.
{img:RestoBot1} - отправит перед сообщением фотографию раздела из внешнего меню iiko с названием RestoBot1. Как создать внешнее меню и загрузить в него фотографии описано здесь.
Информация для технических специалистов: для корректной рассылки гостям сообщений с изображениями из внешнего меню, к api-ключу iikoCloud, который использует телеграм-бот, должно быть обязательно привязано внешнее меню в настройках ключа в iikoWeb
Проверить корректность настроек внешнего меню для использования его в рассылках можно в разделе Диагностика личного кабинета. Для этого введите в соответсвующем поле название раздела внешнего меню, фото которого хотите использовать в рассылке, и нажмите кнопку Тест image. При верных настройках система выдаст ссылку на изображение.
