AnimeTicket / Dokumentacja

Centrum pomocy AnimeTicket

Kompletna dokumentacja dla właściciela serwera i zespołu obsługi. Skonfiguruj system ticketów Discord, formularze, uprawnienia, transcripty i raporty — bez informacji technicznych o hostowaniu bota.

01Szybki startPierwszy panel i typ ticketu02Panele ticketoweWebhook, wygląd i publikacja03Obsługa zgłoszeńPrzejęcia, przypisania i zamknięcia04Transcripty onlineHistoria, obrazy i dostęp05Statystyki i SLARaporty jakości obsługi06AutomatyzacjeReguły, API i webhooki

1. Pierwsza konfiguracja serwera

Po dodaniu AnimeTicket otwórz panel zarządzania, zaloguj się przez Discord i wybierz serwer z listy u góry. Przy pierwszym wejściu kreator może utworzyć podstawową rolę supportu, kategorię ticketów, kanały logów i transcriptów oraz pierwszy panel.

  1. Wybierz język komunikatów bota: polski lub angielski.
  2. Nazwij rolę obsługi i kategorię prywatnych kanałów.
  3. Sprawdź utworzone zasoby i przejdź do sekcji „Typy i formularze”.
  4. Uzupełnij pytania formularza, następnie opublikuj panel na wybranym kanale.
Kreator nie usuwa istniejących kanałów ani ról. Każdy element możesz później zmienić w panelu.

2. Ustawienia systemu ticketów

Rola obsługi

Wybierz rolę, która ma widzieć nowe tickety. Dodatkowe, precyzyjne uprawnienia skonfigurujesz w module „Dostęp i role”.

Kategoria i kanały

  • Kategoria nowych ticketów — miejsce tworzenia prywatnych kanałów.
  • Kanał logów — powiadomienia o otwarciu, przejęciu i zamknięciu.
  • Kanał transcriptów — archiwizacja odnośników do rozmów.

Limity

Limit otwartych ticketów chroni serwer przed spamem. Typ ticketu może mieć własny limit, cooldown, SLA odpowiedzi, SLA rozwiązania oraz automatyczne zamknięcie.

3. Typy ticketów i formularze

Typ określa temat zgłoszenia, routing i pytania zadawane użytkownikowi. Możesz przygotować osobne typy dla pomocy, zakupów, reklamacji, rekrutacji lub zgłoszeń administracyjnych.

Pola typu

  • nazwa, emoji i krótki opis;
  • osobna kategoria, rola obsługi, logi i transcripty;
  • szablon nazwy kanału i wiadomość powitalna;
  • maksymalna liczba otwartych ticketów i czas cooldown;
  • priorytety SLA oraz automatyczne zamykanie.

Dynamiczny formularz

Dodaj pytania krótkie lub wielowierszowe. Dla każdego ustaw etykietę, placeholder, wymaganie oraz minimalną i maksymalną długość. Odpowiedzi pojawią się w szczegółach ticketu.

Pytaj tylko o dane konieczne do rozwiązania sprawy. Nie zbieraj haseł, tokenów, danych kart ani innych informacji wrażliwych.

4. Tworzenie panelu ticketów

  1. Kliknij „Nowy panel” i wybierz kanał publikacji.
  2. Ustaw nazwę webhooka, tytuł, opis, kolor, stopkę, obraz i miniaturę.
  3. Wybierz tryb listy lub przycisków i dodaj typy w odpowiedniej kolejności.
  4. Zapisz panel, a potem użyj „Opublikuj / aktualizuj”.

Podgląd po prawej pokazuje wygląd wiadomości na Discordzie. Jeden serwer może mieć wiele paneli, np. osobny dla supportu, administracji i rekrutacji.

Aktualizacja panelu

Po zmianie wyglądu lub typów zapisz formularz i ponownie opublikuj. AnimeTicket zaktualizuje istniejącą wiadomość, jeśli nadal jest dostępna.

5. Codzienna obsługa ticketów

Przejęcie i przypisanie

Przycisk „Przejmij” przypisuje zalogowanego pracownika. Administrator może wskazać innego uprawnionego opiekuna. Autor ticketu otrzymuje wiadomość prywatną.

Priorytety i notatki

Ustaw priorytet niski, normalny, wysoki lub krytyczny. Notatki wewnętrzne są widoczne wyłącznie dla uprawnionego zespołu.

Zamykanie

Przy zamknięciu podaj czytelny powód. Bot zapisze rozmowę, przygotuje transcript, wyśle powiadomienie DM i usunie kanał po zakończeniu procedury. Zamknięty ticket można ponownie otworzyć, jeśli uprawnienia na to pozwalają.

Uczestnicy i tagi

Dodawaj uczestników do prywatnego kanału oraz tagi ułatwiające filtrowanie. Nie udostępniaj ticketu osobom, które nie powinny widzieć jego treści.

6. Role i uprawnienia

AnimeTicket rozdziela dostęp do konfiguracji, ticketów, statystyk, transcriptów, paneli i integracji. Administrator serwera ma pełny dostęp, a role delegowane mogą otrzymać tylko potrzebne moduły.

  • tickets.view — lista i szczegóły ticketów;
  • tickets.claim — przejmowanie i przypisywanie;
  • tickets.close — zamykanie i reopen;
  • config.edit — ustawienia serwera;
  • panels.manage — projektowanie paneli;
  • statistics.view — analityka i raporty;
  • transcripts.view — odczyt archiwów;
  • access.manage — zarządzanie rolami dostępu.
Stosuj zasadę minimalnych uprawnień: każda osoba powinna widzieć tylko to, czego potrzebuje.

7. Transcripty online

Transcript jest bezpieczną stroną z historią wiadomości, formularzem, datami, autorami oraz załącznikami. Zdjęcia można oglądać bez pobierania dokumentu.

Kto ma dostęp?

Autor ticketu oraz pracownicy posiadający odpowiednie uprawnienie. Link nie daje automatycznie dostępu przypadkowej osobie — wymagane jest zalogowanie przez Discord i sprawdzenie uprawnień.

Załączniki

Archiwizowane pliki są powiązane z konkretnym ticketem. Nie publikuj linku do transcriptu w publicznych kanałach.

8. Statystyki, SLA i raporty

Raporty pokazują liczbę zgłoszeń, medianę odpowiedzi i rozwiązania, realizację SLA, oceny, obciążenie typów oraz ranking obsługi. Zakres możesz ustawić na 7, 30, 90, 365 dni lub własne daty.

  • Filtruj po typie, priorytecie i opiekunie.
  • Porównuj okres z poprzednim zakresem.
  • Eksportuj dane CSV do dalszej analizy.
  • Ustaw raport cykliczny wysyłany na kanał Discord.

Statystyki wspierają ocenę procesu, ale nie powinny być jedynym kryterium oceny pracowników.

9. Automatyzacje i integracje

Reguły automatyzacji reagują m.in. na utworzenie, przejęcie, brak aktywności, naruszenie SLA i zamknięcie ticketu. Każda reguła ma wyzwalacz, warunki i listę akcji.

Webhooki wychodzące

Webhook może przekazać zdarzenie do zewnętrznego systemu. Używaj wyłącznie adresów HTTPS i przechowuj sekret poza publicznymi kanałami.

REST API

Klucze API mają zakresy i opcjonalną datę ważności. Po utworzeniu skopiuj klucz od razu — później nie będzie ponownie pokazany. Usuń każdy nieużywany lub ujawniony klucz.

10. Portal użytkownika

Po zalogowaniu użytkownik widzi własne tickety ze wszystkich serwerów korzystających z AnimeTicket. Może otworzyć transcript, sprawdzić odpowiedzi formularza, wystawić ocenę i wysłać wniosek o ponowne otwarcie.

Zespół zatwierdza lub odrzuca wnioski wraz z uzasadnieniem, które użytkownik otrzyma w wiadomości prywatnej.

11. Rozwiązywanie problemów

Bot nie tworzy kanału

Sprawdź, czy ma zarządzanie kanałami i czy wybrana kategoria nadal istnieje. Upewnij się, że system oraz typ ticketu są aktywne.

Panel nie aktualizuje się

Zapisz zmiany przed publikacją. Bot musi mieć uprawnienie zarządzania webhookami na kanale panelu.

Pracownik nie widzi ticketu

Sprawdź rolę obsługi wybraną dla typu oraz delegowane uprawnienia w module „Dostęp i role”. Typ może nadpisywać ustawienie globalne.

Brak DM

Użytkownik może mieć wyłączone wiadomości prywatne z członkami serwera. Operacja nadal zostanie wykonana i pojawi się w audycie.

Nie widać transcriptu

Zaloguj się właściwym kontem Discord. Dostęp ma autor ticketu albo osoba z uprawnieniem do transcriptów na danym serwerze.