====== Бот для гостя ======

===== Подключение гостей к боту =====
Для того что бы гость мог взаимодействовать с вашим ботом - он должен к нему подключиться и запустить его.
Как это сделать?
Первый вариант - Гость может самостоятельно найти вашего бота в Telegram зная его имя (параметры "Username" и "Name" ), которые были заданы [[https://wiki.carbis.ru/external/zz_дополнительные_материалы/01_telegram_bot|при создании бота]].
{{:external:pro_bonus:04_probonus_tbotv2:02_work:pasted:20230907-104649.png?300}} {{:external:pro_bonus:04_probonus_tbotv2:02_work:pasted:20230907-104707.png?300}}

Второй, более простой для гостя способ, это перейти по ссылке вида **t.me/Username**. 
Например, для бота с именем "test_korobov_probonus_bot" ссылка будет выглядеть так: https://t.me/test_korobov_probonus_bot .
Дополнительно данную ссылку можно представить гостю в виде QR-кода.
QR код со ссылкой на бота можно сформировать непосредственно в Telegram, с экрана описания Бота 
{{:external:pro_bonus:04_probonus_tbotv2:02_work:pasted:20230907-105527.png?300}} {{:external:pro_bonus:04_probonus_tbotv2:02_work:pasted:20230907-105426.png?300}}
Или воспользовавшись любым [[https://yandex.ru/search/?text=генератор+qr+кодов&lr=65|сторонним сервисом]].

Кроме общей ссылки на бота, существует возможность делать уникальные ссылки с UTM-метками. Перешедший по такой ссылке гость будет зарегистрирован в отдельной "группе счетов". Подробно про создание UTM-меток и генерацию ссылок - в статье [[external:pro_bonus:04_probonus_tbotv2:01_setup:02_bot_setting|Настройки]]

После того как гость тем или иным способом найдет Бота, он получит описание его возможностей и должен будет нажать кнопку "Старт" для начала работы с ним.
Следующее что должен будет сделать гость принять политику конфиденциальности и политику обработки персональных данных (если они включены в настройках) и нажать "Перейти к регистрации". Далее сообщить боту свой номер телефона, нажав кнопку "Поделиться номером телефона".

{{:external:pro_bonus:04_probonus_tbotv2:02_work:pasted:20230907-110911.png?300}} {{:external:pro_bonus:04_probonus_tbotv2:02_work:pasted:20230907-110940.png?300}}
Бот попробует найти в среди счетов системы ProBonus аккаунт с указанным номером. Дальнейшее поведение Бота будет различным для новых и уже известных нам гостей.
===== Регистрация нового гостя через Бота =====

Если гостя с указанным номером не существует в базе данных ProBonus, то Бот предложит зарегистрироваться в системе. При регистрации в зависимости от настроек может быть запрошен пол и дата рождения.
{{:external:pro_bonus:04_probonus_tbotv2:02_work:pasted:20230907-111039.png?300}} {{:external:pro_bonus:04_probonus_tbotv2:02_work:pasted:20230907-111053.png?300}}

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

{{:external:pro_bonus:04_probonus_tbotv2:02_work:pasted:20230907-111358.png}}

===== Подключение к Боту существующего гостя =====
Если гость с указанным номером уже есть в базе ProBonus, то Бот автоматически сопоставит аккаунт гостя в Telegram с его счетом в системе лояльности и вводить регистрационные данные не потребуется.
{{:external:pro_bonus:04_probonus_tbotv2:02_work:pasted:20230907-111544.png?300}}

===== Использование виртуальной карты =====
При помощи Бота гость может воспользоваться виртуальной картой для получения лояльности в ресторане. 
{{:external:pro_bonus:04_probonus_tbotv2:02_work:pasted:20230907-111742.png?300}} {{:external:pro_bonus:04_probonus_tbotv2:02_work:pasted:20230907-111801.png?300}}
Далее гость предъявляет QR-код на кассе или называет цифры пин-кода официанту. От версии r_keeper 7.7.0.369 возможно применить QR-код через МО5 (мобильного официанта).

**Важно!** Этот код имеет срок жизни. По истечении этого срока он перестает действовать (и гостю нужно будет выполнить запрос виртуальной карты повторно).
Срок жизни временного идентификатора определяется [[https://wiki.carbis.ru/external/pro_bonus/01_setup/06_probonus_setting |в настройках ProBonus]].

===== Работа с отзывами гостей =====
Гость может отправить боту свой отзыв о работе ресторана.
{{:external:pro_bonus:04_probonus_tbotv2:02_work:pasted:20230907-112054.png?300}}
Гостю будет предложено оценить работу ресторана по 5-ти балльной шкале, а так же гость может отправить текстовое сообщение и/или фото.
Все отзывы транслируются в специально созданную группу в telergam (где есть сотрудники ресторана) и сохраняются в web-админке телеграм-бота. 
Подробно про работу с отзывами - в статье [[external:pro_bonus:04_probonus_tbotv2:02_work:02_reviews|Отзывы]]

===== Отчёт по счету и баланс =====
Гость может запросить "Отчёт по счёту" и "Баланс счёта".
Баланс счёта показывает текущий остаток бонусов на счету.
{{:external:pro_bonus:04_probonus_tbotv2:02_work:pasted:20231220-123246.png?300}}