> For the complete documentation index, see [llms.txt](https://wiki.reezonly.ru/space/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://wiki.reezonly.ru/space/nastroiki/integracii.md). # Интеграции {% hint style="info" %} Раздел **Интеграции** в Reezonly Space позволяет подключать внешние сервисы — среди них платежная система ЮКасса и почтовые рассыльщики. {% endhint %} Рассмотрим из чего состоит страница:

№1. Обзор страницы Интеграции

1. Рассыльщики 2. Платежные системы 3. Ключи API ## Рассыльщик Данный раздел предоставляет возможность подключения рассыльщика, от которого студентам будет отправляться [автоматические рассылки](https://wiki.reezonly.com/space/rassylki/e-mail-rassylki-v-reezonly):

№2. Обзор раздела Рассыльщик

### Подключение рассыльщика Для старта отправки e-mail-писем вашим пользователям вам нужно интегрировать сервис почтовых рассылок. Вы можете подключить сервис рассылок в пару кликов на нескольких страницах: 1. На вкладке **Рассылки.** Если у вас не подключен сервис рассылок, в разделе **Рассылки** будет отображаться баннер для подключения сервис. При нажатии на кнопку **Подключить** вам откроется окно, в котором вы сможете выбрать нужный сервис и ввести все необходимые данные для подключения.

№3. Интеграция через раздел Рассылки

2. Также вы можете подключить рассыльщик через **Интеграции** раздела **Настройки.**

№4. Подключение через Интеграции

3. При создании рассылки. Если на момент создания письма у вас не подключен расссыльщик, система предложит его подключить при попытке отправки письма. Без подключения рассыльщика вы никак не сможете отправить письма, только сохранить его.

№5. Подключение при создании рассылки

{% hint style="warning" %} Без подключения рассыльщика, использование функционала рассылок в Reezonly Space невозможно. {% endhint %} ## Виды рассыльщиков На данный момент в Reezonly Space вы можете подключить два вида рассыльщика: через свой собственный [SMTP-сервер](https://help.reg.ru/support/pochta-i-servisy/obshchiye-voprosy/chto-takoye-smtp-server#0) и через сервис рассылок Unisender. {% hint style="info" %} Вы можете подключить любой из них на свой выбор. Подключить оба рассыльщика сразу невозможно. {% endhint %} Процесс подключения почтового рассыльщика одинаков, вне зависимости от страницы, с которой вы его подключаете. Для подключения собственного SMTP-сервера вам потребуются следующие данные:

№6. Подлючение SMTP-сервера

{% hint style="success" %} 1. Имя хоста. 2. Порт. Вам необходимо ввести порт. Для SMTP-серверов обычно используются порт 25 или 587. 3. Логин 4. Пароль 5. Тип шифрования. Выберите необхожимый тип шифрования: TLS или SSL 6. От кого, имя. Введите имя, от которого будет производится рассылка 7. От кого, email. Введите адрес электронной почты, с которого будет происходить рассылка. {% endhint %} Для интеграции сервиса Unisender вам необходимо ввести:

№7. Подключение сервиса Unisender

{% hint style="success" %} * **Имя хоста.**\ Подробнее в Для аккаунтов на сайте go2.unisender.ru имя хоста: * **Ключ API.** \ Ключ API располагается на сайте go2.unisender.ru в разделе аккаунта \ Учетная запись -> Безопасность -> Ключ-API * **От кого, имя.** Введите имя, от которого будет производится рассылка * **От кого, email.** Введите адрес электронной почты, с которого будет происходить рассылка. {% endhint %} {% hint style="info" %} После подключения почтового рассыльщика мы рекомендуем сразу же проверить его рабоспособность. Перейдите в любую рассылку и нажмите **Тестовая отправка** в редакторе письма. {% endhint %}

№8. Тестовая отправка.

### Отключение рассыльщика Вы можете всего в несколько кликов отключить рассыльщик

№9. Отключение Рассыльщика

1. Перейдите в **Интеграции** 2. Кликните на подключенный рассыльщик 3. В открывшемся окне кликните **Отключить** 4. Подтвердите отключение в новом открывшемся окне {% hint style="warning" %} Обращаем ваше внимание, что при отключении почтового рассыльщика, все текущие и запланированные рассылки будут отключены до подключения нового рассыльщика. {% endhint %} ## Платежные системы Этот раздел предназначен для подключения сервиса, через который ваши студенты смогут оплачивать платные продукты. #### Подключение ЮКассы {% hint style="info" %} Перед настройкой интеграции убедитесь, что ваш личный кабинет ЮКассы полностью подготовлен — необходимые параметры вы найдете в документации [сервиса](https://yookassa.ru/docs/support/payments/overview). {% endhint %} Чтобы подключить ЮКассу в Reezonly Space, выполните следующие действия: 1. Перейдите в **Настройки → Интеграции .** 2. Нажмите **+ Добавить** и выберите **ЮКасса**. 3. В открывшемся окне заполните поля: * **Название профиля** — внутреннее имя, по которому вы будете находить этот профиль в продуктах. * **Тип подключения** — используется вариант *Секретный API-ключ*. * **Секретный API-ключ** — Скопируйте из личного кабинета ЮКассы. Подробнее [тут](https://yookassa.ru/docs/support/merchant/payouts/secret-key) * **Данные магазина** — внутренний ID магазина в ЮКассе. Узнать можно [тут](https://yookassa.ru/docs/support/merchant/payments/settings) * **Онлайн-касса** — по умолчанию *Внешняя онлайн-касса*. * **ФФД** — версия *1.05* установлена автоматически. * **Предмет расчёта** — *Услуга*. * **Тип расчёта** — *Предоплата (аванс)*. * **Способ расчёта** — *Полный расчёт*. * **Тип НДС** — выберите подходящее значение из списка (от «Без НДС» до расчётных ставок). * **Система налогообложения** — выберите ваш налоговый режим (ОСНО, УСН, Патент и др.). * Нажмите **Подключить**. После сохранения профиль станет доступен для выбора в настройках любого платного продукта.

№10. Подключение ЮКассы

После того как вы завершили настройку профиля ЮКассы в Reezonly Space, необходимо перейти в личный кабинет ЮКассы и указать адрес для получения уведомлений. Это делается в разделе **HTTP-уведомления**. В поле **URL для уведомлений** вставьте ссылку в формате: {% hint style="info" %} api-домен/v1/merchant/yookassa {% endhint %} Где *api-домен* — домен вашего бэкенда. Он отличается от основного домена проекта. Например, если платформа работает на `https://test.reezonly.ru`, то API-доменом будет `https://test-api.reezonly.ru`. После ввода URL сохраните изменения. ЮКасса начнёт отправлять в систему уведомления о статусах платежей, и интеграция будет работать корректно. {% hint style="success" %} Если вы сомневаетесь, какой именно API-домен нужно указать, или возникли дополнительные вопросы, смело обращайтесь в поддержку — специалисты подскажут правильный адрес и помогут завершить настройку. {% endhint %} ### Как подключить ЮКассу к платному продукту Для подключения **ЮКассы** как способ платежа перейдите во вкладку **Страницы продуктов -> Нужный вам продукт -> Настройки** и выполните несколько простых действий (Рис. №2):

№11. Подклюсение ЮКассы к продукту

1. Выберите в разделе **Запись** параметр **Платная запись** 2. В настройке Профиль платежной системы выберите нужный профиль ЮКассы, опираясь на название профиля 3. Укажите стоимость продукта в поле **Стоимость в ₽** 4. Нажмите кнопку **Сохранить изменения** После внесения всей необходимой информации в разделе **Запись**, способ оплаты будет автоматически подключен к нужному вам курсу и ваши ученики смогут его приобретать. ### Тестовый режим ЮКассы Перед тем, как подключать рабочую версию ЮКассы, вы можете проверить работу сервиса в тестовом режиме. Вам необходимо создать тестовый магазин внутри личного кабинета ЮКассы и подключить его в разделе Интеграции внутри Reezonly Space и выбрать тестовую ЮКассу в настройках продукта. Для проведения тестового платежа вам необходимо идти по стандартному пути пользователя при покупке образовательного продукта, используя тестовые карты. Более подробно о проведении тестовых платежей вы можете узнать в этой инструкции из [документации ЮКассы](https://yookassa.ru/developers/payment-acceptance/testing-and-going-live/testing#test-bank-card-data). ## **Ключи API** {% hint style="info" %} **Ключи API** - это уникальные идентификаторы, которые используются для безопасного подключения Reezonly Space к внешним сервисам и системам. API-ключи обеспечивают аутентификацию запросов между платформами, позволяя обмениваться данными с платежными системами, аналитическими сервисами, мессенджерами и другими инструментами. Функционал помогает автоматизировать процессы и расширять возможности академии без сложной разработки. **Для ознакомлении с подробной документации пеейдите в** {% endhint %} ### Как сгенерировать ключ API?

№12. Генерация ключа API

1. Перейдите в Интеграции 2. В разделе **Ключи API** кликните на + 3. Введите **Название ключа** и кликните на кнопку **Сгенерировать** 4. Скопируйте ключ и сохраните {% hint style="warning" %} **Cохраните этот секретный ключ** в безопасном и доступном месте. В целях безопасности вы больше не сможете просмотреть его в своём аккаунте. Если вы потеряете этот секретный ключ, вам нужно будет создать новый. {% endhint %} {% hint style="info" %} В данной статье мы рассказали вам о способе подключения ЮКассы внутри Reezonly Space. Информацию о другой функциональности платформы вы сможете узнать в следующих статьях данной базы. {% endhint %}