Віджет для клієнтів
Віджет підтримки (Support Widget) це компонент JavaScript, який ви вбудовуєте на свій вебсайт. Він дозволяє клієнтам надсилати звернення та відстежувати їхній статус, не залишаючи вашого застосунку.
Як це працює
- Ви створюєте деск у модулі Служби підтримки
- Копіюєте код віджета з налаштувань деска
- Вставляєте його на свій вебсайт
- Клієнти можуть надсилати звернення безпосередньо з вашого сайту
Вбудовування віджета на сайт
Щоб додати віджет на свій сайт, вставте наведений нижче код перед закриттям </body>:
<div id="intum-helpdesk-widget"></div>
<script>
var IntumHelpdeskWidget = {
account_url: "https://twojekonto.intum.pl",
desk_token: "TOKEN_DESKU",
locale: "pl"
};
</script>
<script src="WIDGET_URL"></script>
account_url та desk_token ви знайдете в налаштуваннях деска, на вкладці Віджет.
Дані клієнта
Якщо ваш застосунок знає дані користувача, який увійшов, передайте їх у конфігурації - віджет автоматично заповнить форму та прив’яже звернення до клієнта:
<script>
var IntumHelpdeskWidget = {
account_url: "https://twojekonto.intum.pl",
desk_token: "TOKEN_DESKU",
locale: "pl",
client_external_id: "CRM-123",
client_email: "[email protected]",
client_name: "Jan Kowalski",
client_url: "https://klient.fakturownia.pl",
client_plan: "Premium",
user_external_id: "USR-456",
user_email: "[email protected]",
user_name: "Користувач",
user_phone: "+48123456789",
signature: "HMAC_SIGNATURE"
};
</script>
Поле client_external_id є ключовим - без нього клієнт не побачить список своїх попередніх звернень.
Параметри URL
Віджет реагує на параметри в адресі сторінки. Завдяки цьому ви можете створювати посилання, які одразу відкривають віджет із заповненою формою або конкретним зверненням.
Відкриття конкретного звернення
Параметр n відкриває звернення із зазначеним номером:
https://twoja-strona.pl/pomoc?n=2616-2
Віджет завантажиться і одразу покаже деталі звернення #2616-2 (якщо воно належить цьому клієнту). Корисно, наприклад, у сповіщеннях електронною поштою - посилання веде прямо до звернення.
Попереднє заповнення форми
Параметри title, content, priority та c дозволяють відкрити віджет із готовою формою нового звернення:
| Параметр | Опис |
|---|---|
title |
Заголовок звернення |
content |
Текст звернення |
priority |
Пріоритет: low, normal, high, urgent
|
c |
Код категорії - встановлює категорію звернення |
Якщо вказано будь-який із цих параметрів, віджет одразу відкриває форму нового звернення (замість списку).
Приклад - посилання на звернення про помилку із заповненим заголовком і категорією:
https://twoja-strona.pl/pomoc?title=Problem+z+logowaniem&c=bugs&priority=high
Параметри можна поєднувати довільно. Наприклад, сам c=billing відкриє форму зі встановленою категорією розрахунків, а title=Pytanie відкриє форму із заповненим заголовком.
Можливості віджета
- Форма звернення - клієнт вказує заголовок, текст, пріоритет та опціонально категорію
- Список звернень - клієнт бачить свої попередні звернення та їхні статуси
- Деталі звернення - клієнт може переглядати відповіді команди
- Коментарі - клієнт може відповідати на звернення
- Вкладення - можливість додавати файли (до 10 МБ)
Ідентифікація клієнта
Віджет може автоматично ідентифікувати клієнта на основі даних, переданих у коді вбудовування:
- E-mail та ім’я - попереднє заповнення форми
- ID клієнта - зв’язок із клієнтом у CRM
- План - інформація про пакет клієнта
Якщо дані клієнта не передано, віджет відобразить форму ідентифікації.
Безпека
Віджет підтримує перевірку HMAC-SHA256 - коли деск має ввімкнений рівень безпеки “signature”, кожен запит повинен містити правильний підпис, обчислений із секретного ключа деска. Це запобігає видаванню себе за клієнтів.
Керування видимістю віджета
У налаштуваннях деска (вкладка Віджет) ви можете контролювати, на яких сторінках відображається віджет. Завдяки цьому вам не потрібно змінювати код на сайті - усе налаштовується з панелі Intum.
Правила показу (URL Show Rules)
Список шаблонів URL, на яких віджет має відображатися. Якщо вказано - віджет з’явиться лише на сторінках, що відповідають шаблонам. Кожен шаблон в окремому рядку.
Приклад:
https://example.com/dashboard*
*/app/*
Віджет відобразиться лише на сторінках, що починаються з /dashboard або містять /app/ у шляху.
Правила приховування (URL Hide Rules)
Список шаблонів URL, на яких віджет не відображатиметься. Кожен шаблон в окремому рядку.
Приклад:
*/admin/*
*/settings*
*/login
Віджет буде прихований на адміністративних сторінках, у налаштуваннях та на сторінці входу.
Як працюють шаблони
-
*замінює будь-який набір символів - Шаблони зіставляються з повним URL сторінки
- Правила приховування мають пріоритет над правилами показу
- Якщо ви не вкажете жодних правил, віджет відображається на всіх сторінках
Персоналізація
- Колір - налаштуйте колір віджета під свій бренд (встановлюється у десці)
- Текст довідки - додайте інформаційний текст, що відображається над формою
- Категорії - клієнт може вибрати категорію звернення (кожна може мати власний текст довідки)
- Мова - віджет підтримує: польську, англійську, українську, німецьку, французьку, іспанську, чеську, словацьку
Публічне посилання на звернення
Кожне звернення має унікальний токен і публічний URL - його можна надіслати клієнту електронною поштою. Через нього клієнт може переглядати звернення та додавати коментарі без входу в систему.