# Dokumentacja

> Poradniki dla zespołu i programistów: od pierwszego widżetu czatu do agenta AI, który pracuje nad twoimi zadaniami.

## Pierwsze kroki

Firma, pierwszy widżet czatu i zespół w kilka minut.

- [Utworzenie firmy i pierwsze kroki](https://hrc.lt/pl/docs/getting-started/create-company): Jak zalogować się do HRC pagalba, utworzyć firmę i w kilka minut przejść kroki konfiguracji. Co jest bezpłatne na zawsze.
- [Instalacja widżetu czatu na stronie](https://hrc.lt/pl/docs/getting-started/install-widget): Dodaj widżet czatu do strony w kilka minut: adres, wygląd, krótki kod albo instrukcje dla WordPress, Shopify, Wix i Google Tag Manager.
- [Zapraszanie zespołu](https://hrc.lt/pl/docs/getting-started/invite-team): Jak zaprosić współpracowników do HRC pagalba, co mogą właściciele i członkowie zespołu i jak każdy dostaje powiadomienia o nowych wiadomościach.
- [Konfiguracja z agentem AI](https://hrc.lt/pl/docs/getting-started/set-up-with-ai-agent): Pozwól swojemu agentowi AI (Claude, ChatGPT, Codex, Cursor) przygotować HRC pagalba od zera: widżet czatu, bazę wiedzy i gotowe odpowiedzi.

## Widżet czatu

Instalacja, ustawienia, języki, API JavaScript, profil odwiedzającego i weryfikacja tożsamości.

- [Kod do osadzenia, React i CSP](https://hrc.lt/pl/docs/widget/install): Kod do osadzenia widżetu czatu, kolejka poleceń, React i inne SPA, Next.js, Content Security Policy, dozwolone adresy i częste problemy.
- [Ustawienia widżetu czatu](https://hrc.lt/pl/docs/widget/settings): Ustawienia widżetu czatu: nazwa i adresy, wygląd z podglądem na żywo, teksty i języki, nowości, baza wiedzy i weryfikacja tożsamości.
- [Języki widżetu czatu](https://hrc.lt/pl/docs/widget/languages): Jak widżet czatu wybiera język odwiedzającego, 31 gotowych języków, własne teksty dla każdego języka, języki pisane od prawej do lewej i setLocale.
- [API JavaScript widżetu czatu](https://hrc.lt/pl/docs/widget/javascript-api): Wszystkie polecenia API JavaScript widżetu czatu: init, identify, update, setTags, track, setContext, open, on i off, reset i destroy, z przykładami.
- [Profil odwiedzającego, tagi i działania](https://hrc.lt/pl/docs/widget/visitor-profile): Przekazuj plan, firmę, własne pola, tagi i działania odwiedzającego ze swojej strony. Zespół widzi je obok rozmowy. Limity i prywatność.
- [Weryfikacja tożsamości zalogowanych użytkowników](https://hrc.lt/pl/docs/widget/identity-verification): Rozpoznawaj zalogowanych użytkowników w widżecie czatu: klucz weryfikacji, liczenie userHash w Node.js, PHP i Python, zweryfikowany e-mail i wylogowanie.

## Skrzynka i e-mail

Rozmowy, skrzynki pocztowe, odpowiedzi AI i powiadomienia.

- [Rozmowy w skrzynce odbiorczej](https://hrc.lt/pl/docs/inbox/conversations): Jak pracować z rozmowami: widoki i statusy, przypisywanie, notatki wewnętrzne, karty, filtry, gotowe odpowiedzi, wysyłka później i eksport.
- [Podłączanie skrzynek pocztowych](https://hrc.lt/pl/docs/inbox/mailboxes): Podłącz dowolną skrzynkę z serwerem SMTP, także Gmail i Outlook. Logowanie przez Google i Microsoft wkrótce. Test, SPF, DKIM i DMARC.
- [Odpowiedzi AI i tłumaczenie](https://hrc.lt/pl/docs/inbox/ai-answers-and-translation): AI przygotowuje szkic odpowiedzi na podstawie bazy wiedzy, tłumaczy rozmowę i odpowiada na podstawie litewskich przepisów. Jak działa i jak wyłączyć.
- [Powiadomienia o nowych wiadomościach](https://hrc.lt/pl/docs/inbox/notifications): Dostawaj powiadomienie o nowej wiadomości klienta w Telegram lub w przeglądarce. Każdy członek zespołu ustawia własne powiadomienia.

## Kontakty

Kontakty, listy, przypomnienia, pola, import i API.

- [Kontakty i listy](https://hrc.lt/pl/docs/contacts/contacts-and-lists): Prosty CRM w Kontaktach: dodawanie i import CSV, etapy, tagi, listy w menu, przypomnienia, pola i dane z Twojego systemu przez API.
- [Przypomnienia i Twój kalendarz](https://hrc.lt/pl/docs/contacts/calendar): Oś czasu przypomnień: co jest zaległe, co dzieje się dziś i co przed Tobą. Zaplanowane wpisy w Twoim kalendarzu Google, Apple lub Outlook.
- [Rozpoznawanie i łączenie kontaktów](https://hrc.lt/pl/docs/contacts/recognition-and-merging): Jeden kontakt na osobę we wszystkich widżetach czatu i skrzynkach pocztowych: historia rozmów, rozpoznawanie, profil, łączenie i usuwanie.

## Baza wiedzy

Artykuły, tworzenie z AI, własny adres i wyszukiwanie w widżecie.

- [Tworzenie bazy wiedzy](https://hrc.lt/pl/docs/knowledge-base/create): Utwórz bazę wiedzy: sekcje, artykuły, edytor, obrazy i wideo, szkice i publikacja, języki i tłumaczenia.
- [Tworzenie bazy wiedzy z AI](https://hrc.lt/pl/docs/knowledge-base/build-with-ai): Utwórz bazę wiedzy z własnym agentem AI przez MCP, pisz artykuły z AI na podstawie tematu, przepisów lub rozmowy i sprawdzaj je z AI.
- [Strona bazy wiedzy i własny adres](https://hrc.lt/pl/docs/knowledge-base/site-and-domain): Strona bazy wiedzy pod adresem nazwa.hrc.lt albo na twojej subdomenie przez CNAME: statusy, wygląd, menu, widżet czatu i wyszukiwarki.
- [Baza wiedzy w widżecie czatu](https://hrc.lt/pl/docs/knowledge-base/in-the-widget): Podłącz bazę wiedzy do widżetu czatu: sekcja „Pomoc” z wyszukiwaniem i popularnymi artykułami, a w analityce widać, czego klienci nie znaleźli.

## Agenci AI

Uprawnienia, MCP, REST API i OAuth dla twojej aplikacji AI.

- [Agenci AI: uprawnienia, klucze i dziennik](https://hrc.lt/pl/docs/ai-agents/overview): Jak działają agenci AI w HRC pagalba: dwanaście obszarów z uprawnieniami, zestawy, klucze osobiste i OAuth, przygotowane odpowiedzi, dziennik i limity.
- [Podłączanie agenta AI przez MCP](https://hrc.lt/pl/docs/ai-agents/mcp): Podłącz ChatGPT, Claude, Claude Code, Codex, Cursor, VS Code lub Windsurf do HRC pagalba przez MCP z OAuth. Kroki dla każdej aplikacji.
- [REST API dla agentów AI i twojego serwera](https://hrc.lt/pl/docs/ai-agents/rest-api): REST API HRC pagalba z kluczem osobistym: uwierzytelnianie, odpowiedzi { error, data }, kody błędów, plik OpenAPI i przykłady w curl, Node.js i Python.
- [OAuth dla twórców aplikacji AI](https://hrc.lt/pl/docs/ai-agents/oauth): Jak aplikacja AI loguje się do serwera MCP HRC pagalba: wykrywanie OAuth 2.1, dynamiczna rejestracja klienta, PKCE S256, okno zgody i tokeny.

## Zadania

Tablica, zadania z rozmów, agenci AI i nowości dla klientów.

- [Tablica zadań i zadania z rozmów](https://hrc.lt/pl/docs/tasks/board): Zadania w HRC pagalba: statusy, zadanie z rozmowy z opisem od AI, pliki, osoby odpowiedzialne, etykiety i priorytet, tablica, lista i wydajność.
- [Agenci AI w zadaniach i nowości dla klientów](https://hrc.lt/pl/docs/tasks/ai-agents-and-news): Jak agenci AI biorą zadania z kolejki, piszą komentarze i przenoszą do QA, i jak z ukończonego zadania zrobić wpis z nowościami dla klientów.

## Pliki

Wszystkie pliki firmy, foldery, kosz i linki publiczne.

- [Pliki, foldery i linki publiczne](https://hrc.lt/pl/docs/files/files-and-folders): Wszystkie pliki firmy w jednym miejscu: foldery, przesyłanie do 5 TB, kosz, usuwanie plików i linki publiczne z hasłem.

## Analityka

Czasy odpowiedzi, zespół, ruch w widżecie i wyszukiwania.

- [Analityka i co znaczą jej liczby](https://hrc.lt/pl/docs/analytics): Analityka HRC pagalba: czas pierwszej odpowiedzi i oczekiwania, zespół, ruch w widżecie czatu i wyszukiwania w bazie wiedzy. Okresy i przechowywanie.

## Konto i płatności

Firma, logowanie, język, dodatki i dane.

- [Firma, członkowie zespołu i role](https://hrc.lt/pl/docs/account/company-and-team): Nazwa i logo firmy, zużycie w tym miesiącu, limity plików, członkowie zespołu i role, kilka firm i jak usunąć widżet czatu lub firmę.
- [Logowanie i język interfejsu](https://hrc.lt/pl/docs/account/sign-in-and-language): Logowanie kodem z e-maila lub przez Google, twoje imię i język interfejsu: litewski, angielski, polski, ukraiński lub rosyjski. Jak wybierany jest język.
- [Dodatki, płatności i faktury](https://hrc.lt/pl/docs/account/billing): Co w HRC pagalba jest bezpłatne i ile kosztuje sześć dodatków: miejsce na pliki, baza wiedzy, Pakiet AI, akty prawne, zadania i firmy z rejestrów.
- [Dane i prywatność](https://hrc.lt/pl/docs/account/data-and-privacy): Gdzie HRC pagalba przechowuje dane, jak używa ich AI i jak je wyłączyć, jak długo dane są przechowywane, eksport i usuwanie.

## FAQ i pomoc

Krótkie odpowiedzi na najczęstsze pytania i jak do nas napisać.

- [Częste pytania o HRC pagalba](https://hrc.lt/pl/docs/faq): Odpowiedzi na częste pytania o HRC pagalba: ceny, widżet czatu, skrzynka odbiorcza, baza wiedzy, AI, agenci AI i gdzie przechowywane są dane.
- [Pomoc w korzystaniu z HRC pagalba](https://hrc.lt/pl/docs/support): Jak uzyskać pomoc w HRC pagalba: napisz do nas na czacie lub na pagalba@hrc.lt i co nam podać, abyśmy szybko odpowiedzieli.

## Dla programistów

- Skrypt ładujący widżet czatu: https://widget.hrc.lt/v1/loader.js
- Typy TypeScript: https://widget.hrc.lt/v1/hrc.d.ts
- Adres MCP: https://mcp.hrc.lt/mcp
- Opis REST API (OpenAPI): https://api.hrc.lt/agent-api/openapi.json