Подключение Gizmo (компьютерный клуб)
Связать Gizmo с кабинетом: геймеры, тайм-пакеты, чеки с маржой и «за ПК сейчас».
Что даёт интеграция
- база геймеров Gizmo и подписчики бота становятся одной базой (склейка по телефону и номеру карты);
- чеки клуба попадают в карточки геймеров и питают аналитику — с маржой и с плательщиком: Gizmo называет, кто именно оплатил, поэтому выручка ложится на гостя честно;
- меню бара и тайм-пакеты с себестоимостью подтягиваются в «Прайс»;
- видно, кто сейчас за ПК;
- геймер получает карту Wallet, бота и гостевое приложение — со стороны клуба для этого ничего дорабатывать не нужно.
Обмен идёт в одну сторону: мы читаем Gizmo и ничего в базе клуба не меняем.
Что понадобится
- Адрес сервера Gizmo в виде
https://адрес:порт. Сервер стоит в клубе, поэтому адрес знает ваш системный администратор. - Учётная запись оператора — логин и пароль. Это сотрудник Gizmo, а не геймер, и у него должен быть включён доступ к Web API.
- Часовой пояс клуба.
Шаг 1. Подключите сервер
Кабинет → Интеграции → карточка Gizmo → Подключить. Заполните адрес, логин и пароль оператора, часовой пояс → Проверить и сохранить.
Статус «подключён» и имя оператора в ответе = связь работает.
Если что-то не так, под формой будет причина:
- 401 — оператор не авторизуется: проверьте логин с паролем и что этому оператору в Gizmo открыт доступ к Web API.
- Сервер недоступен — проверьте адрес и порт и что сервер клуба включён.
Шаг 2. Загрузите меню и тайм-пакеты
Блок «Данные клуба» → Меню и тайм-пакеты. Товары бара и пакеты игрового времени попадают в раздел «Прайс» вместе с себестоимостью — благодаря ей аналитика меню сразу показывает маржу, руками ничего вводить не нужно. Тайм-пакеты сохраняются как услуга со сроком в минутах, а не как блюдо.
Шаг 3. Импортируйте геймеров
Импортировать геймеров — база Gizmo заливается в «Подписчиков». Совпадения с существующими гостями склеиваются по телефону и номеру карты, дублей не будет. Повторный запуск безопасен: он обновляет данные.
Анонимные посетители без телефона и карты не заводятся: такую карточку не с чем связать и незачем показывать.
Шаг 4. Загрузите чеки
Рядом с кнопкой Синхронизировать чеки выберите период. Начните с трёх дней — так вы сразу увидите, что данные идут правильно. Дальше можно взять неделю или месяц. Повторные запуски безопасны: уже загруженные чеки не задваиваются.
После этого чеки клуба живут в «Аналитике», «Сменах» и в карточках геймеров, а свежие подтягиваются сами — примерно раз в час.
Проверьте результат
- Смены — разбор вчерашнего дня: деньги, часы, чеки; открывается любой чек клуба.
- Аналитика → «Меню» — что приносит деньги: тайм-пакеты и бар с маржой тариф «Про».
- Карточка геймера — его чеки и покупки.
- Кнопка За ПК сейчас — кто играет прямо сейчас и сколько времени.
Если синхронизация сломалась
Сервер клуба выключили или сменили пароль оператора — вы увидите уведомление в колокольчике и причину на странице Gizmo. Почините доступ и нажмите Проверить и сохранить — уведомление закроется само.