В этом руководстве вы узнаете, как управлять интеграциями в Medusa Admin.

Чтобы открыть список интеграций:

1. Откройте Medusa Admin.
2. Перейдите в Настройки → Интеграции.

Откроется список всех интеграций, зарегистрированных в проекте: название и иконка провайдера, автор пакета, описание и категория. Для каждой интеграции показан статус: Не настроено, Не завершено, Включено или Выключено. Для провайдеров, которые поддерживают проверку соединения, дополнительно показывается ещё и Подключено или Ошибка подключения. Список можно фильтровать по категории и искать по названию.

---

В каталоге показаны интеграции, которые ещё не зарегистрированы в проекте, наряду с уже зарегистрированными.

Чтобы добавить новую интеграцию:

1. Перейдите в Настройки → Интеграции.
2. Нажмите Найти интеграции.
3. Найдите нужную интеграцию.
4. Нажмите Добавить.
5. Установите npm-пакет и скопируйте фрагмент конфигурации из открывшегося модального окна в providers файла medusa-config.ts.
6. Перезапустите сервер.

После этого интеграция появится в списке со статусом Не настроено и будет готова к настройке.

---

Пока интеграция не настроена, её страница показывает секции с пустыми обязательными полями. Никакого отдельного действия для первого запуска нет: сохранение любой секции с заполненными полями и создаёт настройку.

Чтобы настроить интеграцию:

1. Перейдите в Настройки → Интеграции.
2. Откройте нужную интеграцию.
3. Нажмите на меню действий в заголовке нужной секции.
4. Выберите Редактировать.
5. Заполните обязательные поля в открывшейся боковой панели.
6. Нажмите Сохранить.

---

Некоторые провайдеры поддерживают проверку соединения: она подтверждает, что введённые данные принимаются провайдером, ещё до того как интеграция будет использована на практике. Если провайдер такую проверку не поддерживает, соответствующего пункта в меню действий не будет.

Чтобы проверить соединение:

1. Перейдите в Настройки → Интеграции.
2. Откройте нужную интеграцию.
3. Откройте меню действий у названия интеграции.
4. Выберите Проверить соединение.

Результат проверки появится в уведомлении.

---

Секции настроенной интеграции редактируются точно так же, как при первой настройке.

Чтобы изменить секцию:

1. Перейдите в Настройки → Интеграции.
2. Откройте нужную интеграцию.
3. Нажмите на меню действий в заголовке нужной секции.
4. Выберите Редактировать.
5. Измените значения полей в открывшейся боковой панели.
6. Нажмите Сохранить.

---

Отключённая интеграция сохраняет свои настройки, но провайдер перестаёт их получать, как будто интеграция не настроена.

Чтобы включить или отключить интеграцию:

1. Перейдите в Настройки → Интеграции.
2. Откройте нужную интеграцию.
3. Откройте меню действий у названия интеграции.
4. Выберите Включить или Отключить.

---

Удаление стирает только сохранённые данные: токены и остальные значения секций. Сам провайдер как источник интеграции при этом не удаляется: он по-прежнему зарегистрирован в medusa-config.ts и снова появится в списке как ненастроенный. Чтобы полностью убрать провайдера, удалите его запись из providers в medusa-config.ts.

Чтобы удалить интеграцию:

1. Перейдите в Настройки → Интеграции.
2. Откройте нужную интеграцию.
3. Откройте меню действий у названия интеграции.
4. Выберите Удалить.
5. Подтвердите удаление.