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

# [Baza Wiedzy w Sugesterze: Twoje centrum informacji i dokumentacji](https://intum.pl/pomoc/baza-wiedzy/baza-wiedzy.md) | [API](#api)

Sprawny dostęp do wiedzy to fundament pracy nowoczesnego zespołu. Moduł Bazy Wiedzy (KB) w Sugesterze pozwala na tworzenie profesjonalnej dokumentacji, która służy zarówno Twoim klientom (jako publiczne centrum pomocy czy FAQ), jak i pracownikom (jako wewnętrzna baza wiedzy). Artykuły mogą być dostępne pod Twoją własną domeną lub dedykowaną ścieżką na koncie.

### Dlaczego warto wdrożyć Bazę Wiedzy?
- **Redukcja liczby pytań:** Klienci sami znajdują odpowiedzi, co odciąża Twój dział wsparcia.
- **Onboarding i procedury:** Nowi pracownicy mają dostęp do wszystkich instrukcji w jednym, uporządkowanym miejscu.
- **SEO i widoczność:** Publiczne artykuły pomagają pozycjonować Twoją markę w wyszukiwarkach.

## Krok 1: Nawigacja i struktura (Gdzie jestem?)
Zarządzanie wiedzą w Sugesterze jest wielopoziomowe i opiera się na prostym schemacie: tworzysz bazę z wybranym szablonem, dodajesz kategorie tematyczne, a następnie uzupełniasz je wpisami.
Zobacz, jak sprawnie poruszać się po module:
- **Menu Główne:** Kliknij ikonę menu (cztery kropki) i wybierz **Baza Wiedzy**. To Twój punkt wyjścia.

![](96cc3b6206e5-aa492f742470-Screenshot - 2026-03-19T143355.035.png)
- **Panel Zarządzania:** Tutaj decydujesz, co chcesz robić. Możesz zarządzać kategoriami, moderować komentarze lub dodawać **Helplinki** (czyli kontekstową pomoc w aplikacji powiązaną bezpośrednio z wpisami KB). Najważniejszym punktem na dole jest sekcja **BAZY WIEDZY** – to tutaj zarządzasz globalnymi ustawieniami swoich portali.

![](7f4fbe14d12e-18dde916537c-Screenshot - 2026-03-18T135007.765.png)
- **Lista Baz:** Sugester pozwala na posiadanie wielu baz jednocześnie (np. osobne forum dla klientów i osobna baza dla zespołu). Każdy kafel bazy pokazuje jej status (publiczna/prywatna) oraz daje szybki dostęp do edycji jej wyglądu, wgrania logo czy konfiguracji domeny.

![](f43224d688cc-2ea33f8097dc-Screenshot - 2026-03-20T153521.406.png)

### Elastyczność i personalizacja: Szablony i domeny
Każda tworzona przez Ciebie baza może zyskać unikalny charakter dzięki dedykowanym szablonom wizualnym:
- **Protocol Basic** - nowoczesny szablon z paskiem bocznym, wyszukiwarką i przyciskiem AI (zalecany).
- **Default** - podstawowy, przejrzysty szablon.
- **Marsian** - szablon wykorzystujący pełną szerokość ekranu.
- **Syntax** - idealny do dokumentacji technicznej, wyposażony w podświetlanie składni kodu.

> 💡 **Własna domena i prywatność:** Każdą bazę możesz podpiąć pod własną domenę (np. `pomoc.firma.pl`) lub zdefiniować dla niej prefix (np. `/pomoc/artykul`). Dodatkowo, jeśli chcesz stworzyć wewnętrzne wiki, możesz ustawić bazę lub konkretne wpisy jako **prywatne** – będą one widoczne wyłącznie dla zalogowanych użytkowników z odpowiednimi uprawnieniami.

## Krok 2: Zarządzanie treścią (Jak dodać wpis?)
Kiedy masz już gotową strukturę, czas na wypełnienie jej treścią. Proces dodawania artykułów jest intuicyjny i podzielony na jasne etapy:
- **Szybki dostęp:** Z menu głównego możesz przejść bezpośrednio do **Wpisy KB**, aby zobaczyć listę wszystkich artykułów we wszystkich Twoich bazach.
- **Lista Wpisów:** Tutaj widzisz pełną analitykę - ile razy dany wpis został wyświetlony, jaki ma priorytet oraz kiedy był ostatnio aktualizowany. Aby dodać nowy artykuł, kliknij ikonę plusa (**+**) w prawym górnym rogu.
- **Edytor Artykułu:** Otworzy się formularz tworzenia wpisu. Umożliwia on nadanie tytułu, przypisanie artykułu do odpowiedniej bazy i kategorii oraz tagowanie i uzupełnianie metadanych SEO. Treść możesz tworzyć za pomocą wygodnego edytora wizualnego lub korzystając z języka **Markdown**.

> ⚠️ **Ważne dla operatora:** Pamiętaj o ustawieniu Statusu. Jeśli artykuł nie jest jeszcze gotowy, zapisz go jako **Roboczy** - dzięki temu nie będzie on widoczny dla klientów, dopóki go nie dopracujesz.

![](b04bfc005268-d3c365af6b57-Screenshot - 2026-03-20T153929.302.png)

## Widoki listy Wpisów i Komentarzy - Praca masowa
Dla administratorów i moderatorów przygotowaliśmy dwa dedykowane widoki tabelaryczne: **Wpisy KB** oraz **Komentarze**.

![](654f5dac74c4-0751c3acd6e7-Screenshot - 2026-03-24T131631.528.png)

W odróżnieniu od standardowego podglądu bazy wiedzy, widoki te są zoptymalizowane pod kątem szybkiego zarządzania dużą ilością danych oraz czyszczenia bazy z niepożądanych treści.
W obu tych miejscach dostępna jest funkcja **masowego zaznaczania rekordów**, która pozwala na jeszcze szybszą pracę.

![](8008b019500d-ab4d8ba73914-Screenshot - 2026-03-24T132056.063.png)

### Do czego rekomendujemy te widoki?
Dzięki przejrzystej formie tabeli, widoki te są idealne do:
- **Zwalczania spamu:** Łatwo wyłapiesz wpisy lub komentarze pochodzące z tego samego adresu IP, co pozwala na błyskawiczną identyfikację i usunięcie serii spamerskich działań.
- **Moderacji treści:** Szybkie skanowanie listy w poszukiwaniu słów wulgarnych lub niedozwolonych treści w treściach wpisów i komentarzy.
- **Usuwania duplikatów:** Przeglądając listę wpisów (posortowaną np. po tytule), sprawnie namierzysz i usuniesz powtarzające się artykuły lub omyłkowo dodane wielokrotnie te same komentarze.
- **Masowych porządków:** Idealne miejsce do weryfikacji statusów moderacji (oczekujące/zaakceptowane) bez konieczności wchodzenia w każdy wpis z osobna.

### Jak sprawnie zarządzać rekordem?
Z prawej strony każdego wiersza znajduje się ikona trzech kropek (menu), która pozwala na błyskawiczne podjęcie akcji:
- **Zobacz:** Podgląd wpisu/komentarza.
- **Edycja:** Szybka poprawka treści.
- **Usuń:** Pozwala na natychmiastowe pozbycie się niechcianego wpisu z bazy.
> **Wskazówka:** Korzystaj z filtrów nad tabelą, aby zawęzić listę np. tylko do komentarzy oczekujących na moderację lub wpisów konkretnego autora, co znacznie przyspiesza proces weryfikacji.
## Jak widzą to Twoi odbiorcy? (Funkcje widoku publicznego)
Dla czytelnika Baza Wiedzy to nowoczesny, responsywny portal. Intuicyjne kafle kategorii pozwalają błyskawicznie dotrzeć do poszukiwanego tematu, a sekcje „Najnowsze” oraz „Popularne” automatycznie podpowiadają, co warto przeczytać w pierwszej kolejności.

![](0fcab8f27b5a-d58dab1e90af-Screenshot - 2026-03-20T154228.765.png)

Użytkownicy przeglądający Twoją bazę mają do dyspozycji szereg interaktywnych funkcji:
- **Wyszukiwarka:** Zaawansowane wyszukiwanie pełnotekstowe po wszystkich artykułach.
- **Nawigacja:** Automatyczny spis treści generowany bezpośrednio z nagłówków artykułu.
- **Ocenianie:** Odwiedzający mogą oceniać artykuły (pomocne/niepomocne), dając Ci feedback, które treści wymagają poprawy.
- **Komentarze:** Możliwość prowadzenia dyskusji bezpośrednio pod wpisami (z opcją Twojej moderacji).
- **Przycisk AI:** Pozwala na natychmiastowe otwarcie artykułu i pracę z nim w modelach Claude lub ChatGPT.
- **Wersja Markdown:** Dostęp do endpointu `.md`, który zwraca treść artykułu jako czysty tekst w formacie Markdown.

> **Wielojęzyczność (Multilang):** Jeśli obsługujesz klientów z całego świata, Sugester umożliwia tworzenie baz wiedzy w różnych językach (pl, en, fr, cs, sk, de, es, uk) i łączenie ich w grupy tłumaczeń za pomocą kodu `multilang_code`. Same wpisy pomiędzy różnymi bazami również mogą być ze sobą powiązane jako bezpośrednie tłumaczenia.
> **Wskazówka dla zaawansowanych:** Skorzystaj z pól *Html description* oraz *Html title* w edycji wpisu. Dzięki temu Twoje artykuły będą się wyświetlać z profesjonalnym opisem w wynikach wyszukiwania Google, co jeszcze bardziej ułatwi klientom trafienie na Twoją pomoc.

---

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

Moduł Baza Wiedzy udostępnia API dla baz wiedzy, wpisów, kategorii, komentarzy i helplinków.

## Endpointy baz wiedzy

| Metoda | Ścieżka | Opis |
|--------|---------|------|
| GET | `/kb/knowledge_bases.json` | Lista baz wiedzy |
| GET | `/kb/knowledge_bases/:id.json` | Pojedyncza baza |
| POST | `/kb/knowledge_bases.json` | Utworzenie bazy |
| PATCH | `/kb/knowledge_bases/:id.json` | Aktualizacja bazy |
| DELETE | `/kb/knowledge_bases/:id.json` | Usunięcie bazy |

**Autoryzacja:** `Authorization: Bearer TOKEN` (uprawnienie: **kb**)

## Pola knowledge_base

| Pole | Typ | Wymagane | Opis |
|------|-----|----------|------|
| `title` | string | tak | Nazwa bazy wiedzy |
| `description` | string | nie | Opis |
| `lang` | string | nie | Język: `pl`, `en`, `fr`, `cs`, `sk`, `de`, `es`, `uk` |
| `template` | string | nie | Szablon: `protocol_basic`, `default`, `marsian`, `syntax` |
| `prefix` | string | nie | Prefix URL (np. `pomoc`) |
| `private` | boolean | nie | Czy prywatna |
| `category_in_url` | boolean | nie | Kategoria w URL wpisu |
| `content_api` | string | nie | Dokumentacja API (Markdown) |
| `multilang_code` | string | nie | Kod grupy tłumaczeń |

Szczegółowa dokumentacja poszczególnych zasobów w osobnych wpisach:

- [Wpisy](wpisy-do-bazy-wiedzy) — `/kb/entries`
- [Kategorie](kategorie-kb) — `/kb/categories`
- [Komentarze](komentarze-kb) — `/kb/comments`
- [Helplinki](helplinki) — `/kb/helplinks`

---

## Powiązane

- [AI w bazie wiedzy - automatyczne odpowiedzi](https://intum.pl/pomoc/baza-wiedzy/ai-w-bazie-wiedzy-automatyczne-odpowiedzi.md)
- [Zasilanie bazy wiedzy z ticketów helpdesku](https://intum.pl/pomoc/baza-wiedzy/zasilanie-bazy-wiedzy-z-ticketow.md)