Přeskočit na hlavní obsah
DocumentationAPI ReferenceVideo Tutorials

Řešení problémů

Tento průvodce vám pomůže vyřešit běžné problémy s platformou Hanc.AI. Najděte svůj problém níže a postupujte podle kroků řešení.

Rychlá diagnostika​

SymptomPravděpodobná příčinaSekce řešení
Nemohu se přihlásitProblém s účtem/heslemProblémy s účtem
Agent neodpovídáProblém s konfiguracíProblémy s agentem
Nesprávné odpovědiProblém se znalostní bázíProblémy se znalostní bází
Hovory se nespojíProblém s nastavením telefonuProblémy s telefonem
Špatná kvalita zvukuProblém se sítí/nastavenímProblémy se zvukem
Widget se nenačítáProblém s doménou/prohlížečemProblémy s widgetem
Hovor je odpojen s "Bez kreditů"Došly kredityProblémy s kredity
Funkce nefungujeOmezení plánuProblémy s fakturací

Problémy s účtem​

Nemohu se přihlásit​

Symptomy:

  • Přihlašovací stránka zobrazuje chybu
  • Heslo není přijato
  • Účet se zdá zamčený

Řešení:

  1. Zkontrolujte e-mail/heslo

    • Ujistěte se, že je správná e-mailová adresa
    • Zkontrolujte caps lock
    • Zkuste zkopírovat heslo

  2. Resetujte heslo

    • Klikněte na "Zapomenuté heslo"
    • Zkontrolujte e-mail (včetně spamu)
    • Klikněte na odkaz pro reset do 1 hodiny
    • Vytvořte nové heslo

  3. Vymažte data prohlížeče

    • Vymažte cookies pro hanc.ai
    • Vymažte mezipaměť
    • Zkuste anonymní/soukromý režim

  4. Zkuste jiný prohlížeč

    • Chrome, Firefox, Safari nebo Edge
    • Deaktivujte rozšíření prohlížeče

Stále nefunguje? Kontaktujte support@hanc.ai

Nemohu vytvořit účet​

Symptomy:

  • Registrace selže
  • Chyba "E-mail již existuje"
  • Ověřovací kód nedostán

Řešení:

  1. E-mail již registrován

    • Zkuste "Zapomenuté heslo" pro obnovení stávajícího účtu
    • Použijte jiný e-mail

  2. Selhává ověření telefonu

    • Ujistěte se o správném kódu země
    • Zadejte číslo bez úvodní nuly
    • Počkejte 60 sekund před žádostí o nový kód
    • Zkuste jiné telefonní číslo

  3. Chyby stránky

    • Obnovte a zkuste znovu
    • Vymažte mezipaměť prohlížeče
    • Zkuste jiný prohlížeč

Problémy s agentem​

Agent neodpovídá​

Symptomy:

  • Testovací hovor se spojí, ale agent je tichý
  • Agent neříká pozdrav
  • Nekonečné načítání

Diagnostické kroky:

1. Zkontrolujte, že stav agenta je ACTIVE (ne INACTIVE nebo DELETED)
2. Ověřte, že první zpráva (pozdrav) je nastavena
3. Zkontrolujte, že prompt není prázdný
4. Zkontrolujte, že znalostní báze je připojena (pokud relevantní)
5. Zkontrolujte, že máte dostupné kredity

Řešení:

  1. Zkontrolujte stav agenta

    • Přejděte na AI hlasoví agenti
    • Ujistěte se, že stav agenta je ACTIVE
    • Pokud je stav INACTIVE, aktivujte ho z nastavení agenta

  2. Ověřte první zprávu

    • Nastavení agenta → První zpráva
    • Ujistěte se, že je text přítomen
    • Uložte po změnách

  3. Zkontrolujte prompt a znalostní bázi

    • Ujistěte se, že prompt není prázdný
    • Pokud používáte znalostní bázi, ověřte, že je připojena a obsahuje obsah

  4. Otestujte v prohlížeči

    • Klikněte na "Promluvit s agentem"
    • Povolte mikrofon
    • Počkejte na pozdrav

Agent dává nesprávné informace​

Symptomy:

  • Citované nesprávné ceny
  • Uvedené špatné obchodní hodiny
  • Vymyšlené informace

Příčina: Obvykle problém se znalostní bází nebo promptem.

Řešení:

  1. Zkontrolujte obsah znalostní báze

    • Jsou přítomny správné informace?
    • Jsou jasně formátovány?
    • Nějaké konfliktní informace?

  2. Ověřte, že je KB připojena

    • Nastavení agenta → Znalostní báze
    • Vybrána správná KB?

  3. Posilte omezení promptu Přidejte do promptu:

    KRITICKÉ: Používejte pouze informace ze znalostní báze.
    Pokud informace není ve znalostní bázi, řekněte "Tuto informaci nemám."
    NIKDY si nevymýšlejte ceny, hodiny nebo jiné konkrétní detaily.

  4. Snižte teplotu

    • Snižte teplotu na 0,3-0,5
    • Determinističtější odpovědi

Agent nepoužívá znalostní bázi​

Symptomy:

  • Říká "Nevím" pro informace, které existují
  • Obecné odpovědi místo konkrétních

Řešení:

  1. Potvrďte připojení KB

    • Nastavení agenta → sekce Znalostní báze
    • Měla by zobrazit vaši KB vybranou

  2. Zkontrolujte formát obsahu KB

    • Jasné nadpisy
    • Jednoduchá struktura
    • Páry otázka/odpověď pro FAQ

  3. Přidejte formát FAQ

    Otázka: Jaké jsou vaše obchodní hodiny?
    Odpověď: Máme otevřeno pondělí-pátek 9:00-18:00, sobota 10:00-14:00.

  4. Ověřte, že soubor byl správně nahrán

    • Přejděte na Znalostní báze
    • Zkontrolujte, zda se soubor objevuje v seznamu
    • Zkontrolujte, že velikost souboru není nula

Agent nepřestane mluvit​

Symptomy:

  • Velmi dlouhé odpovědi
  • Nečeká na uživatele
  • Zavalující informace

Řešení:

  1. Přidejte do promptu:

    - Udržujte odpovědi na 1-2 věty
    - Klaďte jednu otázku najednou
    - Počkejte, až zákazník odpoví
    - Buďte struční a přímí

  2. Snižte max tokenů

    • Pokud je k dispozici v nastavení
    • Omezuje délku odpovědi

Problémy se znalostní bází​

Nahrání souboru selže​

Symptomy:

  • Chyba při nahrávání
  • Soubor odmítnut
  • Zpracování uvízlo

Řešení:

  1. Zkontrolujte formát souboru

    • Podporované: .pdf, .docx, .doc, .xlsx, .xls, .txt, .md, .csv, .rtf, .json
    • Nepodporované: obrázky, audio, video soubory

  2. Zkontrolujte velikost souboru

    • Maximum 10 MB na soubor
    • Maximum 10 souborů na znalostní bázi
    • Zkuste rozdělit velké dokumenty

  3. Zkontrolujte obsah souboru

    • Není chráněn heslem
    • Není poškozen
    • Obsahuje skutečný text (ne skenované obrázky)

  4. Zkuste jiný formát

    • Konvertujte PDF na .txt nebo .docx
    • Zkopírujte text do nového dokumentu

Informace nebyly nalezeny​

Symptomy:

  • Agent říká "Nevím"
  • Informace existuje v KB, ale není použita

Řešení:

  1. Zlepšete strukturu

    • Jasné nadpisy pro témata
    • Formát FAQ pro běžné otázky
    • Vyhněte se dlouhým odstavcům

  2. Použijte přesné fráze

    • Sladťte s tím, jak se ptají zákazníci
    • Zahrňte variace otázek

  3. Přidejte více kontextu

    • Nejen vypisujte ceny
    • Zahrňte názvy služeb a popisy

Příklad zlepšení:

Špatně:

25, 35, 55

Dobře:

## Ceny stříhání
- Pánské stříhání: 25 €
- Dámské stříhání: 35 €
- Dětské stříhání (do 12 let): 20 €

Problémy s telefonem​

Hovory se nespojí​

Symptomy:

  • Hovory jdou do hlasové schránky nebo chyby
  • Vyzvánění, ale žádná odpověď
  • Hovor okamžitě odpojen

Řešení:

  1. Zkontrolujte připojení telefonního čísla

    • Integrace → Telefonní čísla
    • Stav by měl být "Připojeno"
    • Pokud ne, zkontrolujte své nastavení

  2. Ověřte přiřazení čísla

    • Sekce Telefonní čísla
    • Má číslo přiřazeného agenta?
    • Je agent aktivní?

  3. Zkontrolujte stav telefonního čísla

    • Je číslo aktivní?
    • Má účet kreditní zůstatek?

  4. Otestujte s prohlížečem

    • Použijte "Promluvit s agentem" v dashboardu
    • Pokud to funguje, problém je na straně telefonu

Odpovídá špatný agent​

Symptomy:

  • Očekávaný Agent A, dostali jste Agenta B
  • Špatný pozdrav

Řešení:

  1. Zkontrolujte přiřazení čísla

    • Telefonní čísla → Klikněte na číslo
    • Ověřte správného vybraného příchozího agenta

  2. Zkontrolujte konflikty webhooků

    • Ověřte, že webhook ukazuje na Hanc.AI
    • Žádné jiné služby nezachycují

Problémy se zvukem​

Špatná kvalita hovoru​

Symptomy:

  • Robotický hlas
  • Trhaný zvuk
  • Zpoždění v konverzaci

Řešení:

  1. Zkontrolujte internetové připojení

    • Doporučeno minimum 5 Mbps
    • Kabelové připojení lepší než WiFi

  2. Zkontrolujte síťové podmínky

    • Vysoká latence nebo ztráta paketů degraduje kvalitu hovoru
    • Zkuste jinou síť, pokud je to možné
    • Zavřete aplikace náročné na šířku pásma

  3. Zkontrolujte kompatibilitu prohlížeče

    • Použijte moderní prohlížeč (Chrome, Firefox, Safari, Edge)
    • Ujistěte se, že WebRTC a Web Audio API jsou podporovány
    • Aktualizujte prohlížeč na nejnovější verzi

  4. Zkuste jiný hlas

    • Některé hlasy fungují lépe na různých připojeních
    • Otestujte alternativy v nastavení agenta

  5. Pro testovací hovory v prohlížeči

    • Zavřete ostatní karty/aplikace
    • Použijte kabelová sluchátka, pokud je to možné
    • Zkontrolujte, že mikrofon není ztlumený

Agent nerozumí volajícímu​

Symptomy:

  • Agent žádá o opakování
  • Špatně chápe slova
  • Nesprávná transkripce

Řešení:

  1. Nastavení jazyka

    • Ověřte správný vybraný jazyk
    • Sladťte s očekávaným jazykem volajícího

  2. Prompt pro jasnost Přidejte do promptu:

    Pokud nerozumíte, zdvořile požádejte volajícího, aby zopakoval.

  3. Otestujte rozpoznávání řeči nezávisle

    • Použijte funkci testovacího hovoru
    • Mluvte jasně a poznamenávejte si problémy
    • Může to být přízvuk nebo kvalita zvuku

Problémy s fakturací​

Funkce není dostupná​

Symptomy:

  • Tlačítko je šedé
  • Zpráva "Vyžaduje upgrade"
  • Nemohu vytvořit více agentů

Řešení:

  1. Zkontrolujte aktuální plán

    • Nastavení → Fakturace
    • Přezkoumejte limity plánu a funkce

  2. Nemohu vytvořit agenta

    • Plán Free je omezen na 1 agenta
    • Upgradujte na Starter nebo vyšší pro neomezený počet agentů

  3. Zkontrolujte využití

    • Blízko nebo na limitech?
    • Počkejte na další fakturační cyklus nebo upgradujte

  4. Upgradujte plán

    • Pokud je to potřeba, upgradujte ze stránky Fakturace

Platba selhala​

Symptomy:

  • Chyba "Platba selhala"
  • Služba přerušena
  • Nemohu aktualizovat předplatné

Řešení:

  1. Zkontrolujte detaily karty

    • Není karta expirovaná?
    • Dostatečné prostředky?
    • Správná fakturační adresa?

  2. Kontaktujte banku

    • Mezinárodní platby blokovány?
    • Označení podezřelé aktivity?

  3. Aktualizujte platební metodu

    • Nastavení → Fakturace → Aktualizovat platbu
    • Zkuste jinou kartu

  4. Kontaktujte podporu

Problémy s widgetem​

Widget se nenačítá​

Symptomy:

  • Tlačítko widgetu se neobjeví na webu
  • Widget zobrazuje chybu nebo prázdný prostor
  • Widget se načte, ale hovor se nespojí

Řešení:

  1. Zkontrolujte whitelist domén

    • Přejděte na nastavení widgetu vašeho agenta
    • Ujistěte se, že je doména vašeho webu přidána do seznamu povolených domén
    • Zahrňte všechny variace (s/bez www)

  2. Zkontrolujte požadavky prohlížeče Widget Hanc.AI vyžaduje následující schopnosti prohlížeče:

    • WebGL 2.0 — pro vykreslování UI widgetu
    • Web Audio API — pro zpracování zvuku
    • WebRTC — pro hlasovou komunikaci v reálném čase

    Většina moderních prohlížečů (Chrome, Firefox, Safari, Edge) tyto schopnosti podporuje. Pokud uživatelé hlásí problémy, požádejte je o aktualizaci prohlížeče.

  3. Zkontrolujte vložený kód widgetu

    • Ověřte, že je vložený skript správně umístěn ve vašem HTML
    • Zkontrolujte konzoli prohlížeče kvůli JavaScript chybám
    • Ujistěte se, že žádné ad blockery nebo blockery skriptů nezasahují

  4. Otestujte v anonymním režimu

    • Otevřete svůj web v anonymním/soukromém okně
    • To vyloučí konflikty rozšíření

Problémy s widgetem zpětného volání​

Návštěvník odeslal číslo, ale žádné zpětné volání nepřišlo​

  1. Zkontrolujte, že agent je povolen pro zpětná volání — Otevřete agenta → karta Widgety → zajistěte, že "Povolit widget zpětného volání" je zapnuto, a uložte.
  2. Zkontrolujte, že je odchozí telefonní číslo přiřazeno — Agent potřebuje ověřené odchozí číslo ve svém seznamu čísel. Bez něj odeslání zpětných volání selžou.
  3. Zkontrolujte upozornění o způsobilosti — Karta Widgety zobrazuje banner, pokud kterákoli z (placený plán / odchozí číslo / ověřený e-mail) chybí.
  4. Podívejte se na protokol hovorů agenta — Selhaná zpětná volání se objeví v protokolu s jasným důvodem chyby (např. "cílové číslo nedostupné", "žádné odchozí číslo není k dispozici").
  5. Ověřte, že číslo návštěvníka nebylo zformátováno špatně — Widget validuje proti formátu zvolené země, ale nesoulad země může propustit číslo, které operátor později odmítne.

Zpráva "Fronta plná"​

Každý agent zpracovává až 10 zpětných volání paralelně. Když je fronta na kapacitě, nová odeslání čekají. Počkejte minutu a obnovte — kapacita se vrátí, jakmile probíhající hovory skončí. Pokud to pravidelně potkáváte, zvažte rozdělení provozu mezi více než jednoho agenta.

Země návštěvníka není ve výběru​

Pokrytí je kurátorováno. Pokud potřebujete zemi, která není uvedena, napište e-mail na support@hanc.ai — pokrytí se přidává na základě poptávky.

UI widgetu se zobrazuje v angličtině místo nakonfigurovaného jazyka agenta​

Widget čte jazyk ze tří zdrojů v pořadí priority: HTML atribut locale="…" na vloženém kódu, Jazyk widgetu agenta v dashboardu a poté angličtina jako fallback. Pokud vidíte angličtinu na německé stránce, nastavení agenta může stále být en — změňte ho v kartě Widgety agenta a uložte.

Znovu načtení uprostřed zpětného volání zobrazuje čerstvý formulář, ne stav fronty​

To je neobvyklé — widget se obvykle znovu připojí k probíhajícímu zpětnému volání při znovu načtení. Ujistěte se, že vložený snippet je stejný při obou načteních stránky (stejné agent-id, stejné číslo odeslané ze stejného prohlížeče) a že žádné rozšíření soukromí stránku při znovu načtení nemaže.

Problémy s kredity​

Hovor je odpojen s "Bez kreditů"​

Symptomy:

  • Hovor náhle končí uprostřed konverzace
  • Důvod odpojení ukazuje NO_CREDITS
  • Agent přestane odpovídat během aktivního hovoru

Příčina: Vašemu účtu došly kredity, zatímco probíhal hovor. Platforma odpojuje hovory, když nezbývají žádné kredity k pokrytí využití.

Řešení:

  1. Zkontrolujte kreditní zůstatek

    • Přejděte na Nastavení → Fakturace
    • Přezkoumejte zbývající kredity

  2. Přidejte více kreditů

    • Upgradujte svůj plán pro více měsíčních kreditů
    • Kredity z vašeho předplatného jsou okamžitě k dispozici

  3. Sledujte využití proaktivně

    • Pravidelně přezkoumávejte analytiku pro sledování spotřeby kreditů
    • Nastavte upozornění na využití, pokud jsou k dispozici

  4. Pochopte přenos kreditů

    • Nevyčerpané kredity se přenášejí do dalšího měsíce
    • 100 % vašeho předplatného se konvertuje na kredity

Problémy s prohlížečem​

Stránka se nenačítá​

Řešení:

  1. Obnovte stránku (Ctrl/Cmd + R)
  2. Vymažte mezipaměť (Ctrl/Cmd + Shift + Delete)
  3. Zkuste anonymní režim
  4. Zkuste jiný prohlížeč
  5. Zkontrolujte internetové připojení

Tlačítka nefungují​

Řešení:

  1. Deaktivujte ad blockery pro hanc.ai
  2. Povolte JavaScript
  3. Vymažte cookies
  4. Aktualizujte prohlížeč na nejnovější verzi

Problémy s integracemi​

Telefonní čísla se nepřipojují​

Řešení:

  1. Ověřte nastavení telefonního čísla

    • Je číslo aktivní?
    • Je agent přiřazen?

  2. Zkontrolujte stav účtu

    • Účet aktivní a má kredity?

  3. Zkuste znovu připojit

    • Odpojte a znovu připojte číslo
    • Kontaktujte podporu, pokud problémy přetrvávají

Webhook nepřijímá události​

Řešení:

  1. Ověřte URL

    • URL je veřejně dostupná
    • HTTPS (ne HTTP)
    • Není vyžadována autentizace

  2. Zkontrolujte odpověď serveru

    • Musí vrátit stav 200
    • Do 30 sekund

  3. Otestujte s webhook.site

    • Použijte testovací URL pro ověření odesílání událostí
    • Debugujte odtud

Získání pomoci​

Před kontaktováním podpory​

Shromážděte tyto informace:

  • E-mail účtu
  • Jméno/ID agenta (pokud relevantní)
  • Screenshot chyby
  • Kroky k reprodukci problému
  • Použitý prohlížeč a zařízení

Kontaktujte podporu​

E-mail: support@hanc.ai

Zahrňte:

  • Jasný popis problému
  • Kdy to začalo
  • Co jste zkusili
  • Screenshoty, pokud jsou užitečné

Doba odpovědi:

  • Standardní: Do 24 hodin
  • Pro/Business: Do 4 hodin

Stránka stavu​

Zkontrolujte stav platformy pro výpadky:

  • Oznámení o stavu systému
  • Plánovaná okna údržby
  • Historická dostupnost

Související témata​