Instrukcja Kreskio dla zespołu

Czym jest Kreskio?

Kreskio to narzędzie do zgłaszania błędów i uwag bezpośrednio na stronie internetowej. Zamiast maili ze zrzutami ekranu i opisami typu „coś nie działa na telefonie” dostajesz kompletne zgłoszenie: zaznaczony fragment strony, opis oraz dane techniczne, takie jak przeglądarka, system i rozmiar okna.

• Twoi klienci zgłaszają uwagi przyciskiem „Zgłoś błąd” na stronie, bez zakładania konta.
• Twój zespół może zgłaszać błędy na dowolnej stronie przez rozszerzenie Chrome.
• Wszystkie zgłoszenia trafiają w jedno miejsce, gdzie możesz je przypisać, nadać im termin, skomentować i zamknąć.
• Klienci i zespół mogą też zgłaszać pomysły. Trafiają one osobno, do zakładki „Pomysły”, gdzie głosujecie na nie i decydujecie, co zrobić.

Pierwsze kroki

1. 1

   Załóż konto

   Zarejestruj się i potwierdź adres e-mail, klikając link z wiadomości od Kreskio.

2. 2

   Utwórz przestrzeń roboczą

   Podaj nazwę firmy lub zespołu. Możesz od razu wpisać adres strony, z której chcesz zbierać zgłoszenia, a Kreskio utworzy pierwszy projekt.

3. 3

   Wklej kod na stronę

   Skopiuj jedną linijkę kodu z karty projektu i wklej ją na stronie klienta. Szczegóły znajdziesz w sekcji „Instalacja na stronie”.

4. 4

   Zaproś zespół

   W zakładce „Zespół” zaproś osoby, które mają obsługiwać zgłoszenia.

5. 5

   Wyślij instrukcję klientowi

   Na karcie projektu znajdziesz link do instrukcji dla klienta. Możesz go wysłać albo pobrać instrukcję jako PDF.

Przestrzenie robocze

Przestrzeń robocza to Twoja firma lub zespół w Kreskio. Należą do niej projekty i osoby z zespołu. Jedno konto może należeć do wielu przestrzeni, na przykład własnej agencji i przestrzeni klienta, który zaprosił Cię do współpracy.

• Przestrzeń zmieniasz przełącznikiem w lewym górnym rogu, pod logo.
• Nową przestrzeń utworzysz z tego samego menu, wybierając „Nowa przestrzeń robocza”.
• Nazwę przestrzeni zmienisz w „Ustawieniach” (dostępne dla właściciela i administratorów).
• Tam też dodasz logo (PNG lub JPG) i kolor marki. Twoi klienci zobaczą je w portalu klienta, w mailach o swoich zgłoszeniach i na przycisku „Zgłoś błąd” na Twoich stronach – zamiast marki Kreskio.

Projekty

Projekt to jedna strona internetowa lub aplikacja, z której zbierasz zgłoszenia, na przykład sklep klienta albo jego wersja testowa. Każdy projekt ma własny kod instalacyjny i listę dozwolonych domen.

1. 1

   Dodaj projekt

   Wejdź w „Projekty”, kliknij „Nowy projekt”, podaj nazwę i domenę strony.

2. 2

   Ustaw dozwolone domeny

   Widget przyjmie zgłoszenia tylko ze stron na liście. Dzięki temu nikt nie użyje Twojego kodu na obcej stronie.

3. 3

   W razie potrzeby wyłącz widget

   W ustawieniach projektu możesz tymczasowo ukryć przycisk zgłaszania bez usuwania kodu ze strony.

4. 4

   Podaj adres wersji lokalnej (opcjonalnie)

   Jeśli poprawki robicie na swojej kopii strony, np. sklep.test, wpisz jej adres w ustawieniach projektu. Zadania z „Kopiuj dla AI” podadzą wtedy zgłoszoną podstronę od razu pod tym adresem.

5. 5

   Dopasuj przycisk zgłaszania (opcjonalnie)

   W karcie „Przycisk zgłaszania” wybierzesz jego położenie (prawy lub lewy dolny róg albo zakładka przy krawędzi, gdy róg zajmuje czat czy pasek cookies), rozmiar i wygląd: ikona z napisem albo sama ikona, która pokazuje napis po najechaniu kursorem. Podgląd obok pokazuje efekt przed zapisaniem. Na monitorach 4K przycisk sam trochę się powiększa. Możesz też włączyć skrót Alt+Shift+K (na Macu Option+Shift+K), który od razu otwiera zgłoszenie ze zrzutem ekranu. Zmiany widać na stronie po jej odświeżeniu.

6. 6

   Włącz pomysły (opcjonalnie)

   Zaznacz „Przyjmuj pomysły w widgecie”, a klienci przy wysyłaniu wybiorą „Błąd” albo „Pomysł”. Domyślnie pole jest wyłączone, więc klienci nie zobaczą zmiany, dopóki im jej nie zapowiesz. Szczegóły w sekcji „Pomysły”.

7. 7

   Włącz tury poprawek (opcjonalnie, plan Agencja)

   Zaznacz „Licz tury poprawek” i wpisz, ile tur ustaliliście z klientem. Szczegóły w sekcji „Tury poprawek”.

Instalacja na stronie

Kod instalacyjny znajdziesz na karcie projektu i skopiujesz go przyciskiem „Kopiuj”. Składa się z dwóch znaczników <script>: krótki pierwszy zapamiętuje błędy konsoli od początku ładowania strony, a drugi wczytuje widget. W skrócie wygląda tak:

<script>(function (w) { … })(window);</script>
<script type="module" src="https://kreskio.pl/widget/v1/kreskio.js" data-key="pk_…" async></script>

Wklej go w sekcji <head> na każdej podstronie, jak najwyżej – wtedy zgłoszenia obejmą też błędy z samego ładowania strony. Widget ładuje się asynchronicznie i nie spowalnia strony. Kod działa też przed zamykającym znacznikiem </body>, tylko bez błędów sprzed jego wczytania.

• WordPress: użyj wtyczki do wstawiania kodu w nagłówku (np. „WPCode”) albo dodaj kod w pliku header.php motywu.
• Shopify: w edytorze motywu otwórz plik theme.liquid i wklej kod zaraz po <head>.
• React, Next.js, Vue: dodaj znacznik <script> w głównym szablonie lub layoucie aplikacji.
• Google Tag Manager: utwórz tag „Niestandardowy kod HTML” z kodem i reguła „Wszystkie strony”.

Zespół i role

Osoby do przestrzeni zapraszasz w zakładce „Zespół”, podając adres e-mail i rolę. Zaproszenie jest ważne 7 dni. Osoba bez konta najpierw się rejestruje, a potem klika link z zaproszenia.

Etykiety opisują, czym ktoś zajmuje się w zespole, np. „Programista”, „Grafik” albo „Marketing”. Ustawiasz je w zakładce „Zespół” przyciskiem „Etykiety” (do 3 na osobę). Administrator i właściciel ustawiają etykiety każdemu, a członek – sobie. Etykiety widać przy przypisywaniu zgłoszenia, a na tablicy możesz pokazać tylko zgłoszenia przypisane np. do programistów.

Zgłoszenia

Zgłoszenia trafiają na tablicę z kolumnami statusów. Przeciągasz je między kolumnami, przypisujesz osoby i komentujesz. Każde zgłoszenie zawiera zrzut ekranu z zaznaczeniami albo nagranie ekranu, opis, adres strony oraz dane techniczne: przeglądarkę, system, rozmiar okna, błędy konsoli i nieudane żądania sieciowe.

• Statusy: Nowe, W trakcie, Do sprawdzenia, Rozwiązane.
• Przeniesienie do „Do sprawdzenia” prosi klienta mailem o sprawdzenie poprawki. Klient odpowiada w portalu „Działa” albo „Nadal nie działa”, a Ty dostajesz powiadomienie; gdy nie działa, także maila.
• Klient może też zrobić „Przegląd strony”: klika kolejne elementy, do każdego dopisuje zdanie i wysyła wszystko naraz. Każda uwaga przychodzi jako osobne zgłoszenie ze zrzutem, ramką wokół elementu i pinezką na nim, więc możesz je przypisywać i zamykać pojedynczo.
• Przy nagraniu błędy konsoli i żądania sieciowe mają znacznik czasu, np. „▶ 0:12”. Kliknięcie przewija film do chwili, w której wystąpił błąd.
• Karty i lista mają znaczek urządzenia przy zgłoszeniach z telefonu lub tabletu, a tablicę można filtrować po urządzeniu. W szczegółach zgłoszenia urządzenie widać zawsze, także „Komputer”.
• Klient może zaznaczyć kilka miejsc numerowanymi kółkami. Opis przychodzi wtedy jako lista „1. …, 2. …” o tych samych numerach co kółka na zrzucie.
• Zgłoszenie przypięte do elementu pokazuje, którego elementu strony dotyczy („Przypięte do …”).
• Komentarze wewnętrzne (tylko dla zespołu) i publiczne (widoczne dla zgłaszającego).
• Zgłaszający dostaje maila z linkiem do portalu, w którym widzi status i Twoje publiczne odpowiedzi.
• O nowym zgłoszeniu od razu informuje dzwoneczek w górnym pasku i licznik przy „Zgłoszenia”. E-mail dostają właściciel i administratorzy, około 30 minut później: zgłoszenia z tego czasu przychodzą w jednej wiadomości.
• Klient też dostaje wiadomości zbiorczo: jedno potwierdzenie, gdy wyśle kilka uwag pod rząd, i jedną informację, gdy rozwiążesz kilka jego zgłoszeń naraz.
• Powiadomienia webhook do Make, Zapier, n8n albo Slacka. Integracja z Jirą pojawi się wkrótce.

Poza tablicą masz zakładki „Lista” i „Zamknięte”. Na liście zaznaczasz kilka zgłoszeń i naraz zmieniasz im status, osobę odpowiedzialną albo termin; właściciel i administratorzy mogą je też usunąć. „Zamknięte” to archiwum zgłoszeń zdjętych z tablicy – przywrócisz je, zmieniając status. Klient nie dostaje maila o zamknięciu, a w portalu widzi, że zespół zamknął zgłoszenie. Osobę przypiszesz też bez otwierania zgłoszenia, klikając awatar na karcie.

W szczegółach zgłoszenia strzałki ‹ › przy numerze przechodzą do poprzedniego i następnego zgłoszenia w tej samej sekcji, np. w kolumnie „Nowe”, a skrajne przyciski skaczą do pierwszego i ostatniego. Licznik obok pokazuje, które to zgłoszenie, np. „3 z 12 · Nowe”. Strzałki zachowują filtry i kolejność z tablicy albo listy, więc z włączonym „Moje” przejdziesz tylko po swoich zgłoszeniach. Gdy zmienisz status, „Następne” prowadzi dalej po sekcji, z której przyszło zgłoszenie – możesz więc po kolei przejrzeć wszystkie nowe.

Poprawka z pomocą AI: w szczegółach zgłoszenia przycisk „Kopiuj dla AI” kopiuje je jako gotowe zadanie – opis, stronę, przeglądarkę, zaznaczony element, błędy konsoli i nieudane żądania. Wklej je do Claude Code, Cursora albo innego asystenta w repozytorium strony. „Pobierz zrzut” zapisuje zrzut z zaznaczeniami klienta, który dołączysz do zadania, bo asystent nie otworzy prywatnego linku. Zgłoszenie zwykle pochodzi z wersji produkcyjnej (np. sklep.pl), a poprawkę robisz lokalnie (np. sklep.test). Gdy w ustawieniach projektu podasz adres wersji lokalnej, zadanie wskaże gotowy link, np. https://sklep.test/koszyk, i rozmiar okna klienta; bez niego poda samą podstronę, np. /koszyk. Na końcu zadanie prosi asystenta o krótką odpowiedź dla klienta po polsku – wklej ją jako komentarz „Widoczny dla zgłaszającego”, zanim przeniesiesz zgłoszenie do „Do sprawdzenia”.

Moje zadania i terminy

Każdemu zgłoszeniu możesz nadać termin, czyli dzień, do którego zespół chce je zrobić. W szczegółach zgłoszenia kliknij pole „Termin” i wybierz „Dziś”, „Jutro”, „Piątek”, „Za tydzień” albo dowolny dzień z kalendarza. Na liście zaznaczysz kilka zgłoszeń i ustawisz im termin naraz.

• Na kartach i na liście termin jest czerwony, gdy minął, a żółty, gdy wypada dziś. Rozwiązane i zamknięte zgłoszenia nigdy nie są „po terminie”.
• Listę możesz posortować tak, żeby najbliższe terminy były na górze.
• Terminy widzi tylko zespół. Klient nie zobaczy ich ani w portalu, ani w e-mailach.

Zakładka „Moje zadania” w menu to Twoja lista na dziś. Są tam zgłoszenia przypisane do Ciebie, które wciąż wymagają pracy, w grupach: Po terminie, Dziś, W tym tygodniu, Później i Bez terminu. Zgłoszenia „Do sprawdzenia” są osobno, w grupie „Czeka na klienta”, bo teraz ruch należy do niego. Status i termin zmienisz od razu w wierszu, a rozwiązane zgłoszenie samo znika z listy.

Pomysły

Klienci często zgłaszają nie tylko błędy, ale i pomysły: „przydałby się filtr po cenie”, „ten formularz mógłby mieć mniej pól”. Żeby nie mieszały się z poprawkami, Kreskio zbiera je osobno, w zakładce „Pomysły”. Zespół i klienci głosują na nie, a Ty decydujesz, które warto zrobić – często jako dodatkowe zlecenie.

1. 1

   Włącz pomysły w projekcie

   W ustawieniach projektu zaznacz „Przyjmuj pomysły w widgecie”. Od tej chwili klient na stronie wybiera u góry formularza „Błąd” albo „Pomysł”. Pomysł ma zrzut ekranu z zaznaczeniem i adres strony, ale bez logów konsoli i sieci, bo nie dotyczy usterki.

2. 2

   Dodawaj pomysły z rozmów

   Pomysł z telefonu albo spotkania zapiszesz w zakładce „Pomysły” przyciskiem „Dodaj pomysł”: wybierasz projekt, wpisujesz pomysł i ewentualnie szczegóły.

3. 3

   Głosujcie i komentujcie

   Na liście kliknij kciuk przy pomyśle, żeby dodać głos (+1), a kliknij ponownie, żeby go cofnąć. Najczęściej popierane pomysły są na górze. W szczegółach pomysłu widać, kto głosował, i można go komentować tak jak zgłoszenie – także odpowiedzią widoczną dla klienta.

4. 4

   Zdecyduj

   W szczegółach pomysłu zmień status na „Do decyzji”, „Zaakceptowany” albo „Odrzucony”. Przy odrzuceniu warto dopisać klientowi krótkie wyjaśnienie w komentarzu.

5. 5

   Zamień na zadanie

   Gdy pomysł ma zostać zrobiony, kliknij „Zamień na zadanie”. Trafi na tablicę jako nowe zgłoszenie, z tym samym numerem, komentarzami i głosami, i zostanie widoczny wśród zaakceptowanych pomysłów z oznaczeniem „Zadanie na tablicy”.

• Zakładki „Do decyzji”, „Zaakceptowane” i „Odrzucone” dzielą pomysły według statusu. Listę możesz zawęzić do projektu i ułożyć według głosów albo od najnowszych.
• O nowym pomyśle informuje dzwoneczek („Nowy pomysł od…”) i licznik przy „Pomysły” w menu. Pomysły nie trafiają do zbiorczego e-maila o nowych zgłoszeniach.
• Pomysł nie ma statusów błędu, więc klient nie dostanie przez pomyłkę e-maila „Sprawdź poprawkę”. Takie e-maile przychodzą dopiero po zamianie pomysłu na zadanie.
• Klient widzi swoje pomysły w portalu, razem ze statusem pomysłu i Twoimi odpowiedziami.
• Pomysłów nie ma na tablicy, w liczniku zgłoszeń ani na liście, którą widzą asystenci AI. Webhooki mają pole „type” z wartością „bug” albo „idea”, więc w swoich narzędziach odróżnisz pomysł od błędu.

Tury poprawek

Gdy w umowie jest np. „3 tury poprawek”, Kreskio pilnuje ich za Was. Klient nie wysyła uwag po jednej przez kilka tygodni, tylko zbiera je na stronie i wysyła całą turę jednym przyciskiem. Wy dostajecie jedno powiadomienie i pracujecie na komplecie. Tury są dostępne na planie Agencja i w okresie próbnym.

1. 1

   Włącz tury w projekcie

   W ustawieniach projektu zaznacz „Licz tury poprawek” i wpisz liczbę tur (od 1 do 10). Na stronie projektu pojawi się karta „Tury poprawek”.

2. 2

   Klient zbiera uwagi

   Po kliknięciu przycisku zgłaszania klient widzi „Tura 1 z 3” i liczbę zebranych uwag. Na tablicy te uwagi są wyszarzone, ze znacznikiem „Tura 1 · zbierana”. Nie dostajecie o nich powiadomień, maili ani webhooków, dopóki klient nie wyśle tury.

3. 3

   Klient wysyła turę

   Przyciskiem „Wyślij turę 1 do agencji”. Zespół dostaje jedno powiadomienie w dzwoneczku, a właściciel i administratorzy jednego maila z listą uwag. Webhooki dostają każdą uwagę osobno, a klient – maila z potwierdzeniem całej tury.

4. 4

   Poprawiacie i oznaczacie turę

   Na stronie projektu kliknij „Tura poprawiona” przy wysłanej turze. Klient dostaje maila z prośbą o sprawdzenie strony i od tej chwili może wysłać kolejną turę. Uwagi do niej może zbierać już wcześniej.

5. 5

   Klient akceptuje turę

   W portalu przy poprawionej turze klient klika „Akceptuję turę”. Dostajecie powiadomienie, a przy turze pojawia się „Zaakceptowana przez…” z datą. Jeśli któraś uwaga nadal nie działa, klient pisze o tym przy tej uwadze albo dodaje ją do kolejnej tury.

• Uwagi wysłane po ostatniej ustalonej turze trafiają do Was od razu, ze znacznikiem „poza turami”. To dobry moment na rozmowę o dodatkowym zleceniu.
• Zgłoszenia zespołu (z rozszerzenia, z widgetu w trybie zespołu i z aplikacji) oraz pomysły klientów nie liczą się do tur.
• Klient widzi swoje tury w portalu: które są poprawione, która jest u Was, którą zbiera i ile zostało.
• Każda wysłana tura ma protokół odbioru w PDF – przycisk „PDF” przy turze na stronie projektu. Są w nim daty wysłania i poprawienia, lista uwag ze zrzutami oraz to, kto i kiedy zaakceptował turę. Klient pobiera ten sam protokół w portalu.
• Gdy klient zbierze uwagi do tury i przez 3 dni nic nie doda ani jej nie wyśle, dostaje maila z przypomnieniem i przyciskiem do strony. Przypomnienie przychodzi raz; ponownie dopiero wtedy, gdy klient doda kolejne uwagi i znów zostawi turę. Nie przychodzi, dopóki poprawiacie poprzednią turę.
• Gdy wyłączysz tury, uwagi z niewysłanej tury trafią do Was jako zwykłe zgłoszenia.

Asystenci AI: Claude Code i Cursor

Zamiast kopiować zgłoszenie przyciskiem „Kopiuj dla AI”, możesz pozwolić asystentowi pobierać je samemu. Claude Code, Cursor i inni asystenci obsługujący serwery MCP odczytują wtedy zgłoszenie po linku albo numerze: opis, stronę, przeglądarkę, zaznaczony element, błędy konsoli, nieudane żądania i zrzut ekranu klienta jako obraz.

1. 1

   Utwórz klucz

   Ustawienia → Asystenci AI. Nazwij klucz, np. „Claude Code – laptop”, i kliknij „Utwórz klucz”. Kreskio pokaże go tylko raz, razem z gotowymi poleceniami.

2. 2

   Podłącz asystenta

   Claude Code: skopiuj polecenie z zakładki „Claude Code” i uruchom je raz w terminalu. Kreskio będzie dostępne w każdym repozytorium, także w zakładce Code aplikacji Claude. Cursor: skopiuj ustawienia z zakładki „Cursor” i wklej je w Settings → MCP → „Add new MCP server” (plik mcp.json).

3. 3

   Wskaż projekt w repozytorium (zalecane)

   Na stronie projektu w Kreskio, w karcie „Dla zespołu” → „Asystenci AI”, skopiuj gotową notatkę i wklej ją do pliku CLAUDE.md w głównym folderze repozytorium strony (w Cursorze: AGENTS.md). Asystent będzie wtedy wiedział, które zgłoszenia dotyczą tego kodu, i nie będzie zgadywał po adresach.

4. 4

   Poproś o poprawkę

   W repozytorium strony napisz np. „Pobierz zgłoszenie https://kreskio.pl/w/agencja/issues/123 z Kreskio i napraw błąd” albo „zgłoszenie #42 z projektu Sklep”.

• „Jakie zgłoszenia z Kreskio czekają w tym projekcie?” – asystent sam dopasuje repozytorium do projektu po adresie strony i pokaże listę.
• „Pokaż moje pilne zgłoszenia z Kreskio” – tylko przypisane do Ciebie, z wybranym priorytetem.
• „Weź najstarsze nowe zgłoszenie ze Sklepu i je napraw” – asystent wybierze je z listy i pobierze szczegóły razem ze zrzutem i komentarzami.
• „Biorę je” – przy kluczu ze zmianami asystent przypisze zgłoszenie do Ciebie i ustawi „W trakcie”.
• „Ustaw termin #14 na piątek” – asystent zapisze termin, widoczny tylko dla zespołu.
• „Poprawka jest na produkcji, odpisz klientowi i przenieś do sprawdzenia” – asystent pokaże Ci treść odpowiedzi, a po Twojej zgodzie doda ją i ustawi „Do sprawdzenia”.

Kod, który asystent poprawia, to zawsze repozytorium, w którym otworzysz sesję: folder, w którym uruchomisz „claude” w terminalu, albo folder wybrany w aplikacji Claude lub w Cursorze. Kreskio podaje tylko, co jest zepsute. Dlatego otwieraj sesję w repozytorium strony, której dotyczy zgłoszenie. Adres wersji lokalnej z ustawień projektu nie wskazuje kodu: mówi asystentowi, gdzie odtworzyć błąd i sprawdzić poprawkę, np. https://sklep.test/koszyk zamiast strony klienta.

Polecenie dla Claude Code wygląda tak (w miejsce TWOJ_KLUCZ trafia Twój klucz):

claude mcp add --transport http --scope user kreskio https://kreskio.pl/mcp --header "Authorization: Bearer TWOJ_KLUCZ"

A ustawienia dla Cursora tak:

{
  "mcpServers": {
    "kreskio": {
      "url": "https://kreskio.pl/mcp",
      "headers": {
        "Authorization": "Bearer TWOJ_KLUCZ"
      }
    }
  }
}

• Zwykły klucz tylko odczytuje zgłoszenia. Gdy przy tworzeniu zaznaczysz „Pozwól też na zmiany”, asystent może też dodać komentarz, zmienić status i priorytet, ustawić termin oraz przypisać zgłoszenie do Ciebie – w przestrzeniach na planie Agencja i w okresie próbnym. Usunąć niczego nie może.
• Zmiany zrobione przez asystenta zapisują się jako Twoje, a komentarze mają znacznik „przez asystenta AI”. Przed odpowiedzią dla klienta i przed „Do sprawdzenia”, które wysyłają klientowi e-mail, asystent pyta Cię o zgodę.
• Widzi te same zgłoszenia co Ty, tylko z przestrzeni, do których należysz.
• Jest ważny 90 dni. Usuniesz go w każdej chwili w Ustawienia → Asystenci AI, np. gdy zgubisz laptopa.
• Gdy w ustawieniach projektu podasz adres wersji lokalnej, asystent dostanie link do zgłoszonej podstrony u Ciebie, np. https://sklep.test/koszyk.

Przykładowa rozmowa w repozytorium strony, z kluczem pozwalającym na zmiany. Nad odpowiedziami widać, którego narzędzia Kreskio asystent użył – nie musisz ich znać ani wpisywać, wystarczy pisać po ludzku:

1. Ty

   Jakie zgłoszenia z Kreskio czekają w tym projekcie?

2. Claudelist-issues

   W projekcie Sklep czekają 3 zgłoszenia: #14 · Nowe · priorytet: wysoki – „Przycisk zasłania cenę” #13 · Nowe – „Nie działa wyszukiwarka” #11 · Do sprawdzenia – „Literówka w stopce”

3. Ty

   Pokaż #14.

4. Claudeget-issue

   Klient zgłosił na /koszyk, na iPhonie w oknie 390 × 844, że przycisk „Do kasy” zasłania cenę – na zrzucie zaznaczył przycisk. Konsola bez błędów. Odtworzę to na https://sklep.test/koszyk.

5. Ty

   Biorę je, napraw.

6. Claudeupdate-issue

   Przypisałem #14 do Ciebie i ustawiłem „W trakcie”. Przyczyna: pasek z przyciskiem ma position: fixed bez odstępu na dole strony. Poprawiłem resources/css/cart.css. Sprawdź https://sklep.test/koszyk w oknie 390 × 844.

7. Ty

   Działa. Zapisz przyczynę w zgłoszeniu.

8. Claudeadd-comment

   Dodałem komentarz wewnętrzny z przyczyną i zmienionym plikiem. Widzi go tylko zespół.

9. Ty

   Poprawka jest już na produkcji. Odpisz klientowi i przenieś do sprawdzenia.

10. Claude

    Proponuję odpowiedź dla klienta: „Przycisk „Do kasy” nie zasłania już ceny na telefonie. Prosimy o sprawdzenie w koszyku.” Wysłać ją i ustawić „Do sprawdzenia”? Klient dostanie e-mail.

11. Ty

    Tak.

12. Claudeadd-commentupdate-issue

    Gotowe. Klient zobaczy odpowiedź w portalu, a za kilka minut dostanie e-mail z prośbą o sprawdzenie poprawki.

Jak odłączyć asystenta od Kreskio:

1. 1

   Usuń klucz w Kreskio – to odcina dostęp od razu

   Ustawienia → Asystenci AI → „Usuń” przy kluczu. Każde kolejne zapytanie z tym kluczem zostanie odrzucone, niezależnie od tego, na ilu komputerach i w jakich narzędziach jest zapisany. Zrób to od razu, gdy klucz wycieknie albo zgubisz komputer.

2. 2

   Usuń serwer z asystenta

   W Claude Code uruchom poniższe polecenie, w Cursorze usuń wpis „kreskio” z pliku mcp.json. Sam ten krok nie wystarczy: klucz działałby dalej, gdyby ktoś miał jego kopię.

claude mcp remove kreskio --scope user

• Na chwilę, bez usuwania: w Claude Code wpisz /mcp, wybierz „kreskio” i wyłącz go.
• Zmiana uprawnień, np. z odczytu na odczyt i zmiany: utwórz nowy klucz, podmień go w asystencie (najpierw „claude mcp remove”, potem „claude mcp add”) i usuń stary w Kreskio.

Portal klienta

Portal to miejsce, w którym klient śledzi swoje zgłoszenia i rozmawia z Tobą, bez zakładania konta. Dzięki niemu nie musi pisać maili z pytaniem „i co z tym błędem?”.

1. 1

   Klient wysyła zgłoszenie przez widget

   Podaje imię i e-mail. Nie ustawia hasła ani nie zakłada konta.

2. 2

   Dostaje maila z przyciskiem „Śledź zgłoszenie”

   Link sam go loguje do portalu i jest ważny 7 dni. Potem klient wpisuje swój e-mail na stronie portalu i dostaje nowy link.

3. 3

   W portalu widzi status i Twoje odpowiedzi

   Postęp: Nowe → W trakcie → Do sprawdzenia → Rozwiązane. Widzi też swój zrzut lub nagranie i tylko komentarze oznaczone „Widoczne dla zgłaszającego”; notatki wewnętrzne i terminy zespołu zostają ukryte.

4. 4

   Odpowiadacie sobie nawzajem

   Gdy dodasz publiczny komentarz, klient dostanie maila. Gdy klient odpisze w portalu, mail trafi do osoby przypisanej do zgłoszenia albo do właściciela i administratorów.

5. 5

   Klient potwierdza poprawkę

   Gdy przeniesiesz zgłoszenie do „Do sprawdzenia”, klient dostaje maila z prośbą o sprawdzenie. W portalu klika „Działa” – zgłoszenie przechodzi do „Rozwiązane” – albo „Nadal nie działa” i opisuje, co jest nie tak – zgłoszenie wraca do „W trakcie”, a osoba przypisana dostaje maila.

6. 6

   Albo dowiaduje się o poprawce

   Gdy przeniesiesz zgłoszenie od razu do „Rozwiązane”, klient dostaje maila, że błąd został naprawiony.

Webhooki

Webhook to adres, pod który Kreskio samo wysyła informację, gdy coś się wydarzy: przyjdzie nowe zgłoszenie, zmieni się status albo ktoś doda komentarz. Dzięki temu zgłoszenia trafiają tam, gdzie Twój zespół już pracuje.

• Slack lub Teams: nowe zgłoszenie pojawia się jako wiadomość na kanale, np. #błędy.
• Arkusz Google: każde zgłoszenie dopisuje się jako wiersz, np. do raportu dla klienta.
• Trello, Asana, ClickUp lub Twój CRM: zgłoszenie tworzy nowe zadanie.

1. 1

   Utwórz scenariusz w Make, Zapier lub n8n

   Wybierz wyzwalacz „Webhook” (w Make: „Custom webhook”, w Zapier: „Catch Hook”). Narzędzie poda adres, który zaczyna się od https://.

2. 2

   Wklej ten adres poniżej i zaznacz zdarzenia

   Na przykład tylko „Nowe zgłoszenie”, jeśli chcesz powiadomień na Slacku o nowych błędach.

3. 3

   Kliknij „Wyślij test”

   Kreskio wyśle przykładową wiadomość, a Make lub Zapier rozpozna jej pola: tytuł, opis, status, adres strony, zgłaszającego i link do zgłoszenia.

4. 4

   Dokończ scenariusz

   Dodaj akcję, np. „Wyślij wiadomość na Slacku”, i użyj w niej pól ze zgłoszenia.

Każda wiadomość jest podpisana sekretem widocznym przy webhooku (nagłówek Kreskio-Signature), więc Twój system może sprawdzić, że naprawdę pochodzi z Kreskio. Jeśli adres chwilowo nie odpowiada, Kreskio ponawia próbę kilka razy przez 2 godziny. Historię ostatnich wysyłek widzisz przy każdym webhooku.

Webhooki ustawiasz na stronie projektu, w sekcji „Webhooki”. Widzą ją właściciel i administratorzy przestrzeni.

Tryb zespołu w widgecie

Tryb zespołu pozwala Tobie i Twojemu zespołowi korzystać z widgetu na stronie klienta jako zespół, a nie jako anonimowy zgłaszający. Nie trzeba instalować rozszerzenia Chrome, więc działa w każdej przeglądarce, także na telefonie.

1. 1

   Kliknij „Zgłoś błąd”, a potem „Logowanie dla zespołu”

   Link jest na dole okna wyboru zrzutu lub nagrania, a na telefonie na dole formularza zgłoszenia. Otworzy się małe okno Kreskio; jeśli nie jesteś zalogowany, zaloguj się swoim kontem. Gdy przeglądarka zablokuje okno, zezwól tej stronie na wyskakujące okna.

2. 2

   Kliknij „Włącz tryb zespołu”

   Okno samo się zamknie, a na stronie pojawi się pasek „Tryb zespołu” z Twoim imieniem.

3. 3

   Włącz pinezki

   Przycisk „Pokaż pinezki” rysuje numerowane znaczniki przy elementach, których dotyczą otwarte zgłoszenia. Kliknij znacznik, żeby przeczytać zgłoszenie i przejść do niego w Kreskio.

4. 4

   Zgłaszaj jako członek zespołu

   Zgłoszenia z trybu zespołu idą od razu jako Ty, bez podawania imienia i e-maila. Działa zrzut ekranu, nagranie i „Wskaż element”.

5. 5

   Kliknij „Wyloguj”, gdy skończysz

   Szczególnie na cudzym komputerze, np. u klienta. Dostęp i tak wygaśnie sam po 8 godzinach albo po zamknięciu karty.

• Tryb zespołu działa tylko na stronach z widgetem Kreskio i tylko dla członków zespołu tej przestrzeni.
• Dostęp obejmuje wyłącznie ten jeden projekt i wygasa po 8 godzinach.
• Klient widzi jedynie mały link „Logowanie dla zespołu”; bez konta w Twoim zespole nic mu on nie daje.

Rozszerzenie Chrome

Rozszerzenie pozwala Twojemu zespołowi zgłaszać błędy na dowolnej stronie, również takiej, na której nie ma kodu Kreskio, np. na produkcji klienta. Klienci go nie potrzebują: oni zgłaszają przez przycisk na stronie. Paczkę do pobrania znajdziesz w Przewodniku, w sekcji „Rozszerzenie Chrome”.

Rozszerzenie jest w Chrome Web Store. Działa w Google Chrome i w Microsoft Edge, który instaluje je z tego samego sklepu. W Firefoksie i Safari jeszcze go nie ma: tam zgłaszaj błędy przyciskiem Kreskio na stronie.

1. 1

   Otwórz Kreskio w Chrome Web Store

   Kliknij „Dodaj do Chrome” powyżej albo wejdź na https://chromewebstore.google.com/detail/kreskio-%E2%80%93-zg%C5%82aszanie-b%C5%82%C4%99d/oheolljbnkokeakobfehiahdigdmedpm.

2. 2

   Dodaj rozszerzenie

   Na stronie sklepu kliknij „Dodaj do Chrome”, a potem „Dodaj rozszerzenie”.

3. 3

   Przypnij ikonę do paska

   Kliknij ikonę puzzla obok paska adresu i pinezkę przy Kreskio. Ikona będzie zawsze pod ręką.

4. 4

   Połącz z kontem

   Kliknij ikonę Kreskio i „Połącz z kontem”. Otworzy się karta Kreskio, w której potwierdzasz połączenie. Gotowe.

W Microsoft Edge kroki są te same, z dwiema różnicami:

• Dodawanie: Na górze strony sklepu kliknij „Zezwalaj na rozszerzenia z innych sklepów” i potwierdź, a potem „Pobierz” i „Dodaj rozszerzenie”.
• Przypinanie ikony: Kliknij ikonę puzzla obok paska adresu i ikonę oka przy Kreskio („Pokaż na pasku narzędzi”). Ikona będzie zawsze pod ręką.

Gdy sklep jest zablokowany, np. przez zasady firmowego komputera, rozszerzenie zainstalujesz też z paczki zip – kroki są w aplikacji w „Rozszerzenie Chrome”.

• Zrzut widocznej części strony jednym kliknięciem, z zamaskowanymi hasłami i danymi kart.
• Projekt dobierany automatycznie po domenie strony.
• „Wskaż element” przypina zgłoszenie do konkretnego przycisku, zdjęcia czy akapitu.
• „Pokaż pinezki na tej stronie” rysuje numerowane znaczniki przy elementach z otwartymi zgłoszeniami. Kliknięcie znacznika pokazuje tytuł, status i link do zgłoszenia. Zgłoszenia, których elementu nie ma już na stronie, trafiają na listę „Odłączone”.
• „Nagraj kartę” nagrywa bieżącą kartę razem z dźwiękiem strony i Twoim głosem (do 5 minut), bez okna wyboru ekranu. Przy pierwszym użyciu rozszerzenie raz poprosi o dostęp do mikrofonu.
• Od wersji 0.4.2 te same narzędzia co w widgecie: ramki (domyślne), numerowane kółka z opisem przy każdym, strzałki, zakreślacz, tekst, zamazywanie, wybór koloru i grubości linii oraz usuwanie zaznaczeń.
• Od wersji 0.4.3 przycisk „Przegląd strony” w okienku rozszerzenia: klikasz kolejne elementy strony, do każdego dopisujesz uwagę i wysyłasz wszystkie naraz. Każda uwaga trafia jako osobne zgłoszenie ze zrzutem karty, ramką wokół elementu i pinezką. Działa na dowolnej stronie, także bez widgetu.
• Na dole okienka rozszerzenia widać jego wersję. Gdy w Kreskio jest nowsza, okienko informuje o tym i prowadzi do pobrania.

Plan, płatności i limity

Nowa przestrzeń ma okres próbny na planie Agencja, więc działa w niej wszystko. Potem zamawiasz plan w zakładce „Płatności” i płacisz przelewem, a rachunek przychodzi mailem. Po końcu opłaconego okresu nadal widzisz zgłoszenia, ale widget i rozszerzenie nie przyjmują nowych.

• Aktualne ceny i limity obu planów są w zakładce „Płatności” i na stronie głównej.
• Plan zmienisz, zamawiając inny w „Płatnościach”. Po opłaceniu przestrzeń od razu przechodzi na nowy plan, a dni, które zostały z poprzedniego, zamieniają się na dni nowego planu o tej samej wartości (według cen miesięcznych). Przykład: 30 dni planu za 59 zł to ok. 15 dni planu za 119 zł.
• Na niższy plan przejdziesz, gdy przestrzeń mieści się w jego limitach. Jeśli masz np. więcej projektów albo osób (razem z zaproszeniami), niż pozwala Start, „Płatności” pokażą, co trzeba usunąć, zanim zamówisz Start. Miejsce na pliki się tu nie liczy.

• Plan ma limity: liczbę projektów, osób w zespole (razem z oczekującymi zaproszeniami), stron w jednym projekcie oraz miejsca na zrzuty i nagrania. Aktualne wykorzystanie widać w zakładce „Płatności”.
• Adresy do testów lokalnych (localhost, 127.0.0.1, *.test, *.local) nie liczą się jako strony, a example.com, www.example.com i *.example.com liczą się jako jedna.
• Po osiągnięciu limitu nie dodasz kolejnego projektu ani osoby. Gdy skończy się miejsce, zgłoszenia nadal przychodzą, tylko bez zrzutu i nagrania – zgłaszający widzi o tym komunikat.
• Nic, co już zapisane, nie jest usuwane. Potrzebujesz większych limitów? Napisz do nas.

Bezpieczeństwo konta

• Imię, e-mail i hasło zmienisz w menu użytkownika (lewy dolny róg), w „Ustawieniach”.
• Włącz uwierzytelnianie dwuskładnikowe (2FA) w zakładce „Bezpieczeństwo”. Zachowaj kody odzyskiwania w bezpiecznym miejscu.
• Możesz dodać klucz dostępu (passkey), aby logować się odciskiem palca, twarzą lub kodem PIN urządzenia.
• W zakładce „Wygląd” wybierzesz motyw jasny, ciemny lub zgodny z systemem.

Najczęstsze pytania

Nie widzę przycisku „Zgłoś błąd” na stronie. Co zrobić?

Sprawdź, czy domena strony jest na liście dozwolonych domen projektu, czy widget jest włączony w ustawieniach projektu i czy kod jest wklejony na tej podstronie. Jeśli strona korzysta z pamięci podręcznej (cache), wyczyść ją.

Dlaczego e-mail o nowym zgłoszeniu przychodzi z opóźnieniem?

Kreskio czeka około 30 minut i łączy zgłoszenia z jednego projektu w jedną wiadomość, żeby klient, który wysyła kilka uwag pod rząd, nie zasypał Cię mailami. W aplikacji zgłoszenie widać od razu: przy dzwoneczku i w zakładce „Zgłoszenia”.

Czym różni się pomysł od zgłoszenia błędu?

Błąd to coś, co nie działa – trafia na tablicę i przechodzi przez statusy aż do „Rozwiązane”, a klient na końcu sprawdza poprawkę. Pomysł to propozycja zmiany – czeka w zakładce „Pomysły” na głosy i Twoją decyzję, a na tablicę trafia dopiero po kliknięciu „Zamień na zadanie”.

Czy klient widzi terminy zgłoszeń?

Nie. Termin to wewnętrzny plan zespołu: nie ma go w portalu klienta, w e-mailach do klienta ani w webhookach. Klient widzi tylko status i odpowiedzi oznaczone jako widoczne dla zgłaszającego.

Czy klient musi zakładać konto?

Nie. Klient zgłasza błędy bezpośrednio na stronie. Konto jest potrzebne tylko osobom, które obsługują zgłoszenia.

Czy widget spowalnia stronę?

Nie. Skrypt ma kilka kilobajtów i ładuje się asynchronicznie, po załadowaniu treści strony.

Nie dostałem zaproszenia. Co teraz?

Sprawdź folder spam. Administrator przestrzeni może anulować zaproszenie i wysłać je ponownie w zakładce „Zespół”.

Jak przenieść projekt do innej przestrzeni?

Na razie nie jest to możliwe. Utwórz nowy projekt w docelowej przestrzeni i podmień kod na stronie.