[Intum](https://intum.fr/aide.md) / [Helpdesk](https://intum.fr/aide/helpdesk.md)

# [Automatyczne odpowiedzi AI w Widgecie Helpdesk](https://intum.fr/aide/helpdesk/automatyczna-obsluga-uzytkownikow-z-ai.md) | [API](#api)

## Jak działa AI w widgecie

Gdy AI jest [włączone na desku](ai-w-helpdesk), widget helpdesk automatycznie analizuje zgłoszenia klientów przed wysłaniem ich do zespołu wsparcia. Dzięki temu wiele pytań może zostać rozwiązanych natychmiastowo, bez udziału człowieka.

## Przepływ z perspektywy klienta

### 1. Wypełnienie formularza

Klient wypełnia formularz zgłoszenia jak zwykle:
- Tytuł
- Opis problemu
- Priorytet
- Kategoria (jeśli skonfigurowana)
- Załączniki (opcjonalnie)

### 2. Kliknięcie "Zapisz"

Zamiast standardowego przycisku "Wyślij zgłoszenie", klient widzi przycisk **Zapisz**. Po kliknięciu:
- Na przycisku pojawia się animacja i napis **Analiza zgłoszenia...**
- System wysyła treść zgłoszenia do AI
- AI przeszukuje bazę wektorową (RAG) w poszukiwaniu odpowiedzi

### 3. Odpowiedź AI

Jeśli AI znajdzie odpowiedź, wyświetla ją klientowi z pytaniem:

> **Czy ta odpowiedź rozwiązuje Twój problem?**

Klient ma dwie opcje:

- **Tak, dziękuję** — zgłoszenie zostaje automatycznie zapisane ze statusem "Rozwiązane" i oznaczeniem **NoeAI**. Klient wraca do listy swoich zgłoszeń. Odpowiedź AI jest zapisana jako komentarz w tickecie.
- **Nie, chcę wysłać zgłoszenie** — pojawia się przycisk **Wyślij zgłoszenie**, który wysyła ticket normalnie do zespołu wsparcia.

### 4. Brak odpowiedzi AI

Jeśli AI nie znajdzie odpowiedzi w bazie wiedzy, od razu pojawia się przycisk **Wyślij zgłoszenie** — klient nie jest blokowany.

### 5. Timeout

Jeśli AI nie odpowie w skonfigurowanym [czasie timeout](ai-w-helpdesk#timeout-ai) (domyślnie 15 sekund), zgłoszenie zostaje automatycznie wysłane normalnie. Klient nie czeka w nieskończoność.

## Zmiana treści po odpowiedzi AI

Jeśli klient zdecyduje, że odpowiedź AI nie pomogła, ale potem zmieni treść zgłoszenia (tytuł, opis, kategorię lub priorytet):
- Przycisk zmienia się z powrotem na **Zapisz**
- Pod przyciskiem pojawia się informacja: "Zmieniłeś zgłoszenie — analizujemy ponownie"
- Kliknięcie "Zapisz" ponownie uruchomi analizę AI z nową treścią

Jeśli klient cofnie zmiany do oryginalnej treści, przycisk wraca do **Wyślij zgłoszenie** bez ponownej analizy.

## Oznaczenie NoeAI

Zgłoszenia rozwiązane przez AI są oznaczone badge **NoeAI**:
- W widgecie — na liście zgłoszeń klienta
- W panelu admina — na liście ticketów (`/helpdesk/tickets`)
- Na stronie szczegółów ticketu — w pasku statusów

Komentarz z odpowiedzią AI jest wyróżniony jasnoniebieskim tłem i badge **NoeAI** zamiast nazwy autora.

## Logowanie i analiza

Każde zapytanie do AI jest logowane z informacjami:
- Treść pytania i odpowiedzi
- Czas generowania odpowiedzi
- Status (odpowiedziano / brak odpowiedzi / timeout / błąd)
- Feedback klienta (pozytywny / negatywny)
- Użyta kategoria i priorytet
- Kontekst z bazy RAG

Statystyki widoczne są na stronie desku w zakładce AI.

## Kiedy AI nie działa

Gdy AI jest wyłączone na desku, widget działa standardowo:
- Przycisk mówi "Wyślij zgłoszenie"
- Kliknięcie od razu wysyła ticket
- Żadna analiza AI nie jest wykonywana

## Wielojęzyczność

AI w widgecie obsługuje 8 języków: polski, angielski, ukraiński, niemiecki, francuski, hiszpański, czeski i słowacki. Język interfejsu widgetu zależy od ustawień desku.

---

## API

### Ogólne API

# Intum API

Dokumentacja API platformy [Intum](https://intum.pl) - system operacyjny firmy.

## Host

Host jest zawsze taki sam jak adres konta: `xxxx.intum.com` lub `xxx.intum.pl` (w zależności od ustawień konta)

## Autoryzacja

Wszystkie requesty API wymagają `api_token`:
- header: `Authorization: Bearer TOKEN`

Token możesz wygenerować w **Ustawienia Konta** → **Tokeny API**



---

## Powiązane

- [Konfiguracja AI do obsługi użytkowników](https://intum.fr/aide/helpdesk/ai-w-helpdesk.md)
- [Desk](https://intum.fr/aide/helpdesk/desk.md)
- [Support Widget](https://intum.fr/aide/helpdesk/support-widget.md)
- [Obsługa zgłoszeń](https://intum.fr/aide/helpdesk/obsluga-zgloszen.md)