Dokumentacja | Dokumentacja API

Przegląd

Moduł pomocy technicznej zapewnia system zgłoszeń do raportowania problemów, żądania nowych funkcji i uzyskiwania pomocy od zespołu wsparcia. Każde zgłoszenie przechowuje pełną historię rozmów z komentarzami, załączonymi plikami i zmianami statusu.

Zgłoszenia wsparcia

Twórz zgłoszenia z tematem i szczegółowym opisem. Każde zgłoszenie otrzymuje unikalny numer do łatwego śledzenia.

Komentarze i dyskusja

Dodawaj komentarze do zgłoszeń, aby podać dodatkowe informacje lub zadać pytania uzupełniające. Pełna historia rozmów jest zachowana.

Załączniki

Dołączaj pliki do zgłoszeń i komentarzy. Obsługuje przeciąganie i upuszczanie, wybór plików oraz wklejanie ze schowka (Ctrl+V) dla zrzutów ekranu.

Śledzenie statusu

Śledź postęp zgłoszenia poprzez zdefiniowane statusy od utworzenia do rozwiązania. Przejrzysta widoczność tego, co wymaga uwagi.

Powiadomienia

Otrzymuj powiadomienia e-mail i Telegram, gdy zgłoszenia są aktualizowane, komentowane lub zmieniają status.

Prywatność

Zgłoszenia są prywatne między użytkownikiem a zespołem wsparcia. Inni użytkownicy nie mogą zobaczyć Twoich zgłoszeń.

Tworzenie zgłoszenia

Aby utworzyć nowe zgłoszenie wsparcia, wykonaj następujące kroki:

1

Otwórz stronę wsparcia

Przejdź do sekcji pomocy technicznej z menu głównego lub menu użytkownika.

2

Wypełnij szczegóły

Wprowadź jasny temat i szczegółowy opis problemu lub prośby. Im więcej szczegółów podasz, tym szybciej będziemy mogli pomóc.

3

Dołącz pliki (opcjonalnie)

Dołącz zrzuty ekranu, dokumenty lub inne pliki. Możesz przeciągnąć i upuścić pliki, użyć selektora plików lub wkleić obrazy ze schowka za pomocą Ctrl+V.

4

Wyślij zgłoszenie

Kliknij przycisk wyślij. Twoje zgłoszenie zostanie utworzone ze statusem „Otwarte" i zespół wsparcia zostanie powiadomiony.

Statusy zgłoszeń

Każde zgłoszenie przechodzi przez zdefiniowany cykl życia statusów:

Otwarty

Zgłoszenie zostało utworzone i oczekuje na przegląd przez zespół wsparcia.

W trakcie

Zespół wsparcia aktywnie pracuje nad problemem.

Oczekuje na użytkownika

Zespół wsparcia potrzebuje dodatkowych informacji od Ciebie. Sprawdź ostatni komentarz i odpowiedz.

Oczekuje na administratora

Podałeś wymagane informacje i zgłoszenie oczekuje na kontynuację przez zespół wsparcia.

Rozwiązany

Problem został rozwiązany. Możesz ponownie otworzyć zgłoszenie, dodając nowy komentarz, jeśli problem nadal występuje.

Zamknięty

Zgłoszenie jest zamknięte i nie wymaga dalszych działań. Zamknięte zgłoszenia są przechowywane w celach informacyjnych.

Przepływ statusów:

Open → In Progress → Waiting for User / Waiting for Admin → Resolved → Closed

Dodawanie komentarzy i plików

Możesz dodawać komentarze i dołączać pliki do każdego otwartego zgłoszenia, aby podać więcej informacji lub odpowiedzieć zespołowi wsparcia.

Dodawanie komentarzy

Wpisz wiadomość w polu komentarza na dole strony zgłoszenia i kliknij „Wyślij". Twój komentarz będzie widoczny dla Ciebie i zespołu wsparcia.

Dołączanie plików

Istnieje kilka sposobów dołączania plików do zgłoszenia lub komentarza:

Wklej ze schowka

Zrób zrzut ekranu lub skopiuj obraz, a następnie naciśnij Ctrl+V (Cmd+V na Mac), aby wkleić go bezpośrednio do zgłoszenia. Idealny do szybkiego udostępniania zrzutów ekranu z błędami.

Przeciągnij i upuść

Przeciągnij pliki z menedżera plików bezpośrednio do obszaru przesyłania plików w formularzu zgłoszenia.

Selektor plików

Kliknij przycisk załącznika, aby otworzyć okno wyboru plików i wybrać pliki z urządzenia.

Limity plików:

Maksymalny rozmiar pliku: 10 MB na plik
Obsługiwane formaty: obrazy (JPG, PNG, GIF, WebP), dokumenty (PDF, DOC, DOCX, XLS, XLSX), archiwa (ZIP, RAR)

Integracja z API

Dostęp do systemu zgłoszeń przez REST API (wymagane uwierzytelnianie JWT):

GET    /api/v1/tickets                        - Lista Twoich zgłoszeń
POST   /api/v1/tickets                        - Utwórz nowe zgłoszenie
GET    /api/v1/tickets/{id}                   - Pobierz szczegóły zgłoszenia
PUT    /api/v1/tickets/{id}                   - Zaktualizuj zgłoszenie
POST   /api/v1/tickets/{id}/comments          - Dodaj komentarz
GET    /api/v1/tickets/{id}/comments          - Lista komentarzy zgłoszenia
PUT    /api/v1/tickets/{id}/status            - Zmień status zgłoszenia

Przykład tworzenia zgłoszenia

Utwórz nowe zgłoszenie z załączonymi plikami za pomocą multipart/form-data:

POST /api/v1/tickets
Content-Type: multipart/form-data

subject: Login page returns 500 error
description: When I try to log in with my Google account, the page shows a 500 error...
files[]: screenshot.png
files[]: error_log.txt

Przykładowa odpowiedź

{
  "id": 42,
  "subject": "Login page returns 500 error",
  "description": "When I try to log in with my Google account...",
  "status": "open",
  "createdAt": "2026-03-29T10:15:00+00:00",
  "updatedAt": "2026-03-29T10:15:00+00:00",
  "user": {
    "id": 8,
    "name": "John Doe",
    "email": "[email protected]"
  },
  "commentsCount": 0,
  "filesCount": 2,
  "files": [
    {
      "id": 1,
      "originalName": "screenshot.png",
      "mimeType": "image/png",
      "fileSize": 204800,
      "fileSizeFormatted": "200 KB",
      "url": "https://s3.example.com/tickets/42/abc123.png",
      "createdAt": "2026-03-29T10:15:00+00:00"
    },
    {
      "id": 2,
      "originalName": "error_log.txt",
      "mimeType": "text/plain",
      "fileSize": 1024,
      "fileSizeFormatted": "1 KB",
      "url": "https://s3.example.com/tickets/42/def456.txt",
      "createdAt": "2026-03-29T10:15:00+00:00"
    }
  ]
}

Swagger / OpenAPI

Pełna dokumentacja API z interaktywnym testowaniem jest dostępna w Swagger UI: /api/v1/doc

Pomoc techniczna