# Вітаємо в #jedidesk

За допомогою нашого сервісу ви зможете встановити чат на сайт, а також підключити чат-боти Telgram та Viber.

Якщо ви шукаєте **якісний сервіс** який допомагає інтегрувати штучний інтелект, Telegram, Viber та чат на сайті, тоді ми ті, хто вам потрібен.

**Наша місія:** створити корисний продукт для підприємців та компаній, який буде допомагати клієнтам автоматизовано обслуговувати запити в підтримку.

### Шукай цікавинки нашого сервісу тут

<table data-view="cards" data-full-width="false"><thead><tr><th></th><th data-hidden></th><th data-hidden></th><th data-hidden></th><th data-hidden></th><th data-hidden data-type="files"></th><th data-hidden data-type="number"></th><th data-hidden data-card-cover data-type="files"></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><strong>Знайомство</strong></td><td>123</td><td></td><td></td><td></td><td></td><td>0</td><td><a href="/files/gITJhRTxFCBzSu0Yp1JL">/files/gITJhRTxFCBzSu0Yp1JL</a></td><td><a href="/pages/ybR04HoFbK7B6ErNcs1Z">/pages/ybR04HoFbK7B6ErNcs1Z</a></td></tr><tr><td><strong>Віджет</strong></td><td></td><td></td><td></td><td></td><td></td><td>null</td><td><a href="/files/6X8lYIB7fWV5CEuQrdCs">/files/6X8lYIB7fWV5CEuQrdCs</a></td><td><a href="/pages/NfbzgOu9E5vHfr64rvAj">/pages/NfbzgOu9E5vHfr64rvAj</a></td></tr><tr><td><strong>Чат-боти</strong></td><td></td><td></td><td></td><td></td><td></td><td>null</td><td><a href="/files/T2CeuaYIAa1AdkAVJUMH">/files/T2CeuaYIAa1AdkAVJUMH</a></td><td><a href="/pages/8KJQyKzOnBZiruKeLp4b">/pages/8KJQyKzOnBZiruKeLp4b</a></td></tr><tr><td><strong>JediDesk AI</strong></td><td></td><td></td><td></td><td></td><td></td><td>null</td><td></td><td><a href="/pages/JPUQ5Lqnsbfkg89iKBwI">/pages/JPUQ5Lqnsbfkg89iKBwI</a></td></tr><tr><td><strong>API-документація</strong></td><td></td><td></td><td></td><td></td><td></td><td>null</td><td></td><td><a href="/spaces/482eJXUP6YQwaD3RmPKQ">/spaces/482eJXUP6YQwaD3RmPKQ</a></td></tr><tr><td><strong>Відео-інструкції</strong></td><td></td><td></td><td></td><td></td><td></td><td>null</td><td></td><td><a href="/pages/DchGFSMGUn3MVq0F7wmp">/pages/DchGFSMGUn3MVq0F7wmp</a></td></tr></tbody></table>

### Дуже зручний пошук — <mark style="color:blue;">скористайся 👇</mark>

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


# Реєстрація в системі

1. Перейдіть за посиланням: [jedidesk.com](https://jedidesk.com/ua/) та знайдіть відповідні елементи на сайті:

<figure><img src="/files/ZIJz6hTmUmCpatSccC1Y" alt=""><figcaption><p><em>Головна сторінка</em></p></figcaption></figure>

2. Далі ви потрапите на реєстраційну форму сервісту за адресою [app.jedidesk.com](https://app.jedidesk.com). Якщо ви увійшли через **Google** або **Facebook**, тоді ви одразу потрапите в систему.
3. Перед Вами буде **форма реєстрації**:

<figure><img src="/files/r0i07fo1QVoyBb954Xqo" alt=""><figcaption><p><em>Форма реєстрації</em></p></figcaption></figure>

4. Введіть усі поля, для того, щоб ми могли вас ідентифікувати:
   * Назва компанії <mark style="color:red;">(обовʼязкове поле)</mark>
   * Ваш email. Він буде використовуватись у подальшому для входу в систему  <mark style="color:red;">(обовʼязкове поле)</mark>
   * Телефон для звʼязку <mark style="color:yellow;">(не обовʼязкове поле)</mark>
   * Пароль та підтвердження паролю <mark style="color:red;">(обовʼязкове поле)</mark>
5. Натисніть кнопку **"Реєстрація"**
6. Супер! Правда це було 💪 не складно? Далі будемо займатись **налаштуваннями**!

#### Відео-іструкція з реєстрації

{% file src="/files/JvlOkvSQXchQWZiE5nK9" %}


# Застосунок на iOS

Для застосунку на **iOS**, ми використовуємо технологію PWA[^1]. Функціонально, ця технологія дозволяє створювати майже аналогічні застосунки як і нативні, але з деякими обмеженнями, які на даний час майже не впливають на роботу нашої системи.

{% hint style="warning" %}
Нашого застосунку немає в AppStore. І найближчим часом додавати не плануємо, так як в цьому не бачимо функціональних переваг для користувачів.
{% endhint %}

**Інструкція:**

1. Відкрийте на вашому **iOS**-пристрої у барузері **Safari** <img src="/files/D19nPFPzlkUo1aC4kVRg" alt="" data-size="line">адмін-панель app.jedidesk.com
2. Увійдіть в ваш акаунт.
3. Натисніть на кнопку **Поділитись** <img src="/files/RZKZIg4R9ACBPl1jgCHr" alt="" data-size="line">

<figure><img src="/files/kw6Mk4KudjQyb6YxYr6l" alt="" width="563"><figcaption></figcaption></figure>

4. Оберіть в меню пункт **"На Початковий екран"**:

<figure><img src="/files/pr25IfZgXSpn0ExBJlxH" alt="" width="563"><figcaption></figcaption></figure>

5. Оберіть назву застосунку яка буде у вас на робочому столі і підтвердіть додавання:

<figure><img src="/files/QAemMzZoYj6r3sYQTWgp" alt="" width="563"><figcaption></figcaption></figure>

✅ Супер, тепер Ви будете отримувати сповіщення про нові звернення та будете мати змогу зручно відповідати клієнтам. Але обовʼязково увімкніть push сповіщення [в налаштуваннях](https://app.jedidesk.com/settings-profile).

[^1]: Поступовий вебзастосунок (англ. Progressive Web App, PWA) - вебзастосунок, який є гібридом звичайної вебсторінки (чи вебсайту) та мобільного застосунку


# Застосунок на Android

{% hint style="warning" %}
На даний момент застосунок у сервісі Play Market недоступний. Просимо скористатися покроковою інструкцією для його завантаження з нашого сайту.
{% endhint %}

**Інструкція:**

1. Перейдіть до нашого сайту.
2. Відкрийте на вашому пристрої у барузері Chrome Action menu (Три точки у лівому верхньому куті)&#x20;

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

3. Натисніть на "Додати на головний екран".

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

4. Оберіть "Установити" (самий застосунок), або "Створити ярлик" (Швидкий перехід до сайту)<br>

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

✅ Супер, тепер Ви будете отримувати сповіщення про нові звернення та будете мати змогу зручно відповідати клієнтам. Але обовʼязково увімкніть push сповіщення [в налаштуваннях](https://app.jedidesk.com/settings-profile)


# Оплата підписки на сервіс #jedidesk

Інструкція з вибору та оплати підписки на сервіс #jedidesk

**Навігація:**

1. [Налаштування підписки](#nalashtuvannya-pidpiski)
2. [Скасування підписки](#skasuvannya-pidpiski)

## **1. Налаштування підписки:**

Для оплати підписки на сервіс #jedidesk перейдіть до вкладки **Налаштування ->** [**Підписка**](https://app.jedidesk.com/settings-tariff).

На цій сторінці відображена кількість оплачених днів, обраний тариф, дата завершення вашої підписки та історія оплат за підписку:

<figure><img src="/files/KrA7fCWeEoXV1Ip3kCDX" alt=""><figcaption><p>Сторінка з вибором підписки на сервіс #jedidesk</p></figcaption></figure>

{% hint style="danger" %} <mark style="color:red;">**Увага!**</mark>**&#x20;При реєстрації облікового запису автоматично надається 14 безкоштовних днів підписки PRO для демонстрації повного функціоналу сервісу.**&#x20;

На цей період недоступна зміна підписки на START.

Перехід на підписку START буде автоматично проведено після завершення 14 днів.
{% endhint %}

***

Оберіть зручну для себе підписку, натиснувши на кнопку <mark style="background-color:purple;">**Змінити тариф**</mark> та <mark style="background-color:blue;">**Продовжити**</mark>:

<figure><img src="/files/WxkHGRjHQwKM4NtNeV8u" alt=""><figcaption><p>Вибір підписки на сервіс #jedidesk</p></figcaption></figure>

Натисніть <mark style="background-color:blue;">**Оплатити**</mark> та виберіть додаткові налаштування підписки за бажанням:

* Відповіді АІ-асистента&#x20;
* Підключення додаткових менеджерів до вашого облікового запису

***

В блоці **Зміст підписки** буде відображена загальна вартість вашої підписки з обраними налаштуваннями.

В блоці **Виберіть спосіб оплати** натисність кнопку <mark style="background-color:blue;">**Активувати**</mark>:

<figure><img src="/files/cYiXok2A2lv29vpspv8m" alt=""><figcaption><p>Налаштування деталей підписки на сервіс #jedidesk</p></figcaption></figure>

**Відкриється форма оплати кількома способами:**

* QR-code через застосунок monobank
* Google Pay
* Оплата картою

<figure><img src="/files/d3MqmOOgyaBZGZKihOwV" alt="" width="554"><figcaption><p>Види оплати підписки на сервіс #jedidesk</p></figcaption></figure>

{% hint style="danger" %} <mark style="color:red;">**Увага!**</mark> **Діє автоматичне оновлення підписки.**&#x20;

Після завершення оплаченого періоду буде автоматичне списання коштів на наступний місяць.
{% endhint %}

***

Після вдалої оплати ваша підписка буде автоматично продовжена та зафіксована в історії оплат:

<figure><img src="/files/P52NMzMszDb85QZSwOQY" alt=""><figcaption><p>Історія оплат на сервіс #jedidesk</p></figcaption></figure>

***

### 2. Скасування підписки:

Щоб зробити це, дотримуйтесь інструкції:

1. Перейдіть до пункту  "Підписка" та натисніть "Змінити тариф".<br>

   <figure><img src="/files/Ifa32RI7UKfXl6i6LfAV" alt=""><figcaption></figcaption></figure>
2. Оберіть тариф START.&#x20;

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

3. Підтвердьте свої дії у спливаючому вікні.

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


# Налаштування сповіщень

В нашій системі ви можете налаштувати сповіщення двома методами: через Telegram та Push

**Навігація:**

1. [Підключення Push-сповіщень (Windows, MacOS)](#id-1.-pidklyuchennya-push-spovishen-windows-macos)
2. [Підключення сповіщень в Telegram](#id-2.-pidklyuchennya-spovishen-v-telegram)
3. [Підключення сповіщень на IOS](#id-3.-pidklyuchennya-spovishen-na-ios)
4. [Перевірка доступу для відповіді](#id-4.-perevirka-dostupu-dlya-vidpovidi)
5. [Активні підписки на сповіщення](#id-5.-aktivni-pidpiski-na-spovishennya)

***

#### 1. Підключення Push-сповіщень (Windows, MacOS)&#x20;

У вкладці **Налаштування ->** [**Профіль**](https://app.jedidesk.com/settings-profile) в блоці **Сповіщення** увімкніть **Push-сповіщення** та натисніть <mark style="background-color:blue;">**Зберегти зміни**</mark>.

Браузер автоматично надішле запит на дозвіл сповіщень - підтвердіть запит.\
Якщо запит не надійшов, натисність на 🔒 біля адресної стрічки браузера та активуйте дозвіл:

<figure><img src="/files/dCVvQa2OIFLg6TBMSuJo" alt=""><figcaption><p>Налаштування сповіщень в профілі #jedidesk</p></figcaption></figure>

***

Зверніть увагу на додаткові налаштування, які працюють як для PUSH-сповіщень, так і в Telegram-боті:

* **Нові звернення** - сповіщення про новий (неприйнятий) чат
* **Нові повідомлення** - сповіщення про повідомлення в активних (прийнятих) чатах
* **JediDesk AI відповіді** - сповіщення про повідомлення, які відправляє клієнту AI.

***

Перейдіть до вкладки [**LiveChat**](https://app.jedidesk.com/chat) та натисніть на 🔊 в діалозі з будь-яким клієнтом та оберіть додаткові звукові налаштування:

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

***

Зверніть увагу на додаткове налаштування "безкінечні сповіщення". Функція забезпечує постійне звукове сповіщення про нові діалоги для менеджера при отриманні нового діалогу в вкладці **Нові.**&#x20;

Звуковий сигнал буде активний поки вкладка нових діалогів не буде порожньою.&#x20;

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

***

Можна увімкнути окремий звук для сповіщення коли у чаті спрацьовує налаштоване стоп-слово.&#x20;

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

{% file src="/files/ygbImBHmVgSvadZIi6oX" %}

***

#### Відміна закриття чату

Звукове сповіщення, яке спрацьовує, коли клієнт **відхиляє завершення діалогу**.

<figure><img src="/files/j2BI7nqYUYQAVuXhbNeS" alt=""><figcaption><p>Місцезнаходження перемикача</p></figcaption></figure>

У цьому випадку діалог **залишається активним**, а менеджер отримує звуковий сигнал, щоб звернути увагу на чат і продовжити спілкування з клієнтом.

{% file src="/files/L1vtOapqXFWv0botjGp1" %}

***

Перевірте, чи ваша операційна система дозволяє надсилати сповіщення з вашого браузера.

1. **Увімкніть сповіщення на Windows:**&#x20;

Відкрийте **Налаштування -> Система -> Сповіщення й дії** та увімкніть сповіщення:

<figure><img src="/files/kMyGbYiAFBjDL8J5CIK6" alt=""><figcaption><p>Налаштування сповіщень для Windows OS</p></figcaption></figure>

***

Прокрутіть сторінку нижче та увімкніть сповіщення для свого браузера:

<figure><img src="/files/UxxmUl4eRznlV0dc64tM" alt=""><figcaption><p>Налаштування сповіщень від програм на Windows OS</p></figcaption></figure>

***

2. **Увімкніть сповіщення на MacOS:**

Відкрийте меню **Apple -> Системні параметри ->** 🔔 **Сповіщення** на боковій панелі та натисніть на **>** біля свого браузера:

<figure><img src="/files/gweRDfsriThoGCU851HT" alt=""><figcaption><p>Налаштування сповіщень на MacOS</p></figcaption></figure>

***

Розгорніть налаштування та увімкніть сповіщення:

<figure><img src="/files/ZzSzV4MylXpZ4fAMlKCx" alt=""><figcaption><p>Налаштування сповіщень від програм на MacOS</p></figcaption></figure>

***

#### 2. Підключення сповіщень в Telegram

У вкладці **Налаштування ->** [**Профіль**](https://app.jedidesk.com/settings-profile) в блоці **Сповіщення** увімкніть функцію **Сповіщення в Telegram-боті**, яка при переході в системний бот #jedidesk ідентифікує ваш профіль.&#x20;

Запустіть бот, поверніться до налаштувань та натисніть <mark style="background-color:blue;">**Зберегти зміни**</mark>:

<figure><img src="/files/QnwOdzU8w70z4fkZ2H8i" alt=""><figcaption><p>Налаштування сповіщень через Telegram-бот #jedidesk</p></figcaption></figure>

***

Коли бот буде надсилати сповіщення, на них можна відповідати як на звичайні повідомлення через функцію Reply (Відповісти):

<figure><img src="/files/eE8B3Wiv64Wi6Jqvftnu" alt=""><figcaption><p>Отримання сповіщень та швидкі відповіді через Telegram-бот #jedidesk</p></figcaption></figure>

***

#### 3. Підключення сповіщень на IOS

За допомогою [Web push](#user-content-fn-1)[^1] API є можливість підключати сповіщення на IOS.

Також підтримуються сповіщення для мобільних пристроїв у випадку додавання їх на головний екран (👉🏻 [інструкція для iOS](/znaiomstvo/zastosunok-na-ios)).<br>

***

#### 4. Перевірка доступу для відповіді

При спробі відповісти через Telegram-бота система перевіряє права доступу менеджера.

Якщо тариф **дозволяє відповідати**, повідомлення буде надіслано клієнту.

Якщо тариф **не дозволяє відповідати**, бот надішле повідомлення з помилкою:

> ⚠️ Ваш тариф не дозволяє дану дію.\
> Перейдіть до кабінету оператора для оновлення тарифу.

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

***

### Важливо

* Сповіщення про нові повідомлення **надходять усім менеджерам незалежно від тарифу**.
* Обмеження застосовується **лише під час спроби відповісти через Telegram-бота**.
* Логіка перевірки доступу така ж, як і у **LiveChat при відкритті чатів**.

***

## 5. Активні підписки на сповіщення

Функція **«Активні підписки»** дозволяє переглянути всі підключені підписки на отримання сповіщень для вашого профілю.

У цьому списку відображаються:

* підключені **Telegram-акаунти**
* підключені **браузери для Web Push сповіщень**

Це дозволяє менеджеру або власнику акаунта контролювати всі пристрої та сервіси, які отримують сповіщення від системи.

Наприклад, якщо менеджер підключив сповіщення з різних пристроїв або браузерів, усі вони будуть відображатися у списку активних підписок.

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

***

### Де знаходиться

Відкрити список активних підписок можна у налаштуваннях профілю.

Шлях:

```
Налаштування → Профіль → Активні підписки
```

***

### Як працює функція

1. Натисніть кнопку **«Активні підписки»**.
2. Відкриється вікно зі списком усіх підключених підписок.
3. У списку можуть відображатися:

#### Підписки Telegram-бота

Показуються Telegram-акаунти, які підключені до отримання сповіщень.

Для кожного підключення відображається:

* ім’я користувача
* дата підключення
* кнопка **«Видалити»**

#### Підписки Web Push

Показуються браузери, які підписані на отримання push-сповіщень.

Якщо підписок немає — відображається повідомлення:

```
Підписок не знайдено
```

***

### Видалення підписки

Користувач може відключити будь-яку підписку, натиснувши кнопку **«Видалити»** поруч із відповідним підключенням.

Після видалення:

* Telegram-акаунт перестане отримувати сповіщення
* браузер перестане отримувати Web Push повідомлення

Це дозволяє швидко відключити зайві або неактуальні підписки.

[^1]: Наразі Push API став стандартом Web протоколів, і його було нативно впроваджено у сучасні браузери, такі як Chrome, Firefox, Edge та Safari.


# Додаток #jedidesk для Windows та MacOS в Chrome Apps

Настав час забути про купу вкладок браузера, адже #jedidesk тепер доступний як додаток в ChromeApps!

Авторизуйтеся в [**#jedidesk**](https://app.jedidesk.com) та натисніть **Встановити додаток** через браузер **Google Chrome**:

<figure><img src="/files/LD2YWK2XwE9T5wmiNJYs" alt=""><figcaption><p>Установка додатку через браузер Google Chrome</p></figcaption></figure>

За кілька секунд додаток **#jedidesk** буде встановлено та розгорнуто на вашому робочому столі:

<figure><img src="/files/cE3cy8Y0ICEIdRDCvRDt" alt=""><figcaption><p>Додаток #jedidesk</p></figcaption></figure>


# 6 кроків для запуску #jedidesk

Не знаєте, з чого почати роботу на #jedidesk? Давайте розглянемо 6 основних кроків для запуску системи підтримки

#### **Крок 1: Налаштувати та розмістити віджет**

У вкладці **Налаштування ->** **Інтеграції ->** [**Налаштування віджету**](https://app.jedidesk.com/settings-widget) створіть **віджет** для розміщення на своєму сайті.

Тут доступно безліч налаштувань - від дизайну віджета до  мультимовності.

👉🏻 [Текстова інструкція](/vidzhet/yak-stvoriti-chat-jedidesk)

👉🏻 [Відео-інструкція](https://www.youtube.com/watch?v=cqGE3uflAkY)

***

#### Крок 2: Додати менеджерів (операторів)

Якщо у вас є помічники, ви завжди можете додати<mark style="color:red;">\*</mark> їх до **#jedidesk**!

👉🏻 [Текстова інструкція](/nalashtuvannya-jedidesk/yak-dodati-menedzhera-operatora)

👉🏻 [Відео-інструкція](https://www.youtube.com/watch?v=LSMH567TM7o)

*<mark style="color:red;">\*</mark>Кількість менеджерів залежить від обраного вами* [*тарифу*](https://jedidesk.com/ua/price/)*.*

***

#### Крок 3: Увімкнути сповіщення про нові звернення

Будьте в курсі нових звернень, не заходячи на сервіс **#jedidesk**.

Отримуйте сповіщення та спілкуйтесь з клієнтами прямо через **Telegram-бот**!

👉🏻 [Текстова інструкція](/znaiomstvo/nalashtuvannya-spovishen)

***

#### Крок 4: Налаштувати та додати чат-боти

Щоб збільшити кількість каналів для звернень, ви можете підключити<mark style="color:red;">\*</mark> чат-боти **Telegram** та **Viber**.

**Як підключити чат-бот Telegram:**

👉🏻 [Текстова інструкція](/chat-boti/stvorennya-chat-bota-v-telegram)

👉🏻 [Відео-інструкція](https://www.youtube.com/watch?v=cqGE3uflAkY)

**Як підключити чат-бот Viber:**

👉🏻 [Текстова інструкція](/chat-boti/stvorennya-chat-bota-v-viber)

👉🏻 [Відео-інструкція](https://www.youtube.com/watch?v=iwd2L6LAWHQ)

*<mark style="color:red;">\*</mark>Підключення чат-ботів залежить від обраного вами* [*тарифу*](https://jedidesk.com/ua/price/)*.*

***

#### Крок 5: Додати швидкі відповіді та базу знань

Підвищуйте ефективність менеджерів, зекономте час та трудовитрати - додайте шаблони відповідей для чату, каталог з відповідями на типові питання або підключіть JediDesk AI:

👉🏻 [Як додати швидкі відповіді](/nalashtuvannya-jedidesk/yak-stvoriti-shvidki-vidpovidi)

👉🏻 [Як створити базу знань (FAQ)](/nalashtuvannya-jedidesk/yak-stvoriti-bazu-znan-faq)

👉🏻 [Як підключити штучний інтелект JediDesk AI](/nalashtuvannya-jedidesk-ai/yak-nalashtuvati-ai-asistentiv-jedidesk)

***

#### Крок 6: Приймати звернення

Після розміщення віджету та чат-ботів, ви будете отримувати звернення у вкладці [LiveChat](https://app.jedidesk.com/chat):

<figure><img src="/files/Fgym2hk4va27HbSjwemz" alt=""><figcaption><p>Запит від клієнта в LiveChat</p></figcaption></figure>

Натискайте <mark style="background-color:blue;">**Відповісти на діалог**</mark> та починайте обробляти запити ваших клієнтів!

Тут доступний наступний функціонал:

* прослуховування голосових повідомлень
* надсилання медіа-файлів
* emoji
* форматування тексту в **жирний**, *курсив*, ~~перекреслений~~
* заповнення картки клієнта: нотатки, теги, тощо
* зміна менеджера

👉🏻 [Детальний огляд функціоналу LiveChat](/znaiomstvo/funkcional-livechat)


# Аналітика

Огляд функціоналу аналітики на сервісі #jedidesk

#### Продуктивність менеджерів та динаміка звернень

Відкрийте вкладку **Аналітика ->** [**Продуктивність**](https://app.jedidesk.com/analytics/productivity).

Відображення статистики звернень у всіх форматах: (Кожна з них адаптується під указаний вами час)

* **Усього діалогів**- Це поле показує суммарну кількість діалогів.
* **Нові діалоги**- Це поле показує Нові діалоги, які були відкриті
* **Закриті діалоги**- Це поле показує усі закриті чати.
* **Час першої відповіді**- Це час між мометом запиту і першою відповіддю менеджера.
* **Час закриття**- Це час між мометом запиту і закриттям діалогу.

<figure><img src="/files/J0Uqk8Wy78qqDYrwDaYL" alt=""><figcaption><p>Аналітика продуктивності в числах</p></figcaption></figure>

<figure><img src="/files/mRPjusVkNlAxz6ZbGbM5" alt=""><figcaption><p>Графік продуктивності</p></figcaption></figure>

Додатково ви можете вказати певний період та конкретного менеджера, який опрацьовував звернення:

<figure><img src="/files/aOGBxRB3n27gC07P97l0" alt=""><figcaption><p>Аналітика конкретного менеджера за певний період</p></figcaption></figure>

***

#### Оцінка якості обслуговування

Відкрийте вкладку **Аналітика ->** [**Оцінка**](https://app.jedidesk.com/analytics/quality).

Якщо ви вмикали функціонал оцінки менеджерів після завершення діалогу у вкладці **Налаштування ->** [**Компанія**](https://app.jedidesk.com/settings-company), ви маєте змогу оцінити рівень якості обслуговування ваших менеджерів:

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

По кожному клієнту є можливість перейти в чат та переглянути переписку.

Додатково ви можете вказати певний період та конкретного менеджера, який опрацьовував звернення.

***

#### Аналітика тем діалогів&#x20;

Відкрийте вкладку **Аналітика ->** [**Теми діалогів**](https://app.jedidesk.com/analytics/productivity).

Якщо ви додавали [теми діалогів](/nalashtuvannya-jedidesk/nalashtuvannya-temi-dialogu) та позначали всі звернення, ви можете бачити статистику запитів (тем), за якими до вас звертаються клієнти:

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

Додатково ви можете вказати певний період та конкретного менеджера, який опрацьовував звернення.


# Функціонал LiveChat

Огляд основного функціонала модуля LiveChat

Навігація:

1. [Панель користувачів](#panel-koristuvachiv)
2. [Фільтр](#filtr)
3. [Панель з інформацією про користувача](#panel-z-informaciyeyu-pro-koristuvacha)
4. [Налаштування LiveChat](#nalashtuvannya-livechat)
5. С[кидання теми діалогу при закритті](#skidannya-temi-dialogu-pri-zakritti)
6. [Інструкція користування та особливі функції](#instrukciya-koristuvannya-ta-osoblivi-funkciyi)\
   6[.1. Швидка відповідь](#shvidka-vidpovid)\
   6[.2. Редагування тексту](#redaguvannya-tekstu)\
   6[.3. Відкладені повідомлення](#vidkladeni-povidomlennya)\
   6[.4. Копіювати ІD-чату у вікні діалогу](#kopiyuvati-id-chatu-u-vikni-dialogu)\
   [6.5. Бізнес-статуси діалогу](#biznes-statusi-dialogiv)

## Функціонал  LiveChat&#x20;

### Панель користувачів

#### [Модуль LiveChat](https://app.jedidesk.com/chat) виглядає наступним чином:

<figure><img src="/files/66nsqdOs2f69PoNaBHOI" alt=""><figcaption><p>LiveChat</p></figcaption></figure>

Ви бачите діалоги з позначкою месенджерів, віджета та AI у трьох папках:

<mark style="color:purple;">**Нові**</mark> - нові (неприйняті) чати, які потребують опрацювання.

<mark style="color:green;">**Активні**</mark> - прийняті менеджером чати, які опрацьовуються зараз.

<mark style="color:blue;">**Архівні**</mark> - закриті, опрацьовані чати, або деактивовані через відсутність відповіді зі сторони клієнта.

Є можливість налаштувати[ розподілення чатів між менеджерами](/nalashtuvannya-jedidesk/nalashtuvannya-rozpodilennya-dialogiv-mizh-menedzherami) та їх зміни, що дуже корисно при великій кількості звернень.

***

### Фільтр

Чати фільтруються за наступними показниками:\
\- Платформи (Viber, Telegram, Instagam, Messenger, Widget, Email, Telegram Business, Whatsapp)\
\- Теми діалогу (Налаштовується: Автоматизація -> Теми  діалогу)\
\- Початок діалогу (За весь час, Сьогодні, Вчора, Останні 7 днів, Останні 30 днів, **Вказати період** )\
\- Чати \
\- Менеджери (Налаштовується: Налаштування-> Менеджери)

<figure><img src="/files/GX1U0gWulVaWpgvXYO4n" alt=""><figcaption><p>Фільтри чатів</p></figcaption></figure>

***

### Панель з інформацією про користувача

При зверненні кожен клієнт додається в систему, ви маєте можливість переглядати та частково редагувати його інформацію:

<figure><img src="/files/Q7rCMQjw62zWniHDpUBJ" alt=""><figcaption><p>Картка клієнта</p></figcaption></figure>

* **Фото** клієнта
* **Канал звернення**
* **Ім'я**
* **username -** при зверненні через Telegram або Instagram боти
* **email** - вказується[ менеджером](/nalashtuvannya-jedidesk/yak-dodati-menedzhera-operatora) власноруч
* **Телефон -** вказується менеджером власноруч
* [**Додаткове поле**](/nalashtuvannya-jedidesk/dodatkovi-polya-v-kartochci-kliyenta) для необхідної інформації (наприклад ID на сервісі тощо)
* **Мова клієнта** - ідентифікується мовою застосунка або браузера клієнта. Мову можна змінити власноруч, від неї залежить мова системних повідомлень в чаті.
* **Менеджер** - автоматично вказується менеджер, який прийняв запит. Супервайзер може змінювати менеджера.
* **Нотатки**
* [**Теми діалогу**](/nalashtuvannya-jedidesk/nalashtuvannya-temi-dialogu) - вказується менеджером для аналітики за необхідності
* **Тег -** вказується менеджером для групування клієнтів при розсилці тощо
* **Блокування клієнта**

***

### Налаштування LiveChat

\
Зверніть увагу, що частина функціоналу є опціональною та налаштовується у вкладці **Налаштування ->** [**Компанія**](https://app.jedidesk.com/settings-company)**:** &#x20;

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

* **Головна мова** - вкажіть мову, на якій всі клієнти будуть отримувати системні повідомлення (початок та завершення діалогу, підключення оператора, тощо).
* **Показувати сповіщення про приєднання/зміну менеджера чату** - користувач отримає системне повідомлення про підключення менеджера.&#x20;
* **Запитувати у користувача, чи було вирішено його питання** - користувач отримає повідомлення "*У вас ще залишилися запитання?*" з кнопками "*Так / Ні*". Кнопка "*Ні*" автоматично переведе діалог в Архів.
* **Обовʼязкова оцінка діалога користувачем по його завершенню** - увімкніть, якщо даний показник необхідний для [аналітики якості працівників](/znaiomstvo/analitika#ocinka-yakosti-obslugovuvannya).
* **Відображення теми діалогу** - ви можете вказувати кілька [тем діалогу](/nalashtuvannya-jedidesk/nalashtuvannya-temi-dialogu) для [аналітики](/znaiomstvo/analitika#analitika-tem-dialogiv). \
  Якщо це необхідний показник, увімкіть функцію **Обов'язкове зазначення теми діалогу** - чати без тем не зможуть бути закриті.
* **Початок діалогу після активації тригеру автовідповіді** - якщо увімкнути цю функцію, ви будете отримувати повідомлення-сповіщення про користувачів, які переходили за UTM-посиланнями [автовідповідей ](/nalashtuvannya-jedidesk/nalashtuvannya-avtomatichnikh-vidpovidei)в бот (це не є зверненням). Вимкніть цю функцію, якщо ви хочете лише отримувати повідомлення після того як дані клієнти напишуть вам.
* **Заборонити редагування повідомлень у діалогах** - менеджери не зможуть редагувати відправлені повідомлення.&#x20;
* **Заборонити видалення повідомлень** - менеджери не зможуть видаляти відправлені повідомлення.&#x20;
* **Дозволити змінювати менеджера користувачу з роллю Менеджер** - за замовчуванням зміна менеджера доступна лише власнику аккаунта та супервайзеру.&#x20;
* **Дозволити блокувати клієнтів користувачу з роллю Менеджер** - за замовчуванням блокування доступне лише власнику аккаунта та супервайзеру.
* **Закривати діалог через неактивність** - якщо клієнт не відповідає протягом 15 хвилин, діалог автоматично закривається та переходить в Архів. Час очікування можна змінювати або повністю вимкнути цю функцію.

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

* Увімкнувши функцію: **"Переводити діалог в Активні при отриманні відповіді від менеджера в бізнес-месенджері"** - діалог на який була надана відповідь у діректі месенджера на пряму, буде переведенний до вкладки "Активні" у LiveChat.\
  *За замовчуванням ця функція - **ВИМКНЕНА***

***

## Скидання теми діалогу при закритті

Функція **«Скидання теми діалогу при закритті»** дозволяє автоматично очищати теми діалогу після його завершення.

Коли менеджер закриває чат, встановлені теми **не видаляються**, а **переносяться в архів**. При наступному зверненні клієнта менеджер бачить **порожню панель тем** і може встановити теми, що відповідають новому запиту.

***

### Проблема, яку вирішує

У JediDesk для кожного клієнта зберігається **єдина історія діалогу**, яка може відкриватися і закриватися багато разів.

Без цього налаштування теми, встановлені під час попереднього звернення, залишаються активними і при наступному діалозі.

Це може призводити до ситуацій, коли менеджер бачить **застарілі або нерелевантні теми**.

Після увімкнення функції:

* при закритті чату всі теми **переносяться в архів**
* нове звернення починається з **чистої панелі тем**

***

### Як увімкнути

1. Перейдіть у **Налаштування → Компанія**
2. Знайдіть блок **«Розділ Чати»**
3. Увімкніть перемикач **«Скидання теми діалогу при закритті»**
4. Натисніть **«Зберегти зміни»**

> За замовчуванням функція **вимкнена**.

***

### Як працює функція

1. Менеджер веде діалог з клієнтом і встановлює тему або декілька тем.
2. Менеджер закриває діалог.
3. Якщо функція увімкнена — всі теми цього діалогу **автоматично архівуються**.
4. Коли клієнт звертається повторно, відкривається той самий діалог, але **панель тем порожня**.
5. Менеджер може встановити нові теми відповідно до нового запиту.

Якщо функція вимкнена — теми **залишаються активними між зверненнями**.

***

### Вплив на аналітику

Архівні теми **не видаляються з системи** і продовжують враховуватись в аналітиці.

Це означає:

* статистика за попередні періоди залишається коректною
* всі теми враховуються у звітах
* нові теми при повторному зверненні записуються окремо

Аналітика доступна у розділі:

**Аналітика → Теми**

***

### Взаємодія з іншими налаштуваннями

| Налаштування                            | Опис                                    |
| --------------------------------------- | --------------------------------------- |
| **Відображення теми діалогу**           | Показує панель тем у чаті               |
| **Обов'язкове зазначення теми діалогу** | Не дозволяє закрити чат без вибору теми |
| **Скидання теми діалогу при закритті**  | Архівує теми після завершення чату      |

Налаштування працюють **незалежно одне від одного**.

Рекомендована конфігурація:

**Обов'язкове зазначення теми + Скидання теми при закритті**

Це дозволяє менеджерам встановлювати тему **для кожного нового звернення окремо**.

***

### Часті питання

#### Чи можна переглянути архівні теми в чаті?

Ні. Архівні теми не відображаються в інтерфейсі чату. Вони доступні тільки у звітах аналітики.

***

#### Що станеться, якщо вимкнути функцію?

Нові закриття чатів більше не будуть архівувати теми.\
Вже архівовані теми залишаться в архіві.

***

#### Чи застосовується функція до старих діалогів?

Ні. Скидання тем відбувається **лише в момент закриття діалогу** після увімкнення налаштування.

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

\
**Ін**струкція користування та особливі функції

***

Коли користувач відправляє звернення, це виглядає наступним чином:

<figure><img src="/files/Fgym2hk4va27HbSjwemz" alt=""><figcaption><p>Новий запит від клієнта</p></figcaption></figure>

### Швидка відповідь

Менеджер натискає на кнопку <mark style="background-color:blue;">**Відповісти на діалог**</mark>, далі або власноруч вводить повідомлення, або обирає [швидку відповідь](/nalashtuvannya-jedidesk/yak-stvoriti-shvidki-vidpovidi):

<figure><img src="/files/VdxTh7A9BaUEyhK0ipqL" alt=""><figcaption><p>Швидкі відповіді</p></figcaption></figure>

***

### Редагування тексту **⋮**&#x20;

#### &#x20;При натисканні на **⋮** ви маєте змогу редагувати, видаляти повідомлення:

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

***

Також є можливість [генерувати відповіді через MagicButton](/nalashtuvannya-jedidesk-ai/nalashtuvannya-magic-button-dlya-jedidesk-ai) замість самостійного вводу або [налаштувати штучний інтелект JediDesk AI](/nalashtuvannya-jedidesk-ai/yak-nalashtuvati-ai-asistentiv-jedidesk), який буде самостійно опрацьовувати запити клієнтів замість менеджерів.

***

### Відкладені повідомлення

Буває, що під час спілкування з клієнтом розумієш: треба буде нагадати про себе через день, тиждень чи в конкретну дату. \
Для цього існує функція "Відкладені повідомлення"\
Створити його ви можете, натиснувши на відповідну кнопку у чаті.<br>

<figure><img src="/files/DUVJVPukk48QaezPizfA" alt=""><figcaption><p>Кнопка "Відкладені повідомлення"</p></figcaption></figure>

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

<figure><img src="/files/SQX0ODopvvcykgm2cuzx" alt=""><figcaption><p>Кнопка "Відкладені повідомлення"</p></figcaption></figure>

Натиснувши на цю кнопку, ви зможете обрати день та час надсилання повідомлення за допомогою нашого інтерфейсу.<br>

<figure><img src="/files/OSeFHYS1l4cGvV0bf6wO" alt=""><figcaption><p>Інтерфейс Відкладеного повідомлення</p></figcaption></figure>

Надіславши повідомлення, ви побачите його у чаті, ви сможете його редагувати, як і звичайні повідомлення, натиснувши на кнопку \[ **⋮** ]<br>

<figure><img src="/files/X7nHtInpft0DCYdds9Sw" alt=""><figcaption><p>Редагування повідомлення</p></figcaption></figure>

***

Коли розмова з клієнтом буде завершена, натисніть в правому верхньому кутку кнопку <mark style="background-color:green;">**Закрити діалог**</mark>.

Якщо менеджер не буде закривати діалог, в аналітиці не будуть відображатися коректні дані про закриті чаті, а ваші клієнти не будуть отримувати системне повідомлення про [неробочі години компанії](/nalashtuvannya-jedidesk/nalashtuvannya-robochogo-chasu-kompaniyi).

***

### Копіювати ІD-чату у вікні діалогу

У діалозі є кнопка: Скопіювати ID діалогу. Це дає можливість отримати посилання не виходячі із інтерфейсу LiveChat<br>

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

### Відображення часу та дати у вигляді тултіп для дій з діалогом

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

Навівши на системне повідомлення у діалозі про взаємодію, можна отримати тултіп з датою та часом коли ця дія була відтворена

***

## Бізнес-статуси діалогів

**Бізнес-статуси діалогів** — це користувацькі мітки, які менеджери можуть призначати чатам у LiveChat для відображення етапу роботи з клієнтом.

На відміну від **системних статусів діалогу** (Новий / Активний / Архівний), бізнес-статуси створюються компанією самостійно та відображають внутрішні процеси роботи.

Наприклад:

* 🔥 Новий лід
* 💬 Консультація
* ⏳ Очікуємо відповідь клієнта
* 📦 Оформлення замовлення
* ✅ Закрито

Це дозволяє менеджерам швидко розуміти **поточний етап роботи з клієнтом** і зручно фільтрувати діалоги.

***

## Доступність за тарифами

| Тариф | Доступ       |
| ----- | ------------ |
| START | ❌ Недоступно |
| PRO   | ✅ Доступно   |
| PRO+  | ✅ Доступно   |

Якщо тариф не підтримує функцію, пункт **«Статуси діалогів»** у меню налаштувань не відображається.

***

## Налаштування статусів

**Шлях:**

```
Автоматизація → Статуси діалогів
```

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

На сторінці налаштувань можна:

* створювати нові статуси
* редагувати існуючі
* змінювати порядок сортування
* вимикати або видаляти статуси

Кожен статус має такі параметри:

| Поле       | Опис                   |
| ---------- | ---------------------- |
| Назва      | Назва статусу          |
| Статус     | Активний або вимкнений |
| Сортування | Порядок відображення   |

⚠️ **Поле «Сортування» визначає логічну послідовність етапів.**\
Саме на основі цього порядку працює кнопка **«Далі»** у чаті.

***

## Призначення статусу у чаті

Відкрийте будь-який діалог у LiveChat.

У верхній частині чату, поруч з іменем клієнта, знаходиться блок **бізнес-статусу**.

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

Як призначити статус:

1. Натисніть на поточний статус
2. Відкриється список доступних статусів
3. Оберіть потрібний

Також у списку доступна дія:

```
Очистити статус
```

Після цього статус буде видалений з діалогу.

***

## Швидкий перехід між етапами

Якщо статуси мають задану черговість (**поле «Сортування»**), у чаті доступна кнопка **«Далі»**.

Натискання на кнопку:

```
Далі →
```

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

автоматично переводить діалог на **наступний статус у послідовності**.

Це дозволяє менеджерам швидко проходити етапи роботи з клієнтом.

***

## Відображення статусів

#### У списку діалогів

Статус відображається у списку чатів під останнім повідомленням клієнта.

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

Це дозволяє швидко бачити:

* на якому етапі знаходиться діалог
* які діалоги потребують дій менеджера

***

#### У шапці діалогу

Поточний статус відображається у верхній частині чату поруч з іменем клієнта.

***

#### У системних повідомленнях

Коли менеджер змінює статус, у чаті з'являється системне повідомлення:

```
Менеджер змінив статус діалогу на "Новий лід"
```

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

При наведенні на повідомлення відображається **час зміни статусу**.

***

## Якщо статуси не налаштовані

У нових компаніях після активації функції статуси можуть бути відсутні.

У цьому випадку у чаті відображається повідомлення:

```
Статусів немає
```

та кнопка переходу:

```
Додати статус у налаштуваннях
```

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

Натискання відкриває сторінку **налаштування статусів діалогів**.

***

## Рекомендації щодо використання

Рекомендуємо використовувати **5–10 статусів**, щоб зберегти простоту роботи.

Також зручно додавати **emoji перед назвою статусу**, наприклад:

* 🔥 Новий лід
* 💬 Консультація
* ⏳ Очікуємо відповідь
* 📦 Замовлення оформлено
* ✅ Закрито

Emoji значно покращують читабельність у списку діалогів.

***

## Часті питання

#### Скільки статусів можна створити?

Кількість статусів **не обмежена**, але рекомендуємо використовувати не більше 7–10.

***

#### Що станеться, якщо видалити статус?

Статус буде автоматично прибраний з усіх діалогів, де він був встановлений.\
Історія повідомлень при цьому **не змінюється**.

***

#### Чи бачать статуси всі менеджери?

Так. Бізнес-статуси є **спільними для всієї компанії**.

Будь-який менеджер, який має доступ до діалогу, може змінити статус.

***

#### Чи можна використовувати статуси для автоматизації?

Наразі бізнес-статуси використовуються для:

* класифікації діалогів
* фільтрації чатів
* відстеження етапів роботи

Інтеграція зі статистикою та автоматизацією планується у наступних версіях


# Очищення кешу в браузері

Якщо після виходу оновлень на сервісі **#jedidesk** у вас не з'явився новий функціонал, або після виправлення багу проблема залишилася на вашому аккаунті, рекомендовано очистити кеш браузера, з якого ви використовуєте платформу.

***

#### Навігація:

1. [Google Chrome](#id-1.-google-chrome)
2. [Microsoft Edge](#id-2.-microsoft-edge)
3. [Mozilla Firefox](#id-3.-mozilla-firefox)
4. [Opera](#id-4.-opera)
5. [Safari](#id-5.-safari)

***

Якщо після очищення кешу проблема не зникла, будь ласка, зверніться в відділ технічної підтримки через зручний для вас канал зв'язку, вказаний на сайті [https://jedidesk.com](https://jedidesk.com/) або до вашого персонального jedi-менеджера.

***

#### 1. Google Chrome

Відкрийте браузер, натисність н&#x430;**︙**(три точки) в правому верхньому кутку та оберіть **Очистити дані веб-перегляду**.

Або скориcтайтеся комбінацією клавіш **Ctrl + Shift + Del**.

Поставте ✅ тільки на **Кешовані зображення та файли** та натисніть <mark style="background-color:blue;">**Видалити дані**</mark>.

***

#### 2. Microsoft Edge

Відкрийте браузер, натисність на **…** (три точки) в правому верхньому кутку та оберіть\
⚙️ **Параметри** **->** **Конфіденційність, пошук і служби -> Видалити дані про перегляд веб-сторінок ->** натисність на кнопку **Вибрати елементи для видалення**.

Або скориcтайтеся комбінацією клавіш **Ctrl + Shift + Del**.

Поставте ✅ тільки на **Кешовані зображення та файли** та натисніть <mark style="background-color:blue;">**Видалити зараз**</mark>.

***

#### 3. Mozilla Firefox

Відкрийте браузер, натисність на **☰** в правому верхньому кутку та оберіть\
**Налаштування -> Приватність та безпека ->** прокрутіть сторінку до **Куки та дані сайтів**, натисніть на кнопку **Видалили дані**.

Або скориcтайтеся комбінацією клавіш **Ctrl + Shift + Del**.

Поставте ✅ тільки на **Кеш веб-вмісту** та натисніть <mark style="background-color:blue;">**Видалити**</mark>.

***

#### 4. Opera

Відкрийте браузер, натисність на 🕓 в лівому нижньому кутку та оберіть **Очистити історію відвідувань**.

Або скориcтайтеся комбінацією клавіш **Ctrl + Shift + Del**.

Поставте ✅ тільки на **Кешовані зображення та файли** та натисніть <mark style="background-color:blue;">**Видалити дані**</mark>.

***

#### 5. Safari

Відкрийте браузер, у верхньому лівому кутку натисніть на \
**Safari -> Налаштування -> Конфіденційність -> Управління даними веб-сайту**.

Або скориcтайтеся комбінацією клавіш **Ctrl + Alt + E** (Control + Option + E).

Виберіть веб-сайт jedidesk зі списку та натисніть <mark style="background-color:purple;">**Видалити**</mark>.&#x20;

Щоб видалити всі дані веб-сайтів Safari, натисніть <mark style="background-color:purple;">**Видалити все**</mark>.


# Двофакторна автентифікація (2FA)

Двофакторна автентифікація (2FA) — це додатковий рівень захисту акаунту.

Після введення email та пароля система надсилає **одноразовий 6-значний код підтвердження** на електронну пошту користувача. Для завершення входу потрібно ввести цей код.

Навіть якщо пароль буде скомпрометований, зловмисник не зможе отримати доступ до акаунту без доступу до електронної пошти користувача.

***

## Налаштування 2FA

У JediDesk двофакторну автентифікацію можна увімкнути:

* для **всієї компанії**
* для **окремого менеджера**

***

## Увімкнення 2FA для всієї компанії

**Хто може увімкнути:** власник компанії.

**Де знаходиться:**

```
Налаштування → Компанія → Загальне
```

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

#### Як увімкнути

1. Перейдіть у **Налаштування → Компанія**
2. У блоці **Загальне** знайдіть перемикач\
   **"Увімкнути 2FA для всіх менеджерів компанії"**
3. Активуйте перемикач
4. Натисніть **Зберегти зміни**

#### Що відбувається після увімкнення

* 2FA стає **обов'язковою для всіх менеджерів**
* менеджери **не можуть вимкнути її у своєму профілі**
* при кожному вході система вимагатиме **код підтвердження**

***

## Увімкнення 2FA для особистого акаунту

Кожен менеджер може самостійно увімкнути 2FA для свого акаунту.

**Де знаходиться:**

```
Налаштування → Профіль
```

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

#### Як увімкнути

1. Перейдіть у **Налаштування → Профіль**
2. Знайдіть блок **Двофакторна автентифікація (2FA)**
3. Увімкніть перемикач\
   **"Увімкнути 2FA для мого акаунту"**
4. Натисніть **Зберегти зміни**

#### Важливо

Якщо 2FA вже увімкнена на рівні компанії, менеджер **не зможе вимкнути її для свого акаунту**.

***

## Процес входу з 2FA

1. Користувач вводить **email та пароль**
2. Система надсилає **одноразовий код підтвердження на email**
3. Відкривається сторінка **введення коду**
4. Користувач вводить код
5. Якщо код правильний — **вхід виконано**

Код підтвердження **діє 10 хвилин**.

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

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

***

## Часті питання

#### Користувач не отримав код

Перевірте:

* папку **Спам**
* правильність email у профілі
* чи не минуло **10 хвилин** з моменту відправлення

Для отримання нового коду потрібно **повторити вхід**.

***

#### Чому менеджер не може вимкнути 2FA

Якщо 2FA увімкнена у налаштуваннях компанії, вона стає **обов'язковою для всіх менеджерів** і не може бути вимкнена на рівні окремого акаунту.

***

## Технічні деталі

* код підтвердження: **6 цифр**
* час дії коду: **10 хвилин**
* код надсилається на **email користувача**
* сесія створюється **після підтвердження коду**


# API-інтеграція JediDesk

Підключіть JediDesk до вашої системи через REST API та отримуйте події в реальному часі через Webhooks.

***

### Для чого потрібна API-інтеграція

API дозволяє вашій системі (сайту, CRM, ERP, мобільному додатку) автоматично взаємодіяти з JediDesk:

* Синхронізація клієнтів — передача даних між системами
* Управління замовленнями — створення, оновлення та відстеження
* Робота з діалогами — створення чатів і відправка повідомлень
* AI-запити — використання AI JediDesk у вашому продукті
* Оновлення каталогу — масове оновлення цін і наявності
* Реакція на події — отримання сповіщень через Webhooks

***

### Як підключити API

1. Перейдіть у розділ Інтеграції → API в кабінеті JediDesk
2. Натисніть «Згенерувати API-токен»
3. Скопіюйте токен — він використовується для всіх запитів

***

### Аутентифікація

Кожен API-запит повинен містити заголовок:

```
Authorization: Bearer ВАШ_ТОКЕН
```

Якщо токен відсутній або неправильний — API поверне помилку 401 Unauthorized.

***

### Базова інформація

Base URL:

```
https://app.jedidesk.com/api/v1
```

***

### Основні можливості API

**Клієнти**\
Отримання, пошук і оновлення даних (телефон, email, теги, кастомні поля)

**Замовлення**\
Створення, оновлення та видалення замовлень

**Діалоги**\
Перегляд, створення та отримання історії чатів

**Повідомлення**\
Відправка повідомлень у діалоги

**AI**\
Запити до AI-асистента на основі бази знань

**Товари**\
Масове оновлення цін і залишків

Документація:\
<https://documenter.getpostman.com/view/8460280/2sAYkLoJ2S>

***

### Webhooks

Webhooks — це автоматичні HTTP-сповіщення про події.

***

#### Як налаштувати Webhook

1. Перейдіть у Інтеграції → API
2. У блоці Webhooks натисніть «Додати webhook»
3. Вкажіть URL вашого сервера
4. Оберіть події
5. Збережіть

Можна створювати кілька webhook-ів для різних задач.

***

### Події Webhook

#### Клієнти

customer.created — створено нового клієнта\
customer.updated — оновлено дані клієнта\
customer.deleted — клієнта видалено

***

#### Діалоги

chat.created — створено діалог\
chat.updated — оновлено діалог\
chat.deleted — діалог видалено

***

#### Повідомлення

message.created — нове повідомлення\
message.updated — повідомлення змінено\
message.deleted — повідомлення видалено

***

#### AI

ai.func\_call — AI викликав функцію

***

### Формат Webhook-запиту

JediDesk надсилає POST-запит з JSON:

```
{
  "event": "message.created",
  "data": {},
  "timestamp": "2024-03-15T10:00:00Z",
  "token": "ваш_api_токен",
  "request_id": "унікальний_id"
}
```

***

### Логування

Усі webhook-запити зберігаються в логах:

* подія
* тіло запиту
* статус відповіді
* відповідь сервера

Доступно в розділі Інтеграції → API.

***

### Типові сценарії використання

Інтернет-магазин\
Передача замовлень у JediDesk та автоматичні повідомлення клієнтам

CRM-система\
Синхронізація клієнтів і створення лідів через webhook

Мобільний додаток\
Інтеграція AI-асистента у чат додатку

Автоматизація\
Використання ai.func\_call для запуску бізнес-логіки


# Панель надходженя звернень

[Модуль LiveChat](https://app.jedidesk.com/chat?_gl=1*t8hb7u*_gcl_au*MTY1Mzc0NDc2LjE3NzIwMTUyNjY.*_ga*MTg4ODI4MzM1Ny4xNzYzMTE0OTU2*_ga_CDMNDJ2B1P*czE3NzMxNDc4ODkkbzMyMiRnMSR0MTc3MzE0OTE2MCRqNTkkbDAkaDA.) виглядає наступним чином:

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

Ви бачите діалоги з позначкою месенджерів, віджета та AI у трьох папках:

<mark style="color:purple;">**Нові**</mark> - нові (неприйняті) чати, які потребують опрацювання.

<mark style="color:$success;">**Активні**</mark> - прийняті менеджером чати, які опрацьовуються зараз.

<mark style="color:$info;">**Архівні**</mark> - закриті, опрацьовані чати, або деактивовані через відсутність відповіді зі сторони клієнта.

Є можливість налаштувати[ розподілення чатів між менеджерами](https://docs.jedidesk.com/nalashtuvannya-jedidesk/nalashtuvannya-rozpodilennya-dialogiv-mizh-menedzherami) та їх зміни, що дуже корисно при великій кількості звернень.


# Фільтр чатів

Чати фільтруються за наступними показниками: \
\- Платформи (Viber, Telegram, Instagam, Messenger, Widget, Email, Telegram Business, Whatsapp) - Теми діалогу (Налаштовується: Автоматизація -> Теми діалогу) \
\- Початок діалогу (За весь час, Сьогодні, Вчора, Останні 7 днів, Останні 30 днів, **Вказати період**)&#x20;

\- Чати&#x20;

\- Менеджери (Налаштовується: Налаштування-> Менеджери)

<figure><img src="/files/wXnfLP0f9ZVxyqwUNlQs" alt=""><figcaption><p>Фільтри чатів</p></figcaption></figure>

<br>


# Картка інформації про користувача

При зверненні кожен клієнт додається в систему, ви маєте можливість переглядати та частково редагувати його інформацію:

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

* **Фото** клієнта
* **Канал звернення**
* **Ім'я**
* **username -** при зверненні через Telegram або Instagram боти
* **email** - вказується[ менеджером](https://docs.jedidesk.com/nalashtuvannya-jedidesk/yak-dodati-menedzhera-operatora) власноруч
* **Телефон -** вказується менеджером власноруч
* [**Додаткове поле**](https://docs.jedidesk.com/nalashtuvannya-jedidesk/dodatkovi-polya-v-kartochci-kliyenta) для необхідної інформації (наприклад ID на сервісі тощо)
* **Мова клієнта** - ідентифікується мовою застосунка або браузера клієнта. Мову можна змінити власноруч, від неї залежить мова системних повідомлень в чаті.
* **Менеджер** - автоматично вказується менеджер, який прийняв запит. Супервайзер може змінювати менеджера.
* **Нотатки**
* [**Теми діалогу**](https://docs.jedidesk.com/nalashtuvannya-jedidesk/nalashtuvannya-temi-dialogu) - вказується менеджером для аналітики за необхідності
* **Тег -** вказується менеджером для групування клієнтів при розсилці тощо
* **Блокування клієнта**

<br>


# Швидкі відповіді

Менеджер натискає на кнопку **Відповісти на діалог**, далі або власноруч вводить повідомлення, або обирає [швидку відповідь](https://docs.jedidesk.com/nalashtuvannya-jedidesk/yak-stvoriti-shvidki-vidpovidi):<br>

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


# Редагування повідомлення

**При натисканні на ⋮ ви маєте змогу редагувати, видаляти повідомлення:**

<figure><img src="/files/1au1KGMWqwPIUQT2Pec1" alt=""><figcaption></figcaption></figure>

Також є можливість [генерувати відповіді через MagicButton](https://docs.jedidesk.com/nalashtuvannya-jedidesk-ai/nalashtuvannya-magic-button-dlya-jedidesk-ai) замість самостійного вводу або [налаштувати штучний інтелект JediDesk AI](https://docs.jedidesk.com/nalashtuvannya-jedidesk-ai/yak-nalashtuvati-ai-asistentiv-jedidesk), який буде самостійно опрацьовувати запити клієнтів замість менеджерів.


# Відкладені повідомлення

Буває, що під час спілкування з клієнтом розумієш: треба буде нагадати про себе через день, тиждень чи в конкретну дату.
\
Для цього існує функція "Відкладені повідомлення"
\
Створити його ви можете, натиснувши на відповідну кнопку у чаті.<br>

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

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

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

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

<br>

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

Надіславши повідомлення, ви побачите його у чаті, ви сможете [його редагувати,](/redaguvannya-povidomlennya) як і звичайні повідомлення, натиснувши на кнопку \[ **⋮** ]

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


# Копіювати ІD-чату у вікні діалогу

У діалозі є кнопка: Скопіювати ID діалогу. Це дає можливість отримати посилання не виходячі із інтерфейсу LiveChat

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


# Відображення часу та дати у вигляді тултіп для дій з діалогом

Навівши на системне повідомлення у діалозі про взаємодію, можна отримати тултіп з датою та часом коли ця дія була відтворена

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


# Бізнес-статуси діалогів

**Бізнес-статуси діалогів** — це користувацькі мітки, які менеджери можуть призначати чатам у LiveChat для відображення етапу роботи з клієнтом.

На відміну від **системних статусів діалогу** (Новий / Активний / Архівний), бізнес-статуси створюються компанією самостійно та відображають внутрішні процеси роботи.

Наприклад:

* 🔥 Новий лід
* 💬 Консультація
* ⏳ Очікуємо відповідь клієнта
* 📦 Оформлення замовлення
* ✅ Закрито

Це дозволяє менеджерам швидко розуміти **поточний етап роботи з клієнтом** і зручно фільтрувати діалоги.

***

### Доступність за тарифами <a href="#dostupnist-za-tarifami" id="dostupnist-za-tarifami"></a>

| Тариф | Доступ       |
| ----- | ------------ |
| START | ❌ Недоступно |
| PRO   | ✅ Доступно   |
| PRO+  | ✅ Доступно   |

Якщо тариф не підтримує функцію, пункт **«Статуси діалогів»** у меню налаштувань не відображається.

***

### Налаштування статусів <a href="#nalashtuvannya-statusiv" id="nalashtuvannya-statusiv"></a>

**Шлях:**

```
Автоматизація → Статуси діалогів
```

<figure><img src="/files/9wpieK9NKgatX3R4OTXj" alt=""><figcaption></figcaption></figure>

На сторінці налаштувань можна:

* створювати нові статуси
* редагувати існуючі
* змінювати порядок сортування
* вимикати або видаляти статуси

Кожен статус має такі параметри:

| Поле       | Опис                   |
| ---------- | ---------------------- |
| Назва      | Назва статусу          |
| Статус     | Активний або вимкнений |
| Сортування | Порядок відображення   |

⚠️ **Поле «Сортування» визначає логічну послідовність етапів.** Саме на основі цього порядку працює кнопка **«Далі»** у чаті.

### Призначення статусу у чаті <a href="#priznachennya-statusu-u-chati" id="priznachennya-statusu-u-chati"></a>

Відкрийте будь-який діалог у LiveChat.

У верхній частині чату, поруч з іменем клієнта, знаходиться блок **бізнес-статусу**.

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

Як призначити статус:

1. Натисніть на поточний статус
2. Відкриється список доступних статусів
3. Оберіть потрібний

Також у списку доступна дія:

```
Очистити статус
```

Після цього статус буде видалений з діалогу.

***

### Швидкий перехід між етапами <a href="#shvidkii-perekhid-mizh-etapami" id="shvidkii-perekhid-mizh-etapami"></a>

Якщо статуси мають задану черговість (**поле «Сортування»**), у чаті доступна кнопка **«Далі»**.

Натискання на кнопку:

```
Далі →
```

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

автоматично переводить діалог на **наступний статус у послідовності**.

Це дозволяє менеджерам швидко проходити етапи роботи з клієнтом.

***

### Відображення статусів <a href="#vidobrazhennya-statusiv" id="vidobrazhennya-statusiv"></a>

**У списку діалогів**

Статус відображається у списку чатів під останнім повідомленням клієнта.

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

Це дозволяє швидко бачити:

* на якому етапі знаходиться діалог
* які діалоги потребують дій менеджера

***

**У шапці діалогу**

Поточний статус відображається у верхній частині чату поруч з іменем клієнта.

***

**У системних повідомленнях**

Коли менеджер змінює статус, у чаті з'являється системне повідомлення:

```
Менеджер змінив статус діалогу на "Новий лід"
```

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

При наведенні на повідомлення відображається **час зміни статусу**.

***

### Якщо статуси не налаштовані <a href="#yaksho-statusi-ne-nalashtovani" id="yaksho-statusi-ne-nalashtovani"></a>

У нових компаніях після активації функції статуси можуть бути відсутні.

У цьому випадку у чаті відображається повідомлення:

```
Статусів немає
```

та кнопка переходу:

```
Додати статус у налаштуваннях
```

<figure><img src="/files/99TRllz0SLYxw4I68pUE" alt=""><figcaption></figcaption></figure>

Натискання відкриває сторінку **налаштування статусів діалогів**.<br>

***

#### Рекомендації щодо використання

Рекомендуємо використовувати **5–10 статусів**, щоб зберегти простоту роботи.

Також зручно додавати **emoji перед назвою статусу**, наприклад:

* 🔥 Новий лід
* 💬 Консультація
* ⏳ Очікуємо відповідь
* 📦 Замовлення оформлено
* ✅ Закрито

Emoji значно покращують читабельність у списку діалогів.

***

### Часті питання <a href="#chasti-pitannya-1" id="chasti-pitannya-1"></a>

**Скільки статусів можна створити?**

Кількість статусів **не обмежена**, але рекомендуємо використовувати не більше 7–10.

***

**Що станеться, якщо видалити статус?**

Статус буде автоматично прибраний з усіх діалогів, де він був встановлений. Історія повідомлень при цьому **не змінюється**.

***

**Чи бачать статуси всі менеджери?**

Так. Бізнес-статуси є **спільними для всієї компанії**.

Будь-який менеджер, який має доступ до діалогу, може змінити статус.

***

**Чи можна використовувати статуси для автоматизації?**

Наразі бізнес-статуси використовуються для:

* класифікації діалогів
* фільтрації чатів
* відстеження етапів роботи

Інтеграція зі статистикою та автоматизацією планується у наступних версіях


# Як створити чат #jedidesk

Сервіс #jedidesk пропонує дуже легке створення та налаштування свого віджету

#### **Навігація:**

1. [Налаштування мови та тексту](#id-1.-nalashtuvannya-movi-ta-tekstu)
2. [Налаштування міні-віджета](#id-2.-nalashtuvannya-mini-vidzheta)
3. [Згенерований код віджета](#id-3.-zgenerovanii-kod-vidzheta)
4. [Анімація набору повідомлень](#id-4.-animaciya-naboru-povidomlen)
5. [Відео-інструкція](#id-5.-video-instrukciya)

***

#### **1. Налаштування мови та тексту**

Відкрийте **Налаштування** **->** **Інтеграції** **->** [**Налаштування віджету**](https://app.jedidesk.com/settings-widget).

Кожна мова<mark style="color:red;">\*</mark> віджета налаштовується окремо. Натисніть на кнопку <mark style="background-color:blue;">**Виберіть мову**</mark>, та виберіть, наприклад, українську. \
Заповніть шаблони віджета та натисніть <mark style="background-color:blue;">**Зберегти**</mark>:

<figure><img src="/files/39NlCM8zoIVSSwAqFtA8" alt=""><figcaption><p>Список мов віджета за замовчуванням</p></figcaption></figure>

<figure><img src="/files/Bzb0LP4WbKGv3Oi4T75D" alt=""><figcaption><p>Налаштування віджета</p></figcaption></figure>

***

Якщо ви бажаєте скинути свої налаштування, натисніть <mark style="background-color:blue;">**Налаштування за замовчуванням**</mark>.

За замовчуванням для віджета доступно 3 мови: англійська, українська, російська, але ви завжди можете додати більше мов через кнопку <mark style="background-color:blue;">**Додати нову мову**</mark>:

<figure><img src="/files/Y5N54LyjwmhlvjBHC6z6" alt=""><figcaption><p>Додаткові мови для віджета</p></figcaption></figure>

***

Щоб обрана мова працювала в віджеті, активуйте її через перемикач:

<figure><img src="/files/AE58Vm6CWLIPM9u7Ope9" alt=""><figcaption><p>Активація обраної мови в віджеті</p></figcaption></figure>

***

Якщо вимкнути прийняття звернень через віджет, він буде працювати лише як редірект в підключені чат-боти, тому клієнти не зможуть звертатися через чат:

<figure><img src="/files/p6TdvMBGOcymlXbqzK2G" alt=""><figcaption><p>Активація віджета як чату</p></figcaption></figure>

{% hint style="danger" %} <mark style="color:red;">**Увага!**</mark> У тому випадку, коли віджет налаштований на кілька мов, мова віджету залежить від мови браузера клієнта, а не від мови веб-ресурсу, на якому розміщено віджет. Наприклад, якщо браузер налаштований на українську мову, клієнт буде бачити віджет на українській мові.
{% endhint %}

***

#### **2. Налаштування міні-віджета**

Окрім розгорнутого віджета, можна налаштувати міні-віджет:<br>

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

***

#### **3.** Налаштування положення міні-віджета

У налаштуваннях зовнішнього вигляду віджета з’явилась можливість змінювати положення міні-віджета на сайті. Це допоможе розмістити іконку вище, нижче або змістити її вбік, якщо вона перекриває важливі елементи сайту.

**Вибір сторони відображення**

Спочатку оберіть, з якого боку сайту буде відображатися віджет:

* Ліворуч
* Праворуч

Якщо обрано положення ліворуч, боковий відступ буде рахуватися від лівого краю сайту. Якщо обрано праворуч — від правого краю сайту.

**Налаштування відступів для десктопа**

Для десктопної версії сайту можна налаштувати положення міні-іконки за допомогою відступів у пікселях.

**Desktop: відступ іконки знизу, px**\
Визначає, на скільки пікселів міні-віджет буде піднятий від нижнього краю екрана.

**Desktop: відступ іконки збоку, px**\
Визначає відступ міні-віджета від лівого або правого краю сайту, залежно від обраної сторони відображення.

**Пріоритет відображення іконки**\
Відповідає за те, як міні-віджет буде відображатися поверх інших елементів сайту. Якщо на сайті є інші плаваючі кнопки або блоки, які перекривають віджет, можна збільшити це значення.

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

**Окремі налаштування для мобільних**

Якщо потрібно, щоб на смартфонах міні-віджет мав інше положення, увімкніть перемикач **Окремі налаштування для мобільних**.

Після увімкнення можна окремо задати положення міні-віджета для мобільної версії сайту. Це зручно, якщо на мобільному екрані іконка перекриває кнопки, меню, кошик або інші важливі елементи.<br>

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

**Розширені CSS-правки**

Для більш гнучкого налаштування доступний розділ **Розширені CSS-правки**. За замовчуванням це поле приховане. Щоб відкрити його, натисніть на назву розділу.

Цей розділ призначений для додаткового налаштування зовнішнього вигляду віджета через власні CSS-правила. Його варто використовувати лише тим користувачам або розробникам, які розуміють, як працюють CSS-стилі.

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

#### 4. Згенерований код віджета

Після налаштування віджета, натисніть <mark style="background-color:blue;">**Зберегти**</mark> та скопіюйте згенерований код віджета для додавання на ваш веб-ресурс:

<figure><img src="/files/rUHcNQ1shlJQkn1KVq8f" alt=""><figcaption><p>Отримання згенерованого коду віджета</p></figcaption></figure>

***

#### 5. Анімація набору повідомлень

Коли ваш клієнт пише повідомлення у чаті через віджет, ви будете бачити це повідомлення та зможете заздалегідь підготуватися до відповіді:

<figure><img src="/files/VP93tSwZvIevgpdDl5Sm" alt=""><figcaption><p>Клієнт пише повідомлення в реальному часі</p></figcaption></figure>

<figure><img src="/files/Fgym2hk4va27HbSjwemz" alt=""><figcaption><p>Клієнт надіслав повідомлення</p></figcaption></figure>

***

Клієнт також буде бачити, що ви йому пишете, але не буде бачити текст:

<div><figure><img src="/files/pp9YZ7ki3xYKnd2q5uml" alt=""><figcaption><p>Менеджер пише повідомлення</p></figcaption></figure> <figure><img src="/files/nVYIj13IpPQs2PWBgzUw" alt=""><figcaption><p>Менеджер надіслав повідомлення</p></figcaption></figure></div>

***

#### 6. Відео-інструкція

{% embed url="<https://www.youtube.com/watch?v=cqGE3uflAkY>" %}
Відео-інструкція зі створення віджета #jedidesk
{% endembed %}


# Додати чат на сайт

Це загальна інструкція, підходить для будь-яких сайтів, якщо у Вас є доступ до сайту по FTP або іншими методами.

{% hint style="info" %}

#### Попередньо обовʼязково

[Авторизуйтесь](/znaiomstvo/reyestraciya-v-sistemi) в #jedidesk та дотримуйтесь [інструкції з налаштування віджету](/vidzhet/yak-stvoriti-chat-jedidesk) та створення чат-ботів на платформах [Viber](broken://pages/rPRLaBpvtNQl9hNAMI4h) та [Telegram](broken://pages/LvOWGP6gjPktiw0h0jzd).
{% endhint %}

Це загальна інструкція, здебільшого, вона підходить тим, хто розробляє сайт самостійно або у вас індивідуальна розробка. Якщо ви програміст або верстальник для вас тут не буде нічого складного. Якщо ви не програміст - надішліть просту інструкцію вашому майстру 🧑‍💻

Вставте код віджету перед закриваючим тегом **\</body>** на усіх сторінках, де ви хочете щоб був віджет.

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

Якщо у Вас **CMS —** перегляньте наші інструкції для встановлення віджету в наступних розділах:

👉🏻 [Встановлення чату #jedidesk на WordPress](https://docs.jedidesk.com/vidzhet/dodati-chat-na-sait/vstanovlennya-chatu-jedidesk-na-wordpress)

👉🏻 [Встановлення чату #jedidesk на Weblium](https://docs.jedidesk.com/vidzhet/dodati-chat-na-sait/vstanovlennya-chatu-jedidesk-na-weblium)

👉🏻 [Встановлення чату #jedidesk на Хорошоп](https://docs.jedidesk.com/vidzhet/dodati-chat-na-sait/vstanovlennya-chatu-jedidesk-na-khoroshop)


# Встановлення чату #jedidesk на Хорошоп

Хорошоп — це сучасна українська платформа та сукупність послуг із запуску інтернет-магазинів

{% embed url="<https://www.loom.com/share/360fbd15c6ac4ad0b5e38e28dd5a0cb2>" %}

1. [**Створіть віджет #jedidesk**](/vidzhet/yak-stvoriti-chat-jedidesk) та скопіюйте згенерований код.
2. Авторизуйтесь в системі [**Хорошоп**](https://horoshop.ua/ua/).
3. Оберіть розділ **Налаштування** –> **Загальні налаштування** –> **Скрипти**, вставте код віджету **#jedidesk** перед тегом <mark style="color:red;">**\<body>**</mark> та натисніть <mark style="background-color:blue;">**Зберегти**</mark>:

<figure><img src="/files/Dh7JPB7gEOUXiKRZ2Xjy" alt=""><figcaption><p>Встановлення чату #jedidesk на Хорошоп</p></figcaption></figure>


# Встановлення чату #jedidesk на CS CART

CS-Cart – це платформа для створення та керування інтернет-магазинами з безліччю функцій для електронної комерції, включаючи керування товарами, замовленнями та інтеграцією з платіжними системами.

1. [**Створіть віджет #jedidesk**](/vidzhet/yak-stvoriti-chat-jedidesk) та скопіюйте згенерований код.
2. Авторизуйтесь в системі [**CS-Cart**](https://www.cs-cart.com/).
3. У верхньому меню перейдіть в **Дизайн -> Макети**.&#x20;
4. Виберіть унизу **Підвал (footer)** і в секції натисніть ➕, щоб додати **Блок**.
5. Додайте блок до секції, виберіть **Зворотній дзвінок/HTML**.
6. Після додавання натисніть на ⚙️, щоб перейти до параметрів блоку.
7. Коли відкриється редагування блоку, перейдіть на **Сторінки**, очистіть поле введення, вставте скопійований віджет #jedidesk та натисніть кнопку **Зберегти**.


# Встановлення чату #jedidesk на Jimdo

Jimdo – це зручний конструктор сайтів, що дозволяє швидко створювати та редагувати сайти з використанням шаблонів та простого інтерфейсу, без потреби у програмуванні.

1. [**Створіть віджет #jedidesk**](/vidzhet/yak-stvoriti-chat-jedidesk) та скопіюйте згенерований код.
2. Авторизуйтесь в системі [**Jimdo**](https://www.jimdo.com/).
3. Виберіть свій сайт та натисніть **Редагувати** , щоб увійти в режим редагування веб-сайту Jimdo Creator.&#x20;
4. Наведіть курсор на область вмісту та натисніть **Додати елемент -> Додаткові елементи та надбудови -> Віджет/елемент HTML**.
5. Вставте код у **Віджет/ елемент HTML** та натисніть **Зберегти**.&#x20;
6. Перезапустіть браузер, якщо віджет відображається неправильно.


# Встановлення чату #jedidesk на Magento

Magento CMS - відомий двигун для електронної комерції, який дозволяє створювати великі інтернет-магазини з різноманітним додатковим функціоналом.

1. ​[**Створіть віджет #jedidesk**](/vidzhet/yak-stvoriti-chat-jedidesk) та скопіюйте згенерований код.
2. Авторизуйтесь в системі [**Magento**](https://account.magento.com/customer/account/login).
3. Оберіть розділ **Система**, та знайдіть у списку вкладку **Конфігурація**:

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

4. В налаштуваннях **Конфігурації** необхідно вибрати вкладку **Дизайн***:*

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

5. Знаходимо блок **Футер** та вставляємо скопійований **код віджету #jedidesk** в поле **Различный HTML**:

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

6. Зберігаємо налаштування, натиснувши **Сохранить конфигурацию**.


# Встановлення чату #jedidesk на MODX

MODX - безкоштовна система управління контентом і фреймворк для веб-додатків. Його метою є забезпечення ефективного та організованого процесу створення, редагування та управління змістом сайтів.

1. ​[**Створіть віджет #jedidesk**](/vidzhet/yak-stvoriti-chat-jedidesk) та скопіюйте згенерований код.
2. Авторизуйтесь в системі [**MODX**](https://modx.com/).
3. Зліва на панелі в розділі **Элементы** оберіть блок **Шаблоны → Базовый шаблон**:

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

4. В налаштуваннях шаблону вставляємо **код віджету #jedisesk** перед <mark style="color:red;">**\</body> (1)**</mark> та зберігаємо, натиснувши кнопку **Сохранить&#x20;**<mark style="color:red;">**(2)**</mark>:

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


# Встановлення чату #jedidesk на OPENCART

OpenCart є безкоштовним інструментом для створення комерційних сайтів. Основна перевага полягає в тому, що будь-хто може завантажити цей двигун і легко створити свій інтернет-магазин.

1. [**Створіть віджет #jedidesk**](/vidzhet/yak-stvoriti-chat-jedidesk) та скопіюйте згенерований код.
2. Авторизуйтесь в системі [**OpenCart**](https://opencart.ua/).

{% hint style="info" %}
Код віджета #jedidesk відповідає тим же вимогам до розміщення, що й код Google Analytics. Тому його можна розмістити в цей блок як окремо, так і разом з кодом Google. Це не викликає конфлікту та порушення роботи сайту.
{% endhint %}

3. Перейдіть в **Администрирование → Модули и расширения** та виберіть тип розширення **Аналитика**.\
   \
   Встановіть **Google Analitycs** та праворуч натисніть кнопку **Редактировать**:

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

4. Вставте код вашого віджету #jedidesk, оберіть статус **Включено** та збережіть налаштування:

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

***

**Також можна вставити код через FTP, для цього потрібно:**

1. Необхідно зайти на хостинг вашого сайту, або підключитися до хостингу через FTP-клієнт і пройти до директорії: ***головна\_папка/themes/назва вашого шаблону/footer.tpl*** :

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

2. Відкрити в режимі редактора файл **footer.tpl** і вставити код віджета #jedisesk перед тегом, що закривається <mark style="color:red;">**\</body>**</mark> та зберегти зміни:

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

3. У деяких шаблонах файл footer.tpl не підключається до кожної сторінки, тоді доречно використовувати файл **header.tpl** з директорії: ***головна папка/themes/назва вашого шаблону/header.tpl***\
   \
   У ньому необхідно вставити код віджету #jedidesk перед закриваючим тегом <mark style="color:red;">**\</head>**</mark> та зберегти зміни.


# Встановлення чату #jedidesk на PrestaShop

PrestaShop є відкритим програмним забезпеченням для швидкого створення інтернет-магазину. З цією програмою користувач може налаштувати свій магазин як на хмарному сховищі, так і на власному хостингу.

1. [**Створіть віджет #jedidesk**](/vidzhet/yak-stvoriti-chat-jedidesk) та скопіюйте згенерований код.
2. Авторизуйтесь в системі [**PrestaShop**](https://prestashop.com/).

***

#### Варіант №1. ВСТАНОВЛЕННЯ КОДУ ЧЕРЕЗ FTP:

1. Необхідно зайти на хостинг вашого сайту, або підключитися до хостингу через FTP-клієнт і пройти до директорії: ***головна\_папка/themes/назва вашого шаблону/footer.tpl*** :

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

2. Відкрити в режимі редактора файл **footer.tpl** і вставити код віджета #jedisesk перед тегом, що закривається <mark style="color:red;">**\</body>**</mark> та зберегти зміни:

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

3. У деяких шаблонах файл footer.tpl не підключається до кожної сторінки, тоді доречно використовувати файл **header.tpl** з директорії: ***головна папка/themes/назва вашого шаблону/header.tpl***\
   \
   У ньому необхідно вставити код віджету #jedidesk перед закриваючим тегом <mark style="color:red;">**\</head>**</mark> та зберегти зміни.

***

#### **Варіант №2. ВСТАНОВЛЕННЯ КОДУ ЧЕРЕЗ МОДУЛЬ CONTENTBOX (АБО ІНШИЙ HTML-МОДУЛЬ)**

2. Необхідно попередньо завантажити модуль contentBox із сайту [http://contentbox.org](http://contentbox.org/):

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

2. Зайдіть в панель керування PrestaShop, в розлілі **Управление модулями** завантажуємо **модуль ContentBox**:

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

3. Після успішного завантаження модуля натисніть **Настроить**:

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

4. У вікні виберіть редактор **HTML → Edit HTML source** (поряд зі шрифтом) і вставте код свого віджету #jedidesk.\
   \
   Збережіть зміни натисканням на **Update (Save)***.*

{% hint style="info" %}
Якщо вікно не відкрилося автоматично, його можна викликати, натиснувши на кнопку *Configure* у списку модулів, у модулі *СontentBox.*
{% endhint %}


# Встановлення чату #jedidesk на Recommence

Recommence - це хмарний сервіс, який забезпечує можливість створення високоякісного інтернет-магазину та зручного керування ним з використанням інтуїтивно зрозумілої панелі керування.

1. [**Створіть віджет #jedidesk**](/vidzhet/yak-stvoriti-chat-jedidesk) та скопіюйте згенерований код.
2. Авторизуйтесь в системі [**Recommence**](https://recommerce.com.ua/).
3. Оберіть розділ **Настройки&#x20;**<mark style="color:red;">**(1)**</mark>**&#x20;→ Подключение внешних сервисов → Произвольный JavaScript и Html код** <mark style="color:red;">**(2)**</mark>, Натисніть кнопку **Добавить код**, заповніть блок <mark style="color:red;">**(3)**</mark>:

* **Название сервиса**: *JediDesk*
* **Расположение кода**: *Внизу всех страниц*
* **JavaScript или Html код**: *вставте код нашого віджету JediDesk*

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

Натисніть кнопку **Сохранить настройки&#x20;**<mark style="color:red;">**(4)**</mark>.


# Встановлення чату #jedidesk на SitePro

SitePro - це зручний конструктор для створення сайтів без програмування, що пропонує безліч шаблонів та інструментів для налаштування дизайну та функціоналу.

1. [**Створіть віджет #jedidesk**](/vidzhet/yak-stvoriti-chat-jedidesk) та скопіюйте згенерований код.
2. Авторизуйтесь в системі [**SitePro**](https://site.pro/uk/).
3. Вставте віджет одним з варіантів:

#### Варіант 1:

1. **Додавання HTML-коду**:&#x20;

* Перетягніть **Розширені функції** з головної панелі інструментів;&#x20;
* Виберіть **шаблон HTML**;&#x20;
* Виберіть значок **HTML коду ✏️** на правій панелі інструментів та вставте код;&#x20;
* Натисніть кнопку **Застосувати**;&#x20;
* Натисніть кнопку **Перегляд**, щоб переглянути зміни.&#x20;

2. **Налаштування HTML-коду:**&#x20;

* **Розмір**: \
  Відрегулюйте розмір HTML-коду або натисність **Дозволити автоналаштування розміру** на панелі інструментів праворуч.&#x20;

***

#### Варіант 2:&#x20;

**Додавання скрипту користувача:**&#x20;

1. Перейдіть до **Налаштування** (у верхній частині конструктора сайтів);
2. Перейдіть до **Сторінки** у пунктах меню та перейдіть на вкладку **Скрипти**;
3. Вставте свій код в одне з трьох доступних полів:&#x20;

* **Перед \</head>** — вставте код у кінець розділу сторінки/сайту  \<head>
* **Після \</body>** — вставте код на початок розділу сторінки/сайту \<body>
* **Перед \</body>**  — вставте код у кінець розділу сторінки/сайту  \<body>

4. Скрипт можна додати як для сайту (всі сторінки), так і для конкретної сторінки;&#x20;
5. Натисніть кнопку **Застосувати**.


# Встановлення чату #jedidesk на Strikingly

Strikingly - це простий конструктор сайтів, який дозволяє швидко створювати односторінкові сайти за допомогою зручного інтерфейсу та готових шаблонів без навичок програмування.

1. ​[**Створіть віджет #jedidesk**](/vidzhet/yak-stvoriti-chat-jedidesk) та скопіюйте згенерований код.
2. Авторизуйтесь в системі [**Strikingly**](https://www.strikingly.com/).
3. У редакторі вашого сайту натисніть **Додати новий розділ -> Додатково -> Вбудувати & HTML**:

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

4. Натисніть на новий доданий розділ і виберіть **HTML**:

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

5. Вставте код віджета у спеціальне поле та натисніть **Зберегти**:&#x20;

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

6. Опублікуйте свій веб-сайт.

Після встановлення коду ви можете побачити результат, перевіривши сайт через попередній перегляд або відвідавши діючий сайт. Майте на увазі, що код користувача не буде видно в редакторі сайту.


# Встановлення чату #jedidesk на WebFlow

Webflow — це потужний конструктор сайтів, що надає можливості візуального веб-дизайну та гнучкого керування кодом, що дозволяє створювати професійні сайти без програмування.

1. [**Створіть віджет #jedidesk**](/vidzhet/yak-stvoriti-chat-jedidesk) та скопіюйте згенерований код.
2. Авторизуйтесь в системі [**WebFlow**](https://webflow.com/).
3. Відкрийте панель ➕ **Додати Елементи** та додайте **Code Embed** на сторінку Webflow:

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

4. Вставте скопійований код віджета #jedidesk, натисність **Зберегти** та закрийте модальне вікно:

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


# Встановлення чату #jedidesk на Weblium

Weblium – конструктор сайтів, що пропонує динамічне редагування, що адаптується під мобільні пристрої шаблони веб-сайтів і платформу, яка дуже проста для початківців.

1. [**Створіть віджет #jedidesk**](/vidzhet/yak-stvoriti-chat-jedidesk) та скопіюйте згенерований код.
2. Авторизуйтесь в системі [**Weblium**](https://ua.weblium.com/).
3. Оберіть розділ **Налаштування сайту** –> **Інтеграції**:

<figure><img src="/files/XAUvXR2lUMBXP9BpQwJn" alt=""><figcaption><p>Weblium: Налаштування сайту</p></figcaption></figure>

4. Відкрийте вкладку **Сторонній код**, вставте код віджету #jedidesk в розділ <mark style="color:red;">**Before \</BODY>**</mark> та натисніть кнопку <mark style="background-color:blue;">**Зберегти**</mark>**:**

<figure><img src="/files/5NP9D0cldBFWhXkLoAbX" alt=""><figcaption><p>Встановлення чату #jedidesk на Weblium</p></figcaption></figure>


# Встановлення чату #jedidesk на Wix

Wix – це популярний конструктор сайтів, що дозволяє легко створювати та налаштовувати сайти за допомогою безлічі шаблонів та інструментів, без потреби у програмуванні.

1. [**Створіть віджет #jedidesk**](/vidzhet/yak-stvoriti-chat-jedidesk) та скопіюйте згенерований код.
2. Авторизуйтесь в системі [**Wix**](https://uk.wix.com/).
3. Натисніть **Додати елементи** ➕ **-> Вбудувати код ->** **Популярні вставки -> Вставити HTML** та вставте фрагмент коду, щоб відображати віджет на сторінках сайту та натисніть **Застосувати**.
4. Натисніть на вибрану вставку, щоб додати її на сайт.

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


# Встановлення чату #jedidesk на WordPress

Cистема керування сайтом з відкритим кодом, яка через свою простоту в установленні та використанні широко застосовується для створення веб-сайтів

1. [**Створіть віджет #jedidesk**](/vidzhet/yak-stvoriti-chat-jedidesk) та скопіюйте згенерований код.
2. Авторизуйтесь як адміністратор на вашому сайті **WordPress** чи Інтернет-магазині з **WooCommerce**.
3. Відкрийте вкладку **Вигляд -> Редактор тем.**
4. Оберіть зі списку встановлених тем, ту яку ви використовуєте, та натисніть на  шаблон "Підвал сайту" під назвою **footer.php:**
5. Вставте код чату #jedidesk перед тегом <mark style="color:red;">**\</body>**</mark> та натисніть <mark style="background-color:blue;">**Оновити файл**</mark>:

<figure><img src="/files/OxhyJZPchOCsWrUNiftx" alt=""><figcaption><p>Встановлення чату #jedidesk на WordPress</p></figcaption></figure>

{% hint style="success" %}

#### Доповнення та додаткові методи

1. Більшість тем мають спеціальне місце для вставки додаткового коду для аналітики чи інших скриптів. Спочатку рекомендовано пошукати таке місце у вашій темі.
2. Якщо ви не змогли, з будь-яких причин, знайти файл **footer.php,** ви можете аналогічно вставити код віджету у файл **header.php (Заголовок теми)** перед відкриваючим тегом <mark style="color:red;">**\<body>**</mark>
   {% endhint %}


# Встановлення чату #jedidesk на Shopify

1. **Відкрийте адмін-панель Shopify**: [Увійдіть](https://accounts.shopify.com/signup?rid=4257a147-8035-4162-99e8-ed6e13e027a0) у свій обліковий запис Shopify.

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

2. На лівій бічній панелі п**ерейдіть у розділ «**[**Інтернет-магазин**](https://admin.shopify.com/store/sfpqzr-ep/themes?appLoadId=4f4eb198-8104-4774-b2fb-274f83148b35)**»**

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

3. **Виберіть «Themes» (Теми)**: У підменю виберіть **«Themes»**. Оберіть тему та натисніть Редагувати тему та н**алаштуйте поточну тему**, потім оберіть **«Add Section»**&#x20;

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

і у випадаючемо меню оберіть "Custom Liquid"

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

4. Поверніться до JediDesk, перейдіть у Інтеграції - [Налаштування віджету](https://app.jedidesk.com/settings-widget) і скопіюйте код віджета:

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

5. Після копіювання коду поверніться до вкладинки Shopify та вставте скопійований код у це поле:

<figure><img src="/files/21XJaMcSITPEPWpq1oyn" alt=""><figcaption></figcaption></figure>

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

6. Після виконання цих дій на вашому сайті з'явиться віджет JediDesk

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


# Відкриття віджету натискаючи на кнопку на сайті

Ви маєте змогу відкривати віджет #jedidesk за допомогою кнопки чи посилання на вашому сайті.

Якщо ви хочете на сайт додати кнопку **Звʼязатись**, і щоб при натисканні на неї розгорталось вікно чату з оператором. Це зручно, так як клієнт відразу має змогу задати питання, не очікуючи   на довгі відповіді по пошті.

Також у вас є можливість повністю приховати віджет, який буде відкриватись лише при натисканні на кнопку, якщо ви скористаєтесь івентами, які описані нижче:

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

{% hint style="info" %}
Рекомендуємо для такого типу робіт звернутись до програміста або людини яка зможе зайти в вихідний програмний код та додати безпечно потрібний селектор[^1].
{% endhint %}

1. [Встановіть](/vidzhet/dodati-chat-na-sait) віджет на ваш сайт;
2. Додайте до вашої кнопки на сайті клас:&#x20;

   ```html
   jedidesk_widget--open-button
   ```
3. Для закриття віджету додайте до кнопки клас:&#x20;

   ```html
   jedidesk_widget--close-button
   ```
4. Якщо все зроблено правильно, тоді після натискання кнопки буде відкритий чат з оператором, і система вже відправить клієнту привітальне повідомлення 👋

[^1]: В даному випадку маємо на увазі class.&#x20;


# Контактна форма

### Обов’язкова контактна форма у віджеті

**«Обов’язкова контактна форма перед початком чату у віджеті»**. Коли він увімкнений, клієнт не зможе написати в чат, поки не заповнить контактну форму зі своїми даними (ім’я, телефон та/або email).

Це дозволяє компаніям збирати контактні дані клієнтів до початку діалогу — наприклад, коли важливо розуміти, з ким відбувається спілкування ще до першого повідомлення.

***

#### Де знаходиться налаштування

[**Налаштування → Компанія → розділ «Канали комунікації»**](https://app.jedidesk.com/settings-company)

Поруч з існуючими перемикачами полів форми:

* Відображення поля телефону у боті та віджеті
* Відображення поля імені у віджеті
* Відображення поля email у віджеті
* Обов’язкова контактна форма перед початком чату у віджеті (нове)

<figure><img src="/files/1pffsJApCaH4KyN3aMy4" alt=""><figcaption></figcaption></figure>

***

#### Як це працює

**Якщо перемикач вимкнений (стандартна поведінка)**

Поля форми відображаються, але є необов’язковими. Клієнт може одразу написати в чат, не заповнюючи їх.

**Якщо перемикач увімкнений**

При відкритті віджета клієнту спочатку показується контактна форма. Доступ до чату заблокований, поки він її не заповнить. Форма містить лише ті поля, які увімкнені окремими перемикачами вище.

Якщо клієнт уже раніше спілкувався і система його розпізнає, форму повторно не показують.

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

***


# База знань у віджеті

За допомогою бази знань користувачі можуть самостійно знаходити відповіді на поширені запитання без очікування відповіді менеджера.

Спочатку створіть категорії та питання з відповідями у розділі Автоматизація → База знань.

Детальніше про створення категорій, питань і відповідей можна прочитати в інструкції "Як створити базу знань (FAQ)."

{% content-ref url="/pages/NPoV7rUtr5OaD4PL4GJP" %}
[Як створити базу знань (FAQ)](/nalashtuvannya-jedidesk/yak-stvoriti-bazu-znan-faq)
{% endcontent-ref %}

### Як увімкнути базу знань у віджеті

Відкрийте розділ Налаштування → Інтеграції → Налаштування віджету та виберіть потрібний віджет.<br>

<figure><img src="/files/288qrIyiKSoi7pfpPlfI" alt=""><figcaption></figcaption></figure>

Активуйте перемикач Показувати базу знань у віджеті та збережіть зміни.

### Як користувач бачить базу знань

Після активації функції у віджеті з’явиться окрема вкладка База знань.\
Щоб переглянути відповідь, користувачеві потрібно відкрити потрібну категорію та натиснути на питання.

Відповідь відкриється безпосередньо у віджеті. Користувач може повернутися до списку питань або перейти до іншої категорії.<br>

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

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

***

## Важливо🚨

У віджеті відображаються активні категорії та питання з бази знань.

Якщо потрібної відповіді немає в базі знань, користувач може продовжити спілкування в чаті та звернутися до менеджера.

Щоб змінити інформацію у віджеті, відредагуйте відповідну категорію або питання у розділі Автоматизація → База знань.


# Створення чат-бота в Telegram

Покрокова інструкція зі створення чат-бота в Telegram-месенджері

#### **Навігація:**

1. [Створення чат-бота](#id-1.-stvorennya-chat-bota)
2. [Інтеграція чат-бота з #jedidesk](#id-2.-integraciya-chat-bota-z-jedidesk)
3. [Оформлення чат-бота: аватарка](#id-3.-oformlennya-chat-bota-avatarka)
4. [Оформлення чат-бота: опис](#id-4.-oformlennya-chat-bota-opis)
5. [Результат](#id-5.-rezultat)
6. [Відео-інструкція](#id-6.-video-instrukciya)
7. [Інтеграція особистого профайлу Telegram Business](#id-7.-integraciya-osobistogo-profailu-telegram-business)

***

#### **1. Створення чат-бота**

Запустіть системний бот [@BotFather](https://t.me/botfather) командою **/start** (або кнопкою *Розпочати*) та виберіть команду **/newbot:**

<div><figure><img src="/files/Eo6NGaKTMdN6vngfHq7d" alt=""><figcaption><p>Запуск @BotFather</p></figcaption></figure> <figure><img src="/files/OPXWseX4OH7eiViEM5IL" alt=""><figcaption><p>Меню @BotFather</p></figcaption></figure></div>

{% hint style="danger" %} <mark style="color:red;">**Увага!**</mark> Якщо ви втратите доступ до номеру телефона, через який ви створюєте бот, ви назавжди втратите доступ до керування ботом через @BotFather без можливості відновлення!
{% endhint %}

***

Дайте ім’я та юзернейм (username) своєму боту.\
Важливо, щоб юзернейм (username) бота мав закінчення ***Bot*** або ***\_bot***\
В чому різниця між назвою та юзернеймом? Юзернейм працює як посилання для переходу в бот.

{% hint style="danger" %} <mark style="color:red;">**Увага!**</mark> На відміну від назви боту, ви не зможете редагувати юзернейм у майбутньому!
{% endhint %}

***

Далі ви отримаєте API-токен:

<figure><img src="/files/5bOlgO9sQS4ld5vfFTKB" alt=""><figcaption><p>Створення чат-бота в Telegram</p></figcaption></figure>

Натисніть на текст з API, він буде автоматично скопійований.

***

#### **2. Інтеграція чат-бота з #jedidesk**

На сервісі #jedidesk відкрийте вкладку **Налаштування** **->** [**Інтеграції**](https://app.jedidesk.com/integrations), вставте скопійований API-токен та натисніть <mark style="background-color:blue;">**Активувати**</mark>:

<figure><img src="/files/BGDKrGRgK8Lb51PRD6eH" alt=""><figcaption><p>Інтеграція чат-бота з #jedidesk</p></figcaption></figure>

***

#### **3. Оформлення чат-бота: аватарка**

Поверніться в [@BotFather](https://t.me/botfather) та продовжуйте заповнювати свій бот.

Щоб завантажити у свій бот аватарку (зображення), введіть команду **/setuserpic**

Виберіть зі списку свій бот та надішліть зображення як звичайне фото:

<figure><img src="/files/T3XlDEMXByBkdDtM90vZ" alt=""><figcaption><p>Налаштування аватарки чат-бота в Telegram</p></figcaption></figure>

{% hint style="info" %}
**Порада**: для збереження естетики та пропорцій бажано завантажувати зображення зі співвідношенням 1:1 (квадрат), так як прямокутні зображення Telegram обріже і ви можете втратити частину композиції або вказану на зображенні інформацію.
{% endhint %}

***

#### **4. Оформлення чат-бота: опис**

Щоб додати опис своєму боту, введіть команду **/setabouttext**

Виберіть зі списку свій бот та надішліть свій текст як звичайне повідомлення:

<figure><img src="/files/KJv3fsjwzAixZ8vT2miE" alt=""><figcaption><p>Налаштування опису чат-бота в Telegram</p></figcaption></figure>

***

#### **5. Результат:**

<figure><img src="/files/6hgnvJbEFc2o1pSlZo3k" alt=""><figcaption><p>Профіль готового чат-бота в Telegram</p></figcaption></figure>

***

#### 7. Інтеграція особистого профайлу Telegram Business

Також у нас є можливість підключити ваш акаунт Telegram Premium напряму до системи Jedidesk. Більш детально це описано [тут](/chat-boti/pidklyuchennya-telegram-business-do-jedidesk).


# Отримання токену готового чат-бота в Telegram

Інструкція з отримання API-токену для інтеграції з #jedidesk

З аккаунту (номеру телефона), на якому був створений ваш чат-бот, необхідно запустити бот [@BotFather](https://t.me/botfather)**.**

Введіть команду **/mybots** та оберіть з наведеного списку необхідний для інтеграції бот.\
Натисніть на кнопку **API token**:

<figure><img src="/files/Um9tQaGh7DvZfnDOEJO1" alt=""><figcaption><p>Системне меню</p></figcaption></figure>

***

Натисніть на API, токен автоматично скопіюється:

<figure><img src="/files/kCPzRgKnyHHde8mIC1o3" alt=""><figcaption><p>Унікальний API-токен чат-бота</p></figcaption></figure>

***

На сервісі #jedidesk відкрийте вкладку **Налаштування** **->** [**Інтеграції**](https://app.jedidesk.com/integrations), вставте скопійований API-токен та натисніть <mark style="background-color:blue;">**Активувати**</mark>:

<figure><img src="/files/BGDKrGRgK8Lb51PRD6eH" alt=""><figcaption><p>Інтеграція чат-бота з #jedidesk</p></figcaption></figure>


# Створення чат-бота в Viber

Швидка покрокова інструкція зі створення чат-бота в Viber-месенджері

{% hint style="danger" %} <mark style="color:red;">**Увага!**</mark> Починаючи з 05.02.2024 чат-боти в Viber створюються на платній основі (100 євро в місяць), згідно [нової комерційної моделі Viber](https://help.viber.com/hc/en-us/articles/15247629658525-Bot-commercial-model).

Всі чат-боти, які було створено до 05.02.2024, працюють безкоштовно.
{% endhint %}

#### Навігація

1. [Створення чат-бота](#id-1.-stvorennya-chat-bota)
2. [Інтеграція чат-бота з #jedidesk](#id-2.-integraciya-chat-bota-z-jedidesk)
3. [Активація чат-бота](#id-3.-aktivaciya-chat-bota)

***

#### **1. Створення чат-бота**

Якщо ви попередньо не створювали чат-боти на своєму обліковому записі Viber, реєстрація чат-бота через адміністративну панель Viber недоступна, тому вам необхідно зв'язатися [напряму з Viber](https://www.forbusiness.viber.com/ua/messaging-partners/) для [оформлення заявки на створення чат-бота](https://b2b.viber.com/viber-for-business-form).

Якщо ви вже маєте чат-боти на своєму обліковому записі Viber, авторизуйтеся в [адміністративній панелі Viber](https://partners.viber.com/login) за номером телефону, підключеним до застосунку Viber та натисніть <mark style="background-color:purple;">**Запит облікового запису бота**</mark>:

<figure><img src="/files/CZeE5hUrT2TEwEvthW1g" alt=""><figcaption><p>Адміністративна панель Viber</p></figcaption></figure>

{% hint style="danger" %} <mark style="color:red;">**Увага!**</mark> Якщо ви втратите доступ до номеру телефона, через який ви створюєте бот, ви назавжди втратите доступ до керування своїм ботом без можливості відновлення за умови, якщо до бота не додані інші адміністратори.
{% endhint %}

Заповніть заявку на створення бота та керуйтеся рекомендаціями, які надалі буде надавати Viber:

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

Коли ваш запит буде прийнято, заповніть всі наступні пункти:

1. **Аватарка** (зображення) бота у відношенні 1:1 (квадрат)
2. **Назва** бота
3. **URL бота** (посилання на бот) автоматично стає ідентичним назві, але його можна змінити власноруч
4. **Категорія** бота (самостійно створити категорію не можна)
5. **Підкатегорія**, яка точніше визначає призначення бота
6. **Мова** бота
7. **Опис** бота
8. **Посилання на сайт**, контакт або інший ваш основний ресурс
9. Робочий **e-mail**
10. Вказуємо, чи містить ваш бот контент **18+**
11. На карті вибираємо свою **країну**.

<figure><img src="/files/kcSQsB8XXn7JyrNzxuFy" alt=""><figcaption><p>Створення чат-бота в Viber</p></figcaption></figure>

<figure><img src="/files/i70MCKeQZyciA2p0RdtT" alt=""><figcaption><p>Створення чат-бота в Viber</p></figcaption></figure>

<figure><img src="/files/F8UQJVKMBAEWSlVsTkPN" alt=""><figcaption><p>Створення чат-бота в Viber</p></figcaption></figure>

***

Далі йде перелік пунктів, куди потрібно ставити галочки:

<figure><img src="/files/VNZXrpLeIssm48ySC6hV" alt=""><figcaption><p>Умови Viber для створення чат-бота</p></figcaption></figure>

> * *Цим я погоджуюся з* [*Умовами та Політикою Viber*](https://www.viber.com/en/terms/)*, включаючи* [*Умови використання Viber для розробників*](https://www.viber.com/en/terms/viber-developer-distribution-agreement/)*.* <mark style="color:red;">–</mark> <mark style="color:red;"></mark><mark style="color:red;">**обов’язкова галочка**</mark>
> * *Я визнаю та погоджуюся, що Viber матиме право стягувати з мене плату на основі* [*комерційної моделі чат-бота*](https://vb.me/BotComModel)*\*.* <mark style="color:red;">–</mark> <mark style="color:red;"></mark><mark style="color:red;">**обов’язкова галочка**</mark>\
>   *<mark style="color:purple;">\*Комерційна модель Viber Chatbot базується на обмеженнях використання. Viber не стягує плату за сеанси, ініційовані користувачем, або за перші 10 000 повідомлень, ініційованих чат-ботом, доставлених за календарний місяць, як зазначено на сторінці комерційної моделі чат-бота.</mark>*
> * *Я визнаю та погоджуюся дотримуватися* [*Умов використання API Google Pay*](https://payments.developers.google.com/terms/sellertos) *(для розробників, які впроваджують API Google Pay).* <mark style="color:red;">–</mark> <mark style="color:red;"></mark><mark style="color:red;">**обов’язкова галочка**</mark>

Натисніть кнопку <mark style="background-color:purple;">**Create**</mark> (*Створити*)

***

#### **2. Інтеграція чат-бота з #jedidesk**

У спливаючому вікні скопіюйте API-токен бота:

<figure><img src="/files/lL0AKRJjHrKua1D8DX1Q" alt=""><figcaption><p>Отриманий API-токен</p></figcaption></figure>

***

На сервісі #jedidesk відкрийте вкладку **Налаштування** **->** [**Інтеграції**](https://app.jedidesk.com/integrations), вставте скопійований API-токен та натисніть <mark style="background-color:blue;">**Активувати**</mark>:

<figure><img src="/files/RcgKbb1s4DiJ2Tt3zoa3" alt=""><figcaption><p>Інтеграція чат-бота з #jedidesk</p></figcaption></figure>

***

#### **3. Активація чат-бота**

Активуйте чат-бот через мобільний застосунок Viber.

В розділі **Додатково** -> **Параметри** -> **Мої боти** виберіть свій бот:

<figure><img src="/files/qygdNnD4ZFP2oEULQz7q" alt=""><figcaption><p>Меню налаштувань Viber</p></figcaption></figure>

***

Натисніть **Змінити дані** та опублікуйте свій чат-бот:

<figure><img src="/files/JBxtbByGRGWQidHmHuUT" alt=""><figcaption><p>Публікація чат-бота в Viber</p></figcaption></figure>

Також тепер ви маєте можливість керувати оформленням свого бота через мобільний застосунок.

***


# Отримання токену готового чат-бота в Viber

Інструкція з отримання API-токену для інтеграції з #jedidesk

#### Навігація:

1. [Через мобільний застосунок Viber](#id-1.-cherez-mobilnii-zastosunok-viber)
2. [Через адмін-панель Viber](#id-2.-cherez-admin-panel-viber)
3. [Інтеграція чат-бота з #jedidesk](#id-3.-integraciya-chat-bota-z-jedidesk)

***

#### 1. **Через мобільний застосунок Viber:**

В розділі **Додатково** **–>** **Параметри** **–>** **Мої боти**: виберіть свій бот, натисніть **Змінити дані** та вкінці списку скопіюйте API-токен свого боту:

<figure><img src="/files/lcbD8Gn0ACimMUBxxzLn" alt=""><figcaption><p>Отримання API-токена через мобільний застосунок Viber</p></figcaption></figure>

***

#### **2. Через адмін-панель Viber:**

Авторизуйтеся в [адміністративній панелі Viber](https://partners.viber.com/), натисність на іконку з вашим ботом та скопіюйте API-токен:

<figure><img src="/files/eQWk8pumR6awZzawu6Hz" alt=""><figcaption><p>Адміністративна панель Viber</p></figcaption></figure>

<figure><img src="/files/2UvvutpIBoDogBoQBjXw" alt=""><figcaption><p>Отримання API-токена через адміністративну панель Viber</p></figcaption></figure>

***

#### 3. Інтеграція чат-бота з #jedidesk

На сервісі #jedidesk відкрийте вкладку **Налаштування** **->** [**Інтеграції**](https://app.jedidesk.com/integrations), вставте скопійований API-токен та натисніть <mark style="background-color:blue;">**Активувати**</mark>:

<figure><img src="/files/RcgKbb1s4DiJ2Tt3zoa3" alt=""><figcaption><p>Інтеграція чат-бота з #jedidesk</p></figcaption></figure>


# Підключення Instagram Business до #jedidesk

Покрокове налаштування сторінки в Instagram та інтеграція з сервісом #jedidesk.

**Навігація:**

1. [Налаштування типу аккаунта в Instagram та створення бізнес-сторінки Facebook](#id-1.-nalashtuvannya-tipu-akkaunta-v-instagram-ta-stvorennya-biznes-storinki-facebook)
2. [Синхронізація Instagram з Facebook Manager через браузер](#id-2.-sinkhronizaciya-instagram-z-facebook-manager-cherez-brauzer)
3. [Інтеграція Instagram з #jedidesk](#id-3.-integraciya-instagram-z-jedidesk)

***

{% hint style="danger" %} <mark style="color:red;">**Увага:**</mark> Для інтеграції Instagram з сервісом #jedidesk потрібний доступ до Facebook Manager з рівнем власника облікового запису. \
Крім того, обліковий запис Instagram повинен пройти верифікацію у Facebook Manager.
{% endhint %}

#### 1. Налаштування типу аккаунта в Instagram та створення бізнес-сторінки Facebook

Перш ніж налаштовувати інтеграцію, переконайтеся, що ваш акаунт Instagram переведено в статус **Професійний**.&#x20;

Перейдіть в **Налаштування -> Тип облікового запису й інструменти -> Перейти на професійний обліковий запис ->&#x20;**<mark style="color:blue;">**Продовжити**</mark>**:**

<div><figure><img src="/files/x3PjUfDposN6ybiZqN9f" alt=""><figcaption></figcaption></figure> <figure><img src="/files/NDnEu9FmLLuHLDFwO4HB" alt=""><figcaption></figcaption></figure></div>

Вкажіть необхідну **категорію** та чи потрібно **відображати її в профілі** **-> оберіть тип "Автор" або "Бізнес" ->&#x20;**<mark style="background-color:blue;">**Далі**</mark>:

<div><figure><img src="/files/xb8v7xOg5qNZWxJGD70M" alt=""><figcaption></figcaption></figure> <figure><img src="/files/keHbM5FW9FG67H8Ov3h1" alt=""><figcaption></figcaption></figure></div>

Перевірте контактну інформацію та її відображення в профілі, натисніть <mark style="background-color:blue;">**Далі**</mark>:

<div><figure><img src="/files/uaukVJyPxfFoTAHemkQ0" alt=""><figcaption></figcaption></figure> <figure><img src="/files/H7mnDb3WOoeZTWNYpFMY" alt=""><figcaption></figcaption></figure></div>

Наступні кроки залежать від того, чи вже створена ваша бізнес сторінка в Facebook.&#x20;

**1. Якщо сторінка є, натисніть:**

<mark style="background-color:blue;">**Увійдіть у Facebook**</mark> **-> Авторизуйтеся** на сторінці, на якій було створено бізнес-сторінку **-> Виберіть бізнес-сторінку ->&#x20;**<mark style="background-color:blue;">**Підключити**</mark>**:**

<div><figure><img src="/files/mL2NSDFFHYPr90g5zWFs" alt=""><figcaption></figcaption></figure> <figure><img src="/files/ajx7eHA6S0eUwusprEaX" alt=""><figcaption></figcaption></figure></div>

**2. Якщо сторінки немає** і ви хочете створити її з десктопної версії, натисність <mark style="color:blue;">**Пропустити**</mark>.

**3. Якщо сторінки немає** і ви хочете створити її з мобільної версії, натисніть:

**Створити сторінку Facebook ->** Дайте назву та виберіть категорію **->** <mark style="background-color:blue;">**Створити**</mark>:

<div><figure><img src="/files/SoznVhL82B8MpGZicvsY" alt=""><figcaption></figcaption></figure> <figure><img src="/files/cXQeQii4NuZWzvTktxMe" alt=""><figcaption></figcaption></figure></div>

***

Увімкніть доступ до повідомлень в **Налаштування -> Повідомлення й відповіді на розповіді -> Керувати повідомленнями:**

* **Дозволити доступ до повідомлень**&#x20;
* **Ваші читачі в Instagram** - поставити "Запити на повідомлення
* **Інші люди в Instagram** - поставити "Запити на повідомлення)

<div><figure><img src="/files/xW2s20Cus3wOUNksW2Md" alt=""><figcaption></figcaption></figure> <figure><img src="/files/DX8bsC3uN5xBOd2VXSrz" alt=""><figcaption></figcaption></figure> <figure><img src="/files/oYT8zNJZ909bh66djTCD" alt=""><figcaption></figcaption></figure></div>

***

#### **2. Синхронізація Instagram з Facebook Manager через браузер**

Якщо ви створювали бізнес-сторінку окремо та хочете підключити її до Instagram через десктопну версію, увійдіть на Facebook і перейдіть на сторінку, яку хочете підключити до облікового запису Instagram.&#x20;

Перейдіть в [**Сторінки** ](https://www.facebook.com/pages)та натисніть <mark style="background-color:blue;">**+ Створити сторінку**</mark> та пройдіть всі типові етапи налаштування.

На створеній сторінці натисніть <mark style="background-color:blue;">**Керувати**</mark>:

<figure><img src="/files/hmQbFPW04q8hXdPPq3wD" alt=""><figcaption><p>Бізнес-сторінка в Facebook</p></figcaption></figure>

***

Оберіть розділ [**Підключені облікові записи**](https://www.facebook.com/settings/?tab=linked_instagram) та з'єднайте сторінку з Instagram:

<figure><img src="/files/xHcgQ7jmg62puTHmYvwl" alt=""><figcaption><p>Підключення Instagram до Facebook Business</p></figcaption></figure>

***

Увімкніть дозвіл на отримання повідомлень на натисніть <mark style="background-color:blue;">**Підтвердити**</mark>:

<figure><img src="/files/6mXmfZNhgdIXtWCJPl0m" alt=""><figcaption><p>Підключення Instagram до Facebook Business</p></figcaption></figure>

***

Підключіть сторінку Instagram до Facebook:

<figure><img src="/files/ExlZZlob2g8zdBzqbtW9" alt="" width="350"><figcaption><p>Підключення Instagram до Facebook Business</p></figcaption></figure>

***

Оновіть сторінку [**Підключені облікові записи**](https://www.facebook.com/settings/?tab=linked_instagram) та натисніть <mark style="background-color:blue;">**Підтвердити підключення**</mark>, якщо Facebook буде потребувати додаткового підтвердження.

***

#### 3. Інтеграція Instagram з #jedidesk&#x20;

На сервісі #jedidesk відкрийте вкладку **Налаштування ->** [**Інтеграції**](https://app.jedidesk.com/integrations) **-> Інтеграція з Instagram ->** Натисність кнопку <mark style="background-color:blue;">**Підключити**</mark>:

<figure><img src="/files/I5nUGkcJwNUTOwoaCvSV" alt=""><figcaption><p>Інтеграція Instagram з #jedidesk</p></figcaption></figure>

***

Ще раз натисніть <mark style="background-color:blue;">**Підключити**</mark> та увійдіть в акаунт Facebook, на якому створені ваші Business-сторінки.

Оберіть зі списку сторінку, яка має бути синхроніхована з сервісом #jedidesk:

<div><figure><img src="/files/s0Es1DCtAxmhDdlDG8TC" alt=""><figcaption><p>Підключення сторінки до #jedidesk</p></figcaption></figure> <figure><img src="/files/Zho7WXHx7fgwzRtfDWfM" alt=""><figcaption><p>Підключення сторінки до #jedidesk</p></figcaption></figure></div>

Після надання всіх дозволів, JediDesk покаже список Facebook-сторінок та Instagram-акаунтів, прив'язаних до вашого облікового запису. **Оберіть лише ту сторінку Instagram, яку потрібно підключити**, та натисніть — **Підключити вибрані**:<br>

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

Якщо вам потрібно підключити лише один акаунт Instagram — позначте лише його. Інші сторінки залишаться непідключеними і не будуть отримувати повідомлення в JediDesk.&#x20;

***

Переконайтеся, що всі дозволи для застосунку #jedidesk включені та натисніть <mark style="background-color:blue;">**Готово**</mark>:

<figure><img src="/files/id6AphC8GlDiu2Ks7Ew7" alt="" width="281"><figcaption><p>Підключення сторінки до #jedidesk</p></figcaption></figure>

***

Готово! Тепер усі повідомлення та коментарі з підключеного акаунта Instagram надходитимуть у #jedidesk.


# Підключення Telegram Business до #jedidesk

Покрокове налаштування Telegram Business та інтеграція з сервісом #jedidesk.

#### **Навігація:**

1. #### [**Налаштування телеграм бота в @BotFather**](#id-1.-nalashtuvannya-telegram-bota-v-botfather)
2. #### [**Налаштування акаунту Telegram**](#id-2.-nalashtuvannya-akauntu-telegram)
3. #### [**Як спілкуватись з користувачами**](#id-3.-yak-spilkuvatis-z-koristuvachami)

***

{% hint style="danger" %} <mark style="color:red;">**Увага!**</mark> Для налаштування вам потрібна підписка Telegram Premium, а також мати створений телеграм бот підключений до системи jedidesk&#x20;
{% endhint %}

{% hint style="warning" %}
Увага! Telegram Business має обмеження: бот може надсилати повідомлення користувачу лише протягом 24 годин після його останньої взаємодії з бізнесом. Після закінчення цього періоду бот не може ініціювати нову розмову, доки користувач сам не напише нове повідомлення у чат. Це обмеження також знімається, якщо власник бізнес-акаунта напише користувачу вручну - тоді вікно активності поновлюється, і бот знову може відправляти повідомлення протягом наступних 24 годин.
{% endhint %}

#### **1. Налаштування телеграм бота в** [@BotFather](https://t.me/botfather)

Увійдіть у свій обліковий запис Telegram і скористайтеся пошуком для введення [@BotFather](https://t.me/botfather). Після цього надішліть команду /mybots та оберіть бота, інтегрованого із системою jedidesk. Далі перейдіть до **Bot Settings** > **Business mode**. У новій версії Telegram це налаштування доступне відразу після вибору бота.

***

<figure><img src="/files/CsA4lbjnomUytfdtTpht" alt=""><figcaption><p>Налаштування Бізнес версії</p></figcaption></figure>

***

***

#### **2. Налаштування акаунту Telegram**

В потрібному Telegram акаунті перейдіть у **Налаштування**> **Telegram Business** > **Чатботи**.

У полі введення вкажіть username або вставте посилання на бота, а коли він з’явиться у випадаючому списку — натисніть «Додати». Нижче ви зможете налаштувати чати, до яких бот матиме доступ.

<figure><img src="/files/odrf3NhluDWkQg4EQ50E" alt="" width="369"><figcaption><p>Виберіть Telegram Business</p></figcaption></figure>

<figure><img src="/files/VuwkbIGc3TL4vLHBBH0Z" alt="" width="368"><figcaption><p>Виберіть чатботи</p></figcaption></figure>

***

<figure><img src="/files/vDZCg8LkYLwucQmx80HH" alt="" width="366"><figcaption><p>Виберіть потрібний чатбот та чати до яких бот має доступ</p></figcaption></figure>

***

#### **3. Як спілкуватись з користувачами**

На всі повідомлення, буде відповідати наш АІ асистент, якого можна буде вимкнути або ввімкнути по вашому бажанню.

***

<figure><img src="/files/Dj5nTT0tbnb3HSnARDVx" alt=""><figcaption><p>Кнопка стоп зупиняє асистента</p></figcaption></figure>

***

Також всі чати будуть відображатись в LiveChat так, наче писали в звичайний телеграм бот. Всі користувачі, які написали вам через Telegram Business будуть відображатись таким чином: чорна іконка під аватаркою та підпис Telegram-Business

<figure><img src="/files/wdHhf4q2dtXb6w3K7iaK" alt=""><figcaption><p>Ось як позначається користувач, який написав через Telegram Business</p></figcaption></figure>


# Створення чат-бота в WhatsApp

Покрокова інструкція зі створення чат-бота в месенджері WhatsApp.

#### **Навігація:**

1. [Створення облікового запису 360Dialog:](#id-1.-stvorennya-oblikovogo-zapisu-360dialog)

   1.1. [У вас немає облікового запису WhatsApp Business<br>](#id-1.1-stvorennya-oblikovogo-zapisu-360dialog-yaksho-u-vas-nemaye-oblikovogo-zapisu-whatsapp-business)1.2.1. [Ви вже використали номер телефону в WhatsApp](#id-1.2.1-stvorennya-oblikovogo-zapisu-360dialog-vi-vzhe-vikoristali-nomer-telefonu-v-whatsapp)\
   1.2.2. [Ви вже використали номер телефону в WhatsApp Business](#id-1.2.2-stvorennya-oblikovogo-zapisu-360dialog-vi-vzhe-vikoristali-nomer-telefonu-v-whatsapp-business)[<br>](#id-1.2.1-stvorennya-oblikovogo-zapisu-360dialog-vi-vzhe-vikoristali-nomer-telefonu-v-whatsapp)1.2.3. [Ви використали з іншим постачальником WhatsApp, окрім 360dialog](#id-1.2.3-stvorennya-oblikovogo-zapisu-360dialog-vikoristano-z-inshim-postachalnikom-whatsapp-okrim-360d)
2. [Підключення 360Dialog](#id-2.-pidklyuchennya-nomeru-telefonu)
3. [Користування чатом](#id-3.-koristuvannya-chatom)
4. [Політика Meta](#id-4.-politika-meta)
5. [Використання шаблонів](#id-5.-vikoristannya-shabloniv-whatsapp)

## 1. Створення облікового запису 360Dialog

Якщо у вас вже є обліковий запис 360Dialog, перейдіть до наступного розділу – “Підключення 360Dialog”

### 1.1 Створення облікового запису 360Dialog (Якщо у вас немає облікового запису WhatsApp Business)

**Створення облікового запису 360Dialog:**\
Щоб розпочати роботу, зареєструйтесь у 360Dialog та додайте свій номер телефону за цим посиланням:\
[Інструкція з реєстрації](https://docs-360dialog-com.translate.goog/docs/waba-management/embedded-signup/signup-step-by-step?_x_tr_sl=auto&_x_tr_tl=uk&_x_tr_hl=en&_x_tr_pto=wapp&_x_tr_hist=true).

{% hint style="warning" %}
Будь ласка, переконайтеся, що у налаштуваннях номера телефону в 360Dialog для **Hosting Platform Type** відображається **Cloud API hosted by Meta**.

Якщо цього немає, скористайтеся [цією інструкцією](https://docs-360dialog-com.translate.goog/docs/waba-management/hosting-type-change?_x_tr_sl=auto&_x_tr_tl=uk&_x_tr_hl=en&_x_tr_pto=wapp&_x_tr_hist=true) для зміни налаштувань.
{% endhint %}

### 1.2.1 Створення облікового запису 360Dialog (Ви вже використали номер телефону в WhatsApp)

Якщо ваш номер вже використовується для WhatsApp Business, ви можете зробити це двома способами:

1. Через додаток **WhatsApp Business** (iOS, Android або Web).
2. Через **постачальника бізнес-послуг** (наприклад, 360Dialog або Twilio).

### 1.2.2 Створення облікового запису 360Dialog (Ви вже використали номер телефону в WhatsApp Business)

Ви можете використовувати номер телефону, який уже зареєстрований у WhatsApp на Android, iPhone або в бізнес-версії. Однак, якщо ви хочете зареєструвати цей номер у **WhatsApp Business API**, спочатку необхідно **видалити обліковий запис** у додатку WhatsApp Business, пов’язаний із цим номером.

{% hint style="warning" %}
Зверніть увагу, що під час цього процесу **історія чату не передається і не зберігається**.
{% endhint %}

Кроки для видалення :

1\.   Перейдіть в "Налаштування" у вашому додатку WhatsApp Business.

2\.   Натисніть "Обліковий запис" і оберіть "Видалити мій обліковий запис".

3\.   Підтвердіть видалення.

### &#x20;1.2.3 Створення облікового запису 360Dialog (Використано з іншим постачальником WhatsApp, окрім 360dialog)

Якщо ваш номер телефону використовується для облікового запису **WhatsApp Business** через іншого постачальника (наприклад, Twilio), вам потрібно виконати міграцію.

Для цього скористайтеся [цією документацією](https://docs-360dialog-com.translate.goog/docs/waba-management/hosting-type-change?_x_tr_sl=auto&_x_tr_tl=uk&_x_tr_hl=en&_x_tr_pto=wapp&_x_tr_hist=true).

{% hint style="danger" %}
Переконайтеся, що в налаштуваннях номера телефону в **360Dialog** для **Hosting Platform Type** відображається **Cloud API hosted by Meta**.

Якщо цього немає, скористайтеся [цією документацією](https://docs-360dialog-com.translate.goog/docs/waba-management/hosting-type-change?_x_tr_sl=auto&_x_tr_tl=uk&_x_tr_hl=en&_x_tr_pto=wapp&_x_tr_hist=true) для зміни налаштувань.
{% endhint %}

## 2. Підключення номеру телефону

1\.   Увійдіть до облікового запису 360dialog у своєму браузері та перейдіть до головоної сторінки.

2\.   Клацніть "Manage WhatsApp Business account”:

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

3. На сторінці з налаштуваннями натисніть “Manage API keys” та згенеруйте ключ інтеграції, після чого скопіюйте його:

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

4. Перейдіть на вашу сторінку JediDesk та оберіть в вкладці “Налаштування” пункт ”Інтеграції”:

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

5. В налаштуваннях інтеграції оберіть “Інтеграція з WhatsApp” та вставте скопійований раніше ключ інтеграції:

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

6. Інтеграція завершена, ви можете перейти до наступного пункту.

## 3.  Користування чатом

Усі чати WhatsApp потрапляють у ваш вхідний ящик так само, як і звичайні чати. Ви зможете легко відрізнити чати WhatsApp від інших, оскільки ми позначаємо їх спеціальними іконками:

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

## 4. Політика Meta

1. Обліковий запис бізнесу WhatsApp використовує сесії тривалістю **24 години**. Це означає, що після отримання повідомлення від користувача у вас є **24 години** для відповіді. Якщо ви не встигаєте відповісти, ви можете надіслати готовий шаблон, щоб продовжити розмову. Однак у такому випадку буде стягнуто плату за відправлення шаблону.&#x20;

## 5. Використання шаблонів WhatsApp

{% hint style="warning" %}
На даний момент JediDesk працює лише із звичайними текстовими шаблонами, без параметрів та кнопок
{% endhint %}

Якщо ви не відповіли на повідомлення WhatsApp протягом обмеженого часу сесії (**24 години**), ви можете вибрати готовий шаблон і відправити його. Після того, як користувач відповість на шаблон, сесія буде відновлена, і ви зможете продовжити розмову.

Ви можете створювати та керувати шаблонами:

1\. Увійдіть в 360dialog.

2\. Перейдіть до “Templates”

&#x20;та виберіть “Add template”:

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

3\. Після чого ви можете використати їх в JediDesk:

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

{% hint style="info" %}
Врахуйте, що JediDesk відображає лише підтверджені шаблони, які можна відправити. Їх оновлення у системі JediDesk відбувається в реальному часі
{% endhint %}


# Інтеграції з Ecommerce

#### Навігація:

1. [Опис даних](#id-1.-opis-danikh)
2. [Отримання номеру телефона користувача](#id-2.-otrimannya-nomeru-telefona-koristuvacha)
3. [Можливі способи інтеграції](#id-3.-mozhlivi-sposobi-integraciyi)

***

#### 1. Опис даних:

Приклад відображенню заявки з інтегрованої CRM  в блоці користувача на сторінці [**Чати**](https://app.jedidesk.com/chat):&#x20;

<div><figure><img src="/files/3fOx3urodw4dltXEuoE0" alt=""><figcaption></figcaption></figure> <figure><img src="/files/z2Oqtr4yZxvgex11SGTn" alt=""><figcaption></figcaption></figure></div>

Блок <mark style="background-color:green;">**Заявка**</mark>:

* id заявки у внутрішній системі CRM
* дата створення заявки у внутрішній системі CRM
* статус заявки
* коментар до заявки

Блок <mark style="background-color:purple;">**Контактні дані**</mark>:

* ПІБ користувача
* email користувача з можливістю написати
* телефон користувача з можливістю зателефонувати

Блок <mark style="background-color:green;">**Оплата**</mark>:

* Метод оплати
* Додаткові дані оплати (статус, хто сплачує і т.д.)

Блок <mark style="background-color:orange;">**Доставка**</mark>:

* Метод доставки
* Додаткові дані доставки (статус, адреса, номер накладної і т.д.)

Блок <mark style="background-color:purple;">**Товари**</mark>:

* Назва та артикул товару
* Кількість товару
* Ціна за 1 позицію та стара ціна за 1 позицію
* Загальна вартість заявки

Кнопка <mark style="background-color:blue;">**Переглянути заявку в CRM**</mark> - пряме посилання на заявку у внутрішній системі CRM.

Кнопка <mark style="background-color:blue;">**Дані про наступну заявку**</mark> згортає детальну інформацію про заявку.

***

#### 2. Отримання номеру телефона користувача:&#x20;

В **Налаштування ->** [**Компанія**](https://app.jedidesk.com/settings-company) активуйте функцію отримання номера телефону користувача в чат-ботах Telegram, Viber та через чат на сайті:

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

Після активації даного функціоналу, в чат-ботах Telegram та Viber в головному меню з'явиться кнопка **Поділітись телефоном**, при натисканні на яку буде відправлено номер телефона користувача:

<div><figure><img src="/files/zIyeEeaJ7FY8ilxw7we7" alt=""><figcaption><p>Telegram</p></figcaption></figure> <figure><img src="/files/qDZp3IJ9st0qsM3uch85" alt=""><figcaption><p>Telegram</p></figcaption></figure></div>

<div><figure><img src="/files/O5X2eA97uKrOccQkeofQ" alt=""><figcaption><p>Viber</p></figcaption></figure> <figure><img src="/files/qSxi03uD50UH2gwq9buo" alt=""><figcaption><p>Viber</p></figcaption></figure></div>

<figure><img src="/files/xe1iM3E6kXyCqmXegSBA" alt=""><figcaption><p>Віджет</p></figcaption></figure>

***

Також, вказати номер телефону користувача можна у картці користувача на сторінці [**Чати**](https://app.jedidesk.com/chat): &#x20;

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

***

#### 3. Можливі способи інтеграції:&#x20;

* [**REST API**](https://app.jedidesk.com/rest-api-docs) для можливості отримання, створення, редагування та видалення заявок
* Інтеграція із [**SalesDrive CRM**](/integraciyi/integraciya-z-salesdrive)
* Інтеграця із [**PipeDrive CRM**](/integraciyi/integraciya-z-pipedrive)


# Інтеграція з SalesDrive

Покрокова інструкція з інтеграції SalesDrive CRM з сервісом #jedidesk

{% hint style="info" %}
Інтеграція з SalesDrive доступна лише для тарифу Pro та Pro+
{% endhint %}

Інтеграція з SalesDrive дозволяє автоматизувати отримання заявок з CRM-системи. Отримані заявки будуть відображені в модулі [LiveChat](https://app.jedidesk.com/chat) з деталями в картці користувача:

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

Заявки пов'язуються з користувачами по полю введення номера телефону.

***

На сервісі #jedidesk відкрийте вкладку **Налаштування** **->** **Інтеграції ->** [**Інтеграція з SalesDrive CRM**](https://app.jedidesk.com/integration/sales-drive) та активуйте інтеграцію:

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

* **ID магазину** - це URL з вашої SalesDrive CRM.\
  Наприклад [https://**jedi**.salesdrive.me/](https://testjedi.salesdrive.me/ru/index.html?formId=1#/order/index), тут **jedi** є значенням ID магазину.
* **Токен** \
  Перейдіть в **SalesDrive ->  Установки -> Загальні налаштування і інтеграції -> Інші сервіси -> API -> API-ключі -> Редагувати API-ключ**:

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

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

<figure><img src="/files/08jkCjGxqexIWKl1DAbU" alt=""><figcaption></figcaption></figure>

Створіть ключ інтеграції:&#x20;

1. Вкажіть довільну назву
2. Налаштуйте всі доступи.
3. Збережіть налаштування

<figure><img src="/files/EE36RdRJsVeEjPxFyyuU" alt=""><figcaption><p>API-ключі -> Створити API-ключ</p></figcaption></figure>

<figure><img src="/files/uTDAU4wKcUOztLx77fKt" alt=""><figcaption><p>Налаштування доступів</p></figcaption></figure>

<figure><img src="/files/CIKwDRlKSmKTEpuhCAIi" alt=""><figcaption><p>Редагувати АРІ-ключ</p></figcaption></figure>

***

Після активації інтеграції зʼявиться кнопка <mark style="background-color:blue;">**Імпорт**</mark>, по кліку на яку відбудеться імпорт всіх заявок із SalesDrive CRM:

<figure><img src="/files/kjpEYjkdHpAt15CSWrSQ" alt=""><figcaption><p>Імпорт заявок із SalesDrive</p></figcaption></figure>

***

#### Налаштування webhook:

Отримуйте нові заявки, або зміни по наявних заявках в реальному часі за допомогою webhook-налаштувань інтеграції.&#x20;

Для налаштування webhook відкрийте **SalesDrive CRM -> Установки -> Загальні налаштування і інтеграції -> Інші сервіси -> webhook** та натисніть <mark style="background-color:blue;">**Додати**</mark>:

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

На сторінці виберіть події **Створення заявки** та **Зміна статусу заявки**, вкажіть URL webhook, який згенерований на сторінці налаштувань інтеграції #jedidesk:

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

Вкажіть в вимикачі **Інформація про заявку** **-> Повна інформація** та збережіть налаштування:

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

Відтепер при зміні або створенні заявок в SalesDrive CRM будете отримувати заявки в систему #jedidesk, де вони будуть повʼязуватись із користувачами по номеру телефона.


# Інтеграція з PipeDrive

Покрокова інструкція з інтеграції PipeDrive CRM з сервісом #jedidesk

{% hint style="info" %}
Інтеграція з SalesDrive доступна лише для тарифу Pro та Pro+
{% endhint %}

Інтеграція із PipeDrive дозволяє автоматизувати отримання угод з CRM-системи. Отримані угоди будуть відображені в модулі [LiveChat](https://app.jedidesk.com/chat) з деталями в картці користувача:

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

Угоди пов'язуються з користувачами по полю введення номера телефону.

***

На сервісі #jedidesk відкрийте вкладку **Налаштування** **->** **Інтеграції ->** [**Інтеграція з PipeDrive CRM**](https://app.jedidesk.com/integration/pipe-drive) та активуйте інтеграцію:

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

* **ID магазину** - це URL з вашої PipeDrive CRM.\
  Наприклад [https://**jedidesk**.pipedrive.com](https://jedidesk.pipedrive.com/pipeline/1/filter/505), тут **jedidesk** є значенням ID магазину.
* **Токен** \
  Перейдіть в **PipeDrive ->  Персональні налаштування -> API,** скопійюйте ваш ключ інтеграції, вставте на сервіс #jedidesk:&#x20;

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

Натисніть <mark style="background-color:blue;">**Зберегти**</mark>.

***

Щоб в чаті #jedidesk менеджер (оператор) отримував звернення від своїх зафіксованих в PipeDrive угод  (клієнтів), поверніться до вкладки **Налаштування** **->** **Інтеграції ->** [**Інтеграція з PipeDrive CRM**](https://app.jedidesk.com/integration/pipe-drive) та активуйте функцію **Синхронізація менеджерів** та оберіть менеджерів, які мають синхонізуватися:

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

***

#### Налаштування webhook:&#x20;

Отримуйте нові заявки, або зміни по наявних заявках в реальному часі за допомогою webhook-налаштувань інтеграції.&#x20;

Для налаштування webhook відкрийте **PipeDrive CRM -> Інше -> Автоматизація -> Вебхуки** та натисніть **Створити новий вебхук**.

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

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

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

На сторінці виберіть **Дії події -> Об'єкт події -> deal** та вкажіть **Endpoint URL - webhook**, який згенерований на сторінці налаштувань інтеграції #jedidesk:

\-

Поля **Імʼя користувача** та **Пароль HTTP-автентифікації** залиште порожніми та збережіть налаштування.

Відтепер при зміні або створенні угод в PipeDrive CRM будете отримувати угоди в систему #jedidesk, де вони будуть повʼязуватись із користувачами по номеру телефона.

***

#### Функція автостворення угод:

На сторінці налаштувань інтеграції із PipeDrive CRM є можливість активувати функцію автостворення угод. Для цього увімкніть ✅ **Створювати контакти та угоди**.

**Логіка наступна**: при редагуванні номеру телефона користувача, відбувається перевірка наявності контакта із даним номером в системі PipeDrive.&#x20;

Якщо такого номера не було знайдено, то створюється нова угода із назвою **(#jd) Deal <ПІБ користувача>**, передається телефон та email, якщо заповнено.

Автоматично така заявка буде створена і в блоці **Заявки користувача**, де можна переглянути деталі та перейти по прямому посиланню в угоду у системі PipeDrive.

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

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


# Інтеграція з Google Tag Manager

Покрокова інструкція з інтеграції Google Tag Manager з віджетом #jedidesk

Навігація:

1. [Створення облікового запису в Google Tag Manager](#id-1.-stvorennya-oblikovogo-zapisu-v-google-tag-manager)
2. [Інтеграція #jedidesk з Google Tag Manager](#id-2.-integraciya-jedidesk-z-google-tag-manager)

#### 1. Створення облікового запису в Google Tag Manager

Якщо у вас немає облікового запису в GTM, зареєструйтеся згідно [інструкції від Google](https://support.google.com/tagmanager/answer/6103696?hl=uk\&sjid=15006238655126293874-EU#zippy=%2C%D0%BA%D0%B0%D0%BA-%D0%B4%D0%BE%D0%B1%D0%B0%D0%B2%D0%B8%D1%82%D1%8C-%D0%B4%D0%BE%D0%BF%D0%BE%D0%BB%D0%BD%D0%B8%D1%82%D0%B5%D0%BB%D1%8C%D0%BD%D1%8B%D0%B5-%D0%BA%D0%BE%D0%BD%D1%82%D0%B5%D0%B9%D0%BD%D0%B5%D1%80%D1%8B-%D0%B2-%D0%B0%D0%BA%D0%BA%D0%B0%D1%83%D0%BD%D1%82):

1. У [**Менеджері тегів**](https://tagmanager.google.com/) перейдіть на вкладку **Облікові записи** -> **Створити обліковий запис**.
2. Введіть **назву облікового запису** *(назва вашої компанії*) й виберіть для нього країну.
3. Введіть описову **назву контейнера** та виберіть його тип (наприклад, *Веб-сайт*):

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

4. Щоб створити контейнер, натисніть <mark style="background-color:blue;">**Створити**</mark>.
5. Поставте галочку та прийміть Умови використання, натиснувши <mark style="background-color:blue;">**Так**</mark>:

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

***

Під час першого завантаження нового контейнера відобразиться діалогове вікно залежно від його типу:

* **Веб- і AMP** - Ви отримаєте фрагмент коду встановлення для свого веб-сайту.
* **iOS і Android** - Ви отримаєте посилання на документацію для розробників.
* **Сервер** - Ви можете налаштувати сервер автоматично або вручну.

<figure><img src="/files/83bfljzbang2y3BdK7av" alt=""><figcaption></figcaption></figure>

Ви можете встановити контейнер зараз або очистити діалогове вікно, натиснувши **OK**, і продовжити [встановлення](https://support.google.com/tagmanager/answer/6103696?hl=uk\&sjid=15006238655126293874-EU#install) пізніше.

Якщо ви хочете збирати показники з кількох джерел, наприклад із веб-сайту та додатка, створіть для кожної платформи додаткові контейнери.

***

#### 2. Інтеграція #jedidesk з Google Tag Manager

1. На сервісі **#jedidesk** у вкладці **Налаштування -> Інтеграції ->** [**Налаштування віджета**](https://app.jedidesk.com/settings-widget) скопіюйте згенерований код.
2. Авторизуйтеся в [**Google Tag Manager**](https://tagmanager.google.com/), відкрийте вкаду **Теги** та натисніть <mark style="background-color:blue;">**Створити**</mark>:

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

3. Дайте ім’я для свого тегу (наприклад, назва вашого сайту).
4. Натисність на блок **Конфігурація тегу -> Користувацький HTML-тег** зі списку тегів з правого боку:

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

4. Вставте[ скопійований код віджета #jedidesk](/vidzhet/yak-stvoriti-chat-jedidesk) у поле **HTML**.
5. В блоці **Тригери** виберіть **All Pages** (Усі сторінки) та натисніть <mark style="background-color:blue;">**Зберегти**</mark>:

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

6. Щоб завершити установку тега, натисніть кнопки <mark style="background-color:blue;">**Надіслати**</mark>**&#x20;->** <mark style="background-color:blue;">**Опублікувати**</mark> у верхньому правому куті сторінки.&#x20;
7. Перевірте введені дані та повторно натисніть <mark style="background-color:blue;">**Опублікувати**</mark>.


# Інтеграція з email

Інструкція з інтеграції поштових скриньок з #jedidesk

1. Відкрийте вкладку **Налаштуваня -> Інтеграції -> Інтеграція з Email**.
2. Скопіюйте згенерований сервісний email та налаштуйте на своїй робочій пошті переадресацію на нього.&#x20;

<figure><img src="/files/ORZF9OnLkxfIaK418DCH" alt=""><figcaption><p>Індивідуально згенерований сервісний email для переадресації на сервіс #jedidesk</p></figcaption></figure>

3. Вам потрібно отримати наступні дані від поштового сервісу, яким ви користуєтесь.\
   Для цього вам може знадобитися допомога вашого програміста:

* SMTP host&#x20;
* SMTP port&#x20;
* SMTP encryption (SSL або TLS)

Наприклад, для інтеграції з Gmail введіть наступні дані:

* SMTP host - smtp.gmail.com
* SMTP port - 465 (якщо SLL) або 587 (якщо TLS)
* SMTP username - ваша поштова скринька
* SMTP password - пароль вашої поштової скриньки
* SMTP encryption -  SSL (для 465) або TLS (для 587)
* SMTP From address - ваша поштова скринька
* SMTP From name - ім'я вашої поштової скриньки, його будуть бачити отримувачі листів.

Для інтеграції з adm.tools (Україна):

* SMTP host - mail.adm.tools
* SMTP port  - 465
* SMTP encryption - TLS

<figure><img src="/files/eI4FzSOG9TGbc7J6oVo8" alt=""><figcaption><p>Налаштування інтеграції #jedidesk з adm.tools</p></figcaption></figure>

4. Увімкніть інтеграцію та натисніть <mark style="background-color:blue;">**Зберегти**</mark>.
5. Коли ви отримаєте лист, в LiveChat таке звернення буде відмічене як ✉️ (email).\
   В повідомленні ви будете бачити тему листа та сам лист.\
   В картці клієнта ви будете бачити поштову скриньку, з якої він звернувся до вас:

<figure><img src="/files/FiuvgWGyATdTZZfq0Mc8" alt=""><figcaption><p>email від клієнта в LiveChat</p></figcaption></figure>

6. Далі ви отримаєте 2 типи відповіді на email: Чат та Email

<figure><img src="/files/xoIEiOByp8fSJJaOkTFL" alt=""><figcaption><p>Вибір вкладок для відповіді на лист</p></figcaption></figure>

1. **Якщо ваш клієнт з самого початку писав вам з email**, то єдина різниця між відповідями на його лист з даних вкладок це:

* **Чат** відправить лист зі стандартною темою "Нове повідомлення від \*Назва вашої компанії\*
* **Email** дозволить змінити тему вашого листа до клієнта.

2. **Якщо ви отримували звернення з віджета та клієнт вказав свій email**, ви можете одразу обрати вкладку **Email** та відповісти через неї. \
   В такому випадку вся історія переписки буде продубльована клієнту у віджет, але фактично від буде отримувати від вас листи на свою пошту.
3. **Якщо ви отримували звернення з Telegram або Viber**, але в картці клієнта був вказаний email, ви також можете надіслати лист на пошту замість чату. \
   В такому випадку історія переписки не буде продубльована в чат-боти. \
   Щоб продовжити листування в чат-боті, потрібно обрати вкладку **Чат** для відповіді.


# Інтеграція з ХОРОШОП

Підключіть ваш інтернет-магазин на Хорошоп до JediDesk - і AI-асистент автоматично отримає доступ до вашого каталогу товарів та замовлень. Це дозволяє відповідати на питання клієнтів 24/7 без участі менеджера.

***

### Що дає ця інтеграція

Після підключення Хорошоп до JediDesk ваш AI-асистент зможе:

* **Знаходити товари з каталогу** - клієнт описує, що шукає, асистент підбирає відповідні позиції з вашого магазину
* **Рекомендувати товари** - на основі запиту клієнта пропонує релевантні варіанти та альтернативи
* **Перевіряти статус замовлення** - клієнт запитує про своє замовлення, асистент миттєво надає актуальну інформацію зі статусом

Усе це відбувається автоматично, без ручного втручання менеджера.

### 1. Реєстрація в Хорошоп

#### Перехід на сайт

Перейдіть на офіційний сайт платформи [Хорошоп ](https://horoshop.ua/ua/)та заповніть форму реєстрації.

Вам потрібно вказати:

* Ім’я та Призвище
* Номер телефону

Після заповнення форми натисніть кнопку **«Зареєструватися»**.

***

#### 2. Отримати логін, пароль та домен

На вказану електронну пошту прийде лист де буде вказан:

* Домен вашого сайту (знадобиться для вводу у JediDesk)
* Посилання на адмін панель для керування вашим ХОРОШОП
* Логін від адмін панелі ХОРОШОП (знадобиться для вводу у JediDesk)
* Пароль від адмін панелі ХОРОШОП (знадобиться для вводу у JediDesk)

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

***

#### 3. Інтеграція ХОРОШОП та JediDesk

Перейдіть у ІНТЕГРАЦІЇ - [ІНТЕГРАЦІЇ З ХОРОШОП](https://app.jedidesk.com/integration/horoshop)

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

***

У цьому вікні вам треба заповнити домен, логін та пароль з [пункту 2](#id-2.-otrimati-login-parol-ta-domen) та натиснути зберегти.

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

Для того щоб відбулась інтеграція з вашим каталогом товарів на ХОРОШОП, потрібно у цьому вікні натиснути "Імпорт товарів" а потім "Зберегти"

> Важливо щоб попередньо не було підвантажено ніяких каталогів товарів через [YML Goods](https://app.jedidesk.com/integration/yml-goods). Якщо баща товарів була попередньо завантажена, треба видалити базу товарів, вимкунти інтеграцію цієї функції і знов виконати інтеграцію з ХОРОШОП.\
> Якщо  [YML Goods](https://app.jedidesk.com/integration/yml-goods) попередньо не використовувалось та не заповнювалось - ХОРОШОП буде одразу працювати правильно

***

#### 4. Перевірка роботи

Перейдіть на сайт та створіть замовлення.<br>

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

Тепер це замовлення відображається у вашій адмін панелі ХОРОШОП

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

Задайте питання про статус замовлення АІ-асистенту JediDesk, та він надасть інформацію про статус замовлення

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

***

#### Також рекомендуємо встановити віджет JediDesk на ваш сайт ХОРШОП для оперативного зв'язку клієнтів з АІ-асистентом та вашими менеджерами

{% embed url="<https://docs.jedidesk.com/vidzhet/dodati-chat-na-sait/vstanovlennya-chatu-jedidesk-na-khoroshop>" %}

### Юзер-кейси

#### 🔍 Пошук товару за описом

**Ситуація:** Клієнт не знає точної назви товару, але описує, що йому потрібно.

> Клієнт: «А як називається крем для захисту шкіри від ультрафіолету? мені треба такий»
>
> AI-асистент: Знаходить у каталозі відповідні позиції та пропонує декілька варіантів з назвою, ціною та посиланням.

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

Менеджер не витрачає час на ручний пошук - асистент обробляє такі запити миттєво та цілодобово.

***

#### 🎯 Рекомендації товарів

**Ситуація:** Клієнт хоче вибрати між кількома варіантами або шукає щось конкретне за параметрами.

> Клієнт: «Чи є можна придбати ці засоби в пакеті, щоб ціна була нижчою?»
>
> AI-асистент: Фільтрує каталог за критеріями клієнта та пропонує підходящі товари за можливостями клієнта.

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

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

Асистент допомагає клієнту прийняти рішення і підвищує ймовірність покупки без участі менеджера.

***

#### 📦 Перевірка статусу замовлення

**Ситуація:** Клієнт хоче дізнатися, де його замовлення.

> Клієнт: «Яка ситуація з моїм замовленням №12345, номер телефону+380996567788?»
>
> AI-асистент: Звертається до Хорошоп і відразу повідомляє актуальний статус замовлення.

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

Менеджери перестають витрачати час на типові запити про статус - AI відповідає на них автоматично.


# Інтеграція з E-Chat

Ця інструкція допоможе вам самостійно підключити номер телефону в Telegram, Viber або WhatsApp щоб писати першим свої кл

## ⚠️ Перед підключенням: чи "прогрітий" ваш номер?

Системи месенджерів (особливо WhatsApp та Viber) автоматично відстежують підозрілу активність на номері й можуть **заблокувати номер**, якщо побачать ознаки спам-розсилки. Підключення через E-chat одразу після того, як номер активно почав писати новим людям, — одна з найчастіших причин блокування.

**Це особливо критично, якщо номер:**

* щойно зареєстрований у месенджері (Telegram/Viber/WhatsApp), **або**
* раніше не використовувався активно для спілкування з людьми, **або**
* ви плануєте одразу після підключення почати масово писати новим контактам першими

#### Що робити: "прогрів" номера перед підключенням

Якщо номер новий або ви не впевнені в його репутації — **перед підключенням до E-chat / #jedidesk**:

1. **Протягом 3–5 днів** користуйтеся номером **вручну, з мобільного додатку** (не через сервіс)
2. Робіть **по 3–6 ініціацій діалогів на добу** (тобто пишете першими 3–6 новим людям на день, не більше)
3. Паралельно ведіть переписку у вже **існуючих чатах** — відповідайте, листуйтеся, як зазвичай
4. Лише **після 3–5 днів** такого "прогріву" підключайте номер до E-chat і #jedidesk

Якщо номер уже підключений і ви помітили проблеми (повідомлення не доходять, акаунт обмежено) — **тимчасово відключіть номер від інтеграції** і протягом найближчих **3 днів** користуйтеся ним тільки вручну з мобільного додатку, без сервісу. Після цього спробуйте підключити знову.

📌 **Це не вимога E-chat чи #jedidesk** — це обмеження самих месенджерів. Ні E-chat, ні #jedidesk не можуть гарантувати розблокування номера, якщо месенджер вирішив, що це спам.

## Крок 1. Реєстрація в E-chat

1. Перейдіть на сайт 👉 <https://e-chat.tech/profile/registration?ref=39256f4b-3d43-47be-98ba-77949a248b24><br>

   <figure><img src="/files/CzltNE6uhRESDBLt6Tp7" alt=""><figcaption></figcaption></figure>
2. Натисніть **"Sign Up"** / **"Реєстрація"**
3. Заповніть форму реєстрації (email, пароль) і підтвердіть реєстрацію\ <br>

   <figure><img src="/files/BdCJVEFUb02Mhkn2ETpW" alt=""><figcaption></figcaption></figure>
4. Увійдіть до свого особистого кабінету&#x20;

***

> E-chat надає **безкоштовний тестовий період**: 7 днів для першого підключеного номера кожного месенджера, і 3 дні для кожного наступного номера. Оплата на цьому етапі не потрібна.\
> \
> На сканування QR-коду буде відведено від 2 до 9 хвилин залежно від месенджера — підготуйте телефон із потрібним додатком заздалегідь.

***

## Крок 2. Підключення номера

### <img src="/files/GfM78sDqJVaPYVNxK0Si" alt="" data-size="line"> **TELEGRAM**

1. У лівому верхньому куті оберіть месенджер **Telegram** та натисніть **"Підключити номер Telegram"**<br>

   <figure><img src="/files/ZOTRvo6z4rEfMq1Vy5bJ" alt=""><figcaption></figcaption></figure>
2. У спливаючому вікні з'явиться вибір CRM — оскільки готового пункту "JediDesk" у списку **немає**, обираємо загальний варіант (**API** / **Інше**); номер у JediDesk буде підключений пізніше через API-ключ (крок 7)<br>
3. Натисніть **"Підключити номер"**<br>

   <figure><img src="/files/yGxjHfdCezSnX3VhNRYe" alt=""><figcaption></figcaption></figure>
4. Підготуйте телефон з Telegram і натисніть **"Генерувати QR"**
5. Зачекайте, поки згенерується QR-код (зазвичай до 2 хвилин)<br>

   <figure><img src="/files/c2G1lcvVJ2VaA9sJHl6R" alt=""><figcaption></figcaption></figure>
6. Активуйте номер:

   * візьміть телефон з Telegram
   * відкрийте **Налаштування → Пристрої** (або іконка пристроїв у верхньому правому куті списку чатів)

   <figure><img src="/files/rNS8KhxofswMvCOMy0jF" alt="" width="375"><figcaption></figcaption></figure>

   * натисніть **"Скан QR"** / **"Підключити пристрій"**\ <br>

     <figure><img src="/files/v2LhBPd0I6TcDhNPGrhx" alt="" width="375"><figcaption></figcaption></figure>
   * відскануйте QR-код, що відображається в E-chat
   * якщо в Telegram увімкнено хмарний пароль — введіть його протягом хвилини<br>

     <figure><img src="/files/U2YYmQJB5pzM8VB5jQtq" alt=""><figcaption></figcaption></figure>
7. Якщо все пройшло успішно — в кабінеті E-chat з'явиться повідомлення про успішну активацію, і відкриється вкладка з інструкцією з підключення до CRM<br>

***

### <img src="/files/SpeKIr5V9hqLqtysRi5A" alt="" data-size="line"> **VIBER**

1. У лівому верхньому куті натисніть **"Підключити номер Viber"**<br>

   <figure><img src="/files/kTRoX7nQIqRb3CDVuZRR" alt=""><figcaption></figcaption></figure>
2. У спливаючому вікні оберіть API  та введіть номер у **міжнародному форматі** (наприклад, +380...)\ <br>

   <figure><img src="/files/7kpqe17Sep0rfQT94uMA" alt=""><figcaption></figcaption></figure>
3. Натисніть **"Генерувати QR"** і зачекайте (зазвичай 20 секунд, максимум 2 хвилини)<br>

   <figure><img src="/files/Jedegbt8q7M24CcYYEuq" alt=""><figcaption></figcaption></figure>
4. Активуйте номер одним із двох способів:
   * **Через камеру:** відкрийте Viber на телефоні → вкладка **"Ще"** (три риски/крапки) → іконка сканера QR у верхньому правому куті → відскануйте код<br>

     <figure><img src="/files/viRRKE939czUSsXticWo" alt="" width="375"><figcaption></figcaption></figure>

* **Якщо камера не працює:** натисніть "Не працює камера?" → скопіюйте унікальне посилання → відкрийте його в браузері на телефоні → підтвердьте авторизацію в застосунку Viber

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

5. На телефон прийде системне повідомлення Viber про новий вхід з нового пристрою — **не видаляйте** цей пристрій із налаштувань, інакше інтеграція перестане працювати
6. В кабінеті E-chat з'явиться підтвердження успішної активації

***

### <img src="/files/Tct6SHvIk2xLY9bCDJw4" alt="" data-size="line">  WHATSAPP

1. У лівому верхньому куті натисніть **"Підключити номер WhatsApp"**<br>

   <figure><img src="/files/vYTBN5Gdln1BTgBE8jbY" alt=""><figcaption></figcaption></figure>
2. У спливаючому вікні оберіть API  та введіть номер у міжнародному форматі<br>

   <figure><img src="/files/iqTLTo1QoL8ZhXixMhlQ" alt=""><figcaption></figcaption></figure>
3. Натисніть **"Генерувати QR"**<br>

   <figure><img src="/files/JvCUeZUC4cz8kmUDp5wP" alt=""><figcaption></figcaption></figure>
4. Відкрийте WhatsApp на телефоні → відскануйте QR-код (через WhatsApp Web / Пов'язані пристрої)

<div><figure><img src="/files/Y3BdjjNxKkTUqLYzoUmH" alt="" width="375"><figcaption></figcaption></figure> <figure><img src="/files/89xFX5T9nA2JMAifeu6y" alt="" width="375"><figcaption></figcaption></figure></div>

5. Дочекайтесь підтвердження успішної активації в кабінеті E-chat

***

## Крок 2. Отримання API-ключа для підключеного номера

1. Знайдіть **API-ключ** для щойно підключеного номера (відображається в таблиці підключених номерів на головній сторінці кабінету, у колонці **"API key"**)<br>

   <figure><img src="/files/QLc0OqaBcbBuXyLH6Hez" alt=""><figcaption></figcaption></figure>
2. Скопіюйте цей ключ — він знадобиться на наступному кроці

***

## Крок 3. Підключення каналу в #jedidesk

1. У бічному меню перейдіть у розділ **Інтеграції**
2. Відкрийте вкладку **"Канали"**
3. Знайдіть картку **"Інтеграція з E-chat"** <br>

   <figure><img src="/files/uz8yCN3SzsCvLOuCnSKH" alt=""><figcaption></figcaption></figure>
4. Натисніть **"Налаштування інтеграції"**
5. Відкриється сторінка **E-chat** з таблицею підключених каналів (поки що порожня — "Підключень ще немає") та кнопкою **"+ Додати канал"** у верхньому правому куті<br>

   <figure><img src="/files/jeytwHbc8kkCzdu6AojH" alt=""><figcaption></figcaption></figure>
6. Натисніть **"+ Додати канал"** — з'явиться спливаюче вікно з полями:<br>

   * **Канал** — оберіть з випадного списку потрібний месенджер (Telegram / Viber / WhatsApp)
   * **Номер** — введіть номер у форматі 098... або 380... (той самий, що активували в E-chat)
   * **API key** — вставте ключ, скопійований на кроці 6
   * **Назва** — довільна назва для зручності (наприклад, "Telegram — основний номер")

   <figure><img src="/files/6oTP7hx5u3OBgKu0zOcm" alt=""><figcaption></figcaption></figure>
7. Натисніть **"Зберегти"**
8. Канал з'явиться в таблиці зі статусом підключення

## Крок 4. Додати зв'язати JediDesk та E-chat через Webhook

1. У вікні, що з'явилося, натисніть кнопку "СКОПІЮВАТИ"<br>

   <figure><img src="/files/A8I6Y6FbqSn9aIvphI2L" alt=""><figcaption></figcaption></figure>
2. Повертаємось у Е-Chat та натискаємо біля номеру "НАЛАШТУВАННЯ" - "ДОДАТИ ВЕБХУК"<br>

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

<figure><img src="/files/e48NSF0Ac3bLQlX2Cj2S" alt="" width="563"><figcaption></figcaption></figure>

3. Вставляємо в обидва поля скопійоване посилання - після натиснути "Додати"\ <br>

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

\
Крок 5. Як писати першим?
-------------------------

1. Відкриваємо LiveChat у JediDesk і біля фільтру знаходимо іконку олівця з папером<br>

   <figure><img src="/files/EcfTafzLZMFGazIspqtf" alt=""><figcaption></figcaption></figure>
2. У відкритому вікні обираємо:

* Від кого - канал з якого буде відправлене повідомлення (телеграм, вайбер, вацап)
* Кому - нікнейм або через номер телефону користувача якому хочемо написати
* І'мя - ім'я користувача, як діалог буде відображатись у LiveChat (необов'язкове поле)
* Повідомлення - текст який буде відправлено користувачу<br>

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

3. Натиснути відправити. Створено чат, відправленно повідомлення з власного акаунту телеграм та є фіолетова цяточка біля позначки каналу для ідентифікації каналу спілкування.\
   &#x20;<br>

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

<figure><img src="/files/M5CF0aHxO4gdWwYHh8JR" alt="" width="375"><figcaption></figcaption></figure>


# Як додати менеджера (оператора)

Інструкція з додавання менеджерів до основного профілю #jedidesk

#### Навігація:

1. [Додавання менеджера](#id-1.-dodavannya-menedzhera-operatora)
2. [Налаштування доступів до функціоналу чата](#id-2.-nalashtuvannya-dostupiv-do-funkcionalu-chata)
3. [Підключення сповіщень](#id-3.-pidklyuchennya-spovishen)
4. [Відео-інструкція](#id-4.-video-instrukciya)

***

#### 1. Додавання менеджера (оператора)

У вкладці **Налаштування** **–>** [**Менеджери**](https://app.jedidesk.com/settings-managers) натисніть <mark style="background-color:green;">**+ Додати менеджера**</mark> та введіть наступні дані:

* **Фото**, яке буде відображено в віджеті при спілкуванні з клієнтом.
* **Роль**: менеджер або супервізор.
* **Канали**: оберіть окремі канали звернення, або залиште поле пустим і менеджер буде опрацьовувати звернення з усіх каналів.
* **Статус** – активний.
* **Ім’я**
* **Номер** телефону.
* **Email** для авторизації на #jedidesk.
* **Пароль** менеджер автоматично отримає на свій email.

{% hint style="info" %}
**В чому різниця між менеджером та супервізором?**

Супервізору доступні всі діалоги та часткове налаштування сервісу. Менеджер бачить тільки свої та нові (неприйняті) діалоги.
{% endhint %}

<figure><img src="/files/iW548czQf2BaKTqSIygA" alt=""><figcaption><p>Карточка менеджера (оператора)</p></figcaption></figure>

***

У списку менеджерів можна бачити, хто зі співробітників зараз онлайн:

<figure><img src="/files/nFRgC3QqNyx1iQZWoSjN" alt=""><figcaption><p>Список доданих менеджерів</p></figcaption></figure>

***

#### 2. Налаштування доступів до функціоналу чата

У вкладці **Налаштування ->** [**Компанія**](https://app.jedidesk.com/settings-company) є можливість налаштувати додаткові доступи для менеджера, а також запит на оцінку його роботи для аналітики:

<figure><img src="/files/QmuXvujpQKJFTStXXUnk" alt=""><figcaption><p>Налаштування додаткових доступів для менеджера</p></figcaption></figure>

* **Головна мова** - вкажіть мову, на якій всі клієнти будуть отримувати системні повідомлення (початок та завершення діалогу, підключення оператора, тощо).
* **Показувати сповіщення про приєднання/зміну менеджера чату** - користувач отримає системне повідомлення про підключення менеджера.&#x20;
* **Запитувати у користувача, чи було вирішено його питання** - користувач отримає повідомлення "*У вас ще залишилися запитання?*" з кнопками "*Так / Ні*". Кнопка "*Ні*" автоматично переведе діалог в Архів.
* **Обовʼязкова оцінка діалога користувачем по його завершенню** - увімкніть, якщо даний показник необхідний для [аналітики якості працівників](/znaiomstvo/analitika#ocinka-yakosti-obslugovuvannya).
* **Відображення теми діалогу** - ви можете вказувати кілька [тем діалогу](/nalashtuvannya-jedidesk/nalashtuvannya-temi-dialogu) для [аналітики](/znaiomstvo/analitika#analitika-tem-dialogiv). \
  Якщо це необхідний показник, увімкіть функцію **Обов'язкове зазначення теми діалогу** - чати без тем не зможуть бути закриті.
* **Початок діалогу після активації тригеру автовідповіді** - якщо увімкнути цю функцію, ви будете отримувати повідомлення-сповіщення про користувачів, які переходили за UTM-посиланнями [автовідповідей ](/nalashtuvannya-jedidesk/nalashtuvannya-avtomatichnikh-vidpovidei)в бот (це не є зверненням). Вимкніть цю функцію, якщо ви хочете лише отримувати повідомлення після того як дані клієнти напишуть вам.
* **Заборонити редагування повідомлень у діалогах** - менеджери не зможуть редагувати відправлені повідомлення.&#x20;
* **Заборонити видалення повідомлень** - менеджери не зможуть видаляти відправлені повідомлення.&#x20;
* **Дозволити змінювати менеджера користувачу з роллю Менеджер** - за замовчуванням зміна менеджера доступна лише власнику аккаунта та супервайзеру.&#x20;
* **Дозволити блокувати клієнтів користувачу з роллю Менеджер** - за замовчуванням блокування доступне лише власнику аккаунта та супервайзеру.
* **Закривати діалог через неактивність** - якщо клієнт не відповідає протягом 15 хвилин, діалог автоматично закривається та переходить в Архів. Час очікування можна змінювати або повністю вимкнути цю функцію.

***

#### 3. Підключення сповіщень.

У вкладці **Налаштування ->** [**Профіль**](https://app.jedidesk.com/settings-profile) менеджер повинен самостійно увімкнути функцію сповіщення, яка при переході в системний бот #jedidesk ідентифікує його профіль:

<figure><img src="/files/6UtivacJnNZImR2t5qRf" alt=""><figcaption><p>Налаштування сповіщень через Telegram-бот</p></figcaption></figure>

<figure><img src="/files/5KeJAXQ3oKwhf29qISat" alt="" width="434"><figcaption><p>Налаштування сповіщень через Telegram-бот</p></figcaption></figure>

***

#### 4. Відео-інструкція

{% embed url="<https://www.youtube.com/watch?v=LSMH567TM7o>" %}
Відео-інструкція з налаштування кабінета оператора (менеджера) в #jedidesk
{% endembed %}


# Налаштування розподілення діалогів між менеджерами

Якщо у вас кілька менеджерів, ви можете встановити ліміт на кількість запитів на кожного менеджера.

/У вкладці **Налаштування** **–>** [**Менеджери**](https://app.jedidesk.com/settings-managers) натисніть на ⚙️ біля кнопки <mark style="background-color:green;">**+ Додати менеджера**</mark>, активуйте функціонал розподілення діалогів та вкажіть ліміт:

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

{% hint style="info" %}
**Що таке ліміт?**

Це кількість отриманих чатів, після якої менеджер отримує статус **Невидимка** та не може отримувати нові запити, якщо не змінить статус на **В мережі**.
{% endhint %}

***

Щоб отримувати запити, кожен менеджер повинен натиснути на кнопку <mark style="background-color:blue;">**Почати зміну**</mark>:

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

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

***

Активується статус <mark style="background-color:green;">**В мережі**</mark>:

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

***

Коли ліміт на отримання запитів закінчиться, менеджер автоматично перейде в режим <mark style="background-color:purple;">**Невидимка**</mark>. Щоб отримувати більше запитів, потрібно активувати статус <mark style="background-color:green;">**В мережі**</mark>.

Якщо менеджер відійшов на обід або не знаходиться на робочому місці, також потрібно обрати відповідний статус.

В кінці робочого дня потрібно натиснути кнопку <mark style="background-color:blue;">**Завершити зміну**</mark>:

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

### Звук передачі або призначення чату на менеджера

У нашій системі ви можете увімкнути окреме звукове сповіщення, коли супервізор буде призначати діалог менеджеру або коли менеджер №1 передає діалог менеджеру №2<br>

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

{% file src="/files/IQc9DFqyOkM3TgxN1aFB" %}

<p align="center"><mark style="color:$info;">Звук для ознайомленя</mark></p>

### Сповіщення при передачі діалогу менеджеру🛎️

Ця функція допомагає не загубити діалог після його передачі іншому менеджеру. Новий відповідальний менеджер отримує сповіщення, а діалог автоматично закріплюється, доки не буде надано першу відповідь.

Як увімкнути функцію

1. Відкрийте розділ Налаштування → Менеджери.
2. Натисніть кнопку ⚙️ поруч із кнопкою Додати менеджера.
3. У вікні Налаштування розподілу діалогів увімкніть опцію Сповіщення при передачі діалогу менеджеру.
4. Натисніть Зберегти.

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

Як працює передача діалогу

1. Менеджер №1 передає вже призначений йому діалог менеджеру №2.
2. Менеджер №2 отримує сповіщення про передачу діалогу.
3. Діалог автоматично закріплюється за менеджером №2, щоб він не загубив його серед нових звернень.
4. Якщо відповіді немає, система повторює сповіщення не більше трьох разів з інтервалом в одну хвилину.
5. Після першої відповіді менеджера повторні сповіщення припиняються.

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

### Швидкі дії над діалогом

У шапці відкритого діалогу доступне меню з трьома крапками. За допомогою цього меню менеджер може виконати швидкі дії над діалогом, не змінюючи текст листування.

У меню доступні такі дії:

Копіювати посилання — копіює пряме посилання на діалог.

Закріпити діалог — залишає важливий діалог у верхній частині списку.

Позначити непрочитаним — повертає діалог у список як такий, що потребує уваги.

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

#### Закріплення діалогу

Щоб закріпити діалог, відкрийте меню з трьома крапками у шапці діалогу та оберіть Закріпити діалог.

Закріплений діалог отримує відповідну позначку та відображається вище незакріплених діалогів.

Закріплення є персональним — якщо один менеджер закріпив діалог, він не закріплюється автоматично для інших менеджерів.

Щоб зняти закріплення, відкрийте те саме меню та оберіть Відкріпити діалог.

#### Позначення діалогу непрочитаним

Якщо діалог потребує додаткової уваги, відкрийте меню з трьома крапками та оберіть Позначити непрочитаним.

Після цього поточний діалог закриється, а в списку діалогів біля нього з’явиться індикатор непрочитаного.

Ця дія допомагає повернути діалог у фокус, навіть якщо всі повідомлення в ньому вже були прочитані.

***

#### Важливо🚨

Функція спрацьовує саме під час ручної передачі діалогу від одного менеджера іншому.

Автоматичний розподіл діалогів, прийняття нового діалогу та первинне призначення без попереднього відповідального менеджера не запускають ці сповіщення.

Якщо вимкнути функцію, активні повторні сповіщення припиняться, а службове закріплення діалогу буде знято. Закріплення, яке менеджер встановив вручну, залишиться.


# Як створити команду менеджерів

## Команди менеджерів

Команди дозволяють об'єднувати менеджерів у групи та автоматично розподіляти вхідні діалоги між ними. Це зручно, якщо у вас є окремі відділи, напрямки або категорії клієнтів — наприклад, ВІП-клієнти, технічна підтримка, продажі.

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

***

### Як перейти до команд

Відкрийте **Налаштування → Менеджери** і натисніть кнопку **«Команди»** у правому верхньому куті сторінки.

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

***

### Створення команди

На сторінці **«Команди»** натисніть **«+ Додати команду»**.

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

Заповніть форму:

1. **Назва** — введіть назву команди, наприклад *ВІП* або *Підтримка*.
2. **AI працює для цієї команди** — за замовчуванням увімкнено. Детальніше про цю опцію — нижче.
3. **Менеджери** — оберіть зі списку одного або кількох менеджерів, які входитимуть до цієї команди.
4. Натисніть **«Зберегти»**.

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

***

### Налаштування AI для команди

У формі створення та редагування команди є чекбокс **«AI працює для цієї команди»**.

**Що це означає:**

* **Чекбокс увімкнено (✓)** — після призначення діалогу до цієї команди AI-асистент продовжує працювати в ньому в штатному режимі.
* **Чекбокс вимкнено** — після призначення діалогу до команди AI-асистент більше не відповідає в цьому діалозі. Діалог повністю переходить під контроль менеджера.

{% hint style="warning" %}
**Коли вимикати AI для команди?** Вимикайте AI для команд, де потрібна виключно жива комунікація — наприклад, для ВІП-клієнтів або складних звернень, де менеджер має вести діалог самостійно.
{% endhint %}

{% hint style="info" %}
Якщо команди не створені, розподіл діалогів і робота AI працюють за загальними налаштуваннями, як і раніше.
{% endhint %}

***

### Редагування команди

1. На сторінці **«Команди»** знайдіть потрібну команду і натисніть іконку редагування (олівець).
2. Змініть назву, склад менеджерів або налаштування AI.
3. Натисніть **«Зберегти»**.<br>

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

***

### Автоматичне призначення команди

Діалог можна автоматично призначати до команди за ідентифікатором клієнта — наприклад, за номером телефону або іншими параметрами.

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

{% hint style="info" %}
Для налаштування автоматичного призначення команди зверніться до **технічної підтримки JediDesk**.
{% endhint %}

***

### Як це виглядає в роботі

Після того як діалог потрапляє до команди:

* Менеджери цієї команди бачать діалог і можуть з ним працювати.
* AI-асистент працює або не працює в діалозі — залежно від налаштування чекбоксу команди.
* Менеджер, якому призначено діалог, може вести переписку, але не може самостійно змінити команду або переназначити менеджера — ця дія доступна лише супервізору або власнику акаунту.


# Дозвіл на перегляд діалогів інших менеджерів

Якщо менеджеру потрібно бачити не лише свої та нові діалоги, увімкніть цю функцію. Вона дозволяє переглядати діалоги інших менеджерів у межах команд, до яких він належить.

Щоб надати менеджеру такий доступ, у вкладці **Налаштування → Менеджери** знайдіть потрібного менеджера та натисніть іконку редагування.

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

У формі редагування менеджера увімкніть чекбокс **«Дозволити бачити діалоги інших менеджерів»** та натисніть **«Зберегти»**.<br>

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

Після увімкнення цієї опції менеджер бачитиме діалоги інших менеджерів лише в межах команд, до яких він належить.


# Як створити базу знань (FAQ)

База знань – систематизовані відповіді на типові запитання. Користувач або пише запитання в бот та отримує cпівпадаючу відповідь за ключовими словами, або обирає в каталозі потрібну тему та питання

**Навігація:**

1. [Створення категорій](#id-1.-stvorennya-kategorii)
2. [Створення повідомлень (відповіді)](#id-2.-stvorennya-povidomlen-vidpovidi)
3. [Активація бази знань та ключових слів](#id-3.-aktivaciya-bazi-znan-ta-klyuchovikh-sliv)
4. [Приклад роботи бази знань в чат-боті](#id-4.-priklad-roboti-bazi-znan-v-chat-boti)

***

#### **1. Створення категорій**

У вкладці **Автоматизація** **-> База знань** **->** [**Категорії**](https://app.jedidesk.com/faq-category) натисніть <mark style="background-color:green;">**+ Додати категорію**</mark> та заповніть необхідні поля:

* **Назва** категорії
* **Батьківська категорія** (для підкатегорій)
* **Сортування** – порядок, за яким буде відображатися категорія у загальному списку
* **Статус** – **Активний/Неактивний** – відображення категорії в боті

<figure><img src="/files/s3giHiS8kD0jMHtWHa2s" alt=""><figcaption><p>Створення категорій для бази знань (FAQ)</p></figcaption></figure>

Зліва доступна клікабельна панель відображення структури категорій.\
При натисканні на кожну категорію, буде розгорнуто її редагування.

***

#### **2. Створення повідомлень (відповіді)**

У вкладці **Автоматизація -> База знань –>** [**Питання/Відповіді**](https://app.jedidesk.com/faq-category) натисніть <mark style="background-color:green;">**+ Додати питання**</mark> та заповніть необхідні поля:

* **Категорія**, до якої належить повідомлення
* **Назва** питання
* **Текст**, є можливість додати зображення
* Через кому пропишіть **ключові слова**, за якими бот буде давати відповідь на запитання
* **Сортування** – порядок, за яким буде відображатися питання у загальному списку
* **Категорія -** група до якої можна віднести&#x20;
* **Статус** – **Активний/Неактивний** – відображення питання в боті
* **Файли бази знань** - будуть надаватися клієнту при відправці

<figure><img src="/files/Dpz7XPWfzBHxG0YaQ98f" alt=""><figcaption><p>Створення відповіді та вигляд зовнішнього виду інтерфейсу</p></figcaption></figure>

\
**Окрім цього, ви можете самостійно надсилати ці заготовки клієнтам у нашому чаті.**

Для цього вам необхідно перейти до вкладки "Чати" та в діалозі використати спеціальну кнопку&#x20;

<figure><img src="/files/PAUIwt92TYsGQke1t6Sj" alt=""><figcaption><p>Вікно для обрання заготовки</p></figcaption></figure>

Після цього обираєте вашу готову відповідь та надсилаєте її.

<figure><img src="/files/sqQZvWsXrFQUGibreCPg" alt=""><figcaption><p>Відправка повідомлення</p></figcaption></figure>

<figure><img src="/files/1iRLpZmUCQ24G8zR2D8r" alt=""><figcaption><p>Результат</p></figcaption></figure>

***

#### **3. Активація бази знань та ключових слів**

У вкладці **Налаштування ->** [**Компанія** ](https://app.jedidesk.com/settings-company)активуйте базу знань та пошук за ключовими словами:

<figure><img src="/files/U3REbSNdyxWLLy2QLzhH" alt=""><figcaption><p>Підключення бази знань (FAQ)</p></figcaption></figure>

База знань може працювати без ключових слів.

{% hint style="danger" %} <mark style="color:red;">**Увага:**</mark> Якщо в [Базі знань](/nalashtuvannya-jedidesk/yak-stvoriti-bazu-znan-faq) та в [Автовідповідях ](/nalashtuvannya-jedidesk/nalashtuvannya-avtomatichnikh-vidpovidei)вказане однакове ключове слово, в першу чергу бот буде відправляти повідомлення Автовідповіді.
{% endhint %}

***

#### 4. Приклад роботи бази знань в чат-боті

База знань і пошук за ключовими словами відображаються у вигляді кнопок:

<div><figure><img src="/files/z0gnDSy2okHh0stIbT7U" alt=""><figcaption><p>База знань (FAQ) в чат-боті</p></figcaption></figure> <figure><img src="/files/B3LZlVbUPaqEZzyDX8Fr" alt=""><figcaption><p>База знань (FAQ) в чат-боті</p></figcaption></figure></div>

***

Приклад питання-відповіді у вигляді категорії:

<figure><img src="/files/wtBj33S0CU7lp6cPTsLm" alt=""><figcaption><p>База знань (FAQ) як категорії</p></figcaption></figure>

***

Приклад відповіді через пошук за ключовими словами:

<figure><img src="/files/BaA0TwZEtjj9TJgAy5dN" alt=""><figcaption><p>База знань (FAQ) як пошук за ключовими словами</p></figcaption></figure>

<br>


# Як створити розсилку

Розсилки є основним маркетинговим інструментом для підтримки контакту з людьми, які зацікавлені вашим бізнесом та ідеями

{% hint style="danger" %} <mark style="color:red;">**Увага:**</mark>&#x20;

1. Розсилка працює лише для Telegram та Viber ботів.
2. Час відправлення розсилки залежить від часового поясу, який вказано у вашому [профілі](https://app.jedidesk.com/settings-profile).
   {% endhint %}

У вкладці **Розсилки -> Створити розсилку** заповніть бланк:

<figure><img src="/files/5WNNzWzt1PZgslcdzO6F" alt=""><figcaption><p>Створення розсилки</p></figcaption></figure>

1. **Текст**: напишіть повідомлення.\
   Є можливість використовувати emoji. Якщо ви хочете звернутися до користувача за ім’ям, можна додати код <mark style="color:red;">{name}</mark>.\ <mark style="color:red;">**Будьте уважні**</mark>: буде використане ім'я, яке користувач вказував в профілі свого месенджера.
2. **Оберіть платформу**, користувачі якої отримають розсилку – Telegram, Viber, або обидва месенджери.
3. **Теги:** якщо ви привласнювали своїм користувачам відповідні теги, ви можете робити розсилку лише для відповідних груп людей. Для цього оберіть необхідний тег.
4. **Відправлення:** натисніть на поле, щоб обрати на календарі дату та час розсилки.\
   Якщо в цьому немає необхідності, ставимо галочку на “Відправити зараз”.
5. **Зображення:** за бажанням, можна додати зображення до своєї розсилки.\
   Щоб видалити зображення, натисніть під зображенням на кнопку зі сміттєвим кошиком.

<figure><img src="/files/HJZzCewftlnce8JOxX1B" alt=""><figcaption><p>Налаштування запланованої розсилки</p></figcaption></figure>

<figure><img src="/files/77yvY7qGz423urzJaWZH" alt=""><figcaption><p>Налаштування миттєвої розсилки</p></figcaption></figure>


# Як створити швидкі відповіді

Швидкі відповіді – це шаблони, які ви можете відправляти замість того, щоб власноруч писати типові відповіді для своїх користувачів.

#### Навігація:

1. [Створення швидкої відповіді для LiveChat](#id-1.-stvorennya-shvidkoyi-vidpovidi-dlya-livechat)
2. [Швидка відповідь через Telegram](#id-2.-shvidka-vidpovid-cherez-telegram)

***

#### 1. Створення швидкої відповіді для LiveChat

У вкладці **Автоматизація** **–>** [**Швидкі відповіді**](https://app.jedidesk.com/quick-responses) натисніть на кнопку <mark style="background-color:green;">**+ Додати заготовку**</mark> та заповніть шаблон:

<figure><img src="/files/CoahlOl8Qppcfl8sWvv9" alt=""><figcaption><p>Створення швидкої відповіді</p></figcaption></figure>

* **Код:** умовне позначення. Наприклад, “001” або “hello\_ua / hello\_eng” тощо.
* **Текст:** готова відповідь.

При першому відкритті нового діалогу, ви одразу отримаєте розгорнутий список швидких відповідей:

<figure><img src="/files/VdxTh7A9BaUEyhK0ipqL" alt=""><figcaption><p>Список готових відповідей</p></figcaption></figure>

При наступному відкритті діалогу або відповіді клієнту, щоб відправити швидку відповідь, через символ **#** або **.** напишіть код готового повідомлення та виберіть відповідний варіант.

{% hint style="info" %}
Кожен менеджер може додати власні шаблони швидких відповідей, які будуть доступні лише йому.
{% endhint %}

***

#### 2. Швидка відповідь через Telegram

Якщо немає можливості зайти на сервіс #jedidesk, відповісти клієнту можна через бот для сповіщень.

У вкладці **Налаштування ->** [**Профіль**](https://app.jedidesk.com/settings-profile) потрібно увімкнути функцію сповіщення, яка при переході в системний бот #jedidesk ідентифікує ваш профіль:

<figure><img src="/files/6UtivacJnNZImR2t5qRf" alt=""><figcaption><p>Авторизація в Telegram-боті сповіщень</p></figcaption></figure>

Коли бот буде надсилати сповіщення, на них можна відповідати як на звичайні повідомлення:

<figure><img src="/files/eE8B3Wiv64Wi6Jqvftnu" alt="" width="434"><figcaption><p>Діалог через бот сповіщень</p></figcaption></figure>

Діалог буде збережено в LiveChat:

<figure><img src="/files/ZU7OIpDIFkBMKXmrQpOO" alt=""><figcaption><p>Збережений діалог в LiveChat</p></figcaption></figure>


# Налаштування робочого часу компанії

Попередьте своїх клієнтів про робочий час, щоб вони залишались на зв'язку

У вкладці **Налаштування ->** [**Компанія** ](https://app.jedidesk.com/settings-company)активуйте блок з графіком, вкажіть робочі дні та час:

<figure><img src="/files/et5QnPq9PsbD0DhLtoGn" alt=""><figcaption><p>Робочі години</p></figcaption></figure>

***

Додайте повідомлення, яке отримує клієнт при зверненні в неробочий час та натисніть кнопку <mark style="background-color:blue;">**Зберегти зміни**</mark>:

<figure><img src="/files/HqjWlamEiwAtPU02uUkP" alt=""><figcaption><p>Повідомлення з попередженням</p></figcaption></figure>

{% hint style="danger" %} <mark style="color:red;">**Увага:**</mark> Коли розмова в чаті з клієнтом буде завершена, натисніть в правому верхньому кутку кнопку <mark style="background-color:green;">**Закрити діалог**</mark>.

Якщо менеджер не буде закривати діалог, ваші клієнти не будуть отримувати повідомлення про неробочі години компанії.
{% endhint %}

***

## Логіка спрацювання повідомлення про неробочі години

### &#x20;Як саме надсилається повідомлення

#### Telegram / Viber

**Перший контакт (наприклад `/start`)**

Якщо користувач пише **вперше** і зараз **неробочий час**:

* замість стандартного привітального повідомлення
* надсилається повідомлення **про неробочий час**
* **головне меню при цьому все одно відображається**

***

#### При звичайних повідомленнях

Повідомлення **не надсилається на кожне повідомлення клієнта**.

Воно відправляється лише якщо виконується одна з умов:

* це **перше повідомлення в чаті**
* клієнт **пише вперше за сьогодні** (до цього писав учора або раніше)
* минуло **більше 5 хвилин** з моменту останнього повідомлення
* **розмова нова або була закрита**

Якщо клієнт продовжує активно писати в чаті — повідомлення **не повторюється**, щоб уникнути спаму.

***

### Як працює у чаті на сайті (Widget)

У віджеті логіка відрізняється.

Сервер **не надсилає повідомлення автоматично**. Замість цього він передає у віджет два параметри:

* чи зараз **робочий час (так / ні)**
* текст повідомлення **про неробочий час**

Далі вже **сам віджет (JS-код)** вирішує, що показати користувачу. Найчастіше це:

* інформаційна плашка
* повідомлення у чаті
* банер при відкритті чату

***

### Де ця функція не працює

Функція **“Робочий час” наразі не застосовується** для таких каналів:

* Facebook Messenger
* Instagram
* WhatsApp
* Email

Для цих каналів **перевірка робочого часу при отриманні повідомлення не виконується**.

***

### Як це впливає на AI-асистента

Для AI-асистента є окремі налаштування, пов’язані з робочим часом:

**1️⃣ “Працювати поза робочим часом”**\
Якщо вимкнено — AI-асистент **не відповідає**, коли компанія не працює.

**2️⃣ “Вимкнути у робочий час”**\
AI-асистент працює **лише поза робочим часом**. Наприклад, відповідає вночі, а вдень відповідають менеджери.

Ці налаштування **не залежать від повідомлення про неробочий час**.

***

### Основна логіка роботи (коротко)

Повідомлення про неробочий час **не надсилається на кожне повідомлення клієнта**.

Воно відправляється лише у випадках:

* перше повідомлення у чаті
* новий день (клієнт пише вперше сьогодні)
* минуло **більше 5 хвилин** з моменту останнього повідомлення
* чат **новий або був закритий**

Це зроблено для того, щоб **клієнт не отримував одне й те саме повідомлення на кожну репліку**.


# Налаштування теми діалогу

Теми діалогу допомагають збирати статистику по зверненням від ваших клієнтів. Які питання частіше цікавлять ваших клієнтів? З якими проблемами частіше звертаються?

У вкладці **Налаштування ->** [**Компанія** ](https://app.jedidesk.com/settings-company)активуйте **Відображення теми діалогу** та **Обов'язкове зазначення теми діалогу** (якщо кожен діалог має йти в статистику) та натисніть кнопку <mark style="background-color:blue;">**Зберегти зміни**</mark>:

<figure><img src="/files/C2d87c7HWaXNAp70rEaG" alt=""><figcaption><p>Активація тем діалогів</p></figcaption></figure>

***

У вкладці **Автоматизація ->** [**Теми діалогів**](https://app.jedidesk.com/subjects) натисніть <mark style="background-color:green;">**+ Додати тему**</mark>, введіть наступні дані та натисніть кнопку <mark style="background-color:blue;">**Зберегти зміни**</mark>:

1. **Назва теми діалогу** - наприклад, *Доставка Новою Поштою*
2. **Сортування** - налаштуйте порядок відображення теми в загальному списку тем
3. **Статус** - Активуйте або Деактивуйте відображення теми в налаштуванні картки діалогу з клієнтами.

<figure><img src="/files/mGH1ltddbIFuBVPHYPTf" alt=""><figcaption><p>Додавання теми діалогу</p></figcaption></figure>

***

В карточці кожного діалогу з'явиться можливість обирати додані теми:

<figure><img src="/files/yL0B4f6tQcEhjuORShsY" alt=""><figcaption><p>Список всіх тем діалогу</p></figcaption></figure>

<figure><img src="/files/jFpcImVGMWNW7zcb3Glh" alt=""><figcaption><p>Додані теми до діалогу</p></figcaption></figure>

За для потреби можна вимкнути закріплення теми діалогу за чатом, та при новому зверненні, у картці клієнта не буде фіксуватись стара тема діалогу:\
Пееглянути інструкцію із налаштування можна тут: <https://docs.jedidesk.com/znaiomstvo/funkcional-livechat#skidannya-temi-dialogu-pri-zakritti>


# Додаткові поля в карточці клієнта

Кожен клієнт при зверненні має власну карточку з інформацією, яка відображається справа в діалозі в LiveChat. Додаткові поля для будь-якої інформації можна створити самостійно.

У вкладці **Автоматизація** **->** [**Настроювані поля**](https://app.jedidesk.com/customer-custom-fields) натисніть <mark style="background-color:green;">**+ Додати поле**</mark>, заповніть необхідні поля та натисніть кнопку <mark style="background-color:blue;">**Зберегти зміни**</mark>:

1. **Назва поля** - наприклад, ID клієнта, адреса доставки або будь-що необхідне.
2. **Числове значення** - виберіть формат введення: рядок (текст), номер телефона або email.
3. **Сортування** - порядковий номер додаткового поля в карточці клієнта.

<figure><img src="/files/TJacAywmxUrfoqZ2MQGR" alt=""><figcaption><p>Створення додаткового поля</p></figcaption></figure>

***

Тепер при відкритті карточок клієнтів, ви будете бачити нове поле вводу:

<figure><img src="/files/sljEsqjDmZZf7GCYYGof" alt=""><figcaption><p>Додаткове поле в карточці клієнта</p></figcaption></figure>

> Після створення кастомного поля - йому буде присвоєно ID, який можна потім використовувати для інтеграції по REST API, Widget API

***

**👉🏻 Пропонуємо ознайомитись з** [**інструкцією Widget API**](/api-documentation) **по темі.**


# Налаштування автоматичних відповідей

Інструкція з налаштування автоматичних повідомлень за ключовими (тригерними) словами

#### **Навігація:**

1. [Створення ключових слів](#id-1.-stvorennya-klyuchovikh-sliv)
2. [Відео-інструкція](#id-2.-video-instrukciya)

***

{% hint style="info" %}

#### Як працюють ключові слова / тригери ?

📝 Якщо користувач має отримувати конкретне автоматичне повідомлення в будь-який канал звернення, для цього налаштовуються ключові слова.&#x20;

📨 Наприклад, в рекламному Reels ви вказуєте кодове слово, за яким ваш клієнт може отримати більше інформації про товар.&#x20;

🤖 Клієнт пише кодове слово в коментарях, Дірект, боти або віджет, система перевіряє це слово та надає клієнту автоматичну відповідь.

❗️ <mark style="color:red;">**Зверніть увагу:**</mark> Якщо в [Базі знань](/nalashtuvannya-jedidesk/yak-stvoriti-bazu-znan-faq) та в [Автовідповідях ](/nalashtuvannya-jedidesk/nalashtuvannya-avtomatichnikh-vidpovidei)вказане однакове ключове слово, в першу чергу бот буде відправляти повідомлення Автовідповіді.
{% endhint %}

***

#### 1. Створення ключових слів

Перейдіть до вкладки **Автоматизація ->** [**Автовідповіді**](https://app.jedidesk.com/utm), натисніть <mark style="background-color:blue;">**Створити автовідповідь**</mark> та заповніть наступні поля:

**Ключові слова для всіх користувачів:**

1. **Назва** - наприклад, *Запуск проєкта*
2. **URL-посилання** - автоматично підтягує назву мітки, якщо вона латиницею. Напишіть латиницею слово, яке буде частиною загального посилання. Наприклад, *launch.*
3. **Тег** - Якщо ви хочете відслідковувати, за яким запитом до вас звертається клієнт, можна прописати тег. Наприклад, *Запуск під ключ*.&#x20;
4. **Ключові слова** - Слова, які будуть тригером для відправлення конкретного повідомлення. Наприклад, *Запуск.*

{% hint style="danger" %} <mark style="color:red;">**Зверніть увагу:**</mark> ключові слова мають бути прописані окремо через натискання на клавішу Enter.&#x20;

**Не прописуйте ціле речення**, **тому що бот реагує лише на окремі слова.**
{% endhint %}

5. **Фінальне повідомлення** - текст, який користувач отримує після відправки повідомлення з ключовим словом.
6. **Кнопка** - при натисканні на кнопку користувач перейде за вказаним посиланням.

{% hint style="danger" %} <mark style="color:red;">**Увага:**</mark> кнопки-посилання працюють лише для Viber та Telegram ботів.
{% endhint %}

<figure><img src="/files/qm8FESh8KlQ4m7PJDuYS" alt=""><figcaption><p>Створення ключових слів для всіх користувачів</p></figcaption></figure>

Натисність <mark style="background-color:blue;">**Зберегти**</mark>.

Натисніть на іконки месенджерів, у вас автоматично скопіюються спеціально згенеровані посилання на боти з мітками:

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

***

**Ключові слова для підписників на Instagram**

Якщо певні повідомлення мають отримувати лише ваші підписники в Instagram, створіть мітку аналогічно попередній інструкції, але додатково поставте галочку на ✅ **Тільки для підписників**. Після цього у вас з'являться додаткові поля:

6. **Вхідне повідомлення** - перше повідомлення, яке буде спонукати користувача підписатися на ваш Instagram.
7. **Кнопка** - назва кнопки, на яку натискає користувач, коли підтверджує що він підписався. Як тільки він дійсно буде підписаний на Instagram, то отримає наступне повідомлення.
8. **Фінальне повідомлення** - даний текст буде автоматично відправлено згідно ключового слова, яке писав користувач.

<figure><img src="/files/IIH7nepDzhiePniYAYsC" alt=""><figcaption><p>Створення ключових слів для підписників на Instagram</p></figcaption></figure>

Натисність <mark style="background-color:blue;">**Зберегти**</mark>.

***

Тепер ви можете відслідковувати статистику кожної додатної автовідповіді.

Для цього натисність на **👁** біля необхідної автовідповіді:

<figure><img src="/files/CivX7eRWcd0f72w559CQ" alt=""><figcaption><p>Список створених автовідповідей</p></figcaption></figure>

***

Тепер ви зможете бачити статистику автовідповідей по кожному каналу зв'язку:

<figure><img src="/files/NJEFJZcbL3MM8jzxmAUd" alt="" width="450"><figcaption><p>Статистика автоматичних відповідей</p></figcaption></figure>

***

#### 2. Відео-інструкція

{% embed url="<https://vimeo.com/1145172319?fe=ci&fl=sv&share=copy>" %}


# Як налаштувати AI-асистентів #jedidesk

JediDesk AI - асистент на основі штучного інтелекту, інтегрований в систему #jedidesk для швидких відповідей та роботи 24/7

Навігація:

1. [Параметри JediDesk AI](#id-1.-parametri-jedidesk-ai)
2. [Огляд #jedidesk AI-асистентів](#id-2.-oglyad-jedidesk-ai-asistentiv)
3. [Налаштування AI-асистента](#id-3.-nalashtuvannya-ai-asistenta)\
   [3.1. Налаштування інструкції (промт)](#id-3.1.-nalashtuvannya-instrukciyi-promt)\
   [3.2. Налаштування файлів](#id-3.2.-nalashtuvannya-failiv)

   [3.3. Можливість приєднати менеджера](#id-3.3-mozhlivist-priyednati-menedzhera)\
   [3.4 Закритий ШІ-асистент](#id-3.4-zakritii-shi-asistent)\
   [3.5 Оновлення історії переписки](#id-3.5-onovlennya-istoriyi-perepiski)\
   [3.6 Канали](#id-3.6-kanali)
4. [База знань](#id-4.-baza-znan)
5. [Стоп-слова](#id-5.-stop-slova)
6. [Ідентифікатор спрацювання стоп-слова](#identifikator-spracyuvannya-stop-slova)

***

#### 1. Параметри JediDesk AI

**Баланс на використання JediDesk AI** – кількість безкоштовних запитів, які може обробити підключений JediDesk AI. Баланс можна поповнювати.

**Статистика JediDesk AI** – Можна обирати певний період, натиснувши на календар.

**Налаштування** – Активація/Деактивація JediDesk AI.

**Ліміт на навчання JediDesk AI** – Кількість символів з наданої для навчання інформації. Враховується блок Інструкція та База знань.

<figure><img src="/files/hcLLW4DDxYdmpH91Bue2" alt=""><figcaption><p>Статистика та баланс JediDesk AI</p></figcaption></figure>

***

#### 2. Огляд #jedidesk AI-асистентів

\#jedidesk пропонує 6 готових моделей поведінки під різний тип бізнесу:

<figure><img src="/files/GXtecVovGVtO4VvG71bi" alt=""><figcaption><p>Готові моделі поведінки для AI-асистента</p></figcaption></figure>

* **Lexi - ШІ-асистент для онлайн-магазинів**

  Lexi є експертом у вашому інтернет-магазині, знає все про товари і готова допомогти клієнтам з консультаціями, порівнянням товарів та підбором комплектів.
* **Nova - ШІ-асистент для агенцій**

  Nova допомагає агенціям з попереднім бріфуваням клієнтів, збиранням необхідної інформації та передачею менеджерам для подальшої роботи.
* **Bella - ШІ-асистент для бьюті-індустрії (салони краси)**

  Bella спеціалізується на допомозі салонам краси, консультує щодо посуг та акцій, допомагає з бронюванням і рекомендує додаткові послуги клієнтам.
* **Luna - ШІ-асистент для блогерів**

  Luna спеціалізується на Instagram-магазинах, консультує та домопагає з підбором товарів, оформлює замовлення до етапу підтвердження менеджером.
* **Max - ШІ-асистент для продажів**\
  Max підтримує процеси продажів, допомагаючи виявляти потреби клієнтів, консультує та продає ваші продукти 24/7.
* **Zara - ШІ-асистент для підтримки клієнтів**\
  Zara надає швидкі та точні відповіді на запитання клієнтів, допомагає з консультацією та підтримкою, а також повідомляє менеджера про проблему за необхідності.

***

**Можливості AI-асистентів:**

**🎤 Розуміння голосових повідомлень**\
AI-асистент розуміє та відповідає на голосові повідомлення, забезпечуючи зручність та оперативність спілкування:

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

**🖼 Пошук по фото та відео**\
Якщо клієнт надішле фото, AI-асистент знайде подібні товари у вашому асортименті, забезпечуючи індивідуальний підхід до кожного клієнта:

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

***

#### 3. Налаштування AI-асистента

#### **3.1. Налаштування інструкції (промт)**

Для налаштування штучного інтелекту, перейдіть до вкладки [**JediDesk AI**](https://app.jedidesk.com/settings-ai).

**Вибір асистента** – виберіть одну з готових моделей поведінки.&#x20;

Для прикладу налаштування візьмемо магазин туристичного обладнання на 4000 товарних позицій.&#x20;

В даному випадку підійде AI-асистент Lexi.&#x20;

Після вибору AI-асистента, у вас автоматично з'явиться готовий промт (інструкція) в блоці **Налаштування картки бізнесу -> Інструкція**.&#x20;

Обов'язково відкоригуйте ім'я вашого AI-асистента та назви файлів, на які він буде посилатися при обробці інформації в блоці База знань:

<figure><img src="/files/u0TlMZWfAVQJBVoUBfPd" alt=""><figcaption><p>Налаштування промту (інструкції) </p></figcaption></figure>

Натисніть <mark style="background-color:blue;">**Зберегти зміни**</mark>.

{% hint style="info" %}
Ви можете редагувати дану інструкцію за власним бажанням, або замість готового шаблону прописувати модель поведінки власноруч з нуля.
{% endhint %}

{% hint style="info" %}
Ви можете генерувати промт в [ChatGPT Promt Engineering](https://chatgpt.com/g/g-bNiLAvz8R-prompt-engineering), описавши ключові моменти поведінки вашого АІ-асистента: Як він має вітатися, які етапи консультації та продажу проходити, що уточнювати у клієнта тощо.
{% endhint %}

{% hint style="info" %}
Обов'язково вкажіть в Інструкції, що АІ має брати інформацію з завантажених файлів.

Наприклад: "Т*и береш дані про доставку з файлу Delivery.json, ти береш дані про товари з файлу Products.json*".
{% endhint %}

**Мови вашого бота** – виберіть мови, на яких відповідатиме AI-асистент.

Ось стислий опис усіх трьох параметрів з кейс-прикладами:

***

**Креативність (`temperature`)**

Контролює «сміливість» АІ при виборі слів і формулювань. Низькі значення роблять відповіді передбачуваними і точними, високі — більш різноманітними і творчими, але менш стабільними. Для підтримки клієнтів рекомендується тримати низько — `0.10–0.30`.

**Кейс:** Клієнт запитує «Які у вас тарифи?»

* `temperature: 0.10` → «Тариф Pro — 1099 грн/місяць, 5 операторів.» *(стабільно, одна й та ж відповідь щоразу)*
* `temperature: 0.90` → щоразу інакше сформульована відповідь, можливі «вільні інтерпретації» *(ризиковано для підтримки)*

***

**Сфокусованість (`top_p`)**

Обмежує вибір слів лише найімовірнішими варіантами. Нижче значення `top_p` — відповідь більш передбачувана і повторювана; вище — різноманітніші формулювання. На відміну від `temperature`, цей параметр фільтрує словниковий пул, а не «силу» вибору.

**Кейс:** Клієнт питає «Як скасувати підписку?»

* `top_p: 0.30` → АІ використовує найпростіші, найчастотніші слова → чіткий, короткий алгоритм дій
* `top_p: 0.95` → АІ може варіювати формулювання, додавати синоніми → відповіді «живіші», але менш однорідні

***

**Поріг релевантності (`search_threshold`)**

Це фільтр впевненості: кожен знайдений у базі знань фрагмент отримує оцінку від 0 до 1, що показує наскільки він відповідає запиту. Поріг визначає мінімальний бал, нижче якого фрагмент не передається АІ. Без порогу АІ може отримати слабко релевантні фрагменти лише тому, що вони найближчі з наявних — і галюцинувати на їх основі.<br>

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

**Кейс:** Клієнт питає «Які у вас тарифи?». Векторний пошук знаходить фрагмент із базі знань і повертає `score: 0.8388` (видно на твоїх скріншотах).

* `threshold: 0.00` → цей фрагмент **передається** АІ → відповідь на основі реальних даних ✅
* `threshold: 0.90` → `0.8388 < 0.90` → фрагмент **відсіюється**, АІ нічого не отримує → або мовчить, або вигадує ❌<br>

**Ліміт запитів на один діалог** – Ви можете встановити ліміт повідомлень, щоб AI-асистент не витрачав баланс на кожне повідомлення від користувача.

**Ліміт запитів на тиждень** – Ви можете встановити ліміт запитів (чатів), щоб AI-асистент не витрачав баланс на кожен запит від нового користувача.

**Робочі години** – Якщо в розділі **Налаштування ->** [**Компанія**](https://app.jedidesk.com/settings-company) ви налаштовували робочі дні та години, ви можете адаптувати AI-асистента під ваш робочий графік.

**Автоматично вимикати, коли до чату підключений менеджер** – параметр, який відповідає за те, що бот працюватиме коли менеджер розпочне розмову з користувачем.

**Модель вашого бота** — тут ви можете обрати модель для бота. Залежно від обраної моделі, бот працюватиме по-різному

{% hint style="danger" %} <mark style="color:red;">**Увага!**</mark> Не вмикайте одночасно налаштування **Автоматично включати в** [**неробочі години**](https://app.jedidesk.com/settings-company) та **Автоматично виключати в** [**робочі години**](https://app.jedidesk.com/settings-company) - інакше AI-асистент не буде працювати!&#x20;

**Вмикайте лише одне з налаштувань.**
{% endhint %}

***

#### **3.2. Налаштування файлів**

Важливо, щоб файли містили якомога чіткішу інформацію.

Наприклад, для файлу з товарами такі колонки як: Артикул, Назва товару, Розмір / Вага, Короткий опис, Ціна, Посилання:

<figure><img src="/files/tUqcedI9nRIo0766lZIb" alt=""><figcaption><p>Налаштування файлу з товарами для AI-асистента</p></figcaption></figure>

***

Для файлу FAQ (Поширені запитання) додати інформацію з сайту (Оплата, Доставка, Повернення, Гарантії, Контакти):

<figure><img src="/files/zYSMCQvnPUiPTdQjJCmC" alt=""><figcaption><p>Налаштування файлу з інформацією для AI-асистента</p></figcaption></figure>

По завершенню, конвертуйте файли у формат .json на будь-якому онлайн сервісі, наприклад [Online XLSX to JSON Converter](https://products.aspose.app/cells/conversion/xlsx-to-json).

***

#### 3.3 Можливість приєднати менеджера

По замовчуванню в системі Jedidesk ввімкнений параметр, що користувач може приєднати менеджера до діалогу. Ця можливість буде з'являтись після третьої відповіді АІ асистента в таких месенджерах як: Telegram, Viber, Widget. Це зручно коли асистент виконує роль помічника тільки на початкових етапах спілкування, а не повністю керує діалогом.

<figure><img src="/files/ibMNXyeEMmHQFQ1fWXmG" alt=""><figcaption><p>Можливість вимкнення або ввімкнення цієї можливості</p></figcaption></figure>

#### 3.4 Закритий ШІ-асистент

За замовчуванням у системі Jedidesk всі користувачі можуть спілкуватися з чат-ботом. Однак у деяких випадках може знадобитися обмежити доступ і надати можливість взаємодії з ботом лише певним користувачам.

Для цього в нашому сервісі передбачена функція «Закритий ШІ-асистент».

<figure><img src="/files/hpXR9Rw24wkwv9o9qzKI" alt=""><figcaption><p>Функція "Закритий ШІ-асистент" в JediDesk AI</p></figcaption></figure>

При її активації чат-бот припиняє відповідати всім користувачам, окрім тих, кому надано доступ. Щоб надати права на відповідь бота конкретному користувачу, виконайте наступні дії:

1. Перейдіть у вкладку «Користувачі».
2. Знайдіть потрібного користувача.та натисніть іконку олівця «Змінити» поруч із ним.
3. Змініть параметр «Доступ до ШІ-асистента» на «Активний».

<figure><img src="/files/MN43bDFwIAALaJd0ZDDM" alt=""><figcaption><p>Можливість надати доступ до ШІ клієнту</p></figcaption></figure>

#### 3.5 Оновлення історії переписки

Під час спілкування з чат-ботом він запам'ятовує вашу переписку та враховує попередні запитання у відповідях. Це зручно, але після оновлення бота (зміни промту, додавання нових файлів до бази даних або коригування параметрів, як "температура" відповідей) ця функція може заважати. Бот продовжує опиратися на старі відповіді, ігноруючи нові зміни.

Щоб не видаляти історію діалогів вручну для кожного користувача, передбачена функція **"Видалення історії ШІ-діалогів"**. Вона реалізована у вигляді кнопки **"Видалити історію ШІ-діалогів"**, яка повністю стирає попередні розмови, дозволяючи боту працювати з актуальними даними.<br>

<figure><img src="/files/1UxyRcu2ZM4bZKJAAfNc" alt=""><figcaption><p>Кнопка "Видалити історію ШІ-діалогів"</p></figcaption></figure>

Також ви можете автоматизувати цей процес за допомогою функції **"Очищати ШІ-історію чату після закриття бесіди"**. Якщо вона активована, історія кожного завершеного діалогу автоматично видалятиметься, забезпечуючи актуальність відповідей у наступних розмовах.

<figure><img src="/files/vuNSCQhAiFnytIJZe3Ff" alt=""><figcaption><p>Перемикач "Очищати ШІ історію чату після закриття бесіди"</p></figcaption></figure>

#### **3.6 Канали**

Для зручності роботи з нашим сервісом ви можете налаштувати, в яких каналах чат-бот буде активний. Завдяки функції "Канали" ви можете додати певні канали з якими буде працювати чат-бот, і тоді він відповідатиме на запити клієнтів лише у них. Водночас ваші менеджери збережуть можливість спілкуватися з клієнтами без обмежень.

Якщо залишити поле пустим, то бот працюватиме з усіма каналами.

Це дуже зручно, якщо ви хочете перевірити роботу ШІ на окремому каналі, не порушуючи взаємодії з іншими клієнтами.

<figure><img src="/files/3hXKclPyOoZWfgx3Q0fs" alt=""><figcaption><p>Місце знаходження "Канали"</p></figcaption></figure>

<figure><img src="/files/3TGRcTxPwC2TMcijRa8T" alt=""><figcaption><p>Опис на сайті</p></figcaption></figure>

**4. База знань**&#x20;

Ви можете додати до 50-ти файлів, з яких АІ-асистент буде брати інформацію.&#x20;

Кожен файл має важити до 10МБ:

<figure><img src="/files/oYMxBG0e7WDi8LCVn0PY" alt=""><figcaption><p>Завантаження файлів для АІ-асистента</p></figcaption></figure>

Натисніть <mark style="background-color:blue;">**Зберегти зміни**</mark>.

**Пов'язано:** Щоб контролювати, як саме АІ шукає інформацію у створеній базі знань — скористайтесь функцією Пошук у базі знань (search\_knowledge\_base).

{% content-ref url="/pages/c18cRVa9pRtMtxZDD7mS" %}
[Ручне налаштування функції пошуку по базі знань](/nalashtuvannya-jedidesk-ai/ruchne-nalashtuvannya-funkciyi-poshuku-po-bazi-znan)
{% endcontent-ref %}

***

#### **5. Стоп-слова, з**упинка ШІ та передача менеджеру

Вкажіть стоп-слова, які зупинять AI-асистента, або сповістять менеджера про звернення клієнта для подальшого опрацювання запиту:

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

Натисніть <mark style="background-color:blue;">**Зберегти зміни**</mark>.<br>

#### Налаштуйте AI функцію: «Зупинка ШІ та передача менеджеру»

> AI функція stop\_conversation, дозволяє ШІ-асистенту самостійно визначати, коли діалог потрібно передати живому менеджеру. На відміну від стоп-слів (які працюють по точному збігу тексту), ця функція дає ШІ можливість аналізувати контекст розмови і приймати рішення на основі опису, який налаштовує компанія.

#### Як це працює?

Функція відображається першою у списку AI функцій на сторінці налаштувань ШІ. При ввімкненні та збереженні — ШІ отримує інструкцію, в яких ситуаціях потрібно зупинитись і передати діалог менеджеру.

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

Коли ШІ викликає цю функцію, відбувається:

1. ШІ-бот зупиняється для поточного діалогу
2. Діалог розподіляється на менеджера
3. Менеджери отримують[ сповіщення (тригер)](#identifikator-spracyuvannya-stop-slova)
4. Клієнту надсилається повідомлення про очікування (наприклад, «Очікуйте, зараз з вами зв'яжеться менеджер»)

#### Налаштування

У модалі налаштувань функції доступні два поля:

1. Опис для ШІ - текст, який пояснює ШІ, в яких ситуаціях викликати функцію. Можна написати вручну або натиснути кнопку «Згенерувати» - система автоматично створить опис на основі промпту компанії та списку стоп-слів.

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

2. Текст відповіді клієнту - повідомлення, яке отримає клієнт при передачі менеджеру.

#### Системні повідомлення про тригери

Тепер при спрацюванні будь-якого AI тригера менеджер бачить у чаті системне повідомлення з причиною (видно тільки менеджерам, клієнт не бачить):

«Тригер ШІ: клієнт написав стоп-слово «{слово}»»\
«Тригер ШІ: відповідь ШІ містить стоп-слово «{слово}»»\
«Тригер ШІ: функція зупинки — {причина}»\
«Тригер ШІ: клієнт натиснув «Покликати менеджера»»\
«Тригер ШІ: клієнт підключив менеджера»

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

Це допомагає менеджеру одразу зрозуміти, чому саме спрацював тригер, не витрачаючи час на перечитування діалогу.

#### Аналітика

Функція має повну аналітику (як і інші AI функції): кількість викликів, успішні/помилкові, середній час виконання, лог по кожному виклику з посиланням на діалог.

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

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

### Ідентифікатор спрацювання стоп-слова

Для діалогів, у яких задіяно стоп-слово або коли користувач підключає менеджера\
позначка "АІ" на діалозі стає червоного кольору. Для зняття позначки треба прийняти діалог.

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


# Як налаштувати AI-асистентів #jedidesk

JediDesk AI - асистент на основі штучного інтелекту, інтегрований в систему #jedidesk для швидких відповідей та роботи 24/7

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

## Як налаштувати AI-асистента JediDesk

Цей розділ проведе вас від нуля до повністю налаштованого AI-асистента. Кожен крок пояснює не тільки **що** робити, але й **чому** це важливо і **які помилки** найчастіше виникають.\
\
**Навігація:**\
\
[Крок 1. Вибір моделі поведінки](https://app.gitbook.com/o/l4JC5IRyf6z3LewrMfQY/s/XkehX3Ue2D5LVuBJjMnb/~/edit/~/changes/478/nalashtuvannya-jedidesk-ai/yak-nalashtuvati-ai-asistentiv-jedidesk-1#krok-1.-vibir-modeli-povedinki)\
[Крок 2. Написання інструкції (промт)](https://app.gitbook.com/o/l4JC5IRyf6z3LewrMfQY/s/XkehX3Ue2D5LVuBJjMnb/~/edit/~/changes/478/nalashtuvannya-jedidesk-ai/yak-nalashtuvati-ai-asistentiv-jedidesk-1#krok-2.-napisannya-instrukciyi-promt)\
[Крок 3. Три параметри якості відповідей](https://app.gitbook.com/o/l4JC5IRyf6z3LewrMfQY/s/XkehX3Ue2D5LVuBJjMnb/~/edit/~/changes/478/nalashtuvannya-jedidesk-ai/yak-nalashtuvati-ai-asistentiv-jedidesk-1#krok-3.-tri-parametri-yakosti-vidpovidei)\
[Крок 4. Ліміти та робочий час](https://app.gitbook.com/o/l4JC5IRyf6z3LewrMfQY/s/XkehX3Ue2D5LVuBJjMnb/~/edit/~/changes/478/nalashtuvannya-jedidesk-ai/yak-nalashtuvati-ai-asistentiv-jedidesk-1#krok-4.-limiti-ta-robochii-chas)\
[Крок 5. База знань](https://app.gitbook.com/o/l4JC5IRyf6z3LewrMfQY/s/XkehX3Ue2D5LVuBJjMnb/~/edit/~/changes/478/nalashtuvannya-jedidesk-ai/yak-nalashtuvati-ai-asistentiv-jedidesk-1#krok-5.-baza-znan)\
[Крок 6. Стоп-слова та передача менеджеру](https://app.gitbook.com/o/l4JC5IRyf6z3LewrMfQY/s/XkehX3Ue2D5LVuBJjMnb/~/edit/~/changes/478/nalashtuvannya-jedidesk-ai/yak-nalashtuvati-ai-asistentiv-jedidesk-1#krok-6.-stop-slova-ta-peredacha-menedzheru)\
[Крок 7. Додаткові налаштування](https://app.gitbook.com/o/l4JC5IRyf6z3LewrMfQY/s/XkehX3Ue2D5LVuBJjMnb/~/edit/~/changes/478/nalashtuvannya-jedidesk-ai/yak-nalashtuvati-ai-asistentiv-jedidesk-1#krok-7.-dodatkovi-nalashtuvannya)\
\
[Перевірка перед запуском: чеклист](https://app.gitbook.com/o/l4JC5IRyf6z3LewrMfQY/s/XkehX3Ue2D5LVuBJjMnb/~/edit/~/changes/478/nalashtuvannya-jedidesk-ai/yak-nalashtuvati-ai-asistentiv-jedidesk-1#perevirka-pered-zapuskom-cheklist)\
[Статистика та баланс](https://app.gitbook.com/o/l4JC5IRyf6z3LewrMfQY/s/XkehX3Ue2D5LVuBJjMnb/~/edit/~/changes/478/nalashtuvannya-jedidesk-ai/yak-nalashtuvati-ai-asistentiv-jedidesk-1#statistika-ta-balans)\
[Поширені проблеми та їх вирішення](https://app.gitbook.com/o/l4JC5IRyf6z3LewrMfQY/s/XkehX3Ue2D5LVuBJjMnb/~/edit/~/changes/478/nalashtuvannya-jedidesk-ai/yak-nalashtuvati-ai-asistentiv-jedidesk-1#poshireni-problemi-ta-yikh-virishennya)

### Перш ніж починати: як це взагалі працює

Перш ніж переходити до налаштувань, корисно зрозуміти логіку роботи системи.

AI-асистент — це не просто чат-бот з готовими відповідями. Він читає **вашу базу знань, товарний фід** (файли з товарами, FAQ, умовами доставки тощо), отримує **інструкцію від вас** (як поводитись, що говорити, як продавати) і на основі цього відповідає клієнтам.

Схема проста:

```
Клієнт пише повідомлення
        ↓
AI шукає відповідь у ваших файлах (база знань та фід)
        ↓
AI формулює відповідь згідно з вашою інструкцією (промт)
        ↓
Клієнт отримує відповідь
```

Якщо щось із цього ланцюжка налаштовано погано — AI або відповідає неточно, або «вигадує» інформацію, або відповідає не в тому стилі. Саме тому важливо налаштувати кожен елемент правильно.

***

### Крок 1. Вибір моделі поведінки

#### Що це таке і навіщо

JediDesk пропонує 6 готових моделей поведінки — це попередньо написані інструкції для AI під різні типи бізнесу. Вибір правильної моделі економить час: замість написання інструкції з нуля ви отримуєте готовий шаблон, який залишається лише відкоригувати під себе.

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

#### Огляд моделей

| Модель    | Підходить для              | Що вміє                                                     |
| --------- | -------------------------- | ----------------------------------------------------------- |
| **Lexi**  | Інтернет-магазини          | Консультує по товарах, порівнює позиції, підбирає комплекти |
| **Nova**  | Агенції                    | Збирає бриф від клієнта, передає менеджеру                  |
| **Bella** | Салони краси               | Консультує по послугах, допомагає з бронюванням             |
| **Luna**  | Instagram-магазини         | Консультує, оформляє замовлення до підтвердження            |
| **Max**   | Продажі (будь-який бізнес) | Виявляє потреби, консультує, закриває угоди 24/7            |
| **Zara**  | Підтримка клієнтів         | Відповідає на типові запитання, передає складне менеджеру   |

#### Як обрати правильну модель

Запитайте себе: **яке головне завдання AI у вашому бізнесі?**

* Якщо AI має **продавати** — Lexi, Luna або Max
* Якщо AI має **збирати інформацію** від клієнта і передавати менеджеру — Nova
* Якщо AI має **записувати на послуги** — Bella
* Якщо AI має **відповідати на питання** (доставка, повернення, гарантії) — Zara

> **Приклад.** У вас інтернет-магазин туристичного спорядження з 4 000 товарів. Клієнти постійно запитують: «А є цей намет у синьому кольорі?», «Що краще — ця куртка чи ота?». Підходить **Lexi** — вона вміє порівнювати товари та підбирати комплекти.

#### Що відбувається після вибору

Після вибору моделі система автоматично підставляє готовий промт (інструкцію) у поле **Інструкція**. Це відправна точка, яку ви далі редагуєте під свій бізнес.<br>

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

&#x20;**Не пропускайте редагування промту!** Готовий шаблон містить плейсхолдери типу `[Назва магазину]` або посилання на файли, яких ще немає. Якщо запустити AI без правок — він буде відповідати некоректно.<br>

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

***

### Крок 2. Написання інструкції (промт)

#### Що це таке і навіщо

Інструкція — це «правила поведінки» для вашого AI. Саме тут ви пояснюєте: як він має вітатися, яким тоном спілкуватися, що робити якщо клієнт просить знижку, з яких файлів брати інформацію і в яких випадках звати менеджера.

**Без хорошої інструкції навіть ідеальна база знань не допоможе.** AI може мати всі дані про ваші товари, але відповідати холодно, не продавати, або давати інформацію безладно.

#### Що обов'язково має бути в інструкції

**1. Ім'я та роль**

Назвіть AI і скажіть, хто він.

```
Ти — Lexi, AI-асистент інтернет-магазину «Трек Про». 
Ти допомагаєш клієнтам обрати туристичне спорядження.
```

**2. Тон спілкування**

Опишіть, як саме спілкуватись.

```
Спілкуйся дружньо і по-діловому. Не використовуй складні технічні 
терміни без пояснень. Звертайся до клієнта на «Ви».
```

**3. З яких файлів брати інформацію**

Це критично важливий пункт. AI не знає автоматично, які файли ви завантажили і що в них. Йому потрібно сказати явно.

```
Дані про товари бери з файлу Products.json.
Дані про доставку та оплату бери з файлу FAQ.json.
Якщо інформації в файлах немає — так і скажи клієнту, 
не вигадуй відповідь.
```

{% hint style="danger" %} **Найпоширеніша помилка.** Якщо не вказати в інструкції, з яких файлів брати дані, AI може «вигадувати» відповіді з власної пам'яті. Наприклад, написати неіснуючу ціну або умову доставки. Завжди явно вказуйте джерело. {% endhint %}

**4. Етапи консультації**

Опишіть, як виглядає ідеальний діалог.

```
При консультації дотримуйся такої послідовності:
1. Привітайся і запитай, що шукає клієнт
2. Уточни деталі (для кого, який бюджет, які умови використання)
3. Запропонуй 2-3 варіанти з коротким порівнянням
4. Відповідай на уточнюючі запитання
5. Якщо клієнт готовий купити — надай посилання на товар
```

**5. Коли кликати менеджера**

```
Передай діалог менеджеру якщо:
- Клієнт скаржиться або незадоволений
- Запитує про повернення або гарантійний випадок
- Хоче індивідуальне замовлення або опт
- Питає про знижку більше 10%
```

#### Як покращити інструкцію якщо не знаєте з чого почати

Скористайтеся [ChatGPT Prompt Engineering](https://chatgpt.com/g/g-bNiLAvz8R-prompt-engineering). Опишіть свій бізнес і що має робити AI — інструмент допоможе скласти промт.

#### Мови бота

Виберіть мови, якими AI спілкуватиметься з клієнтами. Якщо у вас є клієнти з різних країн, можна додати кілька мов — AI автоматично визначить мову клієнта і відповість нею.<br>

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

***

### Крок 3. Три параметри якості відповідей

Це найважливіший технічний розділ. Три параметри визначають, наскільки точними і стабільними будуть відповіді AI.

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

#### Параметр 1: Креативність (`temperature`)

**Що це:** Контролює, наскільки «передбачуваними» будуть відповіді AI. Значення від 0 до 1.

**Навіщо це потрібно:** Іноді потрібен стабільний, чіткий бот (підтримка клієнтів). Іноді — живий, варіативний (продажі, залучення). Цей параметр дозволяє знайти баланс.

| Значення    | Поведінка                                           | Підходить для               |
| ----------- | --------------------------------------------------- | --------------------------- |
| `0.10–0.30` | Відповіді однакові при кожному запиті, дуже точні   | Підтримка, FAQ, техдопомога |
| `0.40–0.60` | Невелика варіація формулювань, відповіді природніші | Універсально                |
| `0.70–1.00` | Щоразу різні формулювання, творчі відповіді         | Контент, креатив            |

> **Кейс.** Клієнт запитує: «Які у вас тарифи?»
>
> При `temperature: 0.10` — «Тариф Pro — 1 099 грн/міс, до 5 операторів. Тариф Business — 2 499 грн/міс, необмежена кількість операторів.» *(Стабільно. Завжди та сама відповідь.)*
>
> При `temperature: 0.90` — щоразу інше формулювання, можуть з'явитися «творчі» інтерпретації тарифів, яких немає в базі. *(Ризиковано для фактичної інформації.)*

**Рекомендація для більшості бізнесів:** `0.10–0.30`

***

#### Параметр 2: Сфокусованість (`top_p`)

**Що це:** Обмежує словниковий запас AI — залишає тільки найімовірніші слова при формуванні відповіді. Значення від 0 до 1.

**Навіщо це потрібно:** Впливає не на «сміливість» вибору, а на різноманітність словника. Низький `top_p` = короткі, прості, однорідні відповіді. Високий = живіша мова, більше синонімів.

> **Кейс.** Клієнт питає: «Як скасувати підписку?»
>
> При `top_p: 0.30` — AI відповідає найпростішими словами, чіткий алгоритм дій, без «зайвого».
>
> При `top_p: 0.95` — AI варіює формулювання, відповідь звучить природніше, але може бути трохи довшою.

**Рекомендація:** `0.90–0.95` — відповіді звучать природно, але залишаються адекватними.

***

#### Параметр 3: Поріг релевантності (`search_threshold`)

**Що це:** Фільтр для пошуку по базі знань. Кожен знайдений фрагмент отримує оцінку від 0 до 1 — наскільки він відповідає запиту. Поріг визначає мінімальну оцінку, при якій фрагмент передається AI.

**Навіщо це потрібно:** Щоб AI не отримував нерелевантні дані і не «галюцинував» на їх основі.

> **Кейс.** Клієнт запитує: «Які у вас тарифи?». Векторний пошук знаходить фрагмент у базі знань і повертає оцінку `0.84`.
>
> При `threshold: 0.00` → фрагмент передається AI → відповідь на основі реальних даних ✅
>
> При `threshold: 0.90` → `0.84 < 0.90` → фрагмент відсіюється → AI нічого не отримує → або мовчить, або вигадує ❌

&#x20;**Типова проблема з завищеним порогом.** Якщо виставити `threshold: 0.70`, фрагменти з оцінкою `0.65–0.69` будуть відкидатись — хоча вони містять потрібну інформацію. AI не скаже «я не знаю» — він почне відповідати з власної пам'яті і може вигадати неіснуючі ціни, умови або терміни доставки.&#x20;

**Рекомендація:** Починайте з `0.00` і підвищуйте тільки якщо AI стабільно отримує нерелевантні фрагменти. Для більшості бізнесів `0.00` — оптимальне значення, а фільтрацію краще контролювати через якість самих файлів.

***

#### Як ці три параметри взаємодіють між собою

Ці параметри не незалежні — вони підсилюють або нейтралізують один одного.

| Ситуація                              | `temperature` | `top_p` | `search_threshold` |
| ------------------------------------- | ------------- | ------- | ------------------ |
| Максимальна точність (підтримка, FAQ) | `0.10`        | `0.90`  | `0.00`             |
| Природні відповіді (продажі)          | `0.30`        | `0.95`  | `0.00`             |
| Творчий бот (контент, блог)           | `0.70`        | `0.95`  | `0.00`             |

> **Антиприклад.** `temperature: 0.10` + `top_p: 0.10` + `threshold: 0.80` = AI відповідає дуже сухо, однотипно і при цьому часто не знаходить інформацію в базі та галюцинує. Погана комбінація для будь-якого бізнесу.

***

### Крок 4. Ліміти та робочий час

#### Ліміт запитів на один діалог

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

**Що це:** Максимальна кількість повідомлень AI в одному чаті з клієнтом.

**Навіщо:** Захист балансу від «нескінченних» розмов. Якщо клієнт веде безкінечний діалог або тестує бота — ліміт зупиняє зайві витрати.

> **Приклад.** Ви встановили ліміт 5 повідомлень. Якщо діалог затягнувся понад 5 обмінів — AI зупиняється, а менеджер може підключитись вручну.

**Рекомендація:** 15–30 повідомлень залежно від складності ваших консультацій.

***

#### Ліміт запитів на тиждень

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

**Що це:** Максимальна кількість нових діалогів (унікальних чатів), які AI обробляє за тиждень.

**Навіщо:** Корисно на старті, коли ви ще не впевнені в якості відповідей і хочете контролювати масштаб.

> **Приклад.** Ви щойно налаштували AI і хочете спочатку перевірити якість на 100 діалогах на тиждень, перш ніж відкривати на весь трафік. Виставляєте ліміт 200 — і спокійно моніторите.

***

#### Робочі години

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

**Що це:** Налаштування, в які години AI активний.

**Навіщо:** AI може працювати цілодобово або тільки в неробочий час, поки менеджери не онлайн.

**Два корисних режими:**

* **Тільки в неробочі години** — вдень відповідають менеджери, вночі та у вихідні — AI
* **Цілодобово** — AI завжди активний, менеджери підключаються тільки якщо AI не впорався

> &#x20;**Критична помилка!** Не вмикайте одночасно «Автоматично включати в неробочі години» та «Автоматично виключати в робочі години» — ці налаштування суперечать одне одному і AI не буде працювати взагалі. Вмикайте **тільки одне** з них. <br>

***

#### Автоматично вимикати, коли до чату підключений менеджер

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

**Що це:** Якщо менеджер вручну відкриває чат і починає відповідати — AI автоматично замовкає.

**Навіщо:** Щоб AI і менеджер не відповідали одночасно — це виглядає хаотично для клієнта.

**Рекомендація:** Тримайте цю опцію **увімкненою** завжди.

***

### Крок 5. База знань

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

#### Що це таке і чому це найважливіша частина

База знань — це файли, з яких AI бере інформацію для відповідей. Якість бази знань напряму визначає якість відповідей. Навіть ідеальний промт і правильні параметри не врятують, якщо файли погано структуровані або містять неточності.

**Технічні обмеження:**

* До **50 файлів**
* Кожен файл — до **10 МБ**
* Рекомендований формат: **JSON**

#### Як підготувати файли правильно

**Файл з товарами** має містити чіткі, однозначні колонки:

| Артикул | Назва        | Опис                | Розмір/Вага | Ціна      | Посилання           |
| ------- | ------------ | ------------------- | ----------- | --------- | ------------------- |
| TRK-001 | Намет Trek 2 | Двомісний, 3 сезони | 2.8 кг      | 4 200 грн | shop.com/tent-trek2 |

> **Погано:** «Ціна договірна», «Уточнюйте в менеджера», порожні поля — AI не зможе дати чітку відповідь і або буде мовчати, або вигадає.

**Файл FAQ** (Поширені запитання) має охоплювати:

* Умови доставки (терміни, вартість, перевізники)
* Способи оплати
* Умови повернення та обміну
* Гарантійні умови
* Контакти

> **Приклад структури FAQ.json:**
>
> ```json
> [
>   {
>     "питання": "Яка вартість доставки?",
>     "відповідь": "Доставка Новою Поштою — 80 грн. При замовленні від 2 000 грн — безкоштовно."
>   },
>   {
>     "питання": "Чи можна повернути товар?",
>     "відповідь": "Так, протягом 14 днів з моменту отримання, якщо товар не був у використанні."
>   }
> ]
> ```

#### Конвертація файлів у JSON

Підготуйте таблицю в Excel або Google Sheets, потім конвертуйте у JSON через [Online XLSX to JSON Converter](https://products.aspose.app/cells/conversion/xlsx-to-json).

#### Типові помилки при підготовці файлів

**Помилка 1: Змішана інформація в одному файлі** Не кладіть товари, FAQ і контакти в один файл. AI важче орієнтуватись, а ви не можете оновлювати частину інформації окремо.

**Помилка 2: Скорочення без розшифровки** «Д-ка НП 2-3 д» замість «Доставка Новою Поштою 2-3 дні» — AI може неправильно інтерпретувати.

**Помилка 3: Не оновлювати файли при зміні цін або умов** AI відповідає на основі завантажених файлів. Якщо ви підняли ціни, але не оновили файл — бот буде називати старі ціни.

{% hint style="info" %} Після оновлення файлів у базі знань рекомендується натиснути **«Видалити історію ШІ-діалогів»** — щоб AI не спирався на старі відповіді з попередніх розмов. {% endhint %}

***

### Крок 6. Стоп-слова та передача менеджеру

#### Стоп-слова: що це і як працюють

Стоп-слова — це конкретні слова або фрази, при появі яких AI автоматично зупиняється і передає діалог менеджеру.

**Як це виглядає в чаті:** значок «AI» на діалозі стає **червоним** — це сигнал менеджеру, що потрібна його увага. Після прийняття діалогу позначка знімається.

> **Приклад стоп-слів для магазину:**
>
> * «повернення» — клієнт хоче повернути товар
> * «скарга» — незадоволений клієнт
> * «брак» — проблема з якістю
> * «опт» — оптове замовлення, яке потребує індивідуального підходу

**Обмеження стоп-слів:** вони спрацьовують тільки при **точному збігу** тексту. Якщо клієнт напише «хочу повернути», але у вас стоп-слово «повернення» — спрацювання може не відбутись.

***

#### Функція `stop_conversation`: розумна передача менеджеру

На відміну від стоп-слів, ця функція дозволяє AI **самостійно аналізувати контекст** і вирішувати, коли передавати діалог.

**Навіщо це потрібно:** Клієнт може бути незадоволений або в скрутній ситуації, але не написати жодного стоп-слова. Функція `stop_conversation` дозволяє AI «відчути» це і відреагувати.

**Як налаштувати:**

1. У полі **«Опис для ШІ»** опишіть ситуації, коли AI має передавати діалог:

   ```
   Передай діалог менеджеру якщо:
   - Клієнт виражає незадоволення або роздратування
   - Клієнт просить про послугу, якої немає в базі знань
   - Клієнт задав одне й те саме питання більше 2 разів і не отримав задовільної відповіді
   - Клієнт хоче поговорити з живою людиною
   ```
2. У полі **«Текст відповіді клієнту»** напишіть повідомлення, яке отримає клієнт при передачі:

   ```
   Зараз я передам ваш запит менеджеру. Він зв'яжеться з вами протягом декількох хвилин. Дякуємо за терпіння!
   ```

**Що відбувається при спрацюванні:**

1. AI зупиняється в цьому діалозі
2. Діалог призначається на менеджера
3. Менеджер отримує сповіщення
4. Клієнт отримує ваше повідомлення про очікування

**Системне повідомлення для менеджера** (видно тільки менеджеру, клієнт не бачить):

```
Тригер ШІ: функція зупинки — клієнт виражає незадоволення якістю товару
```

Це дозволяє менеджеру одразу зрозуміти ситуацію без перечитування всього діалогу.

***

### Крок 7. Додаткові налаштування

#### Можливість приєднати менеджера (кнопка для клієнта)

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

За замовчуванням після **третьої відповіді AI** клієнт бачить кнопку «Покликати менеджера» в Telegram, Viber і Widget.

**Навіщо:** Клієнт може самостійно запросити живого оператора, не чекаючи поки AI «здогадається».

**Коли варто вимкнути:** Якщо AI у вас повністю автономний і ви не хочете, щоб клієнти переходили на менеджерів без вагомої причини.

***

#### Закритий AI-асистент

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

**Що це:** Бот відповідає **не всім**, а тільки тим користувачам, яким ви надали доступ.

**Коли це потрібно:**

* Внутрішній корпоративний бот (тільки для співробітників)
* Бот для VIP-клієнтів
* Тестовий режим: ви налаштовуєте AI і перевіряєте його на конкретних людях перед повним запуском

**Як надати доступ конкретному користувачу:**

1. Перейдіть у вкладку **«Користувачі»**
2. Знайдіть потрібного користувача → натисніть іконку олівця
3. Змініть **«Доступ до ШІ-асистента»** на **«Активний»**

***

#### Канали

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

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

**Що це:** Вибір конкретних каналів (Telegram, Viber, Instagram тощо), де AI буде активний.

**Навіщо:** Ви можете включити AI тільки в одному каналі для тестування, не зачіпаючи роботу менеджерів в інших каналах.

> **Приклад.** У вас є Telegram, Viber і Instagram. Ви хочете спочатку протестувати AI тільки в Telegram. Додаєте тільки Telegram у поле «Канали» — в Viber і Instagram AI не відповідає, менеджери працюють як звичайно.

Якщо поле залишити **порожнім** — AI активний у всіх підключених каналах.

***

#### Оновлення історії переписки

<figure><img src="/files/337MBcZ8cwYlwbIbcAh5" alt=""><figcaption></figcaption></figure>

AI запам'ятовує контекст розмови в межах одного діалогу — це допомагає відповідати на уточнюючі запитання без повторення.

**Проблема:** Після того як ви змінили промт, додали нові файли або відкоригували параметри — AI в активних діалогах може продовжувати спиратись на старі відповіді, ігноруючи нові дані.

**Рішення:**

* **Вручну** — кнопка **«Видалити історію ШІ-діалогів»** стирає всі попередні розмови. Після цього AI стартує в кожному діалозі «з чистого аркуша».
* **Автоматично** — увімкніть **«Очищати ШІ-історію чату після закриття бесіди»**. Кожен завершений діалог автоматично очищається — наступна розмова з цим клієнтом починається наново.

Рекомендуємо вмикати автоочищення за замовчуванням. Це гарантує, що AI завжди працює з актуальними даними і не «пам'ятає» застарілих відповідей.&#x20;

***

### Перевірка перед запуском: чеклист

Перш ніж запустити AI на реальних клієнтах, перевірте кожен пункт:<br>

* Обрана модель поведінки відповідає типу бізнесу
* &#x20;У промті вказано ім'я AI та його роль
* &#x20;У промті явно вказано, з яких файлів брати інформацію
* &#x20;Прописані етапи консультації та умови передачі менеджеру
* &#x20;Файли бази знань завантажені та містять актуальні дані
* &#x20;У файлах немає порожніх полів, скорочень без розшифровки
* &#x20;Назви файлів у промті точно співпадають з назвами завантажених файлів
* &#x20;`temperature` встановлено `0.10–0.30` для підтримки
* &#x20;`search_threshold` встановлено `0.00`
* Увімкнено «Автоматично вимикати, коли до чату підключений менеджер»
* &#x20;Налаштовані стоп-слова або функція `stop_conversation`
* &#x20;Перевірено, що не увімкнено одночасно два суперечливих налаштування робочих годин

***

### Статистика та баланс

#### Баланс

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

Баланс — це кількість запитів, які може обробити AI. Кожне повідомлення від клієнта, на яке відповідає AI, витрачає певну кількість запитів.

**Де дивитись:** Розділ **JediDesk AI → Параметри**.

Баланс можна поповнювати в будь-який момент.

#### Статистика

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

Дозволяє аналізувати активність AI за будь-який період: скільки діалогів обробив, скільки запитів витратив, скільки разів спрацювали тригери передачі менеджеру.

**Навіщо це дивитись:**

* Якщо AI часто передає діалоги менеджеру — можливо, база знань неповна або промт потребує уточнення
* Якщо баланс витрачається дуже швидко — можливо, варто переглянути ліміти запитів

***

### Поширені проблеми та їх вирішення

| Проблема                                                 | Можлива причина                                              | Що зробити                                                             |
| -------------------------------------------------------- | ------------------------------------------------------------ | ---------------------------------------------------------------------- |
| AI вигадує ціни або умови                                | Не вказано джерело файлів у промті або `threshold` завищений | Додайте в промт явне посилання на файли; знизьте `threshold` до `0.00` |
| AI відповідає занадто сухо                               | Занадто низький `top_p`                                      | Підвищте `top_p` до `0.90–0.95`                                        |
| AI і менеджер відповідають одночасно                     | Не увімкнено автовимкнення при підключенні менеджера         | Увімкніть «Автоматично вимикати, коли до чату підключений менеджер»    |
| AI не працює в неробочі години                           | Увімкнено два суперечливих налаштування часу                 | Залиште тільки одне з налаштувань робочого часу                        |
| AI не знаходить інформацію в базі після оновлення файлів | Старі відповіді збережені в історії діалогів                 | Натисніть «Видалити історію ШІ-діалогів»                               |
| Стоп-слово не спрацювало                                 | Клієнт написав близьке, але не точне слово                   | Додайте більше варіантів стоп-слів або налаштуйте `stop_conversation`  |

***

*Якщо у вас залишились запитання — зверніться до підтримки JediDesk або перегляньте пов'язані розділи документації.*


# Налаштування Magic Button для JediDesk AI

З JediDesk AI ви можете легко тренувати систему, базуючись на особливостях вашого бізнесу, для найкращої взаємодії з клієнтами.

Magic Button самостійно генерує відповідь в контексті розмови з клієнтом всього за 3 секунди.

***

#### Як налаштувати цю чарівну функцію? 🧙

1. **Перейдіть до вкладки** [**JediDesk AI**](https://app.jedidesk.com/settings-ai).
2. **У полі Core вкажіть текст** з інструкцією для вашого консультанта \
   (див. [Як налаштувати JediDesk AI](/nalashtuvannya-jedidesk-ai/yak-nalashtuvati-ai-asistentiv-jedidesk)).
3. **Заповніть поле питання та відповіді**, щоб навчити систему розуміти вашу аудиторію.
4. **Вкажіть стоп-слова**, при яких бот перестане відповідати, наприклад, "*тупий*", "*менеджера*".

***

#### Як це працює?

1. **Натисніть Magic Button** в діалозі з клієнтом.
2. **Перевірте відповідь**, вона з’явиться автоматично.
3. **Натисніть "Редагувати"**, якщо потрібно внести корективи.
4. **Натисніть "Відправити"**, якщо текст точний.

<figure><img src="/files/dcPfmepFdGdILP3wGEkH" alt=""><figcaption><p>Згенерована AI відповідь</p></figcaption></figure>


# Налаштування бази товарів/послуг для JediDesk AI

Вимоги до xml файлу

Jedidesk використовує прайс-листи для масового додавання та оновлення товарів. Нижче наведено детальні вимоги до формату файлу, заповнення полів та рекомендації для успішного імпорту.

### 1. Призначення прайс-листа

Прайс-лист — це структурований файл з даними про товари, який використовується для:\
\- початкового імпорту.\
\- регулярного оновлення цін, залишків і контенту.

### 2. Технічні вимоги

* допустиме кодування даних — UTF-8;
* стандарт YML не допускає використання недрукованих символів з ASCII-кодами від 0 до 31 (за винятком символів з кодами 9, 10, 13 — табуляція, перенесення рядка, повернення каретки);
* url-адреса товарної пропозиції повинна бути закодована відповідно до стандарту RFC-1738;
* Приклад реалізації [прайс-листа](https://public.rozetka.market/sellerrozetka/s1596/xml-pricelist-exaple.xml).
* символи ", &, > <, ' потрібно замінювати на еквівалентні коди. (приклади)

  | Символ в тексті     | Код в XML   |
  | ------------------- | ----------- |
  | <ul><li>"</li></ul> | \&amp;quot; |
  | <ul><li>&</li></ul> | \&amp;amp;  |
  | <ul><li>></li></ul> | \&amp;gt;   |
  | <ul><li><</li></ul> | \&amp;lt;   |
  | <ul><li>'</li></ul> | \&amp;apos; |

  &#x20;\*Вимога стосується лише написання тексту і не стосується написання тегів;

### 3. Опис тегів та елементів даних в xml:

<table data-header-hidden><thead><tr><th>Елемент / тег</th><th>Значення</th></tr></thead><tbody><tr><td><p><strong>yml_catalog</strong></p><p>*обов'язковий елемент</p></td><td>Кореневий елемент формату YML. Атрибут date вказує дату і час генерації або зміни XML (YML). Дата повинна мати формат YYYY-MM-DD hh:mm.</td></tr><tr><td><p><strong>shop</strong></p><p>*обов'язковий елемент</p></td><td>Інформація про інтернет-магазин.</td></tr><tr><td><p><strong>name</strong></p><p>необов'язковий елемент</p></td><td><p>Назва магазину. На сайті не публікується, використовується для внутрішньої ідентифікації.</p><p>Максимальна кількість символів ━ 255.</p></td></tr><tr><td><p><strong>company</strong></p><p>необов'язковий елемент</p></td><td><p>Назва компанії. Не публікується, використовується для внутрішньої ідентифікації.</p><p>Максимальна кількість символів ━ 255.</p></td></tr><tr><td><p><strong>url</strong></p><p>необов'язковий елемент</p></td><td><p>url-адреса головної сторінки магазину.</p><p>Максимальна кількість символів ━ 255.</p></td></tr><tr><td><p><strong>categories</strong></p><p>*обов'язковий елемент</p></td><td><p>Перелік категорій товарів. Для кожної категорії вказується унікальний ідентифікатор <em>(id)</em>, нумерація дозвільна.</p><ul><li>id категорій повинні залишатися незмінними;</li><li>parentId - можливість ваказати батьківську категорію для побудови ієрархії;</li><li>рекомендуємо, щоб в одній категорії в прайс-листі не було товарів з двох різних категорій сайту;</li><li>рекомендуємо вказувати назву категорії згідно з назвою на сайті;</li><li>максимальна кількість символів ━ 255.</li></ul><p>Приклад:</p><pre><code>&#x3C;categories>
&#x3C;category id="1">Кутові дивани&#x3C;/category>
&#x3C;category id="2">Смарт-годинник&#x3C;/category>
&#x3C;category id="3">Дитячі ігрові комплекси&#x3C;/category>
&#x3C;/categories>
</code></pre></td></tr><tr><td><p><strong>offers</strong></p><p>*обов'язковий елемент</p></td><td>Список всіх товарних позицій. Відкривається після тегу <em>&#x3C;/categories></em>. Закривається перед тегом <em>&#x3C;/shop></em>.</td></tr><tr><td><p><strong>offer</strong></p><p>*обов'язковий елемент</p></td><td><p>Інформація про товарну позицію.</p><ul><li>кожен товар описується в окремому елементі <em>offer</em>;</li><li>кожна позиція повинна мати унікальний <em>id</em>, нумерація дозвільна, допускається використання символів: Aa-Zz і 0-9, не допускається використання кирилиці та пробілів;</li><li>забороняється змінювати <em>id</em>, якщо товар вже доданий на ваш сайт;</li><li>атрибут <em>available</em> вказує наявність товару:<br><em>true</em> — товар в наявності,<br><em>false</em> — немає в наявності.</li></ul><p>Кожен різновид товару потрібно передавати окремим унікальним <em>offer id</em> (колір, розмір, об'єм, комплектація тощо).</p></td></tr><tr><td><p><strong>stock_quantity</strong> або <strong>quantity_in_stock</strong></p><p>*обов'язковий елемент</p></td><td><p>Залишки товару. Ціле цифрове значення. Товар буде в наявності поки цей параметр більше ніж 0.</p><p>Обов'язково вказувати для кожного <em>offer</em>, позиції без тегу будуть у статусі «немає в наявності».</p></td></tr><tr><td><p><strong>url</strong> (в offer)</p><p>необов'язковий елемент</p></td><td><p>url-адреса сторінки товару на сайті продавця.</p><p><em>Рекомендуємо заповнювати дане значення для надання посилання користувачу.</em></p><p>Максимальна кількість символів ━ 500.</p></td></tr><tr><td><p><strong>price</strong></p><p>*обов'язковий елемент</p></td><td>Ціна товару. Ціле або дробове числове значення. Роздільником цілої та дробової частин використовуйте крапку або кому.</td></tr><tr><td><p><strong>price_old</strong> або <strong>old_price</strong></p><p>необов'язковий елемент</p></td><td><p>Перекреслена ціна (стара ціна товару). Ціле або дробове числове значення. Використовується для відображення знижки на товар.</p><p>Значення <em>&#x3C;price_old></em> має бути вище значення <em>&#x3C;price></em>.</p></td></tr><tr><td><p><strong>currencyId</strong></p><p>необов'язковий елемент</p></td><td>Валюта, в якій вказана ціна товару: UAH / USD / EUR.</td></tr><tr><td><p><strong>categoryId</strong></p><p>*обов'язковий елемент</p></td><td>Ідентифікатор категорії, до якої відноситься товар.</td></tr><tr><td><p><strong>picture</strong></p><p>необов'язковий елемент</p></td><td><p>url-адреса зображення товару. Посилання повинно мати сертифікат безпеки (https), не має містити кирилицю та пробіли, максимальна кількість символів ━ 1999.</p><p>Мінімальна кількість ━ 1, максимальна ━ 15. Максимальний розмір одного зображення (файлу) ━ 10 Мб.</p></td></tr><tr><td><p><strong>vendor</strong></p><p>*обов'язковий елемент</p></td><td>Бренд товару (торгова марка/виробник).</td></tr><tr><td><p><strong>article</strong></p><p>необов'язковий елемент</p></td><td>Артикул товару.</td></tr><tr><td><p><strong>name</strong> або <strong>model</strong></p><p>*обов'язковий елемент</p></td><td><p>Назва товарної позиції.</p><ul><li>максимальна кількість символів — 255.</li></ul></td></tr><tr><td><p><strong>description</strong></p><p>*обов'язковий елемент</p></td><td><p>Текстовий опис товару.</p><ul><li>максимальна кількість символів — 50 000;</li><li>опис можна форматувати за допомогою HTML тегів, які потрібно згрупувати в розділі <em>CDATA</em>.</li></ul></td></tr><tr><td><p><strong>state</strong></p><p>необов'язковий елемент</p></td><td><p>Стан товару. Використовується для продажу уцінених, вживаних чи відновлених товарів.</p><ul><li><em>new</em> — новий товар;</li><li><em>stock</em> — уцінений товар;</li><li><em>used</em> — вживаний товар;</li><li><em>refurbished</em> — відновлений товар.</li></ul><p>За замовчуванням (і якщо тег <em>state</em> не вказаний) товарам встановлюється статус <em>new</em>.</p></td></tr><tr><td><p><strong>param</strong></p><p>необов'язковий елемент</p></td><td><p>Характеристики товару (параметри).</p><p>Назва характеристики вказується в атрибуті <em>name.</em> Назва та значення обов'язково мають бути заповнені, не допускається наявність незаповненого тегу.</p><p>В багатозначному текстовому параметрі значення перераховуються через роздільник &#x3C;br> і закриваються в CDATA.</p><p>Приклад:</p><pre><code>&#x3C;param name="Колір">Чорний&#x3C;/param>
&#x3C;param name="Додаткові характеристики">&#x3C;![CDATA[Прасувати за температури не більше ніж 110 °C &#x3C;br>
Не можна вибілювати засобами, які містять хлор &#x3C;br>
Прання за температури 30 °C.]]>&#x3C;/param>
</code></pre><p>Максимальна кількість символів ━ 500.</p></td></tr><tr><td><p><strong>paramid</strong></p><p>необов'язковий елемент</p></td><td><p><em>id</em> характеристики (параметра) на сайті. Використовується для автоматичної зв’язки параметра.</p><p><em>id</em> параметрів та їх значень для конкретної категорії можна завантажити в кабінеті продавця, розділ «Управління товарами» → «Довідники».</p><p>Якщо тип параметра: ComboBox, List Values, List, Checkbox, CheckBoxGroup, CheckBoxGroupValues ━ обов'язково вказувати атрибут <em>valueid</em>.</p><p>Приклад:</p><pre><code>&#x3C;param name="Колір" paramid="136895" valueid="1150615">Коричневий&#x3C;/param>
</code></pre></td></tr><tr><td><p><strong>valueid</strong></p><p>необов'язковий елемент</p></td><td><p><em>id</em> значення характеристики (параметра) на сайті. Використовується для автоматичної прив'язки значення.</p><p>Приклад:</p><pre><code>&#x3C;param name="Сезон" paramid="39560" valueid="2296922, 2645254, 63320">Осіння, Весняна, Літня&#x3C;/param>
</code></pre><p>Максимальна кількість символів ━ 255.</p></td></tr><tr><td><p><strong>value lang</strong></p><p>необов'язковий елемент</p></td><td><p>Використовується для вказання текстової характеристики двома мовами.<br><em>value lang="uk"</em> — українська;<br><em>value lang="ru"</em> — російська.</p><p>Приклад:</p><pre><code>&#x3C;param name="Рекомендації по догляду">
&#x3C;value lang="uk">Не відбілювати&#x3C;/value>
&#x3C;value lang="ru">Не отбеливать&#x3C;/value>
&#x3C;/param>
</code></pre><p>Максимальна кількість символів ━ 255.</p></td></tr></tbody></table>

### 4. Оновлення даних

\- Для оновлення ціни/залишків достатньо передати \`id\`, \`price\`, \`quantity\`.\
\- Опис і фото змінюються при повторному імпорті з тим же \`id\`.\
\- Можливе часткове оновлення — тільки змінені поля.

### 5. Типові помилки

\- Ціна з комою замість крапки.\
\- Порожнє поле \`id\`.\
\- Непрямі URL фото (ведуть на сторінку, а не файл).\
\- Некоректна категорія.<br>


# Автоматичне створення бази знань для АІ-асистента

Це інструмент, який автоматично сканує сайт та збирає текстову інформацію зі сторінок.\
Отримані дані використовуються для створення **файлу бази знань**, на основі якого **AI-асистент** відповідає на запитання клієнтів.

Функція дозволяє швидко отримати інформацію про:

* FAQ
* інструкції
* правила
* будь-яку текстову інформацію сайту

без необхідності додавати її вручну.

***

## Елементи інтерфейсу та кнопки

### URL сайту

Поле для введення адреси сайту, який потрібно просканувати.

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

**Як працює:**

* користувач вставляє посилання на сайт
* система переходить по сторінках сайту та збирає текстовий контент

Приклад:

```
https://example.com
```

***

### Pages List / Scanned Pages

Список сторінок, які були проскановані системою.

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

**Що можна зробити:**

* переглянути які сторінки були відскановані

***

## Автоматична генерація інструкції для AI-асистента

Після завершення сканування система:

1. Формує **файл бази знань** із зібраною інформацією сайту та автоматично додає його у базу знань АІ-асистента.
2. Автоматично **генерує інструкцію (prompt) для AI-асистента**, яка пояснює:
   * як використовувати цей файл
   * як знаходити інформацію
   * як правильно відповідати на запитання клієнтів.

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

Кнопка **"Застосувати інструкцію"** додає згенеровану інструкцію до налаштувань AI-асистента.

**Що відбувається після натискання:**

* згенерований промт автоматично додається в **поле системного промта AI-асистента**
* асистент одразу починає використовувати дані зі створеного файлу
* не потрібно копіювати або налаштовувати інструкцію вручну.


# Власні функції AI

Власні функції дозволяють підключити будь-яку зовнішню систему до вашого AI-асистента. Коли під час розмови з клієнтом AI вирішить, що потрібно виконати дію — він автоматично відправить запит на ваш сервер із потрібними параметрами та використає відповідь у розмові.

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

**Приклади використання:**

* Перевірка статусу замовлення за номером
* Перевірка наявності товару на складі
* Отримання інформації з CRM (дані клієнта, історія покупок)
* Запис клієнта на послугу
* Розрахунок вартості доставки
* Будь-яка інша логіка, яку може обробити ваш бекенд

***

### Як створити власну функцію

Перейдіть у **Налаштування AI → AI Функції →** Власні **функції** та натисніть **«Додати функцію»**.

#### Поля функції

**Назва функції (обов'язкове)**

Технічна назва функції латиницею. Дозволено лише малі літери, цифри та підкреслення. Повинна починатися з літери.

**Приклади:**

* `get_order_status`
* `check_stock`
* `calculate_delivery`
* `book_appointment`

&#x20;Ця назва передається в полі `function` у webhook-запиті — саме за нею ваш сервер визначає, яку дію потрібно виконати.&#x20;

**Опис функції (обов'язкове)**

Текстовий опис того, що робить функція. AI використовує цей опис для того, щоб зрозуміти, **коли** потрібно викликати функцію. Чим точніше опис — тим краще AI визначатиме момент виклику.

**Приклади:**

* `перевіряє статус замовлення за номером замовлення`
* `перевіряє наявність товару на складі за артикулом`
* `розраховує вартість доставки за адресою та вагою`

Пишіть опис мовою, на якій працює ваш AI-асистент.

**Інструкція для AI (необов'язкове)**

Додаткові правила поведінки AI, коли ця функція активна. Наприклад, можна вказати, що AI повинен завжди викликати цю функцію в певних ситуаціях, або як інтерпретувати відповідь.

**Приклади:**

* `завжди викликай цю функцію, коли клієнт питає про статус замовлення, не покладайся на попередні відповіді`
* `якщо функція повернула помилку, попроси клієнта повторити номер замовлення`
* `після отримання результату, представ інформацію у зручному вигляді для клієнта`

**Параметри функції**

Список даних, які AI збере від клієнта та передасть у запиті на ваш сервер. Для кожного параметра вказується:

| Поле                   | Опис                                                                                                      |
| ---------------------- | --------------------------------------------------------------------------------------------------------- |
| **Назва (ключ)**       | Технічна назва параметра латиницею (наприклад, `order_id`, `phone`, `product_sku`)                        |
| **Тип**                | Тип даних: Текст, Число, Ціле число, Так/Ні                                                               |
| **Обов'язковий**       | Чи повинен AI обов'язково зібрати цей параметр перед викликом                                             |
| **Підказка для AI**    | Опис параметра, щоб AI розумів, що саме потрібно запитати у клієнта                                       |
| **Допустимі значення** | (необов'язково) Перелік конкретних значень через кому. Якщо заповнено — AI обиратиме лише з цих варіантів |

**Приклад параметрів для функції `get_order_status`:**

| Назва      | Тип   | Обов'язковий | Підказка                 | Допустимі значення |
| ---------- | ----- | ------------ | ------------------------ | ------------------ |
| `order_id` | Текст | Так          | номер замовлення клієнта | —                  |

**Приклад параметрів для функції `book_appointment`:**

| Назва     | Тип   | Обов'язковий | Підказка                         | Допустимі значення                |
| --------- | ----- | ------------ | -------------------------------- | --------------------------------- |
| `service` | Текст | Так          | назва послуги                    | консультація, діагностика, ремонт |
| `date`    | Текст | Так          | бажана дата у форматі ДД.ММ.РРРР | —                                 |
| `phone`   | Текст | Так          | контактний телефон клієнта       | —                                 |
| `comment` | Текст | Ні           | додатковий коментар              | —                                 |

***

### Налаштування вебхука

Для того, щоб ваш сервер отримував виклики від AI, потрібно налаштувати вебхук.

#### Крок 1: Створіть endpoint на вашому сервері

Ваш сервер повинен мати URL, який приймає POST-запити та повертає JSON-відповідь.

#### Крок 2: Зареєструйте вебхук у JediDesk

Перейдіть у розділ **Інтеграція → API** та створіть вебхук:

* Вкажіть URL вашого сервера
* У списку подій оберіть **`ai.func_call`**

***

### Формат запиту (webhook payload)

Коли AI вирішує викликати вашу функцію, JediDesk відправляє POST-запит на ваш вебхук з таким JSON-тілом:

```json
{
  "event": "ai.func_call",
  "data": {
    "function": "get_order_status",
    "parameters": {
      "order_id": "12345"
    }
  },
  "timestamp": "2026-04-07T12:00:00+00:00",
  "token": "your-api-token",
  "request_id": "550e8400-e29b-41d4-a716-446655440000"
}
```

| Поле              | Опис                                              |
| ----------------- | ------------------------------------------------- |
| `event`           | Завжди `ai.func_call`                             |
| `data.function`   | Назва функції, яку AI вирішив викликати           |
| `data.parameters` | Об'єкт з параметрами, які AI зібрав від клієнта   |
| `timestamp`       | Час виклику у форматі ISO 8601                    |
| `token`           | API-токен вашої компанії (для верифікації запиту) |
| `request_id`      | Унікальний ідентифікатор запиту (UUID)            |

#### Як визначити яку функцію викликано

Якщо у вас кілька власних функцій, всі виклики приходять на один вебхук. Розрізняйте їх за полем `data.function`:

```javascript
app.post('/webhook', (req, res) => {
  const { function: funcName, parameters } = req.body.data;

  switch (funcName) {
    case 'get_order_status':
      return res.json(getOrderStatus(parameters.order_id));
    case 'check_stock':
      return res.json(checkStock(parameters.product_sku));
    default:
      return res.json({ error: 'Unknown function' });
  }
});
```

```php
$payload = json_decode(file_get_contents('php://input'), true);
$funcName = $payload['data']['function'];
$params = $payload['data']['parameters'];

switch ($funcName) {
    case 'get_order_status':
        $result = getOrderStatus($params['order_id']);
        break;
    case 'check_stock':
        $result = checkStock($params['product_sku']);
        break;
    default:
        $result = ['error' => 'Unknown function'];
}

header('Content-Type: application/json');
echo json_encode($result);
```

***

### Формат відповіді

Ваш сервер повинен повернути JSON-відповідь. AI використає цю відповідь для формування повідомлення клієнту.

**Успішна відповідь (HTTP 200):**

```json
{
  "status": "delivered",
  "delivery_date": "05.04.2026",
  "tracking_number": "UA1234567890"
}
```

**Відповідь з помилкою:**

```json
{
  "error": "Замовлення з таким номером не знайдено"
}
```

&#x20;AI розуміє структуру вашої відповіді та самостійно формулює повідомлення для клієнта на основі отриманих даних. Тому не потрібно формувати готовий текст — достатньо повернути дані.&#x20;

#### Рекомендації до відповіді

* Повертайте зрозумілі назви полів (краще `delivery_date`, ніж `dd`)
* Якщо помилка — повертайте текст помилки в полі `error`, AI передасть суть клієнту
* Відповідь має повернутися протягом розумного часу (до 10 секунд)
* Максимальний розмір відповіді — не обмежений жорстко, але великі відповіді можуть вплинути на якість інтерпретації AI

***

### Верифікація запиту

Для безпеки рекомендуємо перевіряти `token` у вхідному запиті — він відповідає API-токену вашої компанії з розділу **Інтеграція → API**.

```php
$token = $payload['token'];
if ($token !== env('JEDIDESK_API_TOKEN')) {
    http_response_code(403);
    exit;
}
```

***

### Повний приклад: функція «Перевірка статусу замовлення»

#### 1. Створення функції в JediDesk

* **Назва:** `get_order_status`
* **Опис:** `перевіряє статус замовлення за номером замовлення`
* **Інструкція для AI:** `завжди викликай цю функцію, коли клієнт питає про статус замовлення або доставку. Не вигадуй статус самостійно.`
* **Параметри:**
  * `order_id` — Текст, обов'язковий, підказка: `номер замовлення клієнта`

#### 2. Налаштування вебхука

* **URL:** `https://yoursite.com/api/jedidesk-webhook`
* **Подія:** `ai.func_call`

#### 3. Обробник на вашому сервері

```php
// Laravel приклад
Route::post('/api/jedidesk-webhook', function (Request $request) {
    $funcName = $request->input('data.function');
    $params = $request->input('data.parameters');

    if ($funcName === 'get_order_status') {
        $order = Order::where('number', $params['order_id'])->first();

        if (!$order) {
            return response()->json([
                'error' => 'Замовлення не знайдено'
            ]);
        }

        return response()->json([
            'order_number' => $order->number,
            'status' => $order->status,
            'created_at' => $order->created_at->format('d.m.Y'),
            'total' => $order->total . ' грн',
            'delivery_status' => $order->delivery_status,
            'tracking_number' => $order->tracking_number,
        ]);
    }

    return response()->json(['error' => 'Unknown function']);
});
```

#### 4. Як це виглядає у діалозі

```
Клієнт: Який статус мого замовлення 12345?
AI: [викликає функцію get_order_status з order_id="12345"]
AI: Ваше замовлення #12345 має статус «Доставлено».
    Дата створення: 01.04.2026, сума: 1500 грн.
    Трекінг-номер: UA1234567890.
```

***

### Управління функціями

* **Увімкнути/вимкнути** — перемикач зліва від назви функції. Вимкнена функція не буде доступна AI.
* **Редагувати** — кнопка з іконкою олівця.
* **Видалити** — кнопка з іконкою кошика.
* **Аналітика** — кнопка з іконкою графіка. Показує статистику викликів функції: кількість, успішні/помилкові, середній час відповіді.

***

### Логування

Всі виклики кастомних функцій логуються. Переглянути їх можна в розділі **Інтеграція → API → Логи вебхуків**. Для кожного виклику зберігається:

* Відправлений запит (payload)
* Статус відповіді (HTTP код)
* Тіло відповіді
* Час виклику

Це допомагає у відлагодженні, якщо функція не працює як очікувалось.

***

### Поширені питання

1. **Скільки власних функцій можна створити?**

*Кількість обмежена тарифним планом. Якщо ви бачите повідомлення про обмеження — зверніться до підтримки або перейдіть на вищий план*.

2. **Чи можна мати кілька функцій на одному вебхуку?**

*Так. Всі виклики `ai.func_call` йдуть на один зареєстрований вебхук. Розрізняйте їх за полем `data.function`.*

3. **Що станеться, якщо мій сервер не відповість?**

*AI повідомить клієнту, що не вдалося отримати інформацію, та запропонує спробувати пізніше або звернутися до менеджера.*

4. **Як AI вирішує, коли викликати функцію?**

*AI аналізує опис функції та контекст розмови. Якщо запит клієнта відповідає опису — AI збирає необхідні параметри та робить виклик. Поле «Інструкція для AI» додатково уточнює правила виклику.*

5. **Чи можна тестувати функцію без реального сервера?**

*Так. Ви можете використати сервіси на кшталт* [*webhook.site*](https://webhook.site/) *або* [*requestbin.com*](https://requestbin.com/) *для отримання та перегляду запитів під час тестування.*


# Ручне налаштування функції пошуку по базі знань

## Функція пошуку по базі знань — search\_knowledge\_base

### Що це і навіщо потрібно

Функція `search_knowledge_base` — це інструмент, який дає вам повний контроль над тим, **як саме** АІ-асистент шукає інформацію у базі знань та на основі чого формує відповідь.

За замовчуванням АІ самостійно виконує пошук «під капотом» — без вашого втручання. Після активації функції цей процес стає прозорим і керованим: ви бачите, який запит надійшов до бази знань, що саме повернулося назад, і можете точно налаштувати логіку вибірки.

#### Ключові можливості

* **Контроль вибірки** — визначайте, як формується запит до бази знань і що передається АІ для генерації відповіді.
* **Додаткові інструкції** — дописуйте специфічні правила пошуку, мапінг категорій, пріоритети та інші параметри прямо у налаштуваннях функції.
* **Повні логи** — переглядайте кожен виклик: що запитував АІ, що повернула база знань, скільки часу зайняв запит.
* **Назва файлу у відповіді** — функція повертає `filename` знайденого документа, що дозволяє реалізовувати точний мапінг відповідей на конкретні файли бази знань.

***

### Як увімкнути функцію

> ⚠️ **Важливо:** За замовчуванням функція **вимкнена**. Поки вона не активована, АІ працює у штатному режимі — самостійно шукає по базі знань у фоні. Після активації АІ **перестає шукати самостійно** і використовує виключно те, що повертає функція, а також те, що прописано у основному промпті.

1. Відкрийте налаштування вашого АІ-асистента.
2. Перейдіть до розділу **Функції ШІ**.
3. Знайдіть функцію Пошук у базі знань **`search_knowledge_base`** і активуйте її (увімкніть перемикач).<br>

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

***

### Налаштування функції

Після активації натисніть на іконку налаштувань поруч із функцією. Відкриється вікно **«Налаштування функції: Пошук у базі знань»** з двома полями.<br>

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

#### Поле 1 — «Додаткова інструкція для пошуку»

У це поле вписуються додаткові правила, які АІ враховуватиме при формуванні пошукового запиту до бази знань. Тут можна:

* **Уточнити логіку формування запиту** — наприклад, вказати АІ завжди формувати повний запит із урахуванням контексту діалогу:

  ```
  Формуй повний запит, із врахуванням контексту
  ```

* **Додати інструкції по мапінгу** — якщо різні теми мають відповідати різним розділам або файлам бази знань, опишіть це тут.

  ```
  Якщо питання стосується тарифів або оплати — шукай лише у файлі site_price.txt.
  Якщо питання про доставку — шукай у файлі site_delivery.txt.
  Якщо питання про технічну підтримку — шукай у файлі site_faq.txt.
  ```

  &#x20;

* **Задати пріоритети** — наприклад, завжди шукати спочатку у певному розділі або використовувати конкретні ключові слова.

  ```
  Спочатку шукай у розділі FAQ. Якщо там немає відповіді — шукай у решті бази знань.
  Якщо питання містить слово "ціна", "тариф" або "вартість" — додай до запиту слово "прайс".
  Завжди включай у запит ключові слова з питання користувача без скорочень.
  ```

* **Скопіювати частину основного промпту** — будь-які правила, що стосуються пошуку по базі знань і вже є у вашому системному промпті, можна продублювати або перенести сюди для більш точного контролю.

  ```
  Формуй повний запит із урахуванням контексту діалогу.
  Не скорочуй запит до одного слова — передавай суть питання повністю.
  Відповідай лише на основі того, що повернула функція пошуку.
  ```

> 💡 **Порада:** Що детальніша інструкція — то точніший пошук. Однак уникайте суперечливих формулювань.

#### Поле 2 — «Відповідь, коли нічого не знайдено»

Текст, який АІ поверне користувачу, якщо пошук у базі знань не дав жодного результату. Наприклад:

```
З цим питанням вам допоможе служба підтримки.
```

Ви можете вказати будь-який текст: контакти підтримки, посилання на форму, або загальну фразу-заглушку.

#### Збереження налаштувань

Після внесення змін натисніть кнопку **«Зберегти зміни»**. Щоб закрити без збереження — **«Відмінити»**.

***

### Перегляд логів виклику функції

Кожен виклик функції `search_knowledge_base` фіксується у логах. Це дозволяє діагностувати проблеми, відстежувати ефективність пошуку та розуміти, що саме передається АІ.<br>

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

#### Як відкрити логи

1. У розділі **Функції** натисніть на іконку статистики (графік) поруч із `search_knowledge_base`.
2. Відкриється вікно **«Пошук у базі знань»** з журналом викликів.

#### Що відображається у логах

У верхній частині вікна — зведена статистика за вибраний період (7, 14 або 30 днів):

| Показник     | Опис                                          |
| ------------ | --------------------------------------------- |
| **Виклики**  | Загальна кількість звернень до функції        |
| **Успішні**  | Кількість успішно виконаних запитів           |
| **Помилки**  | Кількість викликів із помилкою                |
| **Сер. час** | Середній час відповіді функції у мілісекундах |

Нижче — таблиця з деталями кожного виклику:

| Колонка      | Опис                                         |
| ------------ | -------------------------------------------- |
| **Дата**     | Точна дата і час виклику                     |
| **Статус**   | `success` (успішно) або помилка              |
| **Сер. час** | Час виконання конкретного запиту             |
| **Діалог**   | Посилання на діалог, у якому відбувся виклик |

Щоб подивитися деталі конкретного виклику — натисніть на іконку ока праворуч у рядку.

***

### Детальний перегляд виклику (Input / Output)

При натисканні на іконку перегляду відкривається вікно **«Функція — search\_knowledge\_base»** з двома панелями.<br>

<figure><img src="/files/0SUBNbfkbp6g4DqSgaMC" alt="" width="563"><figcaption></figcaption></figure>

<figure><img src="/files/btpAAq2gb1OYo0xkGqeq" alt="" width="563"><figcaption></figcaption></figure>

#### Input (що запитував АІ)

Відображає JSON-запит, який АІ сформував і передав функції. Зазвичай це об'єкт із полем `query`:

```json
{
  "query": "тарифи"
}
```

Тут ви бачите **точне формулювання** пошукового запиту — так, як його склав АІ на основі повідомлення користувача та ваших інструкцій.

#### Output (що повернула функція)

Відображає результат пошуку по базі знань — масив об'єктів, кожен з яких містить:

* **`score`** — релевантність знайденого фрагмента (від 0 до 1). Наприклад, `0.8388` означає дуже високу відповідність.
* **`content`** — текст фрагмента, що буде передано АІ для формування відповіді. Включає секцію, джерело (URL), заголовок та інформаційний блок.
* **`filename`** — назва файлу у базі знань, з якого взято фрагмент. Наприклад: `"site_1.txt"`.

Приклад структури output:

```json
{
  "score": 0.8388,
  "content": "[SECTION:Ціни | SOURCE:https://jedidesk.com/ua/price/]\nTITLE: Ціни та тарифи\nINFO: ...",
  "filename": "site_1.txt"
}
```

> 💡 **Про `filename` та мапінг:** Поле `filename` особливо корисне, якщо ви налаштовуєте мапінг — логіку, за якою певні питання мають завжди отримувати відповідь з конкретного документа. Знаючи назву файлу, можна прописати у інструкціях функції правила: «якщо відповідь із файлу `price.txt` — використовуй розділ X» тощо.

***

### Важлива різниця: увімкнена vs. вимкнена функція

| Стан                            | Поведінка АІ                                                                                                       |
| ------------------------------- | ------------------------------------------------------------------------------------------------------------------ |
| **Вимкнена** (за замовчуванням) | АІ самостійно шукає по базі знань у фоні, без вашого контролю                                                      |
| **Увімкнена**                   | АІ НЕ шукає самостійно — відповідь формується лише на основі того, що повертає функція, та даних основного промпту |

> ⚠️ Якщо функція увімкнена, але поле «Додаткова інструкція» порожнє — АІ все одно використовуватиме лише результати функції. Тому після активації обов'язково перевірте, що інструкція для пошуку заповнена коректно.

***

### Типові сценарії використання

#### Сценарій 1 — Покращення точності пошуку

Якщо АІ знаходить нерелевантні фрагменти або «вигадує» відповіді, активуйте функцію і додайте інструкцію:

```
Формуй повний запит із урахуванням контексту попередніх повідомлень у діалозі. Не скорочуй запит до одного слова.
```

#### Сценарій 2 — Мапінг категорій питань на файли

Якщо ваша база знань організована по файлах (тарифи, технічна документація, FAQ тощо), опишіть у інструкції, яка тематика відповідає яким файлам:

```
При запитах про ціни та тарифи — шукай у файлах, що містять "price" у назві.
При технічних питаннях — пріоритет файлам з "tech" або "docs".
```

#### Сценарій 3 — Контроль «заглушки» при відсутності результату

Налаштуйте зрозумілу відповідь, якщо пошук нічого не знайшов:

```
На жаль, у базі знань немає інформації з цього питання. Зверніться до нашої служби підтримки: support@yourcompany.com або скористайтеся формою зворотного зв'язку на сайті.
```

***

### Поширені запитання

**Що буде, якщо я активую функцію без заповнення інструкцій?** АІ використовуватиме лише те, що повертає функція пошуку, і дані основного промпту. Якщо основний промпт не містить правил пошуку — якість відповідей може знизитися. Рекомендуємо завжди заповнювати поле додаткових інструкцій.

**Чи зміниться щось для вже активних чатів?** Ні. Поки функція вимкнена, жоден чат не змінить поведінку. Зміни набувають чинності лише після активації.

**Де подивитися, з якого файлу АІ взяв відповідь?** Відкрийте логи виклику функції → натисніть іконку ока у потрібному рядку → у панелі Output знайдіть поле `filename`.

**Чи можна одночасно використовувати search\_knowledge\_base і стандартний пошук АІ?** Ні. Після активації функції стандартний пошук вимикається повністю. Це два взаємовиключні режими.


# Перелік відео-інструкцій

#### Як створити чат-бот в Telegram

{% embed url="<https://www.youtube.com/watch?v=GcV7S0eVZXI>" %}

***

#### Як створити чат-бот в Viber

{% embed url="<https://www.youtube.com/watch?v=iwd2L6LAWHQ>" %}

***

#### Як створити чат на сайт від #jedidesk&#x20;

{% embed url="<https://www.youtube.com/watch?v=cqGE3uflAkY>" %}

***

#### Налаштування системи підтримки (Кабінет операторів)

{% embed url="<https://www.youtube.com/watch?v=LSMH567TM7o>" %}

***

#### Налаштування штучного інтелекту JediDesk AI

{% embed url="<https://www.youtube.com/watch?v=rla3jB7lH2c>" %}

***

#### Magic Button для JediDesk AI

{% embed url="<https://www.youtube.com/watch?v=DHyXDKqxjgg>" %}

***

#### Як налаштувати ключові слова для Instagram бота

{% embed url="<https://www.youtube.com/watch?v=dpi0izrt3Rg>" %}


# Magic Button для JediDesk AI

Зустрічайте Magic Button – найновіший винахід в системі JediDesk AI, який внесе магію в обслуговування ваших клієнтів!

✨ Час створити відповіді, час відправити їх клієнтам – все стає легше та швидше.  Давайте дізнаємося більше!

<figure><img src="https://media4.giphy.com/media/XTSCOvtuYgmNv3OMnr/giphy.gif?cid=ecf05e47sf7xo8jqgxjvtvpcjb90s3js5k6njt3fy335w38h&#x26;ep=v1_gifs_related&#x26;rid=giphy.gif&#x26;ct=g" alt=""><figcaption><p>Тисни!</p></figcaption></figure>

Менеджери часто витрачають час на формулювання та набір простих відповідей, час якого можна було б зосередити на більш важливих завданнях. Magic Button вирішує цю проблему, дозволяючи генерувати відповіді всього за один клік! 🕒

***

#### Основні переваги

* **Швидкість**: Генерація відповідей за 3 секунди.&#x20;
* **Інтуїтивність**: Легка взаємодія та можливість редагування відповідей.
* **Адаптивність**: Враховує особливості вашого бізнесу та контекст розмови.
* **Ефективність**: Зниження часу на спілкування з клієнтом, без втрати якості. ⚡️

<figure><img src="https://media.tenor.com/s5_yMI0m16YAAAAM/alice-in-wonderland-white-rabbit.gif" alt="" width="375"><figcaption></figcaption></figure>

***

#### Які проблеми вирішує Magic Button&#x20;

* **Економія часу**: Менше часу на набір тексту, більше часу на клієнтів.&#x20;
* **Персоналізація**: Адаптація відповідей під специфіку компанії.&#x20;
* **Контроль**: Встановлення стоп-слів для уникнення необдуманих відповідей. 🚫

***

**Як налаштувати цю чарівну кнопку?** [**Читайте в нашій інструкції!**](/nalashtuvannya-jedidesk-ai/nalashtuvannya-magic-button-dlya-jedidesk-ai)&#x20;


# Розподілення діалогів між менеджерами

#### **У нас є чудові новини!** 🎉&#x20;

Ваш улюблений інструмент для спілкування з клієнтами став ще кращим та потужнішим, завдяки свіжому оновленню. \
Тепер обробка великого об'єму запитів – це легко як ніколи! 🚀

<figure><img src="https://media.giphy.com/media/3ohjUSqjO5T3vgnIvC/giphy-downsized-large.gif" alt="" width="375"><figcaption></figcaption></figure>

Тепер ви можете встановити ліміти на кількість запитів для кожного менеджера, використовувати автоматичний режим "Невидимка", щоб збалансувати навантаження, та багато іншого! 🚀&#x20;

\
Все це створено для того, щоб ваша команда могла зосередитися на найважливішому – наданні найкращого обслуговування клієнтів.

***

#### Що таке функціонал розподілення у JediDesk?

Функціонал розподілення в JediDesk - це особливий інструмент, що дозволяє автоматично розподіляти діалоги між менеджерами. Кожному менеджеру можна встановити конкретний ліміт на кількість запитів, що вони отримують. Це допомагає забезпечити більш збалансовану роботу з клієнтами.

***

#### Навіщо потрібен функціонал розподілення?&#x20;

Функціонал розподілення діалогів допомагає управляти великим об'ємом запитів від клієнтів так, щоб вони були рівномірно розподілені між менеджерами. Це виключає перевантаження окремих співробітників і забезпечує більш рівномірний розподіл роботи.

<figure><img src="https://media.giphy.com/media/gRUvUqTZDUEGrGVLLf/giphy.gif" alt=""><figcaption></figcaption></figure>

***

#### Які проблеми вирішує функціонал розподілення?&#x20;

Функціонал розподілення вирішує декілька ключових проблем:

* Запобігання перевантаження окремих менеджерів.&#x20;
* Гарантія того, що всі запити від клієнтів будуть опрацьовані вчасно.&#x20;
* Більш ефективне використання ресурсів команди, завдяки рівномірному розподілу навантаження.

***

**Як налаштувати функціонал розподілення?** [**Читайте в нашій новій інструкції!**](/nalashtuvannya-jedidesk/nalashtuvannya-rozpodilennya-dialogiv-mizh-menedzherami)


# Widget API

Функції та механізми, якими можна керувати віджетом

**1. Відкриття віджету:**&#x20;

```
JediDesk("openWidget")
```

Використовуйте цю функцію, щоб відкривати вікно віджета в потрібний момент.

***

**2. Закриття віджету:**&#x20;

```
JediDesk("closeWidget") 
```

Використовуйте цю функцію, щоб закривати вікно віджета в потрібний момент.

***

**3. Передача даних користувача:**&#x20;

```
JediDesk("customerData", {
    name: "Max",
    phone: "+380990000000",
    email: "max@gmail.com",
    note: "VIP",
    language: "en",
    custom_fields: [{
            "id": 1,
            "value": "123"
        },
        {
            "id": 2,
            "value": "test"
        },
        {
            "id": 551,
            "value": "test321"
        }
    ]
})
```

Використовуйте цю функцію, щоб заповнювати та передавати дані про користувача віджету в потрібний момент.

***

**Дозволені поля для передачі:**

| **Параметр**   | **Тип**                | **Опис**                                                                                                                                                                                                                     |
| -------------- | ---------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| name           | string                 | Імʼя користувача                                                                                                                                                                                                             |
| phone          | string                 | Номер телефону користувача                                                                                                                                                                                                   |
| email          | string                 | Email користувача                                                                                                                                                                                                            |
| note           | string                 | Додатковий опис користувача, нотатки                                                                                                                                                                                         |
| language       | enum('uk', 'en', 'ru') | Мова користувача                                                                                                                                                                                                             |
| custom\_fields | array                  | <p>Поля, що налаштовуються. Масив об'єктів. <br><br>Параметри об'єктів: </p><p><strong>id</strong> - унікальний id поля (призначається при створення поля в адмін-панелі).</p><p><strong>value</strong> - значення поля.</p> |

**4.AI Page Context — передача даних сторінки для AI асистента**

````
Дані передаються через метод `JediDesk('pageContext', data)` або через поле `page_context` у виклику `JediDesk('customerData', data)`.

Варіант 1: окремий виклик `pageContext`

```js
JediDesk('pageContext', {
  product_name: 'iPhone 16 128GB',
  price: '29999',
  currency: 'UAH',
  category: 'Смартфони',
  availability: 'В наявності'
});
```
Варіант 2: разом із даними клієнта

js
JediDesk('customerData', {
  name: 'Іван',
  page_context: {
    product_name: 'iPhone 16 128GB',
    price: '29999',
    currency: 'UAH'
  }
});
````

Коли клієнт відкриває чат на сторінці конкретного товару або послуги, AI асистент може не знати, що саме переглядає клієнт. Це призводить до зайвих уточнюючих питань замість конкретної відповіді.

Передаючи дані сторінки через Widget API, ви дозволяєте AI одразу розуміти контекст звернення і відповідати точніше.

Повний приклад інтеграції

```html
<script>
  // 1. Ініціалізація JediDesk Widget
  !function(e,t){ /* embed code */ }(window, document);

  // 2. Функція збору даних поточної сторінки
  function getJediDeskPageContext() {
    return {
      product_name: document.querySelector('[data-product-name]')?.dataset.productName || '',
      price:        document.querySelector('[data-product-price]')?.dataset.productPrice || '',
      currency:     'UAH',
      category:     document.querySelector('[data-product-category]')?.dataset.productCategory || '',
      availability: document.querySelector('[data-product-available]')?.dataset.productAvailable || '',
      sku:          document.querySelector('[data-product-sku]')?.dataset.productSku || ''
    };
  }

  // 3. Передача при завантаженні
  JediDesk('pageContext', getJediDeskPageContext());
</script>
```

**5. Підписатись на подію віджета:**&#x20;

```
window.addEventListener("JediDeskFullyLoaded", (e) => {
    // Тут можна розмістити JS-код, який оброблює подію 
});
```

Використовуйте цю функцію, щоб отримувати сповіщення про різні події, які звʼязані із віджетом.

**Можливі події:**

<table data-header-hidden><thead><tr><th></th><th></th><th data-hidden></th><th data-hidden></th><th data-hidden></th><th data-hidden></th></tr></thead><tbody><tr><td><strong>Подія</strong></td><td><strong>Опис</strong></td><td><strong>Опис</strong></td><td><strong>Опис</strong></td><td><strong>Опис</strong></td><td></td></tr><tr><td>JediDeskFullyLoaded</td><td>Ініціалізація віджету повністю завершена</td><td>string</td><td>Імʼя користувача</td><td>Ініціалізація віджету повністю завершена</td><td></td></tr><tr><td>JediDeskOpenedWidget</td><td>Було відкрито віджет</td><td>string</td><td>Номер телефону користувача</td><td>Було відкрито віджет</td><td></td></tr><tr><td>JediDeskClosedWidget</td><td>Було закрито віджет</td><td></td><td></td><td>Було закрито віджет</td><td></td></tr><tr><td>JediDeskClientSendMessage</td><td>Користувач відправив повідомлення менеджеру.<br><br>Вміст параметра detail (e.detail):<br><strong>text</strong> <em>(string)</em> - текст повідомлення<br><strong>firstMessage</strong> <em>(boolean) -</em> чи є це повідомлення першим у діалозі</td><td>string</td><td>Email користувача</td><td>Було закрито віджет</td><td></td></tr><tr><td>JediDeskManagerSendMessage</td><td>Менеджер відправив повідомлення користувачу.<br><br>Вміст параметра detail (e.detail):<br><strong>text</strong> <em>(string)</em> - текст повідомлення<br><strong>hasAI</strong> <em>(boolean)</em> - текст згенеровано і відправлено автоматично за допомогою ШІ</td><td></td><td></td><td></td><td></td></tr></tbody></table>


# Інтеграція із аналітикою (Google Tag Manager, Google Analitycs, FB та інше)

**1. Приклад того, як за допомогою відслідковування подій віджета можна реалізувати інтеграцію віджета із Google Tag Manager.**&#x20;

Будемо вважати, що написане перше повідомлення від користувача є тригером того, що він є лідом. Для цього використаємо подію *JediDeskClientSendMessage* із параметром *firstMessage*:

```
window.addEventListener("JediDeskClientSendMessage", (e) => {
    if (e.detail.firstMessage) {
        dataLayer.push({
            event: "widgetLead",
            client_name: "Тест",
            client_phone: "+380999999990",
            message: e.detail.text // текст повідомлення користувача
        });
    }
});
```

***

**2. Приклад того, як за допомогою відслідковування подій віджета можна відслідковувати відправку повідомлень від АІ** (коли АІ відповідає на повідомлення).&#x20;

Для цього використовуємо подію JediDeskManagerSendMessage із параметром hasAI:

***

```
window.addEventListener("JediDeskManagerSendMessage", (e) => {
    if (e.detail.hasAi) {
        // тут можна отримати повідомлення, яке згенерував АІ та використати це в своїх цілях
        // e.detail.text
    }
});
```

***


# Ініціалізація віджета

Основні налаштування віджету, якими можна керувати на сторінці [Налаштування віджета](https://app.jedidesk.com/settings-widget) - є глобальними для віджета, не залежно від того, де розміщено ваш віджет.

Для відображення одного віджету по-різному на різних сторінках сайту, є можливість налаштувати деякі параметри при його ініціалізації.&#x20;

За замовчуванням, для генерації віджета використовується код:

***

```
window.jediDeskSettings = {
    token: "1111163635543333335527444444375555504f4141",
};
```

***

Параметр jediDeskSettings можна розширити і встановлювати такі змінні:

| **Параметр** | **Тип**                                                                                        | **Опис**                                                                                                                                                                                                                                           |
| ------------ | ---------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| language     | <p>enum</p><p>Можливі варіанти: da, de, en, es, fi, fr, ja, ko, nl, no, pl, pt, ru, sv, uk</p> | <p>Мова віджета. <br></p><p><mark style="color:red;"><strong>Важливо</strong></mark>: налаштування текстів кожної із мов повинно бути проведено до використання на <a href="https://app.jedidesk.com/settings-widget">сторінці налаштувань</a></p> |
| autoOpen     | boolean                                                                                        | <p>Показник, чи відкривати автоматично віджет при завантаженні сторінки. <br><br>За замовчуванням - <strong>false</strong></p>                                                                                                                     |
| alwaysOpen   | boolean                                                                                        | <p>Показник, чи блокувати можливість закрити віджет. <br><br>Віджет буде завжди відкритий на сайті. <br><br>Працює в парі з параметром <strong>autoOpen</strong>.<br></p><p>За замовчуванням -  <strong>false</strong></p>                         |

***

**Приклад, як можна вказати мову віджета при ініціалізації** (корисно використовувати, якщо на сайті дві і більше мовних версій):

***

```
window.jediDeskSettings = {
    token: "1111163635543333335527444444375555504f4141",
    language: "uk"
};
```

***

{% hint style="info" %}
За замовчуванням якщо в налаштуваннях активно більше 1 мови, мова віджету буде дорівнювати мові браузера користувача, або мові за замовчуванням, якщо мова користвувача не знайдена в активних.
{% endhint %}


# Welcome to #jedidesk

With the help of our service, you can install a chat on the site, as well as connect Telegram and Viber chatbots.

If you need a **quality service** that helps integrate artificial intelligence, Telegram, Viber, and chat on your website while preserving the formatting, then you've come to the right place.

Our mission is to create a useful product for entrepreneurs and companies that will assist customers in automating their support inquiries.

### Or look for interesting features here

<table data-view="cards" data-full-width="false"><thead><tr><th></th><th data-hidden></th><th data-hidden></th><th data-hidden></th><th data-hidden></th><th data-hidden data-type="files"></th><th data-hidden data-type="number"></th><th data-hidden data-card-cover data-type="files"></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><strong>Acquaintance</strong></td><td>123</td><td></td><td></td><td></td><td></td><td>0</td><td><a href="/files/gITJhRTxFCBzSu0Yp1JL">/files/gITJhRTxFCBzSu0Yp1JL</a></td><td><a href="/pages/ybR04HoFbK7B6ErNcs1Z">/pages/ybR04HoFbK7B6ErNcs1Z</a></td></tr><tr><td><strong>Widget</strong></td><td></td><td></td><td></td><td></td><td></td><td>null</td><td><a href="/files/6X8lYIB7fWV5CEuQrdCs">/files/6X8lYIB7fWV5CEuQrdCs</a></td><td><a href="/pages/NfbzgOu9E5vHfr64rvAj">/pages/NfbzgOu9E5vHfr64rvAj</a></td></tr><tr><td><strong>Chat-bots</strong></td><td></td><td></td><td></td><td></td><td></td><td>null</td><td><a href="/files/T2CeuaYIAa1AdkAVJUMH">/files/T2CeuaYIAa1AdkAVJUMH</a></td><td><a href="/pages/8KJQyKzOnBZiruKeLp4b">/pages/8KJQyKzOnBZiruKeLp4b</a></td></tr></tbody></table>

### Very convenient search - use it 👇

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


# JediDesk App for Windows and MacOS in Chrome Apps

It's time to forget about a bunch of browser tabs, because #jedidesk is now available as an app in ChromeApps!

Log in to [**#jedidesk**](https://app.jedidesk.com) and click "**Install App**" via the **Google Chrome** browser:

<figure><img src="/files/5q8v5i4X0n3xc91zjkNo" alt=""><figcaption><p>Installing the application through the Google Chrome browser</p></figcaption></figure>

In a few seconds, the **#jedidesk** application will be installed and deployed on your desktop:

<figure><img src="/files/BKpn8d5wun8bZvtq9egV" alt=""><figcaption><p>The #jedidesk app</p></figcaption></figure>

***

#### ✅ **Done!**


# Setting up notifications

In our system, you can set up notifications in two methods: via Telegram and Push

#### **Navigation:**

1. [Connecting Push notifications (Windows, MacOS)](#id-1.-connecting-push-notifications-windows-macos)
2. [Connecting notifications in Telegram ](#id-2.-connecting-notifications-in-telegram)
3. [Connecting notifications on IOS](#id-3.-connecting-notifications-on-ios)

***

#### 1. Connecting Push notifications (Windows, MacOS)&#x20;

On the **Settings ->** [**Profile** ](https://app.jedidesk.com/settings-profile)tab, in the **Notifications** block, enable **Push Notifications** and click <mark style="background-color:blue;">**Save Changes**</mark>.&#x20;

The browser will automatically send a request to allow notifications - confirm the request. \
If the request has not been received, click 🔒 next to the browser address bar and activate the permission:

<figure><img src="https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXkehX3Ue2D5LVuBJjMnb%2Fuploads%2FPKaDMwjBAUqVfMrbB4lP%2FUA_Push-Notifications_01.png?alt=media&#x26;token=cb9335bd-b030-4ac7-a942-5121c26ccd9a" alt=""><figcaption><p>Setting up notifications in profile #jedidesk</p></figcaption></figure>

***

Go to the [**My Chat**](https://app.jedidesk.com/chat) tab and click on 🔊 in a dialogue with any client and choose additional sound settings:

<figure><img src="/files/v6jD4uNBbU6AwAfcyl58" alt=""><figcaption><p>My Chat notification sound settings</p></figcaption></figure>

***

Make sure your operating system allows you to send notifications from your browser.&#x20;

1. **Enable notifications on Windows:**&#x20;

Go to **Settings -> System -> Notifications & Actions** and turn on notifications:

<figure><img src="https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXkehX3Ue2D5LVuBJjMnb%2Fuploads%2FBO4Gh0QNsoHpInf5KRNf%2FUA_Push-Notifications_02.png?alt=media&#x26;token=2d3a11c1-d1b7-4f8b-bdf7-2dfbe6ab4e6b" alt=""><figcaption><p>Setting up notifications for Windows OS</p></figcaption></figure>

***

Go to the page below and turn on notifications for your browser:

<figure><img src="https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXkehX3Ue2D5LVuBJjMnb%2Fuploads%2Fqv2hNgksWMVroqGRWvq6%2FUA_Push-Notifications_03.png?alt=media&#x26;token=05081622-57de-4d82-a364-50a063661aca" alt=""><figcaption><p>Setting up notifications from Windows OS programs</p></figcaption></figure>

***

2. **Enable notifications on MacOS**:&#x20;

Open the **Apple menu -> System Settings -> 🔔 Notifications** in the sidebar and click **>** next to the browser:

<figure><img src="https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXkehX3Ue2D5LVuBJjMnb%2Fuploads%2FaGVL3rai1sl5Vv1LQ6Sq%2FUA_Push-Notifications_04.jpg?alt=media&#x26;token=6bfb2672-8bad-460c-beaa-ce2a4ff579a5" alt=""><figcaption><p>Setting up notifications for MacOS</p></figcaption></figure>

***

Expand settings and enable notifications:

<figure><img src="https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXkehX3Ue2D5LVuBJjMnb%2Fuploads%2FIIIiLwjae8pqM9ZWBuyX%2FUA_Push-Notifications_05.jpg?alt=media&#x26;token=38829351-3954-4b46-aaee-575a221c1394" alt=""><figcaption><p>Setting up notifications from MacOS programs</p></figcaption></figure>

***

#### 2. Connecting notifications in Telegram

In the **Settings ->** [**Profile** ](https://app.jedidesk.com/settings-profile)tab, in the **Notifications** block, enable the **Notifications function in the Telegram bot**, which, when you go to the system bot **#jedidesk**, identifies your profile.&#x20;

Launch the bot, return to settings and click <mark style="background-color:blue;">**Save changes**</mark>:

<figure><img src="https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXkehX3Ue2D5LVuBJjMnb%2Fuploads%2Fiw5WK0eJRgq8cQUx9JXd%2FUA_TG-Notifications_01.png?alt=media&#x26;token=378caf78-cdaf-4022-a620-3ef6b8462970" alt=""><figcaption><p>Setting up alerts via Telegram bot #jedidesk</p></figcaption></figure>

***

When the bot sends notifications, you can respond to them like regular messages using the Reply function:

<figure><img src="/files/3CjqQIAPDW3Rr3x2BDtd" alt="" width="434"><figcaption><p>Receiving notifications and quick replies via Telegram bot #jedidesk</p></figcaption></figure>

***

#### 3. Connecting notifications on iOS

Using the [Web push](#user-content-fn-1)[^1] API, you can connect notifications on iOS.&#x20;

Notifications for mobile devices are also supported when adding them to the home screen.

[^1]: The Push API has become a Web protocol standard, and it has been natively implemented in modern browsers such as Chrome, Firefox, Edge, and Safari.


# 6 steps to start the #jedidesk support system

Not sure where to start on #jedidesk? Let's take a look at the 6 main steps to start a support system

#### **Step 1: Create and embed the widget**

In the **Settings ->** **Integration** **->** [**Widget Settings**](https://app.jedidesk.com/settings-widget) tab, create a widget to place on your site.

Many settings are available here - from widget design to multilingualism.

👉🏻 [How to create a #jedidesk Widget](/english/widget/how-to-create-a-jedidesk-widget)

***

#### **Step 2: Add managers (operators)**

If you have assistants, you can always add<mark style="color:red;">\*</mark> them to #jedidesk!

👉🏻 [How to add a manager (operator)](/english/jedidesk-setup/how-to-add-a-manager-operator)

<mark style="color:red;">\*</mark>*The number of managers depends on the* [*subscription*](https://jedidesk.com/price/) *you have chosen.*

***

#### **Step 3: Turn on notifications for new requests**

Stay up to date with new requests without logging into the #jedidesk service.

Receive notifications and communicate with customers directly through the Telegram bot!

👉🏻 [How to turn on notifications](https://docs.jedidesk.com/english/jedidesk-launch/pages/7drW8ALWuxqxYFj2obHl#2.-quick-reply-via-telegram)

***

#### **Step 4: Setup and add chatbots**

To increase the number of channels for requests, you can connect<mark style="color:red;">\*</mark> Telegram and Viber chatbots.

👉🏻 [How to create a chatbot in Telegram](/english/chatbots/how-to-create-a-chatbot-in-telegram)

👉🏻 [How to create a chatbot in Viber](/english/chatbots/how-to-create-a-chatbot-in-viber)

<mark style="color:red;">\*</mark>*Connection of chatbots depends on the* [*subscription*](https://jedidesk.com/price/) *you have chosen*.

***

#### **Step 5: Add quick answers and knowledge base**

Increase the efficiency of managers, save time and effort - add answer templates for the chat, a knowledge base with answers to common questions, or connect JediDesk AI:

👉🏻 [How to create Quick Answers](/english/jedidesk-setup/how-to-create-quick-answers)

👉🏻 [How to create a knowledge base (FAQ)](/english/jedidesk-setup/how-to-create-a-knowledge-base-faq)

👉🏻 [How to configure JediDesk AI](/english/jedidesk-ai-setup/how-to-configure-jedidesk-ai)

***

#### **Step 6: Accept the requests**

After creating the widget and chatbots, you will receive requests in the [LiveChat](https://app.jedidesk.com/chat) tab.

Click <mark style="background-color:blue;">**Answer dialog**</mark> and start processing your customers' requests!

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

The following functionality is available here:

* listening to voice messages
* sending media files
* emoji
* text formatting in **bold**, *italics*, ~~strikethrough~~
* filling out the client's card: notes, tags, etc
* change of manager
* [indicate the dialogue subjects](/english/jedidesk-setup/setting-the-dialogue-subjects)
* block user&#x20;
* [create custom fields for additional information](/english/jedidesk-setup/customer-custom-fields)


# Analytics

Overview of analytics functionality on the #jedidesk service

#### Productivity of managers and dynamics of requests

Open the **Analytics ->** [**Productivity** ](https://app.jedidesk.com/analytics/productivity)tab.&#x20;

Displaying the statistics of requests in all formats (new, closed) and the response time of managers to them:

<figure><img src="/files/J2cnCuztoK0BwvsF8H2x" alt=""><figcaption><p>Productivity analytics in numbers</p></figcaption></figure>

<figure><img src="/files/dw7CWDuCB9PBkYTfBrIB" alt=""><figcaption><p>Productivity chart</p></figcaption></figure>

Additionally, you can specify a certain period and a specific manager who processed the request:

<figure><img src="/files/97IomQnomgGScpQf2hML" alt=""><figcaption><p>Analytics of a specific manager for a certain period</p></figcaption></figure>

***

#### Assessment of service quality&#x20;

Open the **Analytics ->** [**Quality** ](https://app.jedidesk.com/analytics/quality)tab.&#x20;

If you have enabled the manager evaluation functionality after completing the dialog in the **Settings ->** [**Company** ](https://app.jedidesk.com/settings-company)tab, you can evaluate the level of service quality of your managers:

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

Additionally, you can specify a certain period and a specific manager who processed the requests.

***

#### Analysis of dialogue subjects

Open the **Analytics ->** [**Subjects** ](https://app.jedidesk.com/analytics/subject)**tab**.&#x20;

If you have added [dialogue subjects](/english/jedidesk-setup/setting-the-dialogue-subjects) and marked all requests, you can see the statistics of requests (subjects) for which customers contact you:

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

Additionally, you can specify a certain period and a specific manager who processed the requests.


# Live Chat functionality

Overview of the main functionality of the LiveChat module

The [LiveChat](https://app.jedidesk.com/chat) module looks like this:

<figure><img src="/files/TzEQfbsE01UOA8un9nUF" alt=""><figcaption><p>LiveChat</p></figcaption></figure>

You see dialogs labeled messengers, widgets, and AI in three folders:&#x20;

<mark style="color:purple;">**New**</mark> - new (unaccepted) chats that need processing.&#x20;

<mark style="color:green;">**Active**</mark> - chats accepted by the manager and currently being processed.&#x20;

<mark style="color:blue;">**Archives**</mark> - closed, processed chats, or deactivated due to lack of response from the client.&#x20;

It is possible to configure [the distribution of chats between managers](/english/jedidesk-setup/setting-the-distribution-of-dialogues-between-managers) and their changes, which is very useful in case of a large number of requests.

***

Chats are filtered by the following indicators:

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

***

When applying, each client is added to the system, and you have the opportunity to view and partially edit their information:

<figure><img src="/files/CVxHQO3jSKm4uciysApK" alt=""><figcaption><p>Client card</p></figcaption></figure>

* **Photo**
* **Request channel**
* **Name**&#x20;
* **username** - when contacting via Telegram or Instagram bots
* **email** - specified by the manager himself&#x20;
* **The phone number** is specified by the manager himself&#x20;
* [**Custom field**](/english/jedidesk-setup/customer-custom-fields) for necessary information (for example, ID on the service, etc.)&#x20;
* **Client language** - identified by the language of the client's application or browser. You can change the language yourself, the language of system messages in the chat depends on it.&#x20;
* **Manager** - the manager who accepted the request is automatically indicated. The supervisor can change the manager.&#x20;
* **Notes**&#x20;
* [**Dialogue subjects**](/english/jedidesk-setup/setting-the-dialogue-subjects) - specified by the manager for analytics if necessary&#x20;
* **Tag** - specified by the manager for grouping customers during mailing, etc
* **Blocking the client**

***

Please note that part of the functionality is optional and can be configured in the **Settings ->** [**Company**](https://app.jedidesk.com/settings-company) tab:

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

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

* **Main language** - specify the language in which all clients will receive system messages (dialogue start and end, manager connection, etc.).
* **Displaying the phone number input field in the bot and widget** - The client will be able to specify his number.
* **Displaying the name input field in the widget** - The client will be able to specify his name.
* **Show notifications about joining/changing chat manager** - the client will receive a system message about the manager's connection.
* **Ask the user if the issue has been resolved** - the client will receive the message "*Do you still have questions?*" with "*Yes / No*" buttons. The "*No*" button will automatically transfer the dialogue to the <mark style="color:blue;">**Archives**</mark> folder.
* **Mandatory evaluation of the dialogue upon its completion** - enable if this indicator is necessary for the [analysis of the quality of employees](/english/jedidesk-launch/analytics).
* **Displaying the subject of the dialogue** - you can specify several [dialog subjects](/english/jedidesk-setup/setting-the-dialogue-subjects) for [analytics](/english/jedidesk-launch/analytics). If this is a necessary indicator, enable the **Mandatory indication of the subject of the dialogue** function - chats without topics will not be able to be closed.
* **Applying a trigger starts a dialog** - if you enable this feature, you will receive notification messages about users who clicked on auto-reply UTM trigger links to the bot (this is not a request). Turn off this feature if you only want to receive messages after these clients write to you.
* **Prohibit editing of messages in dialogs** - managers will not be able to edit sent messages.
* **Prohibit deletion of messages in dialogs** - managers will not be able to delete sent messages.
* **Allow a user with the Manager role to change the manager** - by default, the manager change is available only to the account owner and the supervisor.
* **Allow a user with the Manager role to block the customer** - by default, blocking is available only to the account owner and supervisor.
* **Close dialogue via inactivity** - if the client does not respond within 15 minutes, the dialog is automatically closed and goes to the <mark style="color:blue;">**Archives**</mark> folder. The waiting time can be changed or completely disabled.

***

When a user submits a request, it looks like this:

<figure><img src="/files/4HIhEPgPu3lnyWGnrsWt" alt=""><figcaption><p>New request from the client</p></figcaption></figure>

The manager clicks on the <mark style="background-color:blue;">**Answer dialog**</mark> button, then either enters the message himself or chooses a [quick answer](/english/jedidesk-setup/how-to-create-quick-answers):&#x20;

<figure><img src="/files/duNLFXKeutSnYttpX0z3" alt=""><figcaption><p>Quick answers</p></figcaption></figure>

***

By clicking on **⋮** you can edit or delete messages:

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

***

There is also an option to generate answers via [MagicButton](/english/jedidesk-ai-setup/how-to-configure-magic-button-for-jedidesk-ai) instead of manual input, or to [configure artificial intelligence JediDesk AI](/english/jedidesk-ai-setup/how-to-configure-jedidesk-ai), which will independently process customer requests instead of managers.

***

When the conversation with the client is finished, click <mark style="background-color:green;">**Close the dialog**</mark> button in the upper right corner.&#x20;

If the manager does not close the dialog, the [analytics will not display correct data about closed chats](/english/jedidesk-launch/analytics), and your clients will not receive a system message about the [company's non-working hours](/english/jedidesk-setup/setting-the-companys-business-hours).


# How to create a #jedidesk Widget

\#jedidesk offers a very easy way to create and customize your Widget

#### **Navigation:**

1. [Language and text settings](#id-1.-language-and-text-settings)
2. [Mini widget settings](#id-2.-mini-widget-settings)
3. [Generated widget code](#id-3.-generated-widget-code)
4. [Animation of typing messages and viewing messages typed in the chat](#id-4.-animation-of-typing-messages-and-viewing-messages-typed-in-the-chat)

***

#### **1.** Language and text settings:

Open **Settings** **->** **Integration** **->** [**Widget Settings**](https://app.jedidesk.com/settings-widget) tab.

The widget in each language<mark style="color:red;">\*</mark> is configured separately. Click on **Select language**, and select, for example, English, fill in all the templates and click <mark style="background-color:blue;">**Save**</mark> button:

<figure><img src="/files/7rXmuyPgbiVqxbJe9l3D" alt=""><figcaption><p>List of default languages</p></figcaption></figure>

<figure><img src="/files/rjLBbvLHerycwNfssU21" alt=""><figcaption><p>Template for customizing the widget</p></figcaption></figure>

***

If you want to reset all widget settings, click <mark style="background-color:blue;">**Default setting**</mark> button.

By default, 3 languages are available for the widget, but you can always add more languages:

<figure><img src="/files/JFptsH56Ci9Kc3iNeTXZ" alt=""><figcaption><p>Additional languages for the widget</p></figcaption></figure>

***

To enable other languages, click the switch after selecting the language:

<figure><img src="/files/obv6xtXVbRj70AfQemdX" alt=""><figcaption><p>Activate the selected language for the widget</p></figcaption></figure>

***

If you disable accepting requests through the widget, it will only work as a redirect to your messenger bots:

<figure><img src="/files/UECJQG7XgqZSwFB7xCgj" alt=""><figcaption><p>Widget activation as a chat</p></figcaption></figure>

{% hint style="danger" %} <mark style="color:red;">Please note that when the widget is set to multiple languages, the language of the widget depends on the language of the client's browser and not on the language of the web resource on which the widget is placed. For example, if the browser is set to the English language, the client will see the widget in the English language.</mark>
{% endhint %}

***

#### **2.** Mini widget setting&#x73;**:**

Instead of an expanded widget, you can set up a mini-widget with icons:

<figure><img src="/files/CBs5AEYezMfC2htQGhlM" alt=""><figcaption><p>Customizing the mini widget</p></figcaption></figure>

***

#### **3.** Generated widget code:

When you’re done designing your widget, click <mark style="background-color:blue;">**Save**</mark> button and copy the generated code to paste on your site:

<figure><img src="/files/6ZLRu85oMGUlLgmdTbzW" alt=""><figcaption><p>Getting the widget code</p></figcaption></figure>

***

#### 4. Animation of typing messages and viewing messages typed in the chat

When your customer writes a message in the chat via the widget, you will see the message and can prepare a response in advance:

<figure><img src="/files/VO3quRTQ3B1iVkP4cMWG" alt=""><figcaption><p>The customer writes messages in real time</p></figcaption></figure>

<figure><img src="/files/4HIhEPgPu3lnyWGnrsWt" alt=""><figcaption><p>The customer has sent a message</p></figcaption></figure>

***

The customer will also see what you write to him, but will not see the text before sending:

<div><figure><img src="/files/f2J4L0GoFZ3Jljy4lJRW" alt=""><figcaption><p>The manager writes a message</p></figcaption></figure> <figure><img src="/files/6RsTf7RUtRCgJWpv6seb" alt=""><figcaption><p>The manager sent a message</p></figcaption></figure></div>


# How to embed a widget on a site

These instructions are suitable for any sites where you have access to the site via FTP or other methods.

Log in to **#jedidesk** and follow the instructions for [setting up the widget](/english/widget/how-to-create-a-jedidesk-widget) and creating chat bots on the [Viber](/english/chatbots/how-to-create-a-chatbot-in-viber) and [Telegram ](/english/chatbots/how-to-create-a-chatbot-in-telegram)platforms.&#x20;

Paste the widget code before the **\</body>** tag on all pages where you want to place the widget:

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

Done! If you have a **CMS**, look at our instructions for installing a widget in the following sections.


# How to embed a #jedidesk widget in Horoshop

Horoshop is an all-in-one modern Ukraine platform that gives you everything you need to launch and run your online store

1. [**Create a #jedidesk widget**](/english/widget/how-to-create-a-jedidesk-widget) and copy the generated code.
2. Log in to [**Horoshop**](https://horoshop.eu/).
3. Open the **Settings** –> **General Settings** –> **Scripts** tab, paste the #jedidesk widget code before the <mark style="color:red;">**\<body>**</mark> tag and click <mark style="background-color:blue;">**Save**</mark>:

<figure><img src="/files/F2HlVu79BLLSW5LgJtj7" alt=""><figcaption><p>How to embed a #jedidesk widget in Horoshop</p></figcaption></figure>


# How to embed a #jedidesk widget in CS-CART

CS-Cart is a platform for creating and managing online stores with many features for e-commerce, including product management, order management and integration with payment systems.

1. ​[**Create a #jedidesk widget**](https://docs.jedidesk.com/v/english/widget/how-to-create-a-jedidesk-widget) and copy the generated code.
2. Log in to [**CS-Cart**](https://www.cs-cart.com/).
3. In the top menu, go to **Design -> Layouts**.
4. Select **Footer** at the bottom and in the section click ➕ to add a **Block**.
5. Add a block to the section, select **Callback/HTML**.
6. After adding, click on ⚙️ to go to block options.
7. When the block edit opens, go to **Pages**, clear the input field, **paste the copied #jedidesk widget** and click **Save**.


# How to embed a #jedidesk widget in Jimdo

Jimdo is a user-friendly site builder that allows you to quickly create and edit sites using templates and a simple interface, without the need for programming.

1. ​[**Create a #jedidesk widget**](https://docs.jedidesk.com/v/english/widget/how-to-create-a-jedidesk-widget) and copy the generated code.
2. Log in to [**Jimdo**](https://www.jimdo.com/).
3. Select your site and click **Edit** to enter your Jimdo Creator website’s edit mode.
4. Hover over the content area to click on **Add Element -> More elements and Add-ons -> Widget/HTML Element.**
5. Paste your code in to the **Widget/HTML Element** and click **Save.**&#x20;
6. Refresh your browser if the widget doesn’t display correctly.


# How to embed a #jedidesk widget in Magento

Magento CMS is a well-known e-commerce engine that allows you to create extensive online stores with a variety of additional functionality.

1. **​**[**Create a #jedidesk widget**](https://docs.jedidesk.com/v/english/widget/how-to-create-a-jedidesk-widget) and copy the generated code.
2. Log in to [**Magento**](https://account.magento.com/customer/account/login).
3. Select the **System** section, and find the **Configuration** tab in the list:

<figure><img src="https://docs.jedidesk.com/~gitbook/image?url=https%3A%2F%2F4292724302-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FXkehX3Ue2D5LVuBJjMnb%252Fuploads%252FEdnxo4mcVjsXWMBrIAlS%252FMAGENTO_01.png%3Falt%3Dmedia%26token%3D2560ba1f-fcdc-4494-9339-4bcdb3d3db77&#x26;width=768&#x26;dpr=1&#x26;quality=100&#x26;sign=6397a9176738ea841fb0c68a0541f94829796921b7af47f8a61f8ceb446ae33e" alt=""><figcaption></figcaption></figure>

4. Select the **Design** tab in the **Configuration** settings:

<figure><img src="https://docs.jedidesk.com/~gitbook/image?url=https%3A%2F%2F4292724302-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FXkehX3Ue2D5LVuBJjMnb%252Fuploads%252Fl1ZDiGItwx0uwy9bFDPh%252FMAGENTO_02.png%3Falt%3Dmedia%26token%3D7073c91e-2fe9-4e14-9cb9-887004c3b728&#x26;width=768&#x26;dpr=1&#x26;quality=100&#x26;sign=640b4aa680f131a52bc3c97151237243003cbe631614c0c97110298407153b69" alt=""><figcaption></figcaption></figure>

5. Find the **Footer** block and paste the copied **#jedidesk widget code** into the **Miscellaneous HTML** field:

<figure><img src="https://docs.jedidesk.com/~gitbook/image?url=https%3A%2F%2F4292724302-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FXkehX3Ue2D5LVuBJjMnb%252Fuploads%252FTBg63c78HLjpasNOcZK5%252FMAGENTO_03.png%3Falt%3Dmedia%26token%3Df228bca3-7685-435d-a04e-35a5f0246607&#x26;width=768&#x26;dpr=1&#x26;quality=100&#x26;sign=d977eba50fd5b8cf573794d6ab4593802f25de1f344a29efc9194085e8b6c3b3" alt=""><figcaption></figcaption></figure>

6. Save the settings by clicking **Save** configuration.


# How to embed a #jedidesk widget in MODX

MODX is a free professional content management system and framework for web applications. Its goal is to provide an efficient and organized process for creating, editing and managing website content.

1. **​**[**Create a #jedidesk widget**](https://docs.jedidesk.com/v/english/widget/how-to-create-a-jedidesk-widget) and copy the generated code.
2. Log in to [**MODX**](https://modx.com/).
3. On the left side of the panel in the **Elements** section, select the **Templates →** **Basic template** block:

<figure><img src="https://docs.jedidesk.com/~gitbook/image?url=https%3A%2F%2F4292724302-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FXkehX3Ue2D5LVuBJjMnb%252Fuploads%252FMvECwOdns2PWBVag2zcH%252FMODX_01.jpg%3Falt%3Dmedia%26token%3Dc1913fb5-4784-499e-9e3b-829958a1c6c7&#x26;width=768&#x26;dpr=1&#x26;quality=100&#x26;sign=34fbe5c20be539a7a2377802ca2af32e5ce72efa64448799015817ed739293db" alt=""><figcaption></figcaption></figure>

4. In the template settings, paste the **#jedidesk widget code** before <mark style="color:red;">**\<body> (1)**</mark> and save by clicking the **Save button&#x20;**<mark style="color:red;">**(2)**</mark>:

<figure><img src="https://docs.jedidesk.com/~gitbook/image?url=https%3A%2F%2F4292724302-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FXkehX3Ue2D5LVuBJjMnb%252Fuploads%252FThVECJa2htC9LoeHqxzD%252FMODX_02.jpg%3Falt%3Dmedia%26token%3D729228c8-8012-405e-9954-5d0cffd5b577&#x26;width=768&#x26;dpr=1&#x26;quality=100&#x26;sign=bdca18199f63182a0f2fe1473890b7cc497316841b7c6ff685df476f42f19ac7" alt=""><figcaption></figcaption></figure>


# How to embed a #jedidesk widget in OPENCART

OpenCart is a free tool for creating commercial websites. The main advantage is that anyone can download this engine and easily create their own online store.

1. **​**[**Create a #jedidesk widget**](https://docs.jedidesk.com/v/english/widget/how-to-create-a-jedidesk-widget) and copy the generated code.
2. Log in to [**OpenCart**](https://opencart.ua/).

{% hint style="info" %}
**#jedidesk** widget code meets the same placement requirements as Google Analytics code. Therefore, it can be placed in this block both separately and together with the Google code. This does not cause a conflict or disruption of the site.
{% endhint %}

3. Go to **Administration →** **Modules** and extensions and select the **Analytics** extension type.\
   \
   Install **Google Analytics** and click the **Edit** button on the right:

<figure><img src="https://docs.jedidesk.com/~gitbook/image?url=https%3A%2F%2F4292724302-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FXkehX3Ue2D5LVuBJjMnb%252Fuploads%252FdKSL4BoAi7No0Wl01j7N%252FOPENCART_01.png%3Falt%3Dmedia%26token%3De1dbeff8-d42d-4e6c-b8d8-074a542f3e57&#x26;width=768&#x26;dpr=1&#x26;quality=100&#x26;sign=1b55d0cf3aab6db72b12aa9e1fb8e0455efa56af7ab53a400b5d45740486dfa7" alt=""><figcaption></figcaption></figure>

4. Paste your the **#jedidesk widget code**, select the **Enabled** status and save the settings:

<figure><img src="https://docs.jedidesk.com/~gitbook/image?url=https%3A%2F%2F4292724302-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FXkehX3Ue2D5LVuBJjMnb%252Fuploads%252FXWaRq8v3ZlxIBQFkmPll%252FOPENCART_02.png%3Falt%3Dmedia%26token%3D2d794a78-987a-4bb0-8aff-2dd45cca9fe8&#x26;width=768&#x26;dpr=4&#x26;quality=100&#x26;sign=3019b9345c11b795d85e1c8d96eb18d9ab69549109d4c7b156b369f81833f87f" alt=""><figcaption></figcaption></figure>

***

**You can also insert the code via FTP, for this you need:**

1. Go to the hosting of your site, or connect to the hosting via an FTP client and go to the directory: ***main\_folder/themes/name of your template/footer.tpl***&#x20;

<figure><img src="https://docs.jedidesk.com/~gitbook/image?url=https%3A%2F%2F4292724302-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FXkehX3Ue2D5LVuBJjMnb%252Fuploads%252FcgDGlxWOymXK7fBbtzME%252FFTP_01.png%3Falt%3Dmedia%26token%3Dbbbe6eb9-b397-4503-a500-535b4bca1fa1&#x26;width=768&#x26;dpr=1&#x26;quality=100&#x26;sign=04974ee7c522b5f9b8a7e1484bf1d270063c85cd8ac4097add0b230f0a15172e" alt=""><figcaption></figcaption></figure>

2. Open the **footer.tpl** file in editor mode and insert the JediDesk widget code before the closing <mark style="color:red;">**\<body>**</mark> tag and save the changes:

<figure><img src="https://docs.jedidesk.com/~gitbook/image?url=https%3A%2F%2F4292724302-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FXkehX3Ue2D5LVuBJjMnb%252Fuploads%252Fz5qIoGZWWjpURzr0SeR7%252FFTP_02.png%3Falt%3Dmedia%26token%3Da0987308-709b-4c00-b2c3-737ba3a84bbe&#x26;width=768&#x26;dpr=1&#x26;quality=100&#x26;sign=144cde5f08708fd8ff0d30af5931844c83c0d353494343273bf81aed51b6e489" alt=""><figcaption></figcaption></figure>

3. In some templates, the **footer.tpl** file is not connected to each page, then it is appropriate to use the **header.tpl** file from the directory: ***main folder/themes/your template name/header.tpl***\
   \
   You need to insert the #jedidesk widget code in it before the closing <mark style="color:red;">**\<head>**</mark> tag and save the changes.


# How to embed a #jedidesk widget in PrestaShop

PrestaShop is open source software designed to quickly create an online store. With this application, the user can set up their store both on cloud storage and on their own hosting.

1. **​**[**Create a #jedidesk widget**](https://docs.jedidesk.com/v/english/widget/how-to-create-a-jedidesk-widget) and copy the generated code.
2. Log in to [**PrestaShop**](https://prestashop.com/).

***

#### **Option #1. EMBED CODE VIA FTP:**

1. Go to the hosting of your site, or connect to the hosting via an FTP client and go to the directory: ***main\_folder/themes/name of your template/footer.tpl***&#x20;

<figure><img src="https://docs.jedidesk.com/~gitbook/image?url=https%3A%2F%2F4292724302-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FXkehX3Ue2D5LVuBJjMnb%252Fuploads%252FcgDGlxWOymXK7fBbtzME%252FFTP_01.png%3Falt%3Dmedia%26token%3Dbbbe6eb9-b397-4503-a500-535b4bca1fa1&#x26;width=768&#x26;dpr=4&#x26;quality=100&#x26;sign=04974ee7c522b5f9b8a7e1484bf1d270063c85cd8ac4097add0b230f0a15172e" alt=""><figcaption></figcaption></figure>

2. Open the **footer.tpl** file in editor mode and insert the JediDesk widget code before the closing <mark style="color:red;">**\<body>**</mark> tag and save the changes:

<figure><img src="https://docs.jedidesk.com/~gitbook/image?url=https%3A%2F%2F4292724302-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FXkehX3Ue2D5LVuBJjMnb%252Fuploads%252Fz5qIoGZWWjpURzr0SeR7%252FFTP_02.png%3Falt%3Dmedia%26token%3Da0987308-709b-4c00-b2c3-737ba3a84bbe&#x26;width=768&#x26;dpr=4&#x26;quality=100&#x26;sign=144cde5f08708fd8ff0d30af5931844c83c0d353494343273bf81aed51b6e489" alt=""><figcaption></figcaption></figure>

3. &#x20;In some templates, the **footer.tpl** file is not connected to each page, then it is appropriate to use the **header.tpl** file from the directory: ***main folder/themes/your template name/header.tpl***&#x20;

   \
   You need to insert the #jedidesk widget code in it before the closing <mark style="color:red;">**\<head>**</mark> tag and save the changes.

***

#### **Option #2. EMBED CODE VIA THE CONTENTBOX MODULE (OR OTHER HTML MODULE)**

1. Download the contentBox module from the site [http://contentbox.org](http://contentbox.org/):&#x20;

<figure><img src="https://docs.jedidesk.com/~gitbook/image?url=https%3A%2F%2F4292724302-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FXkehX3Ue2D5LVuBJjMnb%252Fuploads%252FZexMIm8kxshjMY4wfPQE%252FPRESTASHOP_01.png%3Falt%3Dmedia%26token%3Dd084618c-2659-445e-911e-3e2b5b122d03&#x26;width=768&#x26;dpr=1&#x26;quality=100&#x26;sign=78a94c2c1f263829add16d64644c50e0fe9fdd9af9ec8cbc152cf0baac2a96e5" alt=""><figcaption></figcaption></figure>

2. Go to the PrestaShop control panel, in the **Module Manager** section, download the **ContentBox module**:

<figure><img src="https://docs.jedidesk.com/~gitbook/image?url=https%3A%2F%2F4292724302-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FXkehX3Ue2D5LVuBJjMnb%252Fuploads%252Ffe1JeAcRsWqs3guX1ecM%252FPRESTASHOP_02.png%3Falt%3Dmedia%26token%3D93d1e9e3-01f4-499e-afdb-bc3c97a684e2&#x26;width=768&#x26;dpr=1&#x26;quality=100&#x26;sign=61759e1d25bdf95810c7eb423e9fc02913712afc697b3011ed1d2236d15ac938" alt=""><figcaption></figcaption></figure>

3. After successfully downloading the module, click **Configure**:

<figure><img src="https://docs.jedidesk.com/~gitbook/image?url=https%3A%2F%2F4292724302-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FXkehX3Ue2D5LVuBJjMnb%252Fuploads%252Ft7Dz2PnWswtxuVHS1Wqy%252FPRESTASHOP_03.png%3Falt%3Dmedia%26token%3D5b92c69b-903d-4899-b9e6-fae6d7f6858a&#x26;width=768&#x26;dpr=1&#x26;quality=100&#x26;sign=731be3aa10a22fe4e5dd25f5132205b5635a6603192c12fac089899cb5e55a06" alt=""><figcaption></figcaption></figure>

4. In the window, select the **HTML editor → Edit HTML source** (next to the font) and paste the code of your #jedidesk widget.

Save changes by clicking **Update (Save)***.*

{% hint style="info" %}
If the window did not open automatically, it can be called by clicking on the Configure button in the list of modules, in the СontentBox module.
{% endhint %}


# How to embed a #jedidesk widget in Recommence

Recommence is a cloud service that allows you to create a high-quality online store and easily manage it using an intuitive control panel.

1. **​**[**Create a #jedidesk widget**](https://docs.jedidesk.com/v/english/widget/how-to-create-a-jedidesk-widget) and copy the generated code.
2. Log in to [**Recommence**](https://recommerce.com.ua/).
3. Select the **Settings&#x20;**<mark style="color:red;">**(1)**</mark>**&#x20;→ Connection of external services → Arbitrary JavaScript and Html code** <mark style="color:red;">**(2)**</mark> tab, Click the **Add code** button, fill in the block <mark style="color:red;">**(3)**</mark>:

* **Service name**: JediDesk
* **Code location**: Under all pages
* **JavaScript or Html code**: Paste the code of your JediDesk widget

<figure><img src="https://docs.jedidesk.com/~gitbook/image?url=https%3A%2F%2F4292724302-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FXkehX3Ue2D5LVuBJjMnb%252Fuploads%252F1yz71oDvm14DfNsKjbWc%252FRECOMMERCE_01.png%3Falt%3Dmedia%26token%3D590537d4-672f-4366-b675-b602b11ccc21&#x26;width=768&#x26;dpr=1&#x26;quality=100&#x26;sign=92b94a73c8e6f344cdcf93f0163edc3836ad27b5ae92dcc753839ae40d358dfd" alt=""><figcaption></figcaption></figure>

Click the **Save settings&#x20;**<mark style="color:red;">**(4)**</mark> button.


# How to embed a #jedidesk widget in SitePro

SitePro is a convenient website builder for creating websites without programming, offering many templates and tools for customizing design and functionality.

1. **​**[**Create a #jedidesk widget**](https://docs.jedidesk.com/v/english/widget/how-to-create-a-jedidesk-widget) and copy the generated code.
2. Log in to [**SitePro**](https://site.pro/).
3. Insert a #jedidesk widget using one of two options:

#### **Option 1:**

1. **Adding HTML code:**

* Drag and drop **Advanced** from main toolbar;
* Choose **Custom HTML** composition;
* Select **HTML code ✏️** icon in right toolbar and insert code;
* Click **Apply** button;
* Click **Preview** button to see your changes;

2. **Customising HTML code:**

* **Size:**\
  Adjust HTML code size or **Allow to adjust size automatically** in right toolbar.

***

#### Option 2:

**Adding custom script:**

1. Go to **Settings** (on the top of the website builder);
2. Go to **Pages** menu items and switch to **Scripts** tab;
3. Insert your code into one of 3 available fields:

* **Before \</head>** — inserts code in the ending of page/website section \<head>
* **After \<body>** — inserts code in the beginning of page/website section \<body>
* **Before \</body>** — inserts code in the ending of page/website section \<body>

4. The script can be added either for whole website (all pages) or for exact page;
5. Click **Apply** button.


# How to embed a #jedidesk widget in Strikingly

Strikingly is a simple site builder that allows you to quickly create one-page sites with a user-friendly interface and ready-made templates without programming skills.

1. **​**[**Create a #jedidesk widget**](https://docs.jedidesk.com/v/english/widget/how-to-create-a-jedidesk-widget) and copy the generated code.
2. Log in to [**Strikingly**](https://www.strikingly.com/).
3. On your site editor, click **Add new section -> Advanced -> Embed & HTML**:

<figure><img src="https://docs.jedidesk.com/~gitbook/image?url=https%3A%2F%2F4292724302-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FXkehX3Ue2D5LVuBJjMnb%252Fuploads%252F9St808mpreqz6fmES3mZ%252FStrikingly_0.png%3Falt%3Dmedia%26token%3Dbc57117a-c86a-4891-b58b-42fc49c3b268&#x26;width=768&#x26;dpr=1&#x26;quality=100&#x26;sign=42203a8a901b6299d24515e82be790c64f3f04f1d635921f4e445856a1fc4f15" alt=""><figcaption></figcaption></figure>

4. Click on the newly added section and choose **HTML**:&#x20;

<figure><img src="https://docs.jedidesk.com/~gitbook/image?url=https%3A%2F%2F4292724302-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FXkehX3Ue2D5LVuBJjMnb%252Fuploads%252FfnSelAv30SX4DdfZe4Eq%252FStrikingly_1.png%3Falt%3Dmedia%26token%3Dd4698265-cf75-424a-a8a7-e63c33ed6462&#x26;width=768&#x26;dpr=1&#x26;quality=100&#x26;sign=f05c7ee9886a7fc31d47f4bc44d248fe2c5ffed8321e33d73967db869940bc03" alt=""><figcaption></figcaption></figure>

5. Add the widget code to the dedicated field and click **Save**:&#x20;

<figure><img src="https://docs.jedidesk.com/~gitbook/image?url=https%3A%2F%2F4292724302-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FXkehX3Ue2D5LVuBJjMnb%252Fuploads%252Fr19wZfJL7q7lpNBJ5btp%252FStrikingly_2.png%3Falt%3Dmedia%26token%3D5cd35ce9-69fa-4b22-9d69-dfac5f174469&#x26;width=768&#x26;dpr=1&#x26;quality=100&#x26;sign=fd076e9bf3e0e778e7e7d5d5beadc60a61e2181fd36f0e4698b7708ed4cc3b45" alt=""><figcaption></figcaption></figure>

6. Publish your site.

After embedding the widget, you can see the result by checking the preview or visiting your live site. Keep in mind that custom code won't be visible in the site editor.


# How to embed a #jedidesk widget in WebFlow

Webflow is a powerful website builder that provides visual web design capabilities and flexible code management, allowing you to create professional websites without coding.

1. **​**[**Create a #jedidesk widget**](https://docs.jedidesk.com/v/english/widget/how-to-create-a-jedidesk-widget) and copy the generated code.
2. Log in to [**WebFlow**](https://webflow.com/).
3. Open the **➕ Add Elements** panel and add the **Code Embed** to the Webflow canvas:

<figure><img src="https://docs.jedidesk.com/~gitbook/image?url=https%3A%2F%2F4292724302-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FXkehX3Ue2D5LVuBJjMnb%252Fuploads%252FDhbNfvBaynUcKEY4TEFj%252FWebFlow_1.png%3Falt%3Dmedia%26token%3D3a24a744-bd21-4c40-88fd-3655716cb0f1&#x26;width=768&#x26;dpr=1&#x26;quality=100&#x26;sign=ac22f647c85dcde768cdccf413465492c392239d75276327c9ceb709bc6c6cec" alt=""><figcaption></figcaption></figure>

1. Paste the copied #jedidesk widget code, click **Save** and close the modal window:

<figure><img src="https://docs.jedidesk.com/~gitbook/image?url=https%3A%2F%2F4292724302-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FXkehX3Ue2D5LVuBJjMnb%252Fuploads%252F3qYPMkPoNudv0CRBj5lP%252FWebFlow_2.png%3Falt%3Dmedia%26token%3Ddd21a14a-d80c-437c-9ac1-95f68fa16c13&#x26;width=768&#x26;dpr=1&#x26;quality=100&#x26;sign=567448dfedf70fad67b76cb652c00cb50bfd22526e3a642ed20bf460be4278a3" alt=""><figcaption></figcaption></figure>


# How to embed a #jedidesk widget in Weblium

Weblium is a smart website builder that offers dynamic editing, mobile responsive website templates and a platform that is very easy for beginners

1. [**Create a #jedidesk widget**](/english/widget/how-to-create-a-jedidesk-widget) and copy the generated code.
2. Log in to [**Weblium**](https://ua.weblium.com/).
3. Open the **Site settings** –> **Integrations** tab:

<figure><img src="/files/xGK4bo4Ba3i4vrRjOCHd" alt=""><figcaption><p>How to embed a #jedidesk widget in Weblium</p></figcaption></figure>

4. Open the **Custom code** tab, paste the #jedidesk widget code into the **Before \</BODY>** section and click <mark style="background-color:blue;">**Save**</mark>:

<figure><img src="/files/drw5FhvRZJCaB27Lic3i" alt=""><figcaption><p>How to embed a #jedidesk widget in Weblium</p></figcaption></figure>




---

[Next Page](/llms-full.txt/1)