> For the complete documentation index, see [llms.txt](https://gym-one.gitbook.io/gym-one/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://gym-one.gitbook.io/gym-one/telegram-bot.md). # Телеграм-бот [Вступление](#vstuplenie) [Как посетитель спортклуба попадает в Телеграм-бот?](#kak-posetitel-sportkluba-popadaet-v-telegram-bot) [Что умеет личный кабинет посетителя?](#chto-umeet-lichnyi-kabinet-posetitelya) [Магазин абонементов, автопродление абонементов, пополнение личного счета (ЛС](#magazin-abonementov-avtoprodlenie-abonementov-popolnenie-ls)) [Настройка магазина абонементов](#nastroika-magazina-abonementov) [Покупки в магазине абонементов](#pokupki-v-magazine-abonementov) [Куда попадают средства с продажи абонементов в магазине?](#kuda-popadayut-sredstva-s-prodazhi-abonementov-v-magazine) [Как выглядят продажи из магазина в системе Gym One?](#kak-otobrazhayutsya-prodazhi-iz-magazina-v-sisteme-gym-one) [Корзина абонементов](#korzina-abonementov) ### Вступление Новый личный кабинет посетителя в Телеграм-боте пришел на замену прежним ЛК в мобильных приложениях для ОС Android и iOS. Главное преимущество ЛК на платформе Telegram (как для разработчиков, так и для пользователей) - независимость от иностранных площадок Google Play и AppStore. Основной и, уже ставший привычным для пользователей, функционал и интерфейс личного кабинета посетителя - остался неизменным. Однако, теперь ЛК реализован на базе Telegram MiniApp. Если вкратце, MiniApp - это веб-приложение, которое интегрировано (встроено) в мессенджер Telegram. Такое приложение позволяет пользователю взаимодействовать с различными сервисами и функциями, не выходя из мессенджера. ### Подключение Телеграм-бота Для подключения Телеграм-бота перейдите в раздел главного меню "Биллинг и оплата" и нажмите на кнопку "Подключить".
Телеграм-бот доступен и готов к использованию сразу после подключения услуги: вы увидите на экране QR-код, адрес бота, а также информацию о дате, до которой оплачена услуга. В указанную дату услуга автоматически продлится, при условии наличия средств на балансе в системе Gym One.
### Как посетитель спортклуба попадает в Телеграм-бот? Посетитель вашего спортклуба сможет попасть в бот следующими способами: 1. Отсканировав QR-код камерой мобильного телефона. Для удобства посетителей вы можете скачать QR-код (из раздела Биллинг и оплата) и разместить его на стойке ресепшен; 2. Перейдя по ссылке ; 3. Воспользовавшись строкой поиска в мессенджере Телеграм по словам Gym One. Попадая таким образом в Телеграм-бот, посетитель нажимает на кнопку Начать (или Start).
В ответ на нажатие кнопки Старт - поступит сообщение "Для продолжения регистрации укажите свой номер телефона". Посетитель вводит и отправляет свой номер телефона и получает предложение позвонить по указанному в сообщении номеру. Нажав на номер телефона (+74955555555) из сообщения - можно сразу начать звонок. Позвонив, посетитель услышит автоответчик "Спасибо! Вы авторизованы".
После завершения звонка посетитель может нажать на кнопку "Войти в приложение" и получит именное приветственное сообщение с баннером вашего спортклуба и кнопкой "Личный кабинет"
{% hint style="info" %} Войти в личный кабинет в боте может только посетитель, который уже есть в клиентской базе вашего спортклуба. Если бот не сможет идентифицировать клиента по номеру телефона (то есть клиент пока отсутствует в вашей базе), то ему будет выдано предложение обратиться к администратору ресепшен. {% endhint %} ### Что умеет личный кабинет посетителя? В личном кабинете, как и прежде, 5 вкладок: 1. Главная - для быстрого доступа к самому необходимому - электронный абонемент, баланс ЛС, запись на тренировки и другое; 2. Абонементы - для просмотра и управления абонементами посетителя; 3. Новости - полистать ленту новостей спортклуба; 4. Тренировки - ознакомиться с расписанием, записаться на персональную или групповую тренировку, выбрать своего тренера; 5. Сообщения - почитать сообщения от клуба (уведомления, напоминания, акции, рассылки) или что-то уточнить, задав админу вопрос.
### Магазин абонементов, автопродление абонементов, пополнение ЛС Подключив услугу Телеграм-бота, вы можете предоставить вашим посетителям возможность самостоятельно выбирать и приобретать абонементы (с автопродлением или без), а также пополнять баланс своего личного счета. Чтобы эти возможности стали доступны, понадобится подключить сервис для приема платежей в интернете ЮКасса. Со стороны системы Gym One за подключение сервиса приема платежей - доплачивать не понадобится. Само подключение сервиса в ЮКасса также бесплатное. ЮКасса взимает только комиссию за успешные платежи. Подробнее о подключении ЮКасса, а также о комиссиях можно почитать на [сайте ЮКассы](https://yookassa.ru/). {% hint style="info" %} Чтобы связать ЮКассу и Gym One, после регистрации в ЮКассе вам понадобится передать нам ключи интеграции. Как это сделать пошагово описано [здесь](/gym-one/integracii/integraciya-s-yukassa-podklyuchenie-internet-ekvairinga-v-telegram-bote.md). {% endhint %} ### Настройка магазина абонементов После того, как вы выполнили интеграцию ЮКассы и Gym One, можно приступить к настройке магазина абонементов. Основная задача - выбрать, какие из типов абонементов в вашем справочнике, будут доступны посетителям для самостоятельной покупки. Переходим в раздел "Настройки" > "Справочники" > "Абонементы". Выделяем нужную группу абонементов и открываем окно настройки выбранного типа абонемента. В окне "Изменение абонемента" переходим на вкладку "Магазин".
Откроется окно настройки свойств абонемента для магазина. Чтобы данный тип абонемента был доступен посетителям для самостоятельной покупки, включите опцию "Доступен для телеграм-магазина".
После включения опции, в окне появится возможность задать название и описание абонемента для магазина. Заполнять их необязательно. Если поля пустые, то в магазине будет отображаться название и описание с вкладки "Основное". Также есть возможность дать посетителям скидку на покупку данного типа абонемента в магазине, чтобы стимулировать совершение самостоятельных покупок. Задайте величину скидки или оставьте поле пустым, если скидка не нужна. Нажмите "Сохранить". {% hint style="info" %} Скидка, заданная в окне настройки свойств абонемента для магазина, применяется только для покупки абонемента. Продление абонемента будет выполняться по стоимости, указанной на вкладке "Основное" окна "Изменение абонемента". {% endhint %} Пройдите таким образом по всем типам абонементов в вашем справочнике, задавая доступность абонементов в магазине, а также, при желании, свойства и скидку. ### Покупки в магазине абонементов На последних двух шагах мы выполнили подключение сервиса ЮКасса и настройку магазина абонементов. Теперь посетителю доступны возможности: * Пополнение баланса личного счета на главной странице; * Магазин абонементов (на вкладке "Абонементы").
Нажимая на кнопку "Магазин абонементов", посетитель видит разрешенные для магазина типы абонементов, сгруппированные по папкам. Также, при наличии специальной скидки на покупку в магазине, обычная цена отображается зачеркнутой, а рядом - стоимость с учетом скидки.
Выбрав из списка понравившийся абонемент, посетитель нажимает на кнопку "Купить" и переходит к окну покупки абонемента. Здесь у него есть возможность включить опцию "Продлевать автоматически". На свое усмотрение посетитель включает или отключает опцию автопродления и, нажав на кнопку "Купить", переходит непосредственно к оплате.
ЮКасса предоставляет посетителю все возможные способы оплаты - оплата картой, электронным кошельком, по СБП и другие. Если по какой-то причине оплата не прошла - абонемент не будет оформлен. Посетителю будет предложено попробовать еще раз, либо использовать другой способ оплаты. После удачной оплаты абонемент появится на вкладке "Абонементы". Если абонемент был куплен с автопродлением, он будет помечен соответствующей иконкой. Отключить автопродление посетитель может в любой момент, нажав на абонемент в разделе "Абонементы" и сняв галку "Автоматическое продление".
За 1 день до даты истечения срока действия абонемента (накануне автопродления абонемента) - посетитель получит уведомление в телеграм-бот о том, что завтра будет выполнено автопродление. {% hint style="info" %} Автопродление доступно для абонементов, которые хоть раз были оплачены или продлены посетителем из магазина. Это обусловлено тем, что при покупке/продлении абонемента происходит "запоминание" способа оплаты и в дальнейшем автопродление будет выполнено этим способом. {% endhint %} ### Куда попадают средства с продажи абонементов в магазине? Все средства, полученные с продаж абонементов через магазин в телеграм-боте, а также средства, положенные посетителями в боте на личный счет - зачисляются на ваш счет за минусом комиссии ЮКассы. Счет зачисления - это тот счет, который вы указывали при регистрации в ЮКассе. Как правило, это юридический счет, но может быть и счет физлица, если вы зарегистрированы в налоговой как самозанятый. {% hint style="info" %} Зачисление средств на ваш расчетный счет, как правило, происходит на следующий рабочий день после оплаты от посетителя. Подробнее можно узнать на [сайте ЮКассы](https://yookassa.ru/). {% endhint %} ### Как отображаются продажи из магазина в системе Gym One? Пополнения личных счетов и продажи абонементов из магазина отображаются в системе Gym One также, как и продажи, выполненные администратором ресепшен. Они попадают как в раздел "Касса", так и в отчеты по продажам, и в историю всех операций в системе. После совершения оплаты посетителем может пройти несколько минут, пока операция отобразится в системе Gym One.
Продажи из магазина идут со способом оплаты "Безнал". В столбце "Пользователь" у таких операций пусто. Над таблицей кассы в выпадающем списке "Администратор" можно выбрать вариант "ЛК посетителя" и, таким образом, оставить в кассе только операции, выполненные посетителями через их личные кабинеты. {% hint style="info" %} В графе "Сумма" указана та стоимость, которую непосредственно оплатил посетитель. На ваш расчетный счет же будет зачислена сумма за вычетом комиссии ЮКассы. Таким образом, цифры будут немного отличаться. {% endhint %} ### Корзина абонементов Корзина абонементов в ЛК посетителя - список абонементов, которые посетитель хотел бы приобрести, но еще не совершил успешную покупку. Положить абонемент в корзину может как сам посетитель, так и администратор ресепшен. Для этого, в системе Gym One в окне выдачи нового абонемента достаточно выбрать нужный тип абонемента, включить опцию "Добавить в корзину телеграм-бота" и нажать на кнопку "Добавить в корзину".
В разделе "Абонементы" в ЛК посетителя появится "Корзина" и посетитель сможет сразу перейти к покупке.
Администратор может управлять корзиной посетителя, а также списком абонементов с автопродлением. Сделать это можно в анкете посетителя (раздел "Посетители") на вкладке "Телеграм-бот".
Если у вас остались вопросы по работе с личным кабинетом посетителя, магазином абонементов, а также любые другие вопросы по работе системы Gym One - пожалуйста, обратитесь к вашему персональному помощнику, будем рады вам помочь!