Как настроить подключение интеграции в нескольких филиалах

Что такое подключение интеграции в нескольких филиалах?

Это модальное окно, которое открывается при нажатии на кнопку «Подключить» в карточке приложения. В нем пользователь может выбрать и подключить интеграцию во всех доступных ему филиалах единовременно.

Флоу подключения интеграции в нескольких филиалах со стороны пользователя:

1. Пользователь нажимает на кнопку «Подключить» в карточке приложения.

2. Появляется модальное окно с выбором доступных ему филиалов (доступные — те, в которых он может подключить интеграцию, то есть в тех, где у него стоит право «Управлять правами пользователей»). Если ему доступен только один филиал, модальное окно с выбором филиалов не появится. Если в каких-то филиалах уже подключена данная интеграция, они не будут доступны для выбора.

3. Пользователь выбирает либо конкретные филиалы, либо нажимает чекбокс «Выбрать все филиалы». Также присутствует функционал поиска филиала по названию.

4. Пользователь нажимает на кнопку «Далее» и переходит на экран соглашения с правами. Затем нажимает на кнопку «Продолжить».

5. Пользователь переходит на сайт интегратора и регистрируется.

6. Во всех выбранных филиалах интеграция переходит в статус «Подключено».

Пример модального окна с выбором одного филиала

Для того чтобы настроить у своего приложения подключение интеграции в нескольких филиалах, нужно:

1. Перейти в Личный кабинет разработчика.

2. Перейти в редактирование приложения в раздел «Настройки для разработки».

3. Отметить чекбокс «Разрешить добавлять приложение в несколько филиалов».

4. Сохранить изменения.

Что еще важно знать:

1. Если пользователь выбрал несколько филиалов, при регистрации вашему сервису будет передаваться не один ID филиала, как прежде, а массив ID филиалов вида ?salon_ids[]=YYY&salon_ids[]=XXX. Запрос на активацию интеграции необходимо передавать по всем полученным филиалам в массиве, иначе интеграция не активируется, и вы со своей стороны не получите доступ к АПИ филиалов и не сможете добавить свои вебхуки в эти филиалы.

2. Если выбраны одновременно две настройки — регистрация через iframe и подключение в нескольких филиалах, в iframe также будет передаваться массив ID при выборе нескольких филиалов (про регистрацию через iframe можно почитать в этой статье).

3. Если выбраны одновременно две настройки — передача данных и подключение в нескольких филиалах, как и прежде вашему сервису будет передаваться user_data + массив ID выбранных филиалов (про передачу данных можно почитать в этой статье).