WebCitrus выдаёт клиенту электронную карту Wallet. ClubIS передаёт на неё данные анкеты, членства, блоки, бонусы, новости и предстоящие занятия. Сообщение рассылки можно показать на этой же карте. Если клиент сам создаёт карту в кабинете или виджете WebCitrus, в ClubIS появляется заявка.
Для обмена нужны работающие службы web-service, event-service и служба рассылок. Идентификатор клиента, секрет и идентификатор проекта берутся в кабинете WebCitrus.
Администратор → Интеграции → Прочее, блок WebCitrus:
| Параметр | Назначение |
|---|---|
| Включено | Обмен с WebCitrus. Пока параметр выключен, кнопка карты в членстве и в бронировании отеля скрыта, автоматическое обновление карт не выполняется. |
| Идентификатор клиента | Идентификатор доступа из кабинета WebCitrus. |
| Секрет клиента | Секрет доступа из кабинета WebCitrus. |
| Домен | Адрес API WebCitrus. По умолчанию https://api.webcitrus.app/v1. |
| Идентификатор проекта | Номер проекта в WebCitrus. В поле изначально стоит 2 — замените его на идентификатор своего проекта. |
| Добавлять иконки emoji в начало каждого поля | Значки в начале новостей, депозитов, бонусов, задолженности, занятий и дат. Значки состояния членств и блоков ставятся и без этого параметра. |
Кнопка Синхронизировать сначала сохраняет параметры, затем сверяет уже выданные карты проекта с анкетами ClubIS. Новые карты эта кнопка не создаёт: она обновляет только карты, уже привязанные к анкете. По окончании появляется сообщение Операция успешно завершена!
Сверка обновляет имя, фамилию, электронную почту, дату рождения, бонусы, членства и срок их действия, личное сообщение, новости и предстоящие занятия. Телефон, блоки, депозиты и задолженность при этой сверке заново на карту не пересчитываются.
Между запросами к WebCitrus выдерживается пауза около секунды (до 60 запросов в минуту). На большом числе карт сверка занимает заметное время; окно программы в это время лучше не закрывать.
Кнопка с подсказкой Электронная карта Wallet появляется, когда интеграция включена:
Окно Электронная карта Wallet показывает сведения из WebCitrus:
| Поле | Смысл |
|---|---|
| Создана | Когда карта создана. |
| Обновлена | Когда карта последний раз менялась в WebCitrus. |
| Создал | Откуда создана карта: кабинет, виджет или API ClubIS. |
| Серийный номер | Идентификатор карты в WebCitrus. Кнопка рядом открывает ввод Серийный номер, чтобы привязать к анкете уже существующую карту. |
| Проект | Идентификатор проекта WebCitrus. |
| Номер | Номер карты для клиента. |
| Дата и время истечения срока действия | Срок, если он задан в WebCitrus. |
| Недействительна | да или нет. |
| Ссылка | Ссылка, по которой клиент добавляет карту в Wallet. Кнопка рядом копирует её в буфер обмена. |
Создать карту выдаёт карту по анкете и заполняет все поля ниже. Если карта у анкеты уже есть, та же кнопка перезаписывает её целиком.
Удалить карту удаляет карту в WebCitrus и снимает привязку с анкеты.
При ошибке WebCitrus окно показывает заголовок Ошибка и текст, который вернул сервис.
При создании и при полной перезаписи на карту уходят:
+7), электронная почта, дата рождения;Пока интеграция включена и работает event-service, на уже выданной карте сами меняются:
Депозиты и задолженность попадают на карту при создании и при полной перезаписи (Создать карту). Отдельная оплата или новый долг сами эти поля не обновляют.
Активные новости ведутся в Администратор → Справочники → Новости и в модуле Реклама → Настройки → Новости.
Если интеграция включена, в списке новостей есть действие Обновить Wallet. Оно записывает текущие новости сразу на все карты проекта.
В Администратор → Справочники → Операторы рассылок создайте оператора канала Wallet. В карточке оператора те же поля, что в блоке WebCitrus: Идентификатор клиента, Секрет клиента, Домен, Идентификатор проекта, Добавлять иконки emoji в начало каждого поля. Кнопка сверки в этой карточке подписана Сихронизировать и запускает ту же сверку, что и на вкладке интеграций.
Рассылка и личное сообщение с этим оператором записывают текст в поле сообщения на карте клиента. Карта должна уже существовать: если её нет, сообщение на карту не попадает. Между получателями так же выдерживается пауза около секунды.
Как выбрать оператора в рассылке: Операторы рассылки.
WebCitrus присылает событие о новой карте на адрес площадки /api/webcitrus. Для проверки: https://test.club-is.ru/api/webcitrus. Служба web-service должна быть доступна из интернета.
Заявка создаётся, если карту оформили в кабинете или в виджете WebCitrus. Источник заявки: Кабинет Webcitrus или Виджет Webcitrus. В заявку попадают имя, фамилия, телефон и электронная почта, карта привязывается к анкете. Дальше заявка обрабатывается как обычный лид: Работа в Менеджере.
Карта, которую создал ClubIS кнопкой Создать карту, повторно в лиды не превращается.
Если интеграция включена, номер электронной карты Wallet передаётся в SIGUR вместе с обычной картой членства — как отдельный идентификатор для прохода.