Интеграция связывает Яндекс Формы с предварительной записью в ClubIS: клиент заполняет опрос по ссылке из push-уведомления, ответы сохраняются в предзаписи и могут автоматически доставляться исполнителю (массажисту, тренеру и т.п.) через триггер.
Типичный сценарий — короткий опрос перед массажем или процедурой: сила воздействия, проблемные зоны, противопоказания.
Токен защищает адрес приёма ответов: без него ClubIS отклонит запрос.
Если клиенту уже уходит push со ссылкой на опрос — проверьте, что в URL формы передаётся код предзаписи. Обязательный параметр:
prejournal_id=%prejournal_id%
%prejournal_id% — маркер триггера; при отправке подставляется номер предзаписи в ClubIS.
Пример адреса в тексте рассылки:
https://forms.yandex.ru/u/<идентификатор-формы>?prejournal_id=%prejournal_id%&master_name=%performer%&massage_date=%pdate%&massage_time=%ptime%
Дополнительные параметры (master_name, дата, время, ФИО) — по желанию: их можно использовать в вопросах формы или для удобства клиента. Для работы интеграции критичен только prejournal_id.
Настройка push клиенту — отдельный триггер на событие предзаписи (например, при создании записи). Подробнее о триггерах: Триггеры, настройка триггера.
В редакторе нужной формы:
https://<ваш-домен>/api/yandexforms?token=<токен-из-шага-1>
<ваш-домен> — тот же хост, на котором работает web-service площадки (как для мобильного приложения и других API).
prejournal_id — обычно его передают скрытым полем формы, значение которого берётся из параметра в ссылке (см. документацию Яндекс Форм по скрытым полям и query-параметрам).Ответы на вопросы формы ClubIS сохранит и передаст в триггер как текст «вопрос — ответ».
Создайте триггер в Менеджер → Настройки → Триггеры или Администратор → Справочники → Триггеры.
Основные настройки:
| Параметр | Значение |
|---|---|
| Условие | Предварительная запись → При получении ответа внешней формы по предзаписи |
| Активен | Да |
| Параметры отбора | При необходимости ограничьте журналы предзаписи (например, только массаж) |
Действие — рассылка или push (как принято на площадке для сотрудников):
| Параметр | Значение |
|---|---|
| Получатель | Исполнитель предзаписи |
| Текст | Шаблон с маркерами, см. ниже |
Пример текста push исполнителю:
Клиент %client_fullname% заполнил опрос перед сеансом %pdate% %ptime%.
%pform_answers%
Маркер %pform_answers% подставляет все ответы формы списком. Остальные маркеры предзаписи (%performer%, %pdate%, %ptime%, %pname% и др.) тоже доступны — полный список в справочнике триггеров.
prejournal_id (из push или вручную из журнала предзаписи).Если события нет — см. раздел ниже.
| Симптом | Что проверить |
|---|---|
| Форма отправлена, в ClubIS тишина | Доступен ли IPv6 на хосте webhook; доходит ли запрос до web-service (логи службы) |
| Ошибка авторизации | Совпадает ли token в URL интеграции с токеном в Параметры → Прочее → Яндекс Формы |
| Ответ не привязан к записи | Есть ли prejournal_id в данных, которые Яндекс отправляет в ClubIS |
| Событие есть, push не пришёл | Запущен ли event-service; настроен ли получатель «Исполнитель предзаписи»; фильтры триггера |
| Нет пункта условия в триггере | Обновление ClubIS на площадке ещё не установлено |