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

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

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

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

   <figure><img src="/files/CMAPr5L0uCbM5HugQ1Yp" alt=""><figcaption></figcaption></figure>
3. Это уникальный номер вашего филиала в YClients. Чтобы его найти:

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

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

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

     <figure><img src="/files/lfpcigRh9wnqV2YoHTXf" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/Q79RkiocYj301nEuzE7P" alt=""><figcaption></figcaption></figure>

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

<figure><img src="/files/TQBxjQpipfCro81ELiTq" alt=""><figcaption></figcaption></figure>

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

<figure><img src="/files/oJTwbNqPKs2532B2RlVr" alt=""><figcaption></figcaption></figure>

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

<figure><img src="/files/6sCeNLPKWT2mEQvepbA3" alt=""><figcaption></figcaption></figure>

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

<figure><img src="/files/6sCeNLPKWT2mEQvepbA3" alt=""><figcaption></figcaption></figure>

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

<figure><img src="/files/dUUN1pzQqxePFMm57wOt" alt=""><figcaption></figcaption></figure>

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

<figure><img src="/files/AOr2jlY9iECtzpKTYZka" alt=""><figcaption></figcaption></figure>

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

<figure><img src="/files/dvUxxtqcAU4aQNox01ps" alt=""><figcaption></figcaption></figure>

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

<figure><img src="/files/Y8SpvRLIg6QFhpVewMMg" alt=""><figcaption></figcaption></figure>

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

<figure><img src="/files/3CKUuWTT7CX3U20hBMuM" alt=""><figcaption></figcaption></figure>

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

    <figure><img src="/files/JukXBpv0rfRwFuc055n4" alt=""><figcaption></figcaption></figure>
15. Скопируйте токен партнера из вашего аккаунта YClients и вставьте его в поле в мастере подключения. Нажмите **«Далее»**
16. В мастере подключения нажмите кнопку **«Перейти к приложению в YClients»**<br>

    <figure><img src="/files/NX7L1hdWUe5kY8G7fmvb" alt=""><figcaption></figcaption></figure>
17. В новой вкладке откроется страница вашего приложения в YCLIENTS. Нажмите **«Подключить» -> «Продолжить»**<br>

    <figure><img src="/files/ysDTudtKDxfLe7OoMFIW" alt=""><figcaption></figcaption></figure>
18. Вернитесь на страницу с мастером подключения.
19. Нажмите **«Далее»** -> **«Завершить настройку».**

**Настройка завершена.** Продолжение — в [следующей статье](broken://pages/455QwY7xWUzhc5szBfTr).

***

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

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

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

      <figure><img src="/files/lfpcigRh9wnqV2YoHTXf" alt=""><figcaption></figcaption></figure>
   2. **Application ID** — если приложение уже создано, найдите его в разделе **«Интеграции»** **→** **«Аккаунт разработчика»**, нажав **«Управление»** → поле **Application ID**.
   3. **User Token** — находится там же, в разделе **«Доступ к API»**.
   4. **Partner Token** — найдите его в разделе **«Настройки аккаунта»** во вкладке **«Аккаунт разработчика»**, в поле **«Токен партнера»**.

<figure><img src="/files/5x9aFmrFrffl8OsZrMDs" alt=""><figcaption></figcaption></figure>

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

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


---

# 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://doc.nextbot.ru/functional/integrations/yclients/podklyuchenie-integracii-s-yclients.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.