# Онлайн чат та віджет на сайті

## Створення/Редагування каналу Веб-сайт <a href="#create-edit-a-website-channel" id="create-edit-a-website-channel"></a>

Для підключення онлайн-чату та віджету в NovaTalks при створенні нового Каналу необхідно обрати тип каналу - **Веб-сайт**.

<figure><img src="https://2328171809-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fth75wDp9OEz0ABIMvgWP%2Fuploads%2FjiQBX0m9J2uthyE0cj5t%2Fimage.png?alt=media&#x26;token=84caf63b-3e6d-479c-bd19-43a866816138" alt=""><figcaption></figcaption></figure>

### Основні налаштування <a href="#main-settings" id="main-settings"></a>

**Основні налаштування** відображають Назву каналу, Канали, що будуть підключенні до віджету,  Чат-бот та налаштування вигляду віджету.

<figure><img src="https://2328171809-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fth75wDp9OEz0ABIMvgWP%2Fuploads%2FBiY3KRWsmpjkS31YyxHv%2Fimage.png?alt=media&#x26;token=94ab6970-ebeb-415d-8084-c5aaae2ebb53" alt=""><figcaption></figcaption></figure>

1. **Додати  канал -** створення каналів, що будуть додані до Вашого віджету.&#x20;

При додаванні каналу необхідно заповнити поля: Ім'я, URL, Підказка, Тип каналу та встановити галочку біля Увімкнути канал.

<figure><img src="https://2328171809-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fth75wDp9OEz0ABIMvgWP%2Fuploads%2FT8GTLBFgCIYzJj0tBLqv%2Fimage.png?alt=media&#x26;token=e54dcae5-0228-4167-9def-4bf06525c4ce" alt=""><figcaption></figcaption></figure>

2. **Назва каналу**
3. **Чат-бот** - чат-бот, який буде підключено до каналу. Налаштовується в розділі [Чат-боти](https://help.novatalks.com.ua/ua/get-started/settings/chatbots).&#x20;
4. **Колір віджету**
5. **Заголовок привітання -** привітальне повідомлення, що відображається у заголовку віджету.
6. **URL-адреса зображення -** URL зображення, що буде відображається замість стандартної іконки віджету.
7. **Показати значок закриття віджету**
8. **Отримання налаштувань з сервера** - це опція, яка визначає, чи необхідно зберігати на сервері налаштування віджету.&#x20;

{% hint style="success" %}
**Якщо опція ввімкнена**, то налаштування будуть оновлюватись автоматично через запит до серверу NovaTalks.&#x20;

**Якщо виключена** -  налаштування зберігаються локально в html сторінці замовника. При кожній зміні в налаштуваннях віджету, необхідно копіювати код з конфігурацією та вносити зміни в html сторінці.
{% endhint %}

9. **Відстеження мови** - це опція, яка визначає, чи необхідно зберігати в атрибутах контакту Мову спілкування клієнта, який звернувся через онлайн чат.
10. **Відстеження URL** -  це опція, яка визначає, чи необхідно зберігати в атрибутах контакту URL початку розмови в онлайн чаті.
11. **Відстеження UTM** - це опція, яка визначає, чи необхідно зберігати в атрибутах контакту **UTM**  мітки, які містяться в URL початку розмови в онлайн чаті  (Детальніше - [Системні кастомні атрибути Контакту](https://help.novatalks.com.ua/ua/get-started/custom-attributes#contact-system-custom-attributes)). &#x20;

{% hint style="warning" %}
Відстеження URL/UTM не підтримується в каналах Twitter та Line.&#x20;

Відстеження для Instagram працює тільки при відкритті посилання з мобільного пристрою.&#x20;
{% endhint %}

12. **Початкове повідомлення** - текст повідомлення, що буде доданий клієнту у вікно введення повідомлення обранного каналу. Активне тільки для каналів WhatsApp, Номерний Telegram,  Email.&#x20;

<figure><img src="https://2328171809-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fth75wDp9OEz0ABIMvgWP%2Fuploads%2FHzcoOdBJRtbTvRJiGQ5B%2Fimage.png?alt=media&#x26;token=2374814c-4b47-4a7d-8626-773106ddbff1" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Для  WhatsApp, Номерний Telegram та Email для відстеження URL/UTM необхідно отримувати параметр clickId. При виборі клієнтом на віджеті одного з цих каналів початкове повідомлення разом з clickId автоматично додасться вашим клієнтам у вікно введення повідомлення. Ви можете вказати власний текст початкового повідомлення, але обов'язково включіть змінну clickId={{shortUUID}}.&#x20;

Якщо Початкове повідомлення не буде містити змінну clickId={{shortUUID}} або клієнт не відправить повідомлення зі змінною, то відстеження URL/UTM здійснюватись не буде.&#x20;
{% endhint %}

13. **Відстеження OС** - це опція, яка визначає, чи необхідно зберігати в атрибутах контакту Операційна система клієнта, який звернувся через онлайн чат.&#x20;
14. **Відстеження назви браузеру -** це опція, яка визначає, чи необхідно зберігати в атрибутах контакту Назву браузеру клієнта, який звернувся через онлайн чат.&#x20;
15. **Відстеження IP та країни по IP** - це опція, яка визначає, чи необхідно зберігати в атрибутах контакту Країну клієнта, який звернувся через онлайн чат.&#x20;
16. **Мова сайту**
17. **Тип розмови** - це тип каналу, з якого звернувся клієнт. За замовчуванням для каналу Веб-сайт встановлено значення "Чат".
18. **Включити форму збору попередньої інформації** - форма збору попередньої інформації дозволяє отримати інформацію про користувачів, перш ніж вони почнуть розмову. Інформація по всім полям після заповнення клієнтом автоматично записується в картку клієнта.

**Типи полів форми:**

* **Стандартні поля** - це основні поля контакту (адреса електронної пошти, номер телефону та повне ім'я).
* **Кастомні поля** - це поля кастомних атрибутів.

**Налаштування форми:**

* Обирати **Поле обов'язкове чи ні**, перетягуючи повзунок біля кожного поля.
* Обирати **Відображати поле чи ні**, перетягуючи повзунок біля кожного поля.
* Встановлювати різні налаштування форми збору попередньої інформації в залежності **Коли чат-центр онлайн та Коли чат-центр оффлайн.**

<figure><img src="https://2328171809-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fth75wDp9OEz0ABIMvgWP%2Fuploads%2FuXx599MILsFmZ5IYAUB2%2Fimage.png?alt=media&#x26;token=99119e65-9694-43de-b874-b74a6ee54ce6" alt=""><figcaption></figcaption></figure>

19. **Показати ім'я агента**&#x20;
20. **Показати аватар агента**
21. **Позиція** - позиція, де буде відображатись віджет: знизу справа/знизу зліва/по центру зліва/по центру справа.
22. **Відступ** - число в пікселях або %, на яке віджет буде відсунуто від краю вікна браузера.
23. **Пристрої** - встановлюється на яких пристроях буде відображатись віджет: ПК чи/та мобільна версія та у якому вигляді буде відображатись віджет для кожного типу пристрою: розгорнутому чи згорнутому.
24. **Іконки** - встановлюється для кожного типу пристрою положення у якому будуть відображатись іконки месенджерів: горизонтально чи вертикально.
25. **Віджет вбудований в iFrame** - можливість розміщення віджету на сайті як iframe.

***

### Налаштування обробки розмов <a href="#configure-conversation-handling" id="configure-conversation-handling"></a>

<figure><img src="https://2328171809-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fth75wDp9OEz0ABIMvgWP%2Fuploads%2FPpmqZaizUyzB5L57Hq1P%2Fimage.png?alt=media&#x26;token=c9e5c6f0-9558-4f99-b91d-bc601fd88fd7" alt=""><figcaption></figcaption></figure>

1. **Утилізація, %** - показник, який показує на скільки % певний діалог утилізує агента. Можливі значення: 0 – 100.

{% hint style="success" %}
В залежності від значення даного параметру розраховується поточна утилізація агента (сума утилізацій діалогів, призначених на даного агента). При автоматичному розподілі діалогів утилізація агента не повинна перевищувати 100%.

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

2. **Ліміт автопризначення** - максимальна кількість розмов, які агент може одночасно обслуговувати в рамках даного Каналу. Якщо по агенту такий показник досяг встановленого значення, то ACD більше не призначить подібний діалог на такого агента.
3. **Автовідповідь -** чи потрібно автоматично прийняти діалог при призначенні на агента.
4. **Таймаут сповіщення** - час, протягом якого агенту необхідно прийняти або відхилити Розмову. Якщо агент не відреагує протягом заданого часу, то розмова повернеться на початок черги, а агент перейде в статус Зайнятий сабстатус Not responding.

Вибір параметру доступний тільки якщо опція Автовідповідь виключена.

6. **Коди завершення** - коди, які використовуються для класифікації діалогів. Обираються агентом після завершення розмови.
7. **Таймаут Кодів завершення** - час, протягом якого необхідно обрати Код завершення. Якщо агент не відреагує протягом заданого часу, то розмова завершиться і Код завершення не буде встановлено.

***

### Агенти <a href="#agents" id="agents"></a>

Список агентів, які включені в канал.

<figure><img src="https://2328171809-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fth75wDp9OEz0ABIMvgWP%2Fuploads%2F97OfFG4M4dwxxOqCEdsl%2Fimage.png?alt=media&#x26;token=0ee940b2-d06a-4bb7-826c-570e55712c3c" alt=""><figcaption></figcaption></figure>

***

### Перегляд та створення каналу <a href="#review-and-create-inbox" id="review-and-create-inbox"></a>

Крок для перегляду налаштувань нового каналу та підтвердження його створення.

<figure><img src="https://2328171809-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fth75wDp9OEz0ABIMvgWP%2Fuploads%2FUEhvUI3PJKkPYFiTuhge%2Fimage.png?alt=media&#x26;token=62e37d24-bc03-41de-85c0-847a1ad15d79" alt=""><figcaption></figcaption></figure>

***

### Код для встановлення віджету <a href="#code-for-installing-the-widget" id="code-for-installing-the-widget"></a>

Скопіюйте Код каналу та розмістіть на Вашому сайті.

<figure><img src="https://2328171809-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fth75wDp9OEz0ABIMvgWP%2Fuploads%2FwUAUaI5rvWTONO8lvyab%2Fimage.png?alt=media&#x26;token=a13f2d0c-436f-498e-a726-4cee143a1d28" alt=""><figcaption></figcaption></figure>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://help.novatalks.com.ua/ua/get-started/settings/inboxes/website.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.