# YCLIENTS

### Что позволяет?

Подключение интеграции с YC позволяет кроме формирования ответов на вопросы, поступающие по выбранному [каналу](/ru/kanaly/crm-sistemy.md) , также осуществить автоматизированную запись клиента на сеанс, по выбранной услуге, мастеру и временному периоду.

### Как подключить?

Интеграция инициализируются на стороне YCLIENTS, подключить можно на странице нашего сервиса в маркетплейсе интеграций по ссылке <https://www.yclients.com/ru/marketplace/booking/suvvy_ai/info>

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

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

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

При выборе автоматическое регистрации, на Вашу электронную почту будут отправлены логин и пароль от личного кабинета Савви. Одновременно с этим произойдет входу в сервис Савви, где Вы можете выполнить настройку режимов работы интеграции с YC. Также ее выполнить можно непосредственно в личном кабинете Савви, используя логин и пароль отправленные Вам на почту.

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

## Как настроить?

### Вкладка "Список услуг"

Основной настройкой является режим работы с услугами:

* По категориям;
* По услугам

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

Если выбран режим использовать категории, то в агент будет передан список категорий, и уже при общении с клиентом, он сам определить нужную категорию и запросит по ней услуги из УС. Это режим подходит когда в системе много услуг или услуги имеют похожие названия, но относятся к разным группам. Если у клиента мало услуг (менее 20), то правильнее работать с выключенным режим **"Использовать категории"**, так как в этом случае в агент передаются сразу сами услуги, и агент без лишних запросов обрабатывает запросы клиента.

Опция **"Использовать название для онлайн записи"** позволяет после активации получать название для онлайн записи вместо обычного, оно будет использоваться в описании функции.

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

#### **Использовать название для онлайн записи**

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

> Опция **"Использовать название для онлайн записи"** позволяет после активации получать название для онлайн записи вместо обычного, оно будет использоваться в описании функции.

#### **Добавлять описание в список услуг**

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

> При активации опции **"Добавлять описание в список услуг"** агент будет получать к услугам их описание из YC. Описание будет идти в контекст агента и позволит отвечать клиенту на основе описания услуги в YC. Обратите внимание, что в этом случае будет наблюдаться дополнительный значительный расход токенов, особенно если у Вас много услуг.

#### **Групповые услуги**

<figure><img src="/files/7XtPbUnQRkpP6bpLwNbx" alt=""><figcaption></figcaption></figure>

> Если среди услуг предполагаются групповые занятия, то для работы с ними необходимо активировать флаг **"Групповые услуги"**.

### Вкладка "Настройки"

В самом начале Вы можете увидеть номер подключенного к агенту филиала.<br>

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

#### Блок "Назначение записи"

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

> **Разрешить назначение сеанса** - должна быть активирована, это позволяет агенту записывать клиентов на сеанс. При ее активации открываются связанные настройки.\
> **Разрешить запись на несколько услуг подряд** - после активации можно записывать клиентов на несколько услуг и искать подходящие свободные слоты на совокупность услуг за одно действие. Технически агент будет передавать id нужных услуг сразу в одной функции.\
> **Изменить цвет записи** - позволяет выделять запись определенным цветом, что позволяет отличать записи, которые создал агент от записей, созданных менеджерами.\
> **Использовать комментарий к записи** - позволяет добавить к записи заранее установленный комментарий.\
> **Установить категорию** - делает возможным выбрать одну из категорий, созданных на стороне YCLIENTS, затем помечать этой категорией записи, сделанные агентом.\
> **Запретить добавление новой записи, при наличии активной записи** - не позволяет выполнить новую запись клиента, если старая еще активна.

#### Блок "Отмена и перенос записи"

<figure><img src="/files/4XUt8E36fjfXNQ3dndns" alt=""><figcaption></figcaption></figure>

> **Разрешить отмену и перенос записи** - должна быть активирована, если необходимо выполнять отмену и перенос сеансов. При ее активации открываются связанные настройки.\
> **Отмечать, что клиент не пришел, вместо удаления сеанса** - при активации данной опции на стороне YCLIENTS, после того, как клиент отменит сеанса, он не будет удален, а будет помечен "Клиент не пришел".

#### Блок "Данные клиента"

<figure><img src="/files/55J8fT35u5nSq55B3AAS" alt=""><figcaption></figcaption></figure>

> **Разрешить получение данных по клиенту** - после активации становится возможным получать данные о клиенте из его карточки со стороны YCLIENTS.\
> **Передавать персональную скидку клиента** - агент будет получать персональную скидку клиента от YCLIENTS после активации опции.

#### Блок "Получение свободных слотов"

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

> **Передавать время окончания сеанса при получении свободных слотов** - если опция активирована, то доступные сеансы будут возвращены в формате интервала.

#### Блок "Сотрудники"

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

> **Предоставить агенту список сотрудников** - при активации агент сможет получать список сотрудников.\
> **Передавать свободные сеансы при получении списка доступных сотрудников, если передана услуга** - данная опция позволяет одновременно со списком сотрудников получить свободные слоты, что позволит не выполнять отдельный запрос на получение слотов.\
> **Запретить запись к выбранным сотрудникам** - после добавления сотрудников в список, запись к ним будет невозможна.

#### Блок "Оплата"

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

> **Передавать ссылку на оплату в ответе функции** - после активации в ответе агента будет ссылка на оплату. Дополнительно можно выставить время для отмены, если оплата не была произведена.\
> **Добавлять стоимость услуги в ответ** - в ответе будет дополнительно выводиться стоимость услуги.

### Аудит филиала

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

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

## Подключение нескольких филиалов

В случае, если необходимо подключить несколько филиалов, необходимо учитывать следующие правила:

* Если у каждого филиала свой канал связи (свой отдельный номер телефона), то на каждый филиал мы создаем отдельного агента. Мы рекомендуем сделать агента для одного филиала, отладить его работу, и после проведения опытной эксплуатации копировать его для других филиалов, при необходимости внося нужные корректировки;
* Если у компании один общий номер телефона на все филиалы, тогда для реализации схемы работы с несколькими филиалами, мы также должны создать агента для каждого филиала, но дополнительно необходимо создать агента "Администратора".
* Для агента "Администратора" необходимо определить одну задачу - это выяснить у клиента в какой филиал он хочет записаться на услуги. Именно это мы указываем в инструкции агента, а также дополняем инструкцию информацией о существующих филиалах;
* Далее необходим добавить в разделе **"Действия"**, новое действие (создаем столько действий, сколько филиалов):
  * В описании действиям указываем для какого оно филиала;
  * В действие добавляем шаг - **"Переключение активного агента"**, в настройках шага указать нужного агента для переключения (на каждый филиал делаем отдельное действие, и в шаге выбираем агента соответствующего филиала).
  * Если мы хотим, чтобы агент администратор не только сделал переключение, но еще и отправил в соответствующего филиалу агента вопросы клиента (если он их успел задать), необходимо добавить еще один шаг - **"Вызов агента"** и указать передачу в него информации. А в описание функции добавить инструкцию, следующего содержания: "В параметре `user_message` формулируй и передавай то, что собеседник хочет, формулируя это будто от его лица."

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

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

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

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

## Важные особенности настройки агента при работе с УС

Для более качественной работы агента в режиме интеграции УС мы рекомендуем учитывать следующие особенности:

* В основной инструкции не давать указаний агенту по порядку записи, отмене записи и вообще порядку работы с УС, так как эти указания могут идти в разрез со служебной инструкцией, которая формируется для каждого агента при подключении УС;
* Так как собеседники агента (клиенты), как правило являются постоянными (то есть обращаются за услугой с какой - то периодичностью), важно ставить ограничение по передаче агенту истории диалога. Это позволит оптимизировать расходы на диалог, а также убрать старую лишнюю информацию, которая может сбивать агента при общении с клиентом;

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

* При подключении канала WhatsApp обязательно надо включать передачу агенту номера телефона, в этом случае агент не будет дополнительно уточнять у собеседника номер телефона.

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

* При настройке записи, самые распространенные ошибки, при которых агент не может записать клиента на сеанс следующие:
  * В УС включено подтверждение записи на сеанс по коду из СМС. Данный режим агенту недоступен. Чтобы агент мог записать клиента, надо отключать подтверждение записи по коду из смс;
  * Для услуг, на которые должен записывать агент, должен быть включен режим он-лайн записи;
  * Услуги должны быть доступны тем специалистам, которые включены в рабочее расписание. Для специалистов также должна быть открыта возможность он-лайн записи.


---

# 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://docs.suvvy.ai/ru/integracii/sistemy-bronirovaniya/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.