# Подключение интеграции с YCLIENTS

{% hint style="success" %}
На этом этапе предполагается, что у вас уже создан и настроен личный кабинет YClients
{% endhint %}

### Настройка через мастер подключения

1. Зайдите в раздел **Интеграции ->** [**YClients**](https://app.nextbot.ru/integrations?tab=YClientSettings)
2. Вы увидите **Мастер подключения**. Нажмите **«Продолжить»**.<br>

   <figure><img src="https://2593311972-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fef2EBU68XAlye1NtG8DF%2Fuploads%2FaddpjPH3TGKKLaigV5W0%2Fimage.png?alt=media&#x26;token=e0671d5a-a42b-4595-ad14-a610e757e37a" alt=""><figcaption></figcaption></figure>
3. Это уникальный номер вашего филиала в YClients. Чтобы его найти:

   * Откройте основное меню YClients.
   * Перейдите в раздел **«Обзор» → «Сводка»**.
   * В поле **«Идентификатор филиала (ID)»** скопируйте нужное значение (ТОЛЬКО ЦИФРЫ).

   Нажмите **«Далее»**.\
   \
   Альтернативный способ:

   * Возьмите значение из URL<br>

     <figure><img src="https://2593311972-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fef2EBU68XAlye1NtG8DF%2Fuploads%2Fc9OYNs9M72B4rjOpFopU%2Fimage.png?alt=media&#x26;token=d21430c4-80d0-4b20-843a-ffb953290433" alt=""><figcaption></figcaption></figure>

<figure><img src="https://2593311972-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fef2EBU68XAlye1NtG8DF%2Fuploads%2F1Tih26cqWXIjN8mB9XFP%2Fimage.png?alt=media&#x26;token=073b85c8-39b7-4dad-bb9d-cc918a1d6439" alt=""><figcaption></figcaption></figure>

4. Создайте аккаунт разработчика в YCLIENTS. Для этого откройте личный кабинет YClients и в основном меню перейдите в раздел «Интеграции» → «Аккаунт разработчика»<br>

<figure><img src="https://2593311972-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fef2EBU68XAlye1NtG8DF%2Fuploads%2FRUziyp3cN8GTxLU1VVyJ%2Fimage.png?alt=media&#x26;token=d7641ada-8acb-4f49-a053-c3e097787757" alt=""><figcaption></figcaption></figure>

5. Заполните обязательные поля и нажмите «Зарегистрироваться» для создания аккаунта разработчика. <mark style="color:orange;">Если у вас уже есть аккаунт разработчика, этот шаг можно пропустить.</mark><br>

<figure><img src="https://2593311972-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fef2EBU68XAlye1NtG8DF%2Fuploads%2FiVWPPPuDBhvWJKMiqdhc%2Fimage.png?alt=media&#x26;token=85238c19-d640-4012-8ce9-c8a14035208e" alt=""><figcaption></figcaption></figure>

6. В YCLIENTS в разделе «Аккаунт разработчика» найдите и нажмите кнопку «Добавить приложение» для начала процесса создания нового API-приложения. После нажатия откроется мастер создания приложения.\ <mark style="color:orange;">Если вы настраиваете повторно, например для второго агента - то шаги создания приложения можно пропустить.</mark>\ <br>

<figure><img src="https://2593311972-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fef2EBU68XAlye1NtG8DF%2Fuploads%2Fx7DV7ClVKldn0FJjZuZI%2Fimage.png?alt=media&#x26;token=a37beecf-1b77-4da9-b83d-dbcb4d5a1414" alt=""><figcaption></figcaption></figure>

7. На первом шаге мастера создания приложения необходимо выбрать тип приложения. **Обязательно выберите тип «Непубличное»**, так как это необходимо для корректной работы с API YClients без публикации в каталоге приложений.<br>

<figure><img src="https://2593311972-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fef2EBU68XAlye1NtG8DF%2Fuploads%2Fx7DV7ClVKldn0FJjZuZI%2Fimage.png?alt=media&#x26;token=a37beecf-1b77-4da9-b83d-dbcb4d5a1414" alt=""><figcaption></figcaption></figure>

8. На этом шаге необходимо заполнить основные данные о вашем приложении:
   * **Название приложения** - введите любое название
   * **Короткое описание** - добавьте любое краткое описание функций вашего приложения
   * **Категория** - выберите категорию «Онлайн-запись»<br>

<figure><img src="https://2593311972-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fef2EBU68XAlye1NtG8DF%2Fuploads%2F6DqO68TYOUgHWnRwuxE9%2Fimage.png?alt=media&#x26;token=8370f3bd-f950-4ec9-8654-2ddd2129ca60" alt=""><figcaption></figcaption></figure>

9. Выбор модели монетизации. Выберите вариант **«Бесплатное»** и нажмите кнопку **«Добавить приложение»**.<br>

<figure><img src="https://2593311972-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fef2EBU68XAlye1NtG8DF%2Fuploads%2FN1agiDt41JxHQA39SLBH%2Fimage.png?alt=media&#x26;token=5f9d0f3e-d9ca-4e27-a371-28a8511e1450" alt=""><figcaption></figcaption></figure>

10. После создания приложения, вы можете найти его Application ID в разделе «Мои приложения» → «Общая информация». Данный идентификатор понадобится для настройки интеграции.<br>

<figure><img src="https://2593311972-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fef2EBU68XAlye1NtG8DF%2Fuploads%2FtkJJLRSqow37laB7c9AP%2Fimage.png?alt=media&#x26;token=a6af0776-5d2e-40ae-9986-d3e43392be31" alt=""><figcaption></figcaption></figure>

11. Теперь необходимо ввести User Token — это персональный токен доступа к API YClients. Чтобы его найти, откройте раздел «Мои приложения» → «Доступ к API». В поле «User Token» вы увидите нужный токен.\ <br>

<figure><img src="https://2593311972-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fef2EBU68XAlye1NtG8DF%2Fuploads%2FBGbTvwkBQ5j4gjTaGNx5%2Fimage.png?alt=media&#x26;token=059864fc-fae0-4a26-a3b9-16171fc136d3" alt=""><figcaption></figcaption></figure>

12. Настройка прав доступа для приложения на этой же странице ниже.\
    Обязательно включите доступ к следующим разделам:
    * **Журнал записи** — для работы с записями клиентов
    * **Форма записи** — для управления процессом онлайн-записи
    * **Клиентская база** — для доступа к информации о клиентах<br>

<figure><img src="https://2593311972-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fef2EBU68XAlye1NtG8DF%2Fuploads%2F1PX9QfVBkWsbBsOQFSp8%2Fimage.png?alt=media&#x26;token=27b48734-a3f8-4f26-8a4a-c4706df644fb" alt=""><figcaption></figcaption></figure>

13. Обязательно нажмите кнопку **СОХРАНИТЬ**
14. Теперь необходимо ввести Partner Token — это партнерский токен для доступа к API YClients. Чтобы его найти, перейдите в раздел **«Настройки аккаунта»** и в блоке **«Данные аккаунта»** найдите поле **«Токен партнера»**.<br>

    <figure><img src="https://2593311972-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fef2EBU68XAlye1NtG8DF%2Fuploads%2FndyVmCzwJL2u9SNt9dlA%2Fimage.png?alt=media&#x26;token=0667ce04-515e-4fea-9dc1-b482712282f2" alt=""><figcaption></figcaption></figure>
15. Скопируйте токен партнера из вашего аккаунта YClients и вставьте его в поле в мастере подключения. Нажмите **«Далее»**
16. В мастере подключения нажмите кнопку **«Перейти к приложению в YClients»**<br>

    <figure><img src="https://2593311972-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fef2EBU68XAlye1NtG8DF%2Fuploads%2F6BGh9Ve6XnWrciRx8XFo%2Fimage.png?alt=media&#x26;token=c16ec5eb-01d5-4d35-aa02-9ec1945f4b5c" alt=""><figcaption></figcaption></figure>
17. В новой вкладке откроется страница вашего приложения в YCLIENTS. Нажмите **«Подключить» -> «Продолжить»**<br>

    <figure><img src="https://2593311972-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fef2EBU68XAlye1NtG8DF%2Fuploads%2FwuWUixMHny8o9N2ulcg6%2Fimage.png?alt=media&#x26;token=7a252b9b-24a4-4648-831e-271982d3f4e9" alt=""><figcaption></figcaption></figure>
18. Вернитесь на страницу с мастером подключения.
19. Нажмите **«Далее»** -> **«Завершить настройку».**

**Настройка завершена.** Продолжение — в [следующей статье](https://doc.nextbot.ru/functional/integrations/yclients/broken-reference).

***

### Настройка вручную

1. Зайдите в раздел Интеграции -> [YClients](https://app.nextbot.ru/integrations?tab=YClientSettings)
2. Нажмите **«Закрыть»** в мастере подключения
3. Введите значения в поля:
   1. **Salon ID** — уникальный номер филиала. Найдите его в **YClients → Обзор → Сводка → Идентификатор филиала (ID)**.

      **Альтернативный способ:** Возьмите значение из URL

      <figure><img src="https://2593311972-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fef2EBU68XAlye1NtG8DF%2Fuploads%2Fc9OYNs9M72B4rjOpFopU%2Fimage.png?alt=media&#x26;token=d21430c4-80d0-4b20-843a-ffb953290433" alt=""><figcaption></figcaption></figure>
   2. **Application ID** — если приложение уже создано, найдите его в разделе **«Интеграции»** **→** **«Аккаунт разработчика»**, нажав **«Управление»** → поле **Application ID**.
   3. **User Token** — находится там же, в разделе **«Доступ к API»**.
   4. **Partner Token** — найдите его в разделе **«Настройки аккаунта»** во вкладке **«Аккаунт разработчика»**, в поле **«Токен партнера»**.

<figure><img src="https://2593311972-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fef2EBU68XAlye1NtG8DF%2Fuploads%2F4880MHwfs2CBQs2jbSmZ%2Fimage.png?alt=media&#x26;token=80b64001-e4ef-44ff-8f4b-4d7dd14e6bff" alt=""><figcaption></figcaption></figure>

4. Нажмите Подключить.
5. В новой вкладке откроется страница приложения в YClients.
   * Нажмите **«Подключить» → «Продолжить»**.
   * Если отображается статус **«Подключено»**, пропустите этот шаг.
6. Вернитесь на страницу настройки YClients.

**Настройка завершена.** Продолжение — в [следующей статье](https://doc.nextbot.ru/functional/integrations/yclients/nastroika-peredachi-tekushei-daty-i-vremeni).