Dla właścicieli, administratorów i członków zespołu

Instrukcja Kreskio dla zespołu

Wszystko, czego potrzebujesz, żeby zbierać zgłoszenia błędów od klientów i testerów prosto ze strony www.

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ć, skomentować i zamknąć.

Pierwsze kroki

1
Załóż konto
Zarejestruj się i potwierdź adres e-mail, klikając link z wiadomości od Kreskio.
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
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
Zaproś zespół
W zakładce „Zespół” zaproś osoby, które mają obsługiwać zgłoszenia.
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
Dodaj projekt
Wejdź w „Projekty”, kliknij „Nowy projekt”, podaj nazwę i domenę strony.
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
W razie potrzeby wyłącz widget
W ustawieniach projektu możesz tymczasowo ukryć przycisk zgłaszania bez usuwania kodu ze strony.

Wpis na liście domen	Co obejmuje
sklep.pl	sklep.pl oraz www.sklep.pl
*.sklep.pl	sklep.pl i wszystkie subdomeny, np. test.sklep.pl
localhost:3000	lokalną wersję strony na porcie 3000

Możesz wkleić pełny adres, np. https://www.sklep.pl/kontakt. Kreskio samo wyciągnie z niego domenę.

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”.

Po wklejeniu kodu odśwież stronę. W prawym dolnym rogu pojawi się przycisk „Zgłoś błąd”. Jeśli go nie widzisz, sprawdź sekcję „Najczęstsze pytania”.

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.

Uprawnienie	Członek	Administrator	Właściciel
Widzi projekty i kod instalacyjny	✓	✓	✓
Obsługuje zgłoszenia	✓	✓	✓
Tworzy, edytuje i usuwa projekty	—	✓	✓
Zaprasza osoby i zmienia role	—	✓	✓
Zmienia ustawienia przestrzeni	—	✓	✓
Usuwa przestrzeń	—	—	✓

Właściciel to osoba, która założyła przestrzeń. Nie można go usunąć ani zmienić jego roli. Każdy członek może sam opuścić przestrzeń przyciskiem „Opuść”.

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.
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 zgłoszeń z telefonu lub tabletu mają znaczek urządzenia, a tablicę można filtrować po urządzeniu.
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.
Powiadomienia webhook do Make, Zapier, n8n albo Slacka. Integracja z Jirą pojawi się wkrótce.

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
Klient wysyła zgłoszenie przez widget
Podaje imię i e-mail. Nie ustawia hasła ani nie zakłada konta.
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
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 zespołu zostają ukryte.
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
Klient dowiaduje się o poprawce
Po przeniesieniu zgłoszenia do „Rozwiązane” klient dostaje maila, że błąd został naprawiony.

Link „Kopiuj link do portalu” prowadzi do strony logowania portalu. Możesz go dodać do stopki maili albo do instrukcji dla klienta, żeby zawsze mógł wrócić do swoich zgłoszeń.

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
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
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
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
Dokończ scenariusz
Dodaj akcję, np. „Wyślij wiadomość na Slacku”, i użyj w niej pól ze zgłoszenia.

Chcesz tylko podejrzeć, co wysyła Kreskio? Wejdź na webhook.site, skopiuj podany tam adres, dodaj go tutaj i kliknij „Wyślij test”. Wiadomość pojawi się od razu na tamtej stronie.

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
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
Kliknij „Włącz tryb zespołu”
Okno samo się zamknie, a na stronie pojawi się pasek „Tryb zespołu” z Twoim imieniem.
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
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
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.

Tryb zespołu czy rozszerzenie? Rozszerzenie działa na każdej stronie, także bez kodu Kreskio, ale tylko w Chrome i Edge. Tryb zespołu nie wymaga instalacji i działa w każdej przeglądarce, ale tylko tam, gdzie jest widget. Zespół może używać obu.

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”.

1
Pobierz paczkę
Kliknij „Pobierz rozszerzenie” powyżej. Zapisze się plik kreskio-extension.zip.
2
Rozpakuj ją do stałego folderu
Kliknij plik prawym przyciskiem i wybierz „Wyodrębnij wszystkie”. Folder zostaw tam na stałe, np. w Dokumentach. Chrome wczytuje rozszerzenie z tego folderu, więc po jego usunięciu rozszerzenie przestanie działać.
3
Otwórz stronę rozszerzeń w Chrome
Skopiuj adres chrome://extensions, wklej go w pasek adresu i naciśnij Enter.
4
Włącz „Tryb dewelopera”
Przełącznik jest w prawym górnym rogu strony rozszerzeń.
5
Kliknij „Załaduj rozpakowane”
Wskaż rozpakowany folder (ten, w którym jest plik manifest.json). Na liście pojawi się Kreskio.
6
Przypnij ikonę do paska
Kliknij ikonę puzzla obok paska adresu i pinezkę przy Kreskio. Ikona będzie zawsze pod ręką.
7
Połącz z kontem
Kliknij ikonę Kreskio i „Połącz z kontem”. Otworzy się karta Kreskio, w której potwierdzasz połączenie. Gotowe.

Aktualizacja: pobierz nową paczkę, rozpakuj ją w to samo miejsce, zastępując pliki, a potem na stronie chrome://extensions kliknij strzałkę odświeżania przy Kreskio.

Gdy rozszerzenie trafi do Chrome Web Store, instalacja sprowadzi się do jednego kliknięcia „Dodaj do Chrome”, a aktualizacje będą przychodzić same.

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.

Plan, płatności i limity

Nowa przestrzeń ma okres próbny, w którym wszystko działa. 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.

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ą.
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.