# HelpDeskEddy

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

## Подключение

1. На стороне Савви перейдите на вкладку **"Каналы"**, в раздел **"Хелпдеск-системы"** и выберите **"HelpDeskEddy"**.

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

2. На стороне HelpDeskEddy перейдите в **"Управление"**, затем **"Глобальные настройки"**, скопируйте API-ключ.

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

3. На стороне Савви, введите API-ключ и адрес Вашего окружения, после чего нажмите **"Сохранить"**.

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

4. После подключения скопируйте **Webhook**.

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

5. На стороне HelpDeskEddy перейдите в **"Управление"**, затем **"Настройка каналов связи"**. Добавьте новый канал.

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

6. В конце выпадающего списка выбрать **"Исходящий канал"**, выберите департамент, в котором будет работать бот. Далее задайте название каналу, в поле **"URL"** вставьте ссылку, полученную в Шаге 4, активируйте флаг **"Повторы событий"** и нажмите **"Сохранить"**.

<figure><img src="/files/2mJld7uO2Mp7WFxWP1Ot" alt=""><figcaption></figcaption></figure>

7. В блоке **"Подписки"** необходимо выбрать **только две подписки:**

* Добавление ответа на заявку
* Создание заявки

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

* Если планируется работа с комментариями, активируйте флаг **"Добавление комментария"**.
* Дополнительно активируйте флаг **"Добавление ответа в омниканальности"**, если сотрудники работают в этом режиме.

{% hint style="warning" %}
Бот будет работать только с теми департаментами, на которые настроены каналы. В каждом канале может быть выбран только один департамент.
{% endhint %}

## Настройка работы с HelpDeskEddy

Интеграция предоставляет широкий набор настроек, которые позволят задать необходимый режим работы бота.

### Дополнительно

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

<figure><img src="/files/0HhSHNsSWHeKnKPuqt4V" alt=""><figcaption></figcaption></figure>

* **Отправлять сообщения от имени текущего исполнителя в тикете** - при активации позволяет отвечать от лица работника, на которого распределена заявка, если флаг не активирован, то ответы будут от лица работника, который выбран в выпадающем списке.
* **Режим "co-pilot"** - позволяет отправлять ответы бота в виде комментариев. Это оптимальный вариант на стадии отладки работы бота. Может использоваться, когда бот является помощником для сотрудников. В этом режиме ответы не видны клиентам.
* **Добавить задержку перед обработкой** - данная опция необходима, если на стороне HelpDeskEddy настроены автоматизации, которые требуют некоторого времени на выполнение, добавление задержки поможет избежать конфликтов с автоматизациями.

### Фильтры

На данной вкладке Вы можете задать настройки фильтров, чтобы более точно обозначить объем работы бота.

Доступны следующие фильтры:

1. Статус тикета
2. Тип тикета
3. Департамент
4. Сотрудник

Возможно выбрать несколько параметров.

#### Фильтр статуса тикета

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

#### Фильтр типа тикета

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

#### Фильтр по департаменту

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

#### Фильтр по сотруднику

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

### Выполнение действий в HelpDeskEddy

Бот может выполнять следующие действия:

1. Смена статуса.
2. Смена приоритета.
3. Смена исполнителя.
4. Смена типа.
5. Смена департамента.

Выполнение действий реализовано через вызов файла, в котором настроено необходимое действие.

{% hint style="success" %}
Механика аналогична той, что используется при взаимодействии с СРМ.
{% endhint %}

#### Настройка действий

1. Создайте файл в прямых вопросах. В файле выберите **"Действия в HelpDeskEddy"** и выберите вкладку нужного действия. Рассмотрим на примере Смены статуса.

<figure><img src="/files/2CHQ14lT4pZ54CkNvhrE" alt=""><figcaption></figcaption></figure>

2. Выберите нужный статус тикета. Нажмите **"Сохранить"**.

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

3. В инструкции бота пропишите условие, при котором статус тикета меняется на "Выполнено" и вызов файла.

{% code overflow="wrap" %}

```
Когда вопрос решен, вызови функцию get_file_text("Accomplished").
```

{% endcode %}

{% hint style="danger" %}
Обратите внимание, что сам файл может содержать дополнительные инструкции для бота, либо информацию, которую необходимо сообщить клиенту при выполнении действия.

**Если файл пустой, бот пропустит ответ, но выполнит действие.**
{% 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://docs.suvvy.ai/ru/kanaly/khelpdesk-sistemy/helpdeskeddy.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.