[Intum](https://intum.fr/aide.md) / [Baza Wiedzy](https://intum.fr/aide/baza-wiedzy.md)

# [Zakładka Bazy Wiedzy (Widget)](https://intum.fr/aide/baza-wiedzy/zakladka-bazy-wiedzy-widget.md) | [API](#api)

## Zakładka Bazy Wiedzy

Zakładka bazy wiedzy to widget, który osadzasz na swojej stronie internetowej. Klienci mogą przeglądać artykuły, wyszukiwać odpowiedzi i znajdować rozwiązania — bez opuszczania Twojej strony.

## Jak uruchomić

1. Przejdź do **Baza wiedzy → Bazy wiedzy → [Twoja baza]**
2. Kliknij zakładkę **Widget**
3. Skopiuj wygenerowany snippet kodu
4. Wklej go na swoją stronę (przed `</body>`)

Zakładka pojawi się automatycznie przy krawędzi ekranu.

## Konfiguracja

W snippecie możesz zmienić:

- **`locale`** — język zakładki (`pl`, `en`, `de`, `fr`, `cs`, `sk`, `es`, `uk`)
- **`position`** — pozycja: `right` (domyślna) lub `left`
- **`label`** — własna etykieta na zakładce (domyślnie "Pomoc")
- **`color`** — kolor zakładki (hex, np. `#3b82f6`)
- **`tab_offset`** — pozycja pionowa zakładki (CSS `top`, domyślnie `50%`)

## Jakie artykuły wyświetla widget

Widget pokazuje trzy sekcje:

1. **Popularne artykuły** — wpisy z największą liczbą wyświetleń (`view_count`), sortowane malejąco. Wyświetlanych jest do 10 wpisów.
2. **Najnowsze artykuły** — ostatnio dodane wpisy, sortowane po dacie utworzenia.
3. **Kategorie** — publiczne kategorie główne z liczbą wpisów.

Dodatkowo dostępne jest **wyszukiwanie** — klient wpisuje frazę i widzi pasujące artykuły.

### Ukrywanie wpisu z sekcji Popularne

Jeśli nie chcesz, żeby konkretny wpis pojawiał się w sekcji "Popularne" w widgecie, zmień jego **priorytet na wartość mniejszą niż 1** (np. 0). Wpisy z priorytetem < 1 są pomijane w tej sekcji.

Priorytet edytujesz w widoku wpisu w polu **Priorytet**.

## Funkcje widgetu

- **Wyszukiwanie** — klienci wpisują frazę i widzą pasujące artykuły
- **Popularne artykuły** — najczęściej odwiedzane wpisy
- **Najnowsze artykuły** — ostatnio dodane wpisy
- **Kategorie** — przeglądanie artykułów po kategoriach
- **Wielojęzyczność** — zakładka wyświetla się w języku ustawionym w `locale`

## Wydajność

Zakładka ładuje się z CDN i **nie wysyła żadnych requestów do serwera**, dopóki klient jej nie otworzy. Dopiero po kliknięciu pobierane są dane z API.

## Testowanie

Na stronie **Widget** kliknij przycisk **Testuj zakładkę** — otworzy się strona testowa z załadowanym widgetem i przykładowymi danymi klienta.

## Przykład snippetu

```html
<div id="intum-kb-widget"></div>
<script>
  var IntumKbWidget = {
    account_url: "https://twoja-firma.intum.pl",
    kb_token: "TWÓJ_TOKEN",
    locale: "pl",
    position: "right",
    color: "#3b82f6"
  };
</script>
<script src="https://widgets.intum.net/kb/intum-kb-widget.js"></script>
```

---

## 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

- [AI w bazie wiedzy - automatyczne odpowiedzi](https://intum.fr/aide/baza-wiedzy/ai-w-bazie-wiedzy-automatyczne-odpowiedzi.md)