Rozwiązywanie problemów

Ten przewodnik pomaga rozwiązywać częste problemy z platformą Hanc.AI. Znajdź swój problem poniżej i postępuj zgodnie z krokami rozwiązania.

Szybka diagnoza

Objaw	Prawdopodobna przyczyna	Sekcja rozwiązania
Nie mogę się zalogować	Problem z kontem/hasłem	Problemy z kontem
Agent nie odpowiada	Problem z konfiguracją	Problemy z agentem
Złe odpowiedzi	Problem z bazą wiedzy	Problemy z bazą wiedzy
Połączenia nie łączą się	Problem z konfiguracją telefonu	Problemy z telefonem
Słaba jakość dźwięku	Problem z siecią/ustawieniami	Problemy z dźwiękiem
Widget się nie ładuje	Problem z domeną/przeglądarką	Problemy z widgetem
Połączenie rozłącza się z „Brak kredytów"	Skończyły się kredyty	Problemy z kredytami
Funkcja nie działa	Ograniczenie planu	Problemy z rozliczeniami

---

Problemy z kontem

Nie mogę się zalogować

Objawy:

• Strona logowania pokazuje błąd
• Hasło nie jest akceptowane
• Konto wydaje się zablokowane

Rozwiązania:

1. Sprawdź email/hasło

   • Upewnij się, że adres email jest poprawny
   • Sprawdź caps lock
   • Spróbuj wkleić hasło

2. Zresetuj hasło

   • Kliknij „Zapomniałem hasła"
   • Sprawdź email (w tym spam)
   • Kliknij link resetujący w ciągu 1 godziny
   • Utwórz nowe hasło

3. Wyczyść dane przeglądarki

   • Wyczyść ciasteczka dla hanc.ai
   • Wyczyść cache
   • Spróbuj trybu incognito/prywatnego

4. Spróbuj innej przeglądarki

   • Chrome, Firefox, Safari lub Edge
   • Wyłącz rozszerzenia przeglądarki

Nadal utknąłeś? Skontaktuj się z support@hanc.ai

Nie mogę utworzyć konta

Objawy:

• Rejestracja się nie powiodła
• Błąd „Email już istnieje"
• Kod weryfikacyjny nie otrzymany

Rozwiązania:

1. Email już zarejestrowany

   • Spróbuj „Zapomniałem hasła", aby odzyskać istniejące konto
   • Użyj innego emaila

2. Weryfikacja telefonu nie działa

   • Upewnij się, że kod kraju jest poprawny
   • Wprowadź numer bez wiodącego zera
   • Poczekaj 60 sekund przed żądaniem nowego kodu
   • Spróbuj innego numeru telefonu

3. Błędy strony

   • Odśwież i spróbuj ponownie
   • Wyczyść cache przeglądarki
   • Spróbuj innej przeglądarki

---

Problemy z agentem

Agent nie odpowiada

Objawy:

• Połączenie testowe łączy się, ale agent milczy
• Agent nie wypowiada powitania
• Nieskończone ładowanie

Kroki diagnostyczne:

1. Sprawdź, czy status agenta to ACTIVE (nie INACTIVE lub DELETED)
2. Zweryfikuj, czy pierwsza wiadomość (powitanie) jest ustawiona
3. Sprawdź, czy prompt nie jest pusty
4. Sprawdź, czy baza wiedzy jest podłączona (jeśli dotyczy)
5. Sprawdź, czy masz dostępne kredyty

Rozwiązania:

1. Sprawdź status agenta

   • Przejdź do Agenci głosowi AI
   • Upewnij się, że status agenta to ACTIVE
   • Jeśli status to INACTIVE, aktywuj go w ustawieniach agenta

2. Zweryfikuj pierwszą wiadomość

   • Ustawienia agenta → Pierwsza wiadomość
   • Upewnij się, że tekst jest obecny
   • Zapisz po zmianach

3. Sprawdź prompt i bazę wiedzy

   • Upewnij się, że prompt nie jest pusty
   • Jeśli używasz bazy wiedzy, zweryfikuj, czy jest podłączona i zawiera treść

4. Testuj w przeglądarce

   • Kliknij „Porozmawiaj z agentem"
   • Zezwól na mikrofon
   • Poczekaj na powitanie

Agent podaje złe informacje

Objawy:

• Cytuje nieprawidłowe ceny
• Podaje błędne godziny pracy
• Wymyślone informacje

Przyczyna: Zwykle problem z bazą wiedzy lub promptem.

Rozwiązania:

1. Sprawdź treść bazy wiedzy

   • Czy poprawna informacja jest obecna?
   • Czy jest jasno sformatowana?
   • Jakieś sprzeczne informacje?

2. Zweryfikuj, czy KB jest podłączona

   • Ustawienia agenta → Baza wiedzy
   • Poprawna KB wybrana?

3. Wzmocnij ograniczenia promptu Dodaj do promptu:

   KRYTYCZNE: Używaj tylko informacji z bazy wiedzy.
   Jeśli informacji nie ma w bazie wiedzy, powiedz „Nie mam tej informacji."
   NIGDY nie wymyślaj cen, godzin ani innych konkretnych szczegółów.

4. Obniż temperaturę

   • Zmniejsz temperaturę do 0,3-0,5
   • Bardziej deterministyczne odpowiedzi

Agent nie używa bazy wiedzy

Objawy:

• Mówi „nie wiem" dla informacji, która istnieje
• Ogólne odpowiedzi zamiast konkretnych

Rozwiązania:

1. Potwierdź, że KB jest podłączona

   • Ustawienia agenta → sekcja Baza wiedzy
   • Powinna pokazywać wybraną Twoją KB

2. Sprawdź format treści KB

   • Jasne nagłówki
   • Prosta struktura
   • Pary pytanie/odpowiedź dla FAQ

3. Dodaj format FAQ

   P: Jakie są wasze godziny pracy?
   O: Jesteśmy otwarci od poniedziałku do piątku 9:00-18:00, w sobotę 10:00-14:00.

4. Zweryfikuj, czy plik został przesłany poprawnie

   • Przejdź do Bazy wiedzy
   • Sprawdź, czy plik pojawia się na liście
   • Sprawdź, czy rozmiar pliku nie wynosi zero

Agent nie chce przestać mówić

Objawy:

• Bardzo długie odpowiedzi
• Nie czeka na użytkownika
• Przytłaczające informacje

Rozwiązania:

1. Dodaj do promptu:

   - Trzymaj odpowiedzi w 1-2 zdaniach
   - Zadawaj jedno pytanie naraz
   - Czekaj, aż klient odpowie
   - Bądź zwięzły i bezpośredni

2. Obniż max tokens

   • Jeśli dostępne w ustawieniach
   • Ogranicza długość odpowiedzi

---

Problemy z bazą wiedzy

Przesyłanie pliku nie powiodło się

Objawy:

• Błąd podczas przesyłania
• Plik odrzucony
• Przetwarzanie utknęło

Rozwiązania:

1. Sprawdź format pliku

   • Obsługiwane: .pdf, .docx, .doc, .xlsx, .xls, .txt, .md, .csv, .rtf, .json
   • Nieobsługiwane: pliki obrazów, audio, wideo

2. Sprawdź rozmiar pliku

   • Maksymalnie 10 MB na plik
   • Maksymalnie 10 plików na bazę wiedzy
   • Spróbuj podzielić duże dokumenty

3. Sprawdź treść pliku

   • Nie chroniony hasłem
   • Nieuszkodzony
   • Zawiera rzeczywisty tekst (nie zeskanowane obrazy)

4. Spróbuj innego formatu

   • Konwertuj PDF na .txt lub .docx
   • Skopiuj tekst do nowego dokumentu

Informacja nie znaleziona

Objawy:

• Agent mówi „nie wiem"
• Informacja istnieje w KB, ale nie jest używana

Rozwiązania:

1. Popraw strukturę

   • Jasne nagłówki dla tematów
   • Format FAQ dla częstych pytań
   • Unikaj długich akapitów

2. Używaj dokładnych fraz

   • Dopasuj, jak klienci pytają
   • Uwzględnij warianty pytań

3. Dodaj więcej kontekstu

   • Nie wypisuj tylko cen
   • Uwzględnij nazwy usług i opisy

Przykładowe ulepszenie:

Słabo:

25, 35, 55

Dobrze:

## Ceny strzyżenia
- Strzyżenie męskie: 25 €
- Strzyżenie damskie: 35 €
- Strzyżenie dziecięce (do 12 lat): 20 €

---

Problemy z telefonem

Połączenia nie łączą się

Objawy:

• Połączenia trafiają na pocztę głosową lub błąd
• Dzwoni, ale brak odpowiedzi
• Połączenie zerwane natychmiast

Rozwiązania:

1. Sprawdź podłączenie numeru telefonu

   • Integracja → Numery telefonów
   • Status powinien być „Połączony"
   • Jeśli nie, sprawdź swoją konfigurację

2. Zweryfikuj przypisanie numeru

   • Sekcja Numery telefonów
   • Czy numer ma przypisanego agenta?
   • Czy agent jest aktywny?

3. Sprawdź status numeru telefonu

   • Czy numer jest aktywny?
   • Czy konto ma saldo kredytów?

4. Testuj z przeglądarką

   • Użyj „Porozmawiaj z agentem" w panelu
   • Jeśli to działa, problem jest po stronie telefonu

Zły agent odpowiada

Objawy:

• Oczekiwany Agent A, otrzymano Agenta B
• Złe powitanie

Rozwiązania:

1. Sprawdź przypisanie numeru

   • Numery telefonów → Kliknij numer
   • Zweryfikuj poprawnego agenta przychodzącego

2. Sprawdź konflikty webhooków

   • Zweryfikuj, czy webhook wskazuje na Hanc.AI
   • Brak innych usług przechwytujących

---

Problemy z dźwiękiem

Słaba jakość połączenia

Objawy:

• Robotyczny głos
• Przerywany dźwięk
• Opóźnienia w rozmowie

Rozwiązania:

1. Sprawdź połączenie internetowe

   • Minimum 5 Mb/s zalecane
   • Połączenie przewodowe lepsze niż WiFi

2. Sprawdź warunki sieci

   • Wysokie opóźnienie lub utrata pakietów obniża jakość połączenia
   • Spróbuj innej sieci, jeśli to możliwe
   • Zamknij aplikacje obciążające pasmo

3. Sprawdź kompatybilność przeglądarki

   • Użyj nowoczesnej przeglądarki (Chrome, Firefox, Safari, Edge)
   • Upewnij się, że WebRTC i Web Audio API są wspierane
   • Zaktualizuj przeglądarkę do najnowszej wersji

4. Spróbuj innego głosu

   • Niektóre głosy działają lepiej na różnych połączeniach
   • Przetestuj alternatywy w ustawieniach agenta

5. Dla testowych połączeń przeglądarki

   • Zamknij inne karty/aplikacje
   • Użyj zestawu słuchawkowego przewodowego, jeśli to możliwe
   • Sprawdź, czy mikrofon nie jest wyciszony

Agent nie rozumie dzwoniącego

Objawy:

• Agent prosi o powtórzenie
• Źle rozumie słowa
• Zła transkrypcja

Rozwiązania:

1. Ustawienia języka

   • Zweryfikuj wybrany poprawny język
   • Dopasuj do oczekiwanego języka dzwoniącego

2. Prompt dla jasności Dodaj do promptu:

   Jeśli nie rozumiesz, uprzejmie poproś dzwoniącego o powtórzenie.

3. Testuj rozpoznawanie mowy niezależnie

   • Użyj funkcji testowego połączenia
   • Mów wyraźnie i zanotuj problemy
   • Może to być akcent lub jakość audio

---

Problemy z rozliczeniami

Funkcja niedostępna

Objawy:

• Przycisk wyszarzony
• Komunikat „Wymagana aktualizacja"
• Nie można utworzyć więcej agentów

Rozwiązania:

1. Sprawdź bieżący plan

   • Ustawienia → Rozliczenia
   • Przejrzyj limity i funkcje planu

2. Nie można utworzyć agenta

   • Plan Free jest ograniczony do 1 agenta
   • Uaktualnij do Starter lub wyższego dla nielimitowanych agentów

3. Sprawdź użycie

   • Blisko lub w limitach?
   • Poczekaj na następny cykl rozliczeniowy lub uaktualnij

4. Uaktualnij plan

   • Jeśli potrzebne, uaktualnij ze strony Rozliczeń

Płatność nie powiodła się

Objawy:

• Błąd „Płatność nie powiodła się"
• Usługa przerwana
• Nie można zaktualizować subskrypcji

Rozwiązania:

1. Sprawdź szczegóły karty

   • Czy karta nie wygasła?
   • Wystarczające środki?
   • Poprawny adres rozliczeniowy?

2. Skontaktuj się z bankiem

   • Płatności międzynarodowe zablokowane?
   • Flaga podejrzanej aktywności?

3. Zaktualizuj metodę płatności

   • Ustawienia → Rozliczenia → Aktualizuj płatność
   • Spróbuj innej karty

4. Skontaktuj się ze wsparciem

   • Jeśli problemy się utrzymują
   • support@hanc.ai

---

Problemy z widgetem

Widget się nie ładuje

Objawy:

• Przycisk widgetu nie pojawia się na stronie
• Widget pokazuje błąd lub puste miejsce
• Widget się ładuje, ale połączenie nie nawiązuje

Rozwiązania:

1. Sprawdź białą listę domen

   • Przejdź do ustawień widgetu swojego agenta
   • Upewnij się, że domena Twojej strony jest dodana do listy dozwolonych domen
   • Uwzględnij wszystkie warianty (z/bez www)

2. Sprawdź wymagania przeglądarki Widget Hanc.AI wymaga następujących możliwości przeglądarki:

   • WebGL 2.0 — do renderowania UI widgetu
   • Web Audio API — do przetwarzania dźwięku
   • WebRTC — do komunikacji głosowej w czasie rzeczywistym

   Większość nowoczesnych przeglądarek (Chrome, Firefox, Safari, Edge) je wspiera. Jeśli użytkownicy zgłaszają problemy, poproś ich o aktualizację przeglądarki.

3. Sprawdź kod osadzania widgetu

   • Zweryfikuj, czy skrypt osadzania jest poprawnie umieszczony w HTML
   • Sprawdź konsolę przeglądarki pod kątem błędów JavaScript
   • Upewnij się, że żadne blokery reklam ani blokery skryptów nie ingerują

4. Testuj w trybie incognito

   • Otwórz swoją stronę w oknie incognito/prywatnym
   • To wyklucza konflikty rozszerzeń

Problemy z widgetem oddzwaniania

Odwiedzający wysłał numer, ale oddzwonienie nie przyszło

1. Sprawdź, czy agent ma włączone oddzwonienia — Otwórz agenta → zakładka Widgety → upewnij się, że „Włącz widget oddzwaniania" jest włączone, i Zapisz.
2. Sprawdź, czy wychodzący numer telefonu jest przypisany — Agent potrzebuje zweryfikowanego wychodzącego numeru na swojej liście numerów. Bez niego wysyłki oddzwonienia nie powiodą się.
3. Sprawdź alert wymagań — Zakładka Widgety pokazuje baner, jeśli brakuje którejś z (płatny plan / wychodzący numer / zweryfikowany email).
4. Spójrz na log połączeń agenta — Nieudane oddzwonienia pojawiają się w logu z jasnym powodem błędu (np. „numer docelowy nieosiągalny", „brak dostępnego numeru wychodzącego").
5. Zweryfikuj, czy numer odwiedzającego nie był zniekształcony — Widget waliduje względem formatu wybranego kraju, ale niedopasowanie kraju może przepuścić numer, który operator później odrzuci.

Komunikat „Kolejka pełna"

Każdy agent przetwarza do 10 oddzwonień równolegle. Gdy kolejka jest na maksimum, nowe wysłania czekają. Poczekaj minutę i odśwież — przepustowość wraca, gdy połączenia w toku się kończą. Jeśli regularnie to napotykasz, rozważ podział ruchu na więcej niż jednego agenta.

Kraju odwiedzającego nie ma w selektorze

Zasięg jest wyselekcjonowany. Jeśli potrzebujesz kraju, którego nie ma na liście, napisz na support@hanc.ai — zasięg jest dodawany na podstawie zapotrzebowania.

UI widgetu pokazuje się po angielsku zamiast skonfigurowanego języka agenta

Widget odczytuje język z trzech źródeł, w kolejności priorytetu: atrybut HTML locale="…" na osadzeniu, Język widgetu agenta w panelu, a następnie angielski jako fallback. Jeśli widzisz angielski na niemieckiej stronie, ustawienie agenta może nadal być en — zmień je w zakładce Widgety agenta i zapisz.

Przeładowanie w trakcie oddzwonienia pokazuje świeży formularz, a nie status w kolejce

To nietypowe — widget normalnie ponownie łączy się z oddzwonieniem w toku po przeładowaniu. Upewnij się, że fragment osadzania jest taki sam na obu ładowaniach strony (ten sam agent-id, ten sam numer wysłany z tej samej przeglądarki) i że żadne rozszerzenie prywatności nie wyciera strony przy przeładowaniu.

---

Problemy z kredytami

Połączenie rozłącza się z „Brak kredytów"

Objawy:

• Połączenie nagle kończy się w trakcie rozmowy
• Powód rozłączenia pokazuje NO_CREDITS
• Agent przestaje odpowiadać podczas aktywnego połączenia

Przyczyna: Twoje konto wyczerpało kredyty, gdy połączenie było w toku. Platforma rozłącza połączenia, gdy nie ma pozostałych kredytów na pokrycie użycia.

Rozwiązania:

1. Sprawdź swoje saldo kredytów

   • Przejdź do Ustawienia → Rozliczenia
   • Przejrzyj pozostałe kredyty

2. Dodaj więcej kredytów

   • Uaktualnij swój plan dla większej liczby miesięcznych kredytów
   • Kredyty z Twojej subskrypcji są dostępne natychmiast

3. Monitoruj użycie proaktywnie

   • Przeglądaj analitykę regularnie, aby śledzić zużycie kredytów
   • Ustaw alerty użycia, jeśli dostępne

4. Zrozum przenoszenie kredytów

   • Niewykorzystane kredyty przenoszą się na następny miesiąc
   • 100% Twojej opłaty subskrypcyjnej konwertuje się na kredyty

---

Problemy z przeglądarką

Strona się nie ładuje

Rozwiązania:

1. Odśwież stronę (Ctrl/Cmd + R)
2. Wyczyść cache (Ctrl/Cmd + Shift + Delete)
3. Spróbuj trybu incognito
4. Spróbuj innej przeglądarki
5. Sprawdź połączenie internetowe

Przyciski nie działają

Rozwiązania:

1. Wyłącz blokery reklam dla hanc.ai
2. Włącz JavaScript
3. Wyczyść ciasteczka
4. Zaktualizuj przeglądarkę do najnowszej wersji

---

Problemy z integracją

Numery telefonów nie łączą się

Rozwiązania:

1. Zweryfikuj konfigurację numeru telefonu

   • Czy numer jest aktywny?
   • Czy agent jest przypisany?

2. Sprawdź status konta

   • Konto aktywne i ma kredyty?

3. Spróbuj ponownie podłączyć

   • Odłącz i ponownie podłącz numer
   • Skontaktuj się ze wsparciem, jeśli problemy się utrzymują

Webhook nie otrzymuje zdarzeń

Rozwiązania:

1. Zweryfikuj URL

   • URL publicznie dostępny
   • HTTPS (nie HTTP)
   • Brak wymaganego uwierzytelniania

2. Sprawdź odpowiedź serwera

   • Musi zwrócić status 200
   • W ciągu 30 sekund

3. Testuj z webhook.site

   • Użyj testowego URL, aby zweryfikować wysyłanie zdarzeń
   • Debuguj stamtąd

---

Uzyskiwanie pomocy

Przed skontaktowaniem się ze wsparciem

Zbierz te informacje:

• Email konta
• Nazwa/ID agenta (jeśli dotyczy)
• Zrzut ekranu błędu
• Kroki do odtworzenia problemu
• Używana przeglądarka i urządzenie

Skontaktuj się ze wsparciem

Email: support@hanc.ai

Uwzględnij:

• Jasny opis problemu
• Kiedy się zaczął
• Co próbowałeś
• Zrzuty ekranu, jeśli pomocne

Czas odpowiedzi:

• Standardowy: W ciągu 24 godzin
• Pro/Business: W ciągu 4 godzin

---

Strona statusu

Sprawdź status platformy pod kątem awarii:

• Ogłoszenia statusu systemu
• Planowane okna konserwacji
• Historyczna dostępność

---

Powiązane tematy

• Przegląd platformy — Przewodnik po interfejsie
• Agenci głosowi AI — Konfiguracja agenta
• Baza wiedzy — Najlepsze praktyki KB
• Integracje — Konfiguracja integracji