Rozwiązywanie problemów

Ten przewodnik pomaga rozwiązać typowe problemy z platformą Hanc.AI. Znajdź swój problem poniżej i wykonaj kroki 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
Błędne odpowiedzi	Problem z bazą wiedzy	Problemy z bazą wiedzy
Połączenia się nie łączą	Problem z konfiguracją telefonu	Problemy z telefonem
„Tego numeru nie można użyć"	Typ numeru jest zablokowany	Mój numer telefonu został odrzucony
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"	Wyczerpano 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ź e-mail/hasło

   • Upewnij się, że adres e-mail jest poprawny
   • Sprawdź Caps Lock
   • Spróbuj skopiować i wkleić hasło

2. Zresetuj hasło

   • Kliknij „Nie pamiętam hasła"
   • Sprawdź e-mail (w tym spam)
   • Kliknij link resetujący w ciągu 1 godziny
   • Utwórz nowe hasło

3. Wyczyść dane przeglądarki

   • Wyczyść pliki cookie dla hanc.ai
   • Wyczyść pamięć podręczną
   • 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 nie udaje się
• Komunikat „Tego numeru nie można użyć, spróbuj innego"
• Nie otrzymano kodu weryfikacyjnego

Rozwiązania:

1. „Tego numeru nie można użyć"

   • Rejestracja zaczyna się od telefonu, a niektóre typy numerów są zablokowane (zobacz Mój numer telefonu został odrzucony poniżej)
   • Numery premium, o podzielonych kosztach i strukturalnie nieprawidłowe nigdy nie są akceptowane — użyj standardowego numeru mobilnego lub stacjonarnego

2. Nie otrzymano kodu weryfikacyjnego

   • Upewnij się, że kod kraju jest poprawny
   • Wprowadź numer bez wiodącego zera
   • Kod przychodzi SMS-em; dla telefonu stacjonarnego, który nie może odbierać SMS-ów, jest dostarczany zamiast tego przez automatyczne połączenie głosowe — odbierz telefon i posłuchaj kodu
   • Kody weryfikacyjne są odczytywane/zapisywane w Twoim języku interfejsu
   • Poczekaj 60 sekund przed poproszeniem o nowy kod
   • Spróbuj innego numeru telefonu

3. Telefon już zarejestrowany

   • Spróbuj „Nie pamiętam hasła" / zaloguj się, aby odzyskać istniejące konto
   • Użyj innego numeru

4. Błędy strony

   • Odśwież i spróbuj ponownie
   • Wyczyść pamięć podręczną 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 ani 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
   • 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 błędne informacje

Objawy:

• Podawane niepoprawne ceny
• Podawane błędne godziny pracy
• Zmyślone informacje

Przyczyna: Zwykle problem z bazą wiedzy lub promptem.

Rozwiązania:

1. Sprawdź treść bazy wiedzy

   • Czy obecne są poprawne informacje?
   • Czy są przejrzyście sformatowane?
   • Czy nie ma sprzecznych informacji?

2. Zweryfikuj, czy KB jest podłączona

   • Ustawienia agenta → Baza wiedzy
   • Czy wybrano poprawną KB?

3. Wzmocnij ograniczenia promptu Dodaj do promptu:

   CRITICAL: Only use information from the knowledge base.
   If information is not in the knowledge base, say "I don't have that information."
   NEVER make up prices, hours, or other specific details.

4. Obniż temperaturę

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

Agent nie używa bazy wiedzy

Objawy:

• Mówi „Nie wiem" o informacjach, które istnieją
• 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

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

3. Dodaj format FAQ

   Q: What are your business hours?
   A: We are open Monday-Friday 9am-6pm, Saturday 10am-2pm.

4. Zweryfikuj, czy plik został poprawnie wgrany

   • Przejdź do Baza wiedzy
   • Sprawdź, czy plik pojawia się na liście
   • Sprawdź, czy rozmiar pliku nie jest zerowy

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:

   - Keep responses to 1-2 sentences
   - Ask one question at a time
   - Wait for the customer to respond
   - Be concise and direct

2. Obniż maks. tokenów

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

---

Problemy z bazą wiedzy

Wgrywanie pliku nie udaje się

Objawy:

• Błąd podczas wgrywania
• 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

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

4. Spróbuj innego formatu

   • Przekonwertuj 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ę

   • Przejrzyste nagłówki dla tematów
   • Format FAQ dla typowych pytań
   • Unikaj długich akapitów

2. Używaj dokładnych fraz

   • Dopasuj do sposobu, w jaki pytają klienci
   • Uwzględnij warianty pytań

3. Dodaj więcej kontekstu

   • Nie tylko wymieniaj ceny
   • Uwzględnij nazwy i opisy usług

Przykład poprawy:

❌ Słabo:

25, 35, 55

✅ Dobrze:

## Haircut Prices
- Men's haircut: €25
- Women's haircut: €35
- Children's haircut (under 12): €20

---

Problemy z telefonem

Połączenia się nie łączą

Objawy:

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

Rozwiązania:

1. Sprawdź połączenie numeru telefonu

   • Integracja → Numery telefonów
   • Status powinien być „Połączono"
   • 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 w przeglądarce

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

Odpowiada niewłaściwy agent

Objawy:

• Oczekiwano Agenta A, otrzymano Agenta B
• Niewłaściwe powitanie

Rozwiązania:

1. Sprawdź przypisanie numeru

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

2. Sprawdź konflikty webhooków

   • Zweryfikuj, czy webhook wskazuje na Hanc.AI
   • Żadne inne usługi nie przechwytują

Mój numer telefonu został odrzucony

Objawy:

• „Tego numeru nie można użyć, spróbuj innego" podczas rejestracji, dodawania lub weryfikacji numeru
• Numer, którego jesteś właścicielem, nie chce się zweryfikować

Przyczyna: Hanc.AI stosuje bramkę numerów telefonów, aby zapobiec nadużyciom związanym z oszustwami telefonicznymi. Niektóre typy numerów są całkowicie zablokowane, a niektóre telefony stacjonarne nie przechodzą automatycznego wyszukiwania u operatora.

Zablokowane typy numerów:

• Numery premium — numery o specjalnej taryfie, które obciążają dzwoniącego opłatą premium
• Numery o podzielonych kosztach — numery ze współdzielonym kosztem (np. w stylu 0180)
• Numery strukturalnie nieprawidłowe — błędna długość lub format dla wybranego kraju
• Niektóre telefony stacjonarne — linie stacjonarne, które nie przechodzą wyszukiwania u operatora

Rozwiązania:

1. Spróbuj innego numeru

   • To rozwiązanie w niemal każdym przypadku
   • Standardowy numer mobilny lub stacjonarny jest akceptowany

2. Sprawdź format

   • Wybrano poprawny kod kraju
   • Brak wiodącego zera po kodzie kraju

3. Weryfikacja telefonu stacjonarnego

   • Telefony stacjonarne nie mogą odbierać SMS-ów, więc kod weryfikacyjny jest dostarczany przez automatyczne połączenie głosowe — odbierz telefon i posłuchaj kodu
   • Kody weryfikacyjne są podawane w Twoim języku interfejsu

4. Nadal zablokowany?

   • Jeśli numer, którego legalnie jesteś właścicielem, jest odrzucany i żadna alternatywa nie działa, skontaktuj się z support@hanc.ai

---

Problemy z dźwiękiem

Słaba jakość połączeń

Objawy:

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

Rozwiązania:

1. Sprawdź połączenie internetowe

   • Zalecane minimum 5 Mbps
   • Połączenie przewodowe lepsze niż WiFi

2. Sprawdź warunki sieciowe

   • Wysokie opóźnienia lub utrata pakietów pogarszają jakość połączeń
   • Spróbuj innej sieci, jeśli to możliwe
   • Zamknij aplikacje zużywające dużo pasma

3. Sprawdź kompatybilność przeglądarki

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

4. Spróbuj innego głosu

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

5. Dla testowych połączeń w przeglądarce

   • Zamknij inne karty/aplikacje
   • Użyj słuchawek przewodowych, 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
• Błędna transkrypcja

Rozwiązania:

1. Ustawienia języka

   • Zweryfikuj, czy wybrano poprawny język
   • Dopasuj do oczekiwanego języka dzwoniącego

2. Prompt dla jasności Dodaj do promptu:

   If you don't understand, politely ask the caller to repeat.

3. Testuj rozpoznawanie mowy niezależnie

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

---

Problemy z rozliczeniami

Funkcja niedostępna

Objawy:

• Przycisk wyszarzony
• Komunikat „Wymagana aktualizacja planu"
• 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
   • Zaktualizuj do Starter lub wyższego, aby uzyskać nieograniczoną liczbę agentów

3. Sprawdź użycie

   • Blisko limitów lub na ich poziomie?
   • Poczekaj na następny cykl rozliczeniowy lub zaktualizuj plan

4. Zaktualizuj plan

   • W razie potrzeby zaktualizuj ze strony Rozliczenia

Płatność nieudana

Objawy:

• Błąd „Płatność nieudana"
• Usługa przerwana
• Nie można zaktualizować subskrypcji

Rozwiązania:

1. Sprawdź dane karty

   • 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 → Zaktualizuj 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 się nie łączy

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 interfejsu 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) to obsługuje. Jeśli użytkownicy zgłaszają problemy, poproś ich o aktualizację przeglądarki.

3. Sprawdź kod osadzenia widgetu

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

4. Testuj w trybie incognito

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

Problemy z widgetem oddzwaniania

Odwiedzający przesłał numer, ale nie nastąpiło oddzwonienie

1. Sprawdź, czy agent jest włączony dla oddzwaniania — Otwórz agenta → zakładka Widgety → upewnij się, że „Włącz widget oddzwaniania" jest włączone i Zapisz.
2. Sprawdź, czy przypisano numer telefonu wychodzącego — Agent potrzebuje zweryfikowanego numeru wychodzącego na swojej liście numerów. Bez niego oddzwaniania zawodzą.
3. Sprawdź alert kwalifikowalności — Zakładka Widgety pokazuje baner, jeśli brakuje któregokolwiek z (plan płatny / numer wychodzący / zweryfikowany e-mail).
4. Spójrz na log połączeń agenta — Nieudane oddzwaniania pojawiają się w logu z jasną przyczyną 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 niezgodność kraju może przepuścić numer, który operator później odrzuci.

Komunikat „Kolejka pełna"

Każdy agent przetwarza do 10 oddzwaniań równolegle. Gdy kolejka jest pełna, nowe zgłoszenia czekają. Poczekaj minutę i odśwież — pojemność wraca, gdy trwające połączenia się kończą. Jeśli regularnie na to trafiasz, rozważ rozłożenie ruchu na więcej niż jednego agenta.

Kraju odwiedzającego nie ma w selektorze

Pokrycie jest kuratorowane. Jeśli potrzebujesz kraju, którego nie ma na liście, napisz na support@hanc.ai — pokrycie jest dodawane na podstawie zapotrzebowania.

Interfejs widgetu wyświetla się po angielsku zamiast w skonfigurowanym języku 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 zapasowy. 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 oddzwaniania pokazuje świeży formularz, a nie status w kolejce

To niezwykłe — widget zwykle ponownie podłącza się do trwającego oddzwaniania przy przeładowaniu. Upewnij się, że fragment osadzenia jest taki sam przy obu ładowaniach strony (ten sam agent-id, ten sam numer przesłany z tej samej przeglądarki) i że żadne rozszerzenie prywatności nie czyści strony przy przeładowaniu.

---

Problemy z kredytami

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

Objawy:

• Połączenie kończy się nagle w środku rozmowy
• Przyczyna rozłączenia pokazuje NO_CREDITS
• Agent przestaje odpowiadać podczas aktywnego połączenia

Przyczyna: Twoje konto wyczerpało kredyty podczas trwającego połączenia. 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

   • Zaktualizuj plan, aby uzyskać więcej miesięcznych kredytów
   • Kredyty z Twojej subskrypcji są dostępne natychmiast

3. Monitoruj użycie proaktywnie

   • Regularnie przeglądaj analitykę, aby śledzić zużycie kredytów
   • Skonfiguruj alerty użycia, jeśli dostępne

4. Zrozum przenoszenie kredytów

   • Niewykorzystane kredyty przechodzą na następny miesiąc
   • 100% opłaty subskrypcyjnej zamienia się na kredyty

---

Problemy z przeglądarką

Strona się nie ładuje

Rozwiązania:

1. Odśwież stronę (Ctrl/Cmd + R)
2. Wyczyść pamięć podręczną (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ść pliki cookie
4. Zaktualizuj przeglądarkę do najnowszej wersji

---

Problemy z integracjami

Numery telefonów się nie łączą

Rozwiązania:

1. Zweryfikuj konfigurację numeru telefonu

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

2. Sprawdź status konta

   • Czy konto jest aktywne i ma kredyty?

3. Spróbuj połączyć ponownie

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

Webhook nie odbiera zdarzeń

Rozwiązania:

1. Zweryfikuj URL

   • URL jest publicznie dostępny
   • HTTPS (nie HTTP)
   • Nie jest wymagane uwierzytelnianie

2. Sprawdź odpowiedź serwera

   • Musi zwracać 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:

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

Kontakt ze wsparciem

E-mail: support@hanc.ai

Dołącz:

• Jasny opis problemu
• Kiedy się zaczął
• Co już 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 o statusie systemu
• Zaplanowane okna konserwacji
• Historyczna dostępność

---

Powiązane tematy

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