Support Widget

Widget dla klientów

Support Widget to komponent JavaScript, który osadzasz na swojej stronie internetowej. Pozwala klientom wysyłać zgłoszenia i śledzić ich status bez wychodzenia z Twojej aplikacji.

Jak to działa

1. Tworzysz desk w module Helpdesk
2. Kopiujesz kod widgetu z ustawień desku
3. Wklejasz go na swoją stronę internetową
4. Klienci mogą wysyłać zgłoszenia bezpośrednio z Twojej strony

Osadzenie widgetu na stronie

Aby dodać widget na swoją stronę, wklej poniższy kod przed zamknięciem </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 i desk_token znajdziesz w ustawieniach desku, w zakładce Widget.

Dane klienta

Jeśli Twoja aplikacja zna dane zalogowanego użytkownika, przekaż je w konfiguracji - widget automatycznie wypełni formularz i powiąże zgłoszenie z klientem:

<script>
  var IntumHelpdeskWidget = {
    account_url: "https://twojekonto.intum.pl",
    desk_token: "TOKEN_DESKU",
    locale: "pl",
    client_external_id: "CRM-123",
    client_email: "jan@firma.pl",
    client_name: "Jan Kowalski",
    client_url: "https://klient.fakturownia.pl",
    client_plan: "Premium",
    user_external_id: "USR-456",
    user_email: "user@firma.pl",
    user_name: "Użytkownik",
    user_phone: "+48123456789",
    signature: "HMAC_SIGNATURE"
  };
</script>

Pole client_external_id jest kluczowe - bez niego klient nie zobaczy listy swoich wcześniejszych zgłoszeń.

Parametry URL

Widget reaguje na parametry w adresie strony. Dzięki temu możesz tworzyć linki, które od razu otwierają widget z wypełnionym formularzem lub konkretnym zgłoszeniem.

Otwarcie konkretnego zgłoszenia

Parametr n otwiera zgłoszenie o podanym numerze:

https://twoja-strona.pl/pomoc?n=2616-2

Widget załaduje się i od razu pokaże szczegóły zgłoszenia #2616-2 (jeśli należy do danego klienta). Przydatne np. w powiadomieniach e-mail - link prowadzi prosto do zgłoszenia.

Wstępne wypełnienie formularza

Parametry title, content, priority i c pozwalają otworzyć widget z gotowym formularzem nowego zgłoszenia:

Parametr	Opis
title	Tytuł zgłoszenia
content	Treść zgłoszenia
priority	Priorytet: low, normal, high, urgent
c	Kod kategorii - ustawia kategorię zgłoszenia

Jeśli którykolwiek z tych parametrów jest podany, widget od razu otwiera formularz nowego zgłoszenia (zamiast listy).

Przykład - link do zgłoszenia błędu z wypełnionym tytułem i kategorią:

https://twoja-strona.pl/pomoc?title=Problem+z+logowaniem&c=bugs&priority=high

Parametry można łączyć dowolnie. Np. sam c=billing otworzy formularz z ustawioną kategorią rozliczeń, a title=Pytanie otworzy formularz z wypełnionym tytułem.

Możliwości widgetu

• Formularz zgłoszenia - klient podaje tytuł, treść, priorytet i opcjonalnie kategorię
• Lista zgłoszeń - klient widzi swoje wcześniejsze zgłoszenia i ich statusy
• Szczegóły zgłoszenia - klient może przeglądać odpowiedzi zespołu
• Komentarze - klient może odpowiadać na zgłoszenie
• Załączniki - możliwość dodawania plików (do 10 MB)

Identyfikacja klienta

Widget może automatycznie identyfikować klienta na podstawie danych przekazanych w kodzie osadzenia:

• E-mail i imię - wstępne wypełnienie formularza
• ID klienta - powiązanie z klientem w CRM
• Plan - informacja o pakiecie klienta

Jeśli dane klienta nie są przekazane, widget wyświetli formularz identyfikacji.

Bezpieczeństwo

Widget obsługuje weryfikację HMAC-SHA256 - gdy desk ma włączony poziom bezpieczeństwa “signature”, każde żądanie musi zawierać prawidłowy podpis wyliczony z klucza tajnego desku. Zapobiega to podszywaniu się pod klientów.

Sterowanie widocznością widgetu

W ustawieniach desku (zakładka Widget) możesz kontrolować, na których stronach widget się wyświetla. Dzięki temu nie musisz modyfikować kodu na stronie - wszystko konfigurujesz z poziomu panelu Intum.

Reguły pokazywania (URL Show Rules)

Lista wzorców URL, na których widget ma się wyświetlać. Jeśli podane - widget pojawi się tylko na stronach pasujących do wzorców. Każdy wzorzec w osobnej linii.

Przykład:

https://example.com/dashboard*
*/app/*

Widget wyświetli się tylko na stronach zaczynających się od /dashboard lub zawierających /app/ w ścieżce.

Reguły ukrywania (URL Hide Rules)

Lista wzorców URL, na których widget nie będzie wyświetlany. Każdy wzorzec w osobnej linii.

Przykład:

*/admin/*
*/settings*
*/login

Widget będzie ukryty na stronach administracyjnych, w ustawieniach i na stronie logowania.

Jak działają wzorce

• * zastępuje dowolny ciąg znaków
• Wzorce dopasowywane są do pełnego URL strony
• Reguły ukrywania mają priorytet nad regułami pokazywania
• Jeśli nie podasz żadnych reguł, widget wyświetla się na wszystkich stronach

Personalizacja

• Kolor - dostosuj kolor widgetu do swojej marki (ustawiany w desku)
• Treść pomocy - dodaj tekst informacyjny wyświetlany nad formularzem
• Kategorie - klient może wybrać kategorię zgłoszenia (każda może mieć własny tekst pomocy)
• Język - widget obsługuje: polski, angielski, ukraiński, niemiecki, francuski, hiszpański, czeski, słowacki

Publiczny link do zgłoszenia

Każde zgłoszenie ma unikalny token i publiczny URL - można go wysłać klientowi w e-mailu. Klient może przez niego przeglądać zgłoszenie i dodawać komentarze bez logowania.