external:old:05_probonus_tbot_v2:02_bot_setting

Настройки

Важно! После изменения и сохранения любых настроек из данного раздела необходимо перезапустить службу «Carbis ProBonus Telegram Bot», чтобы новые значения вступили в силу.

  • Параметры «Слушать все адреса» и «Прослушиваемый адрес».

Данная настройка предназначена для случая когда сервер на котором расположена служба работает с несколькими сетевыми адаптерами и/или в нескольких подсетях и есть необходимость разрешить доступ к боту только из одной подсети (по одному адаптеру)
Важно! Не рекомендуется изменять значение данных настроек без понимания их смысла.

  • Порт на котором работает сервер ProBonus Bot. Порт занимаемый службой бота для свое работы. Значение по умолчанию 11031. Порт должен быть свободен для использования. При необходимости работы с web панелью бота с других компьютеров локально сети и/или из интернета - необходимо открыть этот порт в брандмауэре и осуществить проброс порта на роутере.
  • Язык интерфейса web панели администратора. Возможен перевод админки на любой язык (по умолчанию в поставку включены русский и английский варианты). Если вам требуется перевод на другой язык - напишите нам на soft@carbis.ru

  • Токен, выданный BotFather - при регистрации бота был выдан токен. Его значение необходимо вписать в данное поле и нажать кнопку «Проверить токен».
  • Сообщений из рассылок в секунду - сколько сообщений в секунду отправляет бот гостям по рассылкам. Рекомендуемые значения 5-20
  • Разрешить гостям оставлять отзывы в боте - Включение возможности оставления отзывов гостями внутри бота. Если включено - в соседнее поле необходимо вписать ID чата в который будут приходить отзывы оставленные гостями.

Алгоритм создания группы для работы с отзывами и получения ее ID

Алгоритм создания группы для работы с отзывами и получения ее ID

  1. Создать отдельную группу, в которую будут поступать сообщения от гостей. Дать ей осмысленное название, например «Отзывы наших гостей».
  2. Превратить её в супергруппу. Последовательность действий для настройки:
    1. При создании группы добавить в неё кого-нибудь временно (потому что для создания группы нужно хотя бы 2 участника).
    2. После создания группы можно сразу удалить «лишнего» участника.
    3. Чтобы группа могла корректно работать с ботами, нужно сделать её публичной. Для этого нажать «Управление группой» → «Тип группы» → «Публичная группа». Указать какое-то имя для формирования ссылки на группу и сохранить. После этого группа превратилась в «супергруппу».
    4. Чтобы группа не была общедоступной - делаем её обратно «частной». Для этого нажать «Управление группой» → «Тип группы» → «Частная группа».
  3. Добавить в нее всех заинтересованных людей.
  4. Добавить в нее вашего бота.
  5. Узнать ID созданной группы и прописать его в настройках Бота ProBonus.
    1. Перейти по ссылке и запустить данного бота: https://bot-t.ru/link/FIND_MY_ID_BOT
    2. Добавить в группу бота «FIND_MY_ID_BOT»
    3. Отправить в чат команду «/id@FIND_MY_ID_BOT»
    4. Из полученного сообщения скопировать значение ID. (Важно! ID группы может начинаться со знака «-», его тоже надо копировать!!!)
    5. Исключить из группы бота «FIND_MY_ID_BOT»

Существует множество других вариантов того как узнать ID нужного чата/группы. Вы можете использовать любой другой.

  • Разрешить регистрацию новых счетов через бота - если эта опция включена, то гость придя в бота может самостоятельно зарегистрироваться в системе лояльности ProBonus, получить виртуальную карту и пользоваться ей для получения скидки/бонуса. если эта опция отключена, то пользоваться ботом могут только те гости, которых завели в базе ProBonus в ручную.
    • Запрашивать возраст при регистрации - При регистрации гость обязательно должен будет указать дату рождения.
    • Запрашивать пол при регистрации - При регистрации гость обязательно должен будет указать свой пол. Важно! если в настройках сервера ProBonus поле «пол гостя» объявлено обязательным, то в настройках бота эта значение будет задано по умолчанию и изменить его нельзя.
    • Разрешить использовать Имя из Телеграм - если включено, то при регистрации гость сможет либо ввести ФИО в ручную, либо использовать ФИО из своего аккаунта телеграмм. Если вам важно исеть реальный ФИО гостей - рекомендуется отключить данную настройку.

В процессе работы бот постоянно взаимодействует с сервером ProBonus (создает новых гостей, выводит информацию о состоянии счета и т.д.)
Для выполнения этих функций требуется подключение к серверу.

  • Логин - имя пользователя заведенного в системе ProBonus.
  • Пароль - пароль пользователя для подключения к ProBonus.
  • Адрес сервера - IP адрес по которому доступен сервер ProBonus.
  • Порт сервера - Порт сервера ProBonus.
  • Стандартная группа счетов для регистрации гостей - При регистрации нового гостя через бота, он создается в определенной группе счетов в системе ProBonus. При этом ему присваиваются параметры лояльности (начальный баланс, размер скидки/бонуса, ограничения и т.п.) указанные в свойствах группы счетов. Важно! Что бы в боте можно выбрать только те группы для которых включена опция «Шаблон для API».
  • Ссылка для входа - ссылка перейдя по которой гость начнет общение с ботом. Поле предназначено только для чтения, значение можно скопировать.

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

Ссылка генерируется прямо в интерфейсе настроек. В поле «UTM-метка» для ввода доступны только Латинские буквы и числа.

Эти возможности можно дополнительно использовать для сегментации гостей и в других маркетинговых целях.
Варианты использования:

  1. Сегментация источников. Ссылка на бота системы лояльности может быть размещена в различных соц. сетях, на сайте, и в кассовой зоне (в виде QR кода). Для того что бы оценить конверсию можно создать несколько UTM меток и получить уникальные ссылки для каждого источника. Когда гости будут переходить по ссылкам и регистрироваться в системе лояльности - сервер бота будет учитывать источники перехода гостей по UTM меткам. Важно! При этом всех гостей мы можем создавать в одной, общей группе счетов.
  2. Разные группы гостей для разных ресторанов. Система ProBonus используется в сетевом заведении (разные рестораны, но общая база гостей). При этом требуется различать гостей каждого ресторана и/или устанавливать для них разные условия (скидки/бонусы/лимиты).
  3. Промо-акции. Для гостей зарегистрировавшихся в боте по ссылке из рекламы - специальные условия: приветственный бонус в размере 500 рублей (эти условия настраиваются в сервере ProBonus в свойства шаблона группы).


Устаревшие (не актуальные) метки можно удалять. Если гость придет и зарегистрируется по такой (удаленной) ссылке, его счет будет создан в стандартной группе счетов.

  • Уровень логирования (по умолчанию 3) - чем больше значение тем подробнее логи и тем больший размер файла.
  • Срока хранения логов (по умолчанию 7 дней) - более старые файлы автоматически удаляются
  • «Размер тредпула сервер» и «Размер тредпула бота» - количество потоков и процессорных мощностей которые может занять бот. Важно! Не рекомендуется изменять эти значения без понимания того что вы делаете.

В данном разделе можно сформировать приветственное сообщение, которое бот будет отправлять гостю при первом знакомстве. В нем можно описать возможности, которые получит гость пользуясь ботом, разместить информацию о ресторане (ссылки на сайт и соц сети) и т.п.
Тут же можно сформулировать тексты политики обработки персональных данных и политики конфиденциальности.
Если они включены (значение по умолчанию), то при регистрации гость должен будет принять эти политики (одну или обе).
Настоятельно рекомендуем заполнить тексты этих политик во избежание вопросов со стороны государственных контролирующих органов.



После изменения настроек в данном разделе нужно нажать кнопку «Сохранить».

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


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

  • external/old/05_probonus_tbot_v2/02_bot_setting.txt
  • Последнее изменение: 2024/11/12 07:09
  • Евгений Горносталь