external:pro_bonus:04_probonus_tbotv2:01_setup:02_bot_setting

Это старая версия документа!


Настройки

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

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

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

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

  • Токен, выданный BotFather - при регистрации бота был выдан токен. Его значение необходимо вписать в данное поле и нажать кнопку «Проверить токен».
  • Идентификатор чата для отзывов - сюда необходимо вписать 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 нужного чата/группы. Вы можете использовать любой другой.

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

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

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

Работа с UTM метками

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

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


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

  • Уровень логирования (по умолчанию 3) - чем больше значение тем подробнее логи и тем больший размер файла.
  • Срока хранения логов (по умолчанию 7 дней) - более старые файлы автоматически удаляются
  • «Размер тредпула сервер» и «Размер тредпула бота» - количество потоков и процессорных мощностей которые может занять бот. Важно! Не рекомендуется изменять эти значения без понимания того что вы делаете.
  • external/pro_bonus/04_probonus_tbotv2/01_setup/02_bot_setting.1693997579.txt.gz
  • Последнее изменение: 2023/09/06 13:52
  • Александр Ильин