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

На этом этапе предполагается, что у вас уже создан и настроен личный кабинет YClients

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

0. Зайдите в раздел Интеграции → YClients → Мастер подключения

1. Нажмите «Далее».

1. Salon ID это уникальный номер вашего филиала в YClients. Чтобы его найти:

• Откройте основное меню YClients.

• Перейдите в раздел «Обзор» → «Сводка».

• В поле «Идентификатор филиала (ID)» скопируйте нужное значение (ТОЛЬКО ЦИФРЫ).

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

• Возьмите значение из URL

  

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

1. Заполните обязательные поля и нажмите «Зарегистрироваться» для создания аккаунта разработчика. Если у вас уже есть аккаунт разработчика, этот шаг можно пропустить.

1. В YCLIENTS в разделе «Аккаунт разработчика» найдите и нажмите кнопку «Добавить приложение» для начала процесса создания нового API-приложения. После нажатия откроется мастер создания приложения. Если вы настраиваете повторно, например для второго агента - то шаги создания приложения можно пропустить.

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

1. На этом шаге необходимо заполнить основные данные о вашем приложении:

• Название приложения - введите любое название

• Короткое описание - добавьте любое краткое описание функций вашего приложения

• Категория - выберите категорию «Онлайн-запись»

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

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

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

1. Настройка прав доступа для приложения на этой же странице ниже. Обязательно включите доступ к следующим разделам:

• Журнал записи — для работы с записями клиентов

• Форма записи — для управления процессом онлайн-записи

• Клиентская база — для доступа к информации о клиентах

1. Настройка уведомлений из YClients позволяет автоматически отправлять клиентам сообщения в каналы связи WhatsApp и Max при создании и/или удалении записи вручную в интерфейсе YClients. Сообщение отправляется по номеру телефона, указанному в записи клиента.

Для работы этой опции необходимо скопировать webhook-ссылку из интерфейса Nextbot → перейти в YClients в раздел «Мои приложения» → открыть «Настройки подключения» и вставить webhook-ссылку в поле «Адрес, на который отправлять уведомления» → нажать «Сохранить» внизу страницы.

Пример использования: Администратор добавляет запись в сервисе YClients → Nextbot через webhook получает информацию о событии → клиенту приходит сообщение в WhatsApp/Max в соответствии с выбранным форматом сообщения на странице интеграции: «Стандартное сообщение» или «Инструкция для ИИ». Если у агента, на котором настроена интеграция YClients, подключен только один мессенджер, например, WhatsApp, клиент получит сообщение только в WhatsApp. Если подключены оба канала — WhatsApp и Max, сообщение будет отправлено в каждый мессенджер.

1. Настройка реакции на новую запись

1. Настройка реакции на удаление записи

1. Теперь необходимо ввести Partner Token — это партнерский токен для доступа к API YClients. Чтобы его найти, перейдите в раздел «Настройки аккаунта» и в блоке «Данные аккаунта» найдите поле «Токен партнера».

Скопируйте токен партнера из вашего аккаунта YClients и вставьте его в поле в мастере подключения. Нажмите «Далее»

1. В мастере подключения нажмите кнопку «Перейти к приложению в YClients»

В новой вкладке откроется страница вашего приложения в YCLIENTS. Нажмите «Подключить» -> «Продолжить»

Вернитесь на страницу с мастером подключения.

1. Настройка даты и времени

1. Настройка YClients завершена

Теперь ваш ИИ-агент может обращаться к API YClients: записывать клиентов, получать информацию о записях и многое другое.

Для активации функций записи воспользуйтесь мастером создания функций. Вы всегда сможете вернуться в мастер подключения, чтобы изменить настройки.

---

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

1. Зайдите в раздел Интеграции -> YClients

2. Нажмите «Закрыть» в мастере подключения

3. Введите значения в поля:

   1. Salon ID — уникальный номер филиала. Найдите его в YClients → Обзор → Сводка → Идентификатор филиала (ID).

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

      
   2. Application ID — если приложение уже создано, найдите его в разделе «Интеграции» → «Аккаунт разработчика», нажав «Управление» → поле Application ID.

   3. User Token — находится там же, в разделе «Доступ к API».

   4. Partner Token — найдите его в разделе «Настройки аккаунта» во вкладке «Аккаунт разработчика», в поле «Токен партнера».

1. Нажмите «Подключить»

2. В новой вкладке откроется страница приложения в YClients.

   • Нажмите «Подключить» → «Продолжить».

   • Если отображается статус «Подключено», пропустите этот шаг.

3. Вернитесь на страницу настройки YClients.

Настройка завершена. Продолжение — в следующей статье.