# Интеграции

{% hint style="info" %}
Раздел **Интеграции** в Reezonly Space позволяет подключать внешние сервисы — среди них платежная система ЮКасса и почтовые рассыльщики.&#x20;
{% endhint %}

Рассмотрим из чего состоит страница:

<figure><img src="/files/BcAkQnaEUm1nxo9ZSXh1" alt=""><figcaption><p>№1. Обзор страницы Интеграции</p></figcaption></figure>

1. Рассыльщики
2. Платежные системы
3. Ключи API

## Рассыльщик

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

<figure><img src="/files/3Oyq7pfQ07zl0eLZlc1y" alt=""><figcaption><p>№2. Обзор раздела Рассыльщик</p></figcaption></figure>

### Подключение рассыльщика

Для старта отправки e-mail-писем вашим пользователям вам нужно интегрировать сервис почтовых рассылок.  Вы можете подключить сервис рассылок в пару кликов на нескольких страницах:&#x20;

1. На вкладке **Рассылки.** Если у вас не подключен сервис рассылок, в разделе **Рассылки** будет отображаться баннер для подключения сервис. При нажатии на кнопку **Подключить** вам откроется окно, в котором вы сможете выбрать нужный сервис и ввести все необходимые данные для подключения.

<figure><img src="/files/D6MpgHPsv0Th5EQTlhpd" alt="" width="563"><figcaption><p>№3. Интеграция через раздел Рассылки</p></figcaption></figure>

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

<figure><img src="/files/PfY3Ylp3nAUNEDcWonIN" alt=""><figcaption><p>№4. Подключение через Интеграции</p></figcaption></figure>

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

<figure><img src="/files/22kTi3zdSfvIla4rmyhb" alt="" width="563"><figcaption><p>№5. Подключение при создании рассылки</p></figcaption></figure>

{% hint style="warning" %}
Без подключения рассыльщика, использование функционала рассылок в Reezonly Space невозможно.&#x20;
{% endhint %}

## Виды рассыльщиков

На данный момент в Reezonly Space вы можете подключить два вида рассыльщика: через свой собственный [SMTP-сервер](https://help.reg.ru/support/pochta-i-servisy/obshchiye-voprosy/chto-takoye-smtp-server#0) и через сервис рассылок Unisender.&#x20;

{% hint style="info" %}
Вы можете подключить любой из них на свой выбор. Подключить оба рассыльщика сразу невозможно.&#x20;
{% endhint %}

Процесс подключения почтового рассыльщика одинаков, вне зависимости от страницы, с которой вы его подключаете.&#x20;

Для подключения собственного SMTP-сервера вам потребуются следующие данные:&#x20;

<figure><img src="/files/psbeHVoLCuynpwMpBSZb" alt="" width="375"><figcaption><p>№6. Подлючение SMTP-сервера</p></figcaption></figure>

{% hint style="success" %}

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

Для интеграции сервиса Unisender вам необходимо ввести:&#x20;

<figure><img src="/files/9LlkAKg09DaMN8uzPRIL" alt="" width="375"><figcaption><p>№7. Подключение сервиса Unisender</p></figcaption></figure>

{% hint style="success" %}

* **Имя хоста.**\
  Подробнее в Для аккаунтов на сайте go2.unisender.ru имя хоста: <https://go2.unisender.ru/ru/transactional/api/v1>
* **Ключ API.** \
  Ключ API располагается на сайте go2.unisender.ru в разделе аккаунта \
  Учетная запись -> Безопасность -> Ключ-API
* **От кого, имя.** Введите имя, от которого будет производится рассылка
* **От кого, email.** Введите адрес электронной почты, с которого будет происходить рассылка.
  {% endhint %}

{% hint style="info" %}
После подключения почтового рассыльщика мы рекомендуем сразу же проверить его рабоспособность. Перейдите в любую рассылку и нажмите **Тестовая отправка** в редакторе письма.&#x20;
{% endhint %}

<figure><img src="/files/HRB7mpHzFSXRnsAR571H" alt=""><figcaption><p>№8. Тестовая отправка. </p></figcaption></figure>

### Отключение рассыльщика

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

<figure><img src="/files/RG5eI4i4eIsQB7AgEgg9" alt="" width="563"><figcaption><p>№9. Отключение Рассыльщика</p></figcaption></figure>

1. Перейдите в **Интеграции**
2. Кликните на подключенный рассыльщик&#x20;
3. В открывшемся окне кликните **Отключить**
4. Подтвердите отключение в новом открывшемся окне&#x20;

{% hint style="warning" %}
Обращаем ваше внимание, что при отключении почтового рассыльщика, все текущие и запланированные рассылки будут отключены до подключения нового рассыльщика.
{% endhint %}

## Платежные системы

Этот раздел предназначен для подключения сервиса, через который ваши студенты смогут оплачивать платные продукты.

#### Подключение ЮКассы

{% hint style="info" %}
Перед настройкой интеграции убедитесь, что ваш личный кабинет ЮКассы полностью подготовлен — необходимые параметры вы найдете в документации [сервиса](https://yookassa.ru/docs/support/payments/overview).
{% endhint %}

Чтобы подключить ЮКассу в Reezonly Space, выполните следующие действия:

1. Перейдите в **Настройки → Интеграции .**&#x20;
2. Нажмите **+ Добавить** и выберите **ЮКасса**.
3. В открывшемся окне заполните поля:

* **Название профиля** — внутреннее имя, по которому вы будете находить этот профиль в продуктах.
* **Тип подключения** — используется вариант *Секретный API-ключ*.
* **Секретный API-ключ** — Скопируйте из личного кабинета ЮКассы. Подробнее [тут](https://yookassa.ru/docs/support/merchant/payouts/secret-key)
* **Данные магазина** — внутренний ID магазина в ЮКассе. Узнать можно [тут](https://yookassa.ru/docs/support/merchant/payments/settings)
* **Онлайн-касса** — по умолчанию *Внешняя онлайн-касса*.
* **ФФД** — версия *1.05* установлена автоматически.
* **Предмет расчёта** — *Услуга*.
* **Тип расчёта** — *Предоплата (аванс)*.
* **Способ расчёта** — *Полный расчёт*.
* **Тип НДС** — выберите подходящее значение из списка (от «Без НДС» до расчётных ставок).
* **Система налогообложения** — выберите ваш налоговый режим (ОСНО, УСН, Патент и др.).
* Нажмите **Подключить**.

После сохранения профиль станет доступен для выбора в настройках любого платного продукта.

<figure><img src="/files/TDGMxBqAlpzB1yv4YiHe" alt="" width="563"><figcaption><p>№10. Подключение ЮКассы</p></figcaption></figure>

После того как вы завершили настройку профиля ЮКассы в Reezonly Space, необходимо перейти в личный кабинет ЮКассы и указать адрес для получения уведомлений. Это делается в разделе **HTTP-уведомления**. В поле **URL для уведомлений** вставьте ссылку в формате:

{% hint style="info" %} <mark style="color:orange;">api-домен/v1/merchant/yookassa</mark>
{% endhint %}

Где *api-домен* — домен вашего бэкенда. Он отличается от основного домена проекта. Например, если платформа работает на `https://test.reezonly.ru`, то API-доменом будет `https://test-api.reezonly.ru`.

После ввода URL сохраните изменения. ЮКасса начнёт отправлять в систему уведомления о статусах платежей, и интеграция будет работать корректно.

{% hint style="success" %}
Если вы сомневаетесь, какой именно API-домен нужно указать, или возникли дополнительные вопросы, смело обращайтесь в поддержку — специалисты подскажут правильный адрес и помогут завершить настройку.
{% endhint %}

### Как подключить ЮКассу к платному продукту

Для подключения **ЮКассы** как способ платежа перейдите во вкладку **Страницы продуктов -> Нужный вам продукт -> Настройки** и выполните несколько простых действий (Рис. №2):&#x20;

<figure><img src="/files/JKWRt3haL4gMVrPmu37K" alt=""><figcaption><p>№11. Подклюсение ЮКассы к продукту</p></figcaption></figure>

1. Выберите в разделе **Запись** параметр **Платная запись**
2. В настройке Профиль платежной системы выберите нужный профиль ЮКассы, опираясь на название профиля&#x20;
3. Укажите стоимость продукта в поле **Стоимость в ₽**
4. Нажмите кнопку **Сохранить изменения**

После внесения всей необходимой информации в разделе **Запись**, способ оплаты будет автоматически подключен к нужному вам курсу и ваши ученики смогут его приобретать.&#x20;

### Тестовый режим ЮКассы&#x20;

Перед тем, как подключать рабочую версию ЮКассы, вы можете проверить работу сервиса в тестовом режиме.&#x20;

Вам необходимо создать тестовый магазин внутри личного кабинета ЮКассы и подключить его в разделе Интеграции внутри Reezonly Space и выбрать тестовую ЮКассу в настройках продукта.&#x20;

Для проведения тестового платежа вам необходимо идти по стандартному пути пользователя при покупке образовательного продукта, используя тестовые карты.&#x20;

Более подробно о проведении тестовых платежей вы можете узнать в этой инструкции из [документации ЮКассы](https://yookassa.ru/developers/payment-acceptance/testing-and-going-live/testing#test-bank-card-data). &#x20;

## **Ключи API**

{% hint style="info" %}
**Ключи API** - это уникальные идентификаторы, которые используются для безопасного подключения Reezonly Space к внешним сервисам и системам. API-ключи обеспечивают аутентификацию запросов между платформами, позволяя обмениваться данными с платежными системами, аналитическими сервисами, мессенджерами и другими инструментами. Функционал помогает автоматизировать процессы и расширять возможности академии без сложной разработки.

**Для ознакомлении с подробной документации пеейдите в** <https://insdoc.reezonly.ru/>
{% endhint %}

### Как сгенерировать ключ API?

<figure><img src="/files/AoKXxiYO0GpvqhKTXQ9Q" alt=""><figcaption><p>№12. Генерация ключа API</p></figcaption></figure>

1. Перейдите в Интеграции
2. В разделе **Ключи API** кликните на +
3. Введите **Название ключа** и кликните на кнопку **Сгенерировать**
4. Скопируйте ключ и сохраните

{% hint style="warning" %}
**Cохраните этот секретный ключ** в безопасном и доступном месте. В целях безопасности вы больше не сможете просмотреть его в своём аккаунте. Если вы потеряете этот секретный ключ, вам нужно будет создать новый.
{% endhint %}

{% hint style="info" %}
В данной статье мы рассказали вам о способе подключения ЮКассы внутри Reezonly Space. Информацию о другой функциональности платформы вы сможете узнать в следующих статьях данной базы.
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://wiki.reezonly.ru/space/nastroiki/integracii.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
