Настройка интеграции с Claris
Чтобы UnSpot создавал в Claris заявки на парковку, нужно сделать две вещи в двух разных местах консоли: подключить учётную запись Claris в карточке интеграции и включить отправку в подписке на бронирование парковки. Порядок важен: подписка без подключения ничего не отправляет и об этом не предупреждает. Как устроен обмен и что именно уходит в Claris — в статье «Интеграция с Claris: как устроена».
Что понадобится
| Условие | Подробности |
|---|---|
| Роль в UnSpot | «Администратор интеграций» или владелец компании. Администраторам офисов и персонала карточка Claris и раздел «Исходящие подписки» недоступны |
| Учётная запись Claris | логин и пароль отдельной служебной учётной записи с правом создавать заявки. Под её именем в Claris будут числиться все заявки от UnSpot |
| Настроенная парковка | в офисе должны быть заведены парковочные места — подписка привязывается к офису |
| Сетевой доступ | исходящий HTTPS от сервера UnSpot к api.claris.su |
Шаг 1. Подключение к Claris
- Откройте «Настройка → Интеграции» и найдите блок «Оборудование».
- В карточке Claris нажмите «Подключить».
- В окне «Подключение к Claris» заполните поля Логин и Пароль учётной записи Claris.
- Нажмите «Подключить».
UnSpot сразу проверяет данные: обращается к Claris за токеном доступа и запрашивает сведения об учётной записи. Если всё сошлось, окно закрывается, а в карточке появляется имя подключённой учётной записи и кнопка отключения. Если нет — интеграция не сохраняется и показывается сообщение «Не удалось подключиться к Claris».
Учтите особенность формы: пароль вводится открытым текстом — он виден на экране и попадает в автозаполнение браузера. Не подключайте интеграцию при демонстрации экрана.
Шаг 2. Подписка на бронирование парковки
Отправка заявок включается не в карточке Claris, а в подписке — в разделе «Настройка → Исходящие подписки».
- Нажмите «Добавить исходящую подписку» и задайте «Название подписки».
- В поле «Событие» выберите «Бронирование создано». Для других событий отправка в Claris недоступна.
- В поле «Укажите пространства» выберите офисы, в которых должна работать отправка. Хотя бы один офис обязателен — подписка с пустым списком не сработает ни разу.
- Отметьте чекбокс «Отправлять в Claris». Поле «URL получателя» заполнится само и станет недоступным для правки — это штатное поведение.
- Проверьте предпросмотр состава данных и нажмите «Добавить».
Чекбокс появляется только при выбранном событии «Бронирование создано». При смене события он снимается автоматически.
Переключить чекбокс у уже сохранённой подписки нельзя — при редактировании он заблокирован. Чтобы превратить обычную подписку в подписку с отправкой в Claris (или наоборот), создайте новую подписку, а прежнюю отключите.
Держите одну подписку с отправкой в Claris на один офис. Продукт не мешает завести вторую такую же, и тогда на одну бронь в Claris уйдёт столько заявок, сколько подписок покрывают этот офис. Прежде чем создавать новую, проверьте список — нет ли в нём уже подписки на то же событие с теми же офисами.
В предпросмотре рядом с полями arrivalDate и departureDate показаны даты брони, но фактически эти два поля уходят в Claris пустыми. Полный и точный состав данных — в разделе «Что передаётся в Claris» парной статьи.
Проверка
Создайте тестовую бронь парковочного места в одном из офисов подписки и убедитесь, что в Claris появилась заявка. Это единственный надёжный способ проверки: индикатора «интеграция работает» в UnSpot нет, а подключённая карточка сама по себе ничего не гарантирует.
Если заявки нет сразу, подождите: отправка идёт через очередь и при сбое повторяется, причём паузы между повторами растут. Окончательный вывод «не работает» стоит делать не раньше чем через несколько минут после брони.
Тестовую бронь после проверки отмените в UnSpot, а заявку закройте в Claris вручную — отмена брони заявку не отзывает.
Как узнать, что интеграция сломалась
Своих уведомлений у этой интеграции нет: карточка Claris не показывает, доходят ли заявки, а сотрудники ничего не замечают — бронь создаётся как обычно. Поэтому настройте оповещение заранее.
- Заведите отдельную подписку на событие «Системные ошибки» и укажите в ней рабочий адрес почты. Когда подписка с отправкой в Claris выключится из-за череды сбоев, письмо придёт именно по этой подписке. Без неё отключение произойдёт молча.
- Смотрите статус и счётчик сбоев в списке «Исходящие подписки». Статус «сбой» и растущее число ошибок — единственный признак поломки, видимый в интерфейсе.
- Помните про тихие отказы. Если Claris не подключён или пароль его учётной записи сменили, счётчик сбоев не растёт и статус не меняется: подписка выглядит здоровой, а заявки не создаются. Такое ловится только тестовой бронью или отсутствием заявок в Claris.
Изменение и отключение
| Что нужно сделать | Как |
|---|---|
| Сменить учётную запись Claris | отключить в карточке и подключить заново с новыми логином и паролем |
| Временно остановить отправку | отключить подписку в разделе «Исходящие подписки», подключение к Claris не трогать |
| Добавить офис | изменить список офисов в существующей подписке |
| Убрать офис | там же. Следите, чтобы в списке остался хотя бы один офис |
| Отключить интеграцию целиком | нажать кнопку отключения в карточке Claris |
Отключение в карточке переводит все подписки с отправкой в Claris в статус «отключена». Само по себе повторное подключение их не поднимает: после того как вы снова подключите Claris, включите подписки вручную. Иначе интеграция будет выглядеть настроенной, а заявки создаваться не будут.
Порядок при смене пароля служебной учётной записи, чтобы ничего не потерялось:
- Смените пароль в Claris.
- В UnSpot отключите интеграцию в карточке Claris и подключите заново с новым паролем.
- Откройте «Исходящие подписки» и включите подписки с отправкой в Claris — после отключения они остались выключенными.
- Создайте тестовую бронь и убедитесь, что заявка появилась в Claris.
Что изменить нельзя
- Адрес получателя у Claris-подписки. Он подставляется автоматически и заблокирован. Направить эти данные в другую систему через ту же опцию нельзя.
- Номер и модель автомобиля у созданной брони. В брони можно поменять только название, дату и время. Ошибку в номере исправляют так: отменяют бронь, создают заново — и правят заявку в Claris руками, потому что старая заявка там остаётся.
- Уже отправленную заявку. Изменение и отмена брони в Claris не передаются, повторно отправить заявку из интерфейса нельзя.
- Номер заявки в UnSpot. UnSpot запоминает его, но нигде не показывает: сверять брони с заявками приходится в Claris.
Если что-то не сходится
| Симптом | Вероятная причина | Что делать |
|---|---|---|
| «Не удалось подключиться к Claris» при подключении | неверные логин или пароль, либо сервер UnSpot не достаёт до Claris | проверить учётные данные в Claris и исходящий доступ к api.claris.su |
| Чекбокса «Отправлять в Claris» нет в форме | выбрано не то событие | выбрать событие «Бронирование создано» |
| Чекбокс есть, но заблокирован | вы редактируете сохранённую подписку | создать новую подписку, прежнюю отключить |
| Подписка активна, заявок в Claris нет, ошибок тоже нет | Claris не подключён либо пароль учётной записи сменили на стороне Claris | открыть карточку Claris и подключить заново, затем включить подписки |
| То же самое, но подключение на месте | в подписке не осталось офисов — например после удаления офиса из системы | открыть подписку и заново выбрать офисы |
| Заявки уходят по офису, который вывели из эксплуатации | офис отправлен в архив; подписка по нему продолжает срабатывать, хотя в списке офисов он не виден | отключить подписку или пересобрать её состав офисов |
| На одну бронь в Claris две заявки и больше | на офис заведено несколько подписок с отправкой в Claris | оставить одну, лишние отключить |
| Изредка появляются парные заявки с одинаковыми данными | штатный эффект повторной попытки: Claris заявку создал, но ответ до UnSpot не дошёл | лишнюю заявку закрыть в Claris |
| Заявок в Claris больше, чем броней | бронь была на несколько дней: заявка создаётся на каждый день. Либо срабатывает несколько подписок | сверить период брони и число подписок |
| Заявка появилась не сразу | штатное поведение: отправка идёт через очередь и повторяется при сбоях с растущей паузой | подождать; вывод делать не раньше чем через несколько минут |
| Подписка получила статус «сбой» | сто неуспешных попыток подряд — это примерно девять-десять броней с полностью провалившимся обменом | устранить причину на стороне Claris, включить подписку заново и проверить тестовой бронью |
| Бронь отменили, заявка в Claris осталась | штатное поведение — отмена не передаётся | закрыть заявку в Claris вручную |
