Чтобы ФитСигнал начал считать ваши цифры, нужен ключ API из Impulse. Мы просим ключ отдельного пользователя с ролью «только чтение»: ФитСигнал сможет смотреть данные, но не сможет ничего изменить в вашем Impulse.
Что понадобится
Около 10 минут и вход в Impulse под пользователем с правами директора: только он может создавать роли и пользователей.
Всё делается в разделе настроек Impulse: шестерёнка в левом верхнем углу → «Пользователи» и «Роли». Порядок такой:
- Зарегистрировать клуб в ФитСигнале.
- Создать в Impulse роль «ФитСигнал — только чтение».
- Создать пользователя с этой ролью.
- Войти под ним и выпустить API-ключ.
- Вставить ключ в ФитСигнал.
- Проверить настройки клуба.
Шаг 0. Регистрация в ФитСигнале
Откройте ссылку из приглашения и заполните:
- Email — почта руководителя, на неё придёт письмо для подтверждения.
- Пароль — не короче 10 символов.
- Название клуба — как его знают клиенты.
- Часовой пояс — город клуба: по нему считаются «сегодня» и «вчера».
Отметьте согласие с офертой и нажмите «Зарегистрироваться», затем подтвердите почту по ссылке из письма. Письма нет — загляните в «Спам» или нажмите «Отправить письмо ещё раз» в кабинете.
Шаг 1. Роль «только чтение»
Откройте «Роли» и нажмите «Добавить». Новая роль в Impulse создаётся со всеми галочками сразу, поэтому лишние нужно снять.
Назовите роль «ФитСигнал — только чтение» и пройдите все вкладки слева по таблице ниже.
| Вкладка | Что оставить | Что снять |
|---|---|---|
| Просмотр | всё | — |
| Разделы | Повестка дня, Отметка посещений, Расписание занятий, Таблицы (со всеми вложенными), Модули → Дополнительные расходы, Товары, Система лояльности | Воронка продаж, Аналитика, Заработная плата, Списания товаров, Массовые действия, Уведомления клиентов, СКУД, Клиентское приложение, Интернет-платежи |
| Редактирование | — | всё |
| Удаление | — | всё |
| Продажи | — | всё |
| Посещения | — | всё |
| Клиент | Просмотр карточки клиента | всё остальное, включая задачи, комментарии и экспорт в Excel |
| Касса | — | всё |
| Повестка дня | всё (это только просмотр), включая «Просмотр прошлых дней» | — |
| Баланс сотрудников | всё (это только просмотр) — нужно для движений кассы `agenda/balance` | — |
| Доп. расходы | Просмотр прошлых дней | — |
Без галочек «Повестка дня» и «Баланс сотрудников» ФитСигнал получит отказ на часть запросов: клуб останется «Готов», но в «Подключении» появится предупреждение о нехватке права (это не «Ошибка ключа»).
Какие запросы ФитСигнал делает и какая галочка роли нужна:
| Запрос Impulse | Метод | Галочка роли |
|---|---|---|
| `branch/list`, `hall/list`, `style/list`, `teacher/list`, `group/list`, `schedule/list`, `tag/list`, `informer/list`, `status/list`, `pipeline/list`, `level/list` | POST | Разделы → Таблицы (соответствующие справочники) + Просмотр |
| `client/list` | POST | Разделы → Таблицы → Клиенты + Просмотр |
| `client/load/{id}` | GET | Клиент → Просмотр карточки клиента |
| `visit/list` | POST | Разделы → Отметка посещений + Просмотр |
| `reservation/list` | POST | Разделы → Расписание занятий + Просмотр |
| `agenda/sales` | POST | Разделы → Повестка дня + вкладка «Повестка дня» (в т.ч. прошлые дни) |
| `agenda/balance` | POST | Разделы → Повестка дня + вкладка «Баланс сотрудников» (просмотр) |
| `user/current` | GET | Просмотр (профиль API-пользователя; без этого ключ считается нерабочим) |
| `user/update_setting` | POST | Обычно нет при «только чтение» — это ожидаемо: ФитСигнал не переключает фильтр филиалов и показывает предупреждение на «Подключении» |
| `user/list` | POST | Для тарифа Клуб: Разделы → Таблицы → Пользователи + Просмотр (сотрудники для раздела «Администраторы») |
| `shift/list` | POST | Для тарифа Клуб: Просмотр + доступ к списку смен (на ключе OMG при «Касса=всё снято» уже 200; если Impulse откажет — в «Подключении» будет предупреждение о праве, не «Ошибка ключа») |
| `task/list` | POST | Для тарифа Клуб: Просмотр задач (на ключе OMG при снятых «Клиент → задачи» уже 200 через общий просмотр; без права — предупреждение в «Подключении», раздел «Администраторы» без задач) |
| `bonus/list` | POST | Для тарифа Клуб: Разделы → Модули → Система лояльности + Просмотр |
Просмотр — оставить всё:
Разделы — только те, откуда ФитСигнал берёт данные:
Редактирование, Удаление, Продажи, Посещения, Касса — снять всё. Именно эти галочки отвечают за изменения в Impulse:
Клиент — только «Просмотр карточки клиента»:
Повестка дня — оставить: без «Просмотра прошлых дней» ФитСигнал не увидит историю продаж.
Баланс сотрудников — оставить всё (просмотр): без этого Impulse отвечает отказом на `agenda/balance`, и в ФитСигнале не будет движений кассы.
Нажмите «Сохранить».
Шаг 2. Пользователь для ФитСигнала
Откройте «Пользователи» и нажмите «Добавить». Это отдельный пользователь только для ФитСигнала: так доступ можно отключить в любой момент, не трогая сотрудников.
- Логин — например, fitsignal.
- Пароль — любой длинный. Он понадобится один раз — войти под этим пользователем и выпустить ключ (шаг 3). Нам его сообщать не нужно.
- Роль — «ФитСигнал — только чтение» из шага 1.
- Филиал — основной.
- Фамилию и имя можно указать «ФитСигнал», остальные поля — пустые.
Нажмите «Сохранить».
Шаг 3. API-ключ
Выйдите из Impulse и войдите под новым пользователем (логин и пароль из шага 2). Нажмите на аватарку слева вверху — откроется карточка пользователя. В её правом верхнем углу нажмите «API».
Нажмите «Обновить ключ» — в поле «API ключ» появится ключ. Скопируйте его целиком.
Ключ — как пароль: не пересылайте его в мессенджерах и письмах, вставляйте сразу в ФитСигнал. Если нажать «Обновить ключ» ещё раз, старый перестанет работать, и его нужно будет заменить в ФитСигнале.
Шаг 4. Подключение в ФитСигнале
Войдите в кабинет на app.fitsignal.ru и откройте «Подключение».
- Адрес API — адрес вашего Impulse и /api/public в конце, например https://myclub.impulsecrm.ru/api/public.
- API-ключ — ключ из шага 3.
- Нажмите «Проверить соединение».
После проверки ФитСигнал сам определит часовой пояс клуба и ссылку на карточки клиентов и начнёт загрузку. Первые цифры появятся через 10–30 минут; глубокая история догружается вне рабочих часов клуба.
Как обновляются данные
В часы работы клуба (на «Подключении», по умолчанию 07:00–23:00) ФитСигнал не ходит в Impulse сам: обновление — когда вы открываете кабинет (если данным больше часа) или нажимаете «Обновить сейчас» (не чаще раза в 15 минут).
Вне рабочих часов — раз в час; ночью — полная сверка в выбранном окне. Подробнее для команды — `docs/ops/SYNC.md`.
«Обновить сейчас» подтягивает изменения за последние 3 дня и записи на 30 дней вперёд, затем пересчитывает экраны (обычно 1–3 минуты).
Шаг 5. Настройки клуба
Откройте «Настройки клуба» в первый же день: от них зависит, кого ФитСигнал считает клиентами и что — посещениями. После сохранения цифры пересчитываются за 1–2 минуты.
| Настройка | Когда менять |
|---|---|
| Считать аренду посещениями | Снимите, если аренда залов — не ваша основная работа и арендаторы не должны попадать в клиенты |
| Бесплатные посетители — клиенты | Снимите, если клиент для вас — только тот, кто платит сам: например, «пришёл с кем-то» не попадёт в очереди и активных |
| Считать платными | Отметьте типы посещений от агрегаторов и корпоративных программ (ФитМост, СберПрайм): в Impulse они часто идут по нулевой цене |
| Не считать посещениями | Отметьте услуги, которые оформлены как абонемент, но не являются занятием: полотенце, шкафчик, инвентарь |
Какие данные мы берём
ФитСигнал только читает данные Impulse и ничего в нём не меняет.
| Берём | Не храним |
|---|---|
| Продажи, возвраты, абонементы, посещения, записи | ФИО, телефоны, email и даты рождения клиентов |
| Расписание, группы, залы, филиалы | Задачи и комментарии по клиентам |
| Имена тренеров — для экрана «Тренеры» | Пароли и ключи других пользователей |
| Инициалы и номер клиента в Impulse | Настройки касс и платёжных систем |
Имена и телефоны клиентов в очередях действий подтягиваются из Impulse в момент показа и нигде не сохраняются. У каждого клиента есть ссылка на его карточку в Impulse. Ключ API хранится в зашифрованном виде.
Отключить доступ можно в любой момент: кнопка «Отключить» в «Подключении» или архивация пользователя fitsignal в Impulse.
Если что-то не получилось
- «Проверить соединение» пишет ошибку ключа — скопируйте ключ ещё раз целиком, без пробелов по краям.
- В каком-то разделе нет данных — проверьте галочки роли по таблице из шага 1, особенно «Повестка дня → Просмотр прошлых дней».
- Любой другой вопрос — раздел «Поддержка» в кабинете, Telegram @fitsignalbot или почта info@fitsignal.ru.