# HelpDeskEddy

## Введение

**Термины:**

* аудит(аудитлог, список событий) - список изменинй тикета
* endpoint - url на который должны поступать запросы
* кастомные поля - поля, которые клиент Qolio может добавлять тикетам в системе HDE
* ответы - сообщения которые оператор отправил клиенту в тикете HDE
* комментарии - сообщения которые оператор добавил в тикете HDE, которые видят только операторы тикета
* тикет - заявка

## Процесс создания интеграции с HDE

1. Пользователь создает API ключ в своем кабинете HDE(Управление - Глобальные настройки - Система, копирует API ключ(email:token))&#x20;

<figure><img src="https://1276573813-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRlSUdCzfdc7nn3SIxKb9%2Fuploads%2FhDudk2vDlgvlsv5SvP2s%2FHDE1.png?alt=media&#x26;token=7254a69b-6bdf-4852-b238-56216a44b5c1" alt=""><figcaption></figcaption></figure>

2. Пользователь переходит в Qolio в раздел интеграции, нажимает "Добавить интеграцию", выбирает “HDE”, вводит endpoint(домен\_системы.helpdeskeddy.com) и api\_key(API ключ HDE) и нажимает "продолжить".\
   \&#xNAN;***tech note:** отправляется запрос на qolio.io/api/v1/integrations*

Для того, чтобы установить интеграцию с HelpDeskEddy в вашем кабинете Qolio, перейдите в Личный кабинет -> Интеграции и нажмите на "Добавить интеграцию".

![](https://fc-euc1-00-pics-bkt-00.s3.eu-central-1.amazonaws.com/0721dce3c3785a031c746e321256bd63df24b9869ed57f74c93416f4284e377c/f_faq-image/u_27963c26d01c313b4a2c286fd7865b33f176c47687009f3345e11133a4c6bf07/img_vbcq8em6um_0bd8b42d86b263072e7d479d2cdf088c2a6dfcb7f2292f2b2e7cf85794680c94.png)

Далее выберите тип интеграции HelpDeskEddy и введите имя (можно любое).

Endpoint - это адрес, на котором размещается ваш HelpDeskEddy. Его необходимо скопировать из URL-строки и вставить в соответствующее поле в Qolio.

![](https://fc-euc1-00-pics-bkt-00.s3.eu-central-1.amazonaws.com/0721dce3c3785a031c746e321256bd63df24b9869ed57f74c93416f4284e377c/f_faq-image/u_27963c26d01c313b4a2c286fd7865b33f176c47687009f3345e11133a4c6bf07/img_5sv4199k1m_1d0d2df6a5a4dab21b8bb369e094c89a7d013b0c42d486f83a6f9e358ce9fdcf.png)

Для того, чтобы получить ваш Client Secret, необходимо перейти в HelpDeskEddy перейти в Управление -> Глобальные настройки и скопировать информацию из поля API ключ.&#x20;

![](https://fc-euc1-00-pics-bkt-00.s3.eu-central-1.amazonaws.com/0721dce3c3785a031c746e321256bd63df24b9869ed57f74c93416f4284e377c/f_faq-image/u_27963c26d01c313b4a2c286fd7865b33f176c47687009f3345e11133a4c6bf07/img_kp40iausav_a5c2c06bf3c03ac152f1507063f11bc2aa1805861da29a8602e29e1ee9a143ce.png)

![](https://fc-euc1-00-pics-bkt-00.s3.eu-central-1.amazonaws.com/0721dce3c3785a031c746e321256bd63df24b9869ed57f74c93416f4284e377c/f_faq-image/u_27963c26d01c313b4a2c286fd7865b33f176c47687009f3345e11133a4c6bf07/img_nptrjc38ba_7a4df67f321e1acd855a335c4f18dcc3d1746b376c4a07383836f79cd1325a59.png)

Далее вернуться в Qolio и вставить информацию в соответствующее поле.&#x20;

![](https://fc-euc1-00-pics-bkt-00.s3.eu-central-1.amazonaws.com/0721dce3c3785a031c746e321256bd63df24b9869ed57f74c93416f4284e377c/f_faq-image/u_27963c26d01c313b4a2c286fd7865b33f176c47687009f3345e11133a4c6bf07/img_7e6t54b4i6_b54103a78dd218d6a6493757497cecb0e71917d67eeb75075d63ffeedbca22d9.jpeg)

После того, как все поля заполнены, нажмите на кнопку "Продолжить".

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

![](https://fc-euc1-00-pics-bkt-00.s3.eu-central-1.amazonaws.com/0721dce3c3785a031c746e321256bd63df24b9869ed57f74c93416f4284e377c/f_faq-image/u_27963c26d01c313b4a2c286fd7865b33f176c47687009f3345e11133a4c6bf07/img_o0e0lbsaq3_02f0db17e0f2c41698faf48e5c3ef0d57ca999524c0ecb64a09ac552ffc70b67.jpeg)

После завершения синхронизации вы увидите список ваших пользователей. Галочками нужно отметить тех сотрудников, которые будет пользоваться Qolio, а также операторов, по которым будут синхронизироваться коммуникации. После этого нажмите справа на кнопку "Продолжить".

![](https://fc-euc1-00-pics-bkt-00.s3.eu-central-1.amazonaws.com/0721dce3c3785a031c746e321256bd63df24b9869ed57f74c93416f4284e377c/f_faq-image/u_27963c26d01c313b4a2c286fd7865b33f176c47687009f3345e11133a4c6bf07/img_oote3lt72l_8c194152f759ade32523e398589a9dbcc6e4a3734055294485565c60408af81c.jpeg)

Далее, нужно выбрать период, за который вы хотите синхронизировать коммуникации. Обращаем внимание, что чем больше выбранный промежуток, тем больше времени займет синхронизация коммуникаций. Выберите промежуток (рекомендуем выбрать за три дня) и нажмите справа на кнопку  "Продолжить".

![](https://fc-euc1-00-pics-bkt-00.s3.eu-central-1.amazonaws.com/0721dce3c3785a031c746e321256bd63df24b9869ed57f74c93416f4284e377c/f_faq-image/u_27963c26d01c313b4a2c286fd7865b33f176c47687009f3345e11133a4c6bf07/img_to8kdc1u66_af2b81baaa21aaddfa58d740c33e5b5029edc9b1d4e689df48bac67a595c98bf.jpeg)

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

![](https://fc-euc1-00-pics-bkt-00.s3.eu-central-1.amazonaws.com/0721dce3c3785a031c746e321256bd63df24b9869ed57f74c93416f4284e377c/f_faq-image/u_27963c26d01c313b4a2c286fd7865b33f176c47687009f3345e11133a4c6bf07/img_nn6f1jqff4_8d3c81925b06fab98cad06aa8a4e9b85f6414a6f56431fa9d5f15e3fa8a575bd.jpeg)

После того, как синхронизация завершится, на странице отобразятся  поля, которые импортировались из вашего HelpDeskEddy. Вы можете галочками отметить те поля, которые вам нужны во время оценки в списке коммуникаций.&#x20;

![](https://fc-euc1-00-pics-bkt-00.s3.eu-central-1.amazonaws.com/0721dce3c3785a031c746e321256bd63df24b9869ed57f74c93416f4284e377c/f_faq-image/u_27963c26d01c313b4a2c286fd7865b33f176c47687009f3345e11133a4c6bf07/img_0o4g55g596_a82009a9a03282560cb1de55a6ba889a6b02456c403bf0d57635772b5ed0c862.png)

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

![](https://fc-euc1-00-pics-bkt-00.s3.eu-central-1.amazonaws.com/0721dce3c3785a031c746e321256bd63df24b9869ed57f74c93416f4284e377c/f_faq-image/u_27963c26d01c313b4a2c286fd7865b33f176c47687009f3345e11133a4c6bf07/img_gbo6j1kujk_4340541a32a666e95db4b07091b580367df083a0cf47006c3315774e88c2f6f1.png)

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

![](https://fc-euc1-00-pics-bkt-00.s3.eu-central-1.amazonaws.com/0721dce3c3785a031c746e321256bd63df24b9869ed57f74c93416f4284e377c/f_faq-image/u_27963c26d01c313b4a2c286fd7865b33f176c47687009f3345e11133a4c6bf07/img_d2hpulsifi_7b87fa24bec73a0b22b74dab5dad20c45c27146cb8b6f000fe77041bc8597ab0.png)

После того, как синхронизация завершится, перейдите на список коммуникаций и проверьте набор фильтров "Дополнительная информация". Там будут отображаться поля, которые импортировались из HelpDeskEddy. С помощью этих и других фильтров (для установки даты коммуникации и выбора оператора используйте набор "Общая информация") вы можете найти нужные коммуникации.&#x20;

Проставьте необходимые фильтры (сверху есть подсказка, сколько коммуникаций найдено по выбранным фильтрам), а затем нажмите сверху кнопку "Применить фильтры". Список коммуникаций обновится согласно выбранным вами фильтрам.

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

![](https://fc-euc1-00-pics-bkt-00.s3.eu-central-1.amazonaws.com/0721dce3c3785a031c746e321256bd63df24b9869ed57f74c93416f4284e377c/f_faq-image/u_27963c26d01c313b4a2c286fd7865b33f176c47687009f3345e11133a4c6bf07/img_9m4i8i01ek_c70b8d66cda797f40b73fbb3bed18d314ecb9ed758eb11b3c92216ca1e22fb81.png)

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

![](https://fc-euc1-00-pics-bkt-00.s3.eu-central-1.amazonaws.com/0721dce3c3785a031c746e321256bd63df24b9869ed57f74c93416f4284e377c/f_faq-image/u_27963c26d01c313b4a2c286fd7865b33f176c47687009f3345e11133a4c6bf07/img_ikn59e179v_3f2b134b209ef3a5672e257191aaafa892caa944033fa2528d44fe9aab565648.png)

1. Дополнительная информация. Нажав на эту кнопку, вы увидите информацию из полей, которые были импортированы из HelpDeskEddy.

   ![](https://fc-euc1-00-pics-bkt-00.s3.eu-central-1.amazonaws.com/0721dce3c3785a031c746e321256bd63df24b9869ed57f74c93416f4284e377c/f_faq-image/u_27963c26d01c313b4a2c286fd7865b33f176c47687009f3345e11133a4c6bf07/img_665f1l5tc3_65dd5875236c1c4eed15019fb3f4bc813981c910a311af7642ee9734c13209a8.png)

   2\. Переход к тикету в HelpDeskEddy.

   3\. Копирование ссылки на коммуникацию в Qolio.

   4\. Добавление тега к коммуникации. Подробнее о тегах [здесь](https://wiki.qolio.ru/qolio-or-baza-znanii/vozmozhnosti-platformy/tegi).

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

1\. Они еще не были созданы.

2\. Формы оценки не добавлены к отделу, в котором находится оператор, чей тикет вы сейчас просматриваете.

3.Формы оценки не добавлены к отделу, в котором находитесь вы.

Для того, чтобы проверить эти моменты, перейдите по этой ссылке в раздел Формы оценки в вашем кабинете. Подробнее о том, как настраивать формы оценки [здесь](https://wiki.qolio.ru/qolio-or-baza-znanii/videoinstrukcii/nastroika-formy-ocenki).
