Ugrás a fő tartalomhoz
DocumentationAPI ReferenceVideo Tutorials

Hibaelhárítás

Ez az útmutató segít megoldani a Hanc.AI platform gyakori problémáit. Keresd meg a problémádat alább, és kövesd a megoldási lépéseket.

Gyors diagnózis​

TünetValószínű okMegoldás-szakasz
Nem tudok belépniFiók/jelszó problémaFiókproblémák
Az ügynök nem reagálKonfigurációs problémaÜgynök-problémák
Rossz válaszokTudásbázis-problémaTudásbázis-problémák
A hívások nem csatlakoznakTelefon-beállítási problémaTelefon-problémák
Gyenge hangminőségHálózati/beállítási problémaAudio-problémák
A widget nem töltődik beDomain/böngésző problémaWidget-problémák
A hívás megszakad „No Credits" üzenettelElfogyott a kreditKredit-problémák
Egy funkció nem működikCsomag-korlátozásSzámlázási problémák

Fiókproblémák​

Nem tudok belépni​

Tünetek:

  • A bejelentkezési oldal hibát mutat
  • A jelszó nincs elfogadva
  • A fiók zároltnak tűnik

Megoldások:

  1. Ellenőrizd az e-mailt/jelszót

    • Győződj meg a helyes e-mail-címről
    • Ellenőrizd a Caps Lockot
    • Próbáld a jelszót másolás-beillesztéssel

  2. Állítsd vissza a jelszót

    • Kattints a „Forgot Password" gombra
    • Ellenőrizd az e-mailed (beleértve a spam mappát is)
    • Kattints a visszaállító linkre 1 órán belül
    • Hozz létre új jelszót

  3. Töröld a böngészőadatokat

    • Töröld a hanc.ai sütijeit
    • Töröld a gyorsítótárat
    • Próbáld inkognitó/privát módban

  4. Próbálj másik böngészőt

    • Chrome, Firefox, Safari vagy Edge
    • Tiltsd le a böngésző-bővítményeket

Még mindig elakadtál? Lépj kapcsolatba a support@hanc.ai címmel.

Nem tudok fiókot létrehozni​

Tünetek:

  • A regisztráció meghiúsul
  • „Email already exists" hiba
  • Nem érkezik meg a megerősítő kód

Megoldások:

  1. Az e-mail már regisztrálva

    • Próbáld a „Forgot Password" funkciót a meglévő fiók visszaállításához
    • Használj másik e-mailt

  2. A telefon-ellenőrzés meghiúsul

    • Győződj meg a helyes országhívóról
    • Add meg a számot vezető nulla nélkül
    • Várj 60 másodpercet, mielőtt új kódot kérnél
    • Próbálj másik telefonszámot

  3. Oldalhibák

    • Frissítsd és próbáld újra
    • Töröld a böngésző gyorsítótárát
    • Próbálj másik böngészőt

Ügynök-problémák​

Az ügynök nem reagál​

Tünetek:

  • A teszthívás csatlakozik, de az ügynök néma
  • Az ügynök nem mondja el az üdvözlést
  • Végtelen betöltés

Diagnosztikai lépések:

1. Ellenőrizd, hogy az ügynök státusza AKTÍV (nem INAKTÍV vagy TÖRÖLT)
2. Ellenőrizd, hogy az első üzenet (üdvözlés) be van állítva
3. Ellenőrizd, hogy a prompt nem üres
4. Ellenőrizd, hogy a tudásbázis csatlakoztatva van (ha alkalmazható)
5. Ellenőrizd, hogy van elérhető krediteid

Megoldások:

  1. Ellenőrizd az ügynök státuszát

    • Lépj a Voice Agents menüpontra
    • Győződj meg, hogy az ügynök státusza ACTIVE
    • Ha a státusz INACTIVE, aktiváld az ügynök beállításaiból

  2. Ellenőrizd az első üzenetet

    • Ügynök beállításai → Első üzenet
    • Győződj meg, hogy van szöveg
    • Mentsd a változtatások után

  3. Ellenőrizd a promptot és a tudásbázist

    • Győződj meg, hogy a prompt nem üres
    • Ha tudásbázist használsz, ellenőrizd, hogy csatlakoztatva van és tartalmaz tartalmat

  4. Tesztelj böngészőben

    • Kattints a „Talk to agent" gombra
    • Engedélyezd a mikrofont
    • Várd meg az üdvözlést

Az ügynök rossz információt ad​

Tünetek:

  • Helytelen árak idézése
  • Rossz nyitvatartás közlése
  • Kitalált információ

Ok: Általában tudásbázis- vagy prompt-probléma.

Megoldások:

  1. Ellenőrizd a tudásbázis tartalmát

    • Jelen van a helyes információ?
    • Világosan formázott?
    • Vannak ellentmondó információk?

  2. Ellenőrizd, hogy a KB csatlakoztatva van

    • Ügynök beállításai → Knowledge Base
    • A helyes KB van kiválasztva?

  3. Erősítsd meg a prompt-korlátozásokat Add hozzá a prompthoz:

    KRITIKUS: Csak a tudásbázisból származó információt használd.
    Ha az információ nincs a tudásbázisban, mondd „Nincs ilyen információm."
    SOHA NE találj ki árakat, nyitvatartást vagy más konkrét részleteket.

  4. Csökkentsd a temperature-t

    • Csökkentsd a temperature-t 0,3–0,5-re
    • Determinisztikusabb válaszok

Az ügynök nem használja a tudásbázist​

Tünetek:

  • „Nem tudom"-ot mond olyan információra, ami létezik
  • Általános válaszok konkrét helyett

Megoldások:

  1. Erősítsd meg, hogy a KB csatlakoztatva van

    • Ügynök beállításai → Knowledge Base szakasz
    • Mutatnia kell a kiválasztott KB-t

  2. Ellenőrizd a KB tartalom formátumát

    • Világos címsorok
    • Egyszerű struktúra
    • Kérdés/válasz párok GYIK-hez

  3. Adj hozzá GYIK formátumot

    K: Mi a nyitvatartás?
    V: Hétfő–péntek 9:00–18:00, szombat 10:00–14:00.

  4. Ellenőrizd, hogy a fájl megfelelően lett feltöltve

    • Lépj a Knowledge Base menüpontra
    • Ellenőrizd, hogy a fájl megjelenik a listában
    • Ellenőrizd, hogy a fájlméret nem nulla

Az ügynök nem hagyja abba a beszédet​

Tünetek:

  • Nagyon hosszú válaszok
  • Nem vár a felhasználóra
  • Túlterhelő információ

Megoldások:

  1. Add hozzá a prompthoz:

    - Tartsd a válaszokat 1-2 mondatban
    - Egyszerre egy kérdést tegyél fel
    - Várj az ügyfél válaszára
    - Légy tömör és közvetlen

  2. Csökkentsd a max tokent

    • Ha elérhető a beállításokban
    • Korlátozza a válasz hosszát

Tudásbázis-problémák​

A fájlfeltöltés meghiúsul​

Tünetek:

  • Hiba feltöltéskor
  • Fájl elutasítva
  • Feldolgozás elakadt

Megoldások:

  1. Ellenőrizd a fájlformátumot

    • Támogatott: .pdf, .docx, .doc, .xlsx, .xls, .txt, .md, .csv, .rtf, .json
    • Nem támogatott: kép-, audio-, videofájlok

  2. Ellenőrizd a fájlméretet

    • Maximum 10 MB fájlonként
    • Maximum 10 fájl tudásbázisonként
    • Próbáld nagy dokumentumokat felosztani

  3. Ellenőrizd a fájltartalmat

    • Nem jelszóval védett
    • Nem sérült
    • Tényleges szöveget tartalmaz (nem szkennelt képeket)

  4. Próbálj másik formátumot

    • Konvertáld a PDF-et .txt vagy .docx formátumba
    • Másold a szöveget új dokumentumba

Nem található meg az információ​

Tünetek:

  • Az ügynök „Nem tudom"-ot mond
  • Az információ létezik a KB-ben, de nem használja

Megoldások:

  1. Javítsd a struktúrát

    • Világos címsorok témákhoz
    • GYIK formátum gyakori kérdésekhez
    • Kerüld a hosszú bekezdéseket

  2. Használj pontos kifejezéseket

    • Illeszkedj ahhoz, ahogy az ügyfelek kérdeznek
    • Tartalmazz a kérdések variációit

  3. Adj hozzá több kontextust

    • Ne csak árakat listázz
    • Tartalmazz szolgáltatás-neveket és leírásokat

Példa-javítás:

❌ Rossz:

25, 35, 55

✅ Jó:

## Hajvágási árak
- Férfi hajvágás: 25 €
- Női hajvágás: 35 €
- Gyermek hajvágás (12 év alatt): 20 €

Telefon-problémák​

A hívások nem csatlakoznak​

Tünetek:

  • A hívások hangpostára vagy hibára kerülnek
  • Cseng, de nincs válasz
  • A hívás azonnal megszakad

Megoldások:

  1. Ellenőrizd a telefonszám-kapcsolatot

    • Integration → Phone Numbers
    • A státusznak „Connected"-nek kell lennie
    • Ha nem, ellenőrizd a beállítást

  2. Ellenőrizd a szám hozzárendelését

    • Phone Numbers szakasz
    • A számnak van hozzárendelt ügynöke?
    • Az ügynök aktív?

  3. Ellenőrizd a telefonszám státuszát

    • A szám aktív?
    • A fiókodnak van kreditegyenlege?

  4. Tesztelj böngészővel

    • Használd a „Talk to agent" funkciót az irányítópulton
    • Ha ez működik, a probléma telefon-oldali

Rossz ügynök válaszol​

Tünetek:

  • Az A ügynököt vártad, a B ügynököt kaptad
  • Rossz üdvözlés

Megoldások:

  1. Ellenőrizd a szám hozzárendelését

    • Phone Numbers → Kattints a számra
    • Ellenőrizd a helyes bejövő ügynök kiválasztását

  2. Ellenőrizd a webhook-ütközéseket

    • Ellenőrizd, hogy a webhook a Hanc.AI-ra mutat
    • Nincs más szolgáltatás, amely elfogja

Audio-problémák​

Gyenge hívásminőség​

Tünetek:

  • Robothang
  • Akadozó audio
  • Késések a beszélgetésben

Megoldások:

  1. Ellenőrizd az internetkapcsolatot

    • Minimum 5 Mbps ajánlott
    • A vezetékes kapcsolat jobb, mint a WiFi

  2. Ellenőrizd a hálózati körülményeket

    • A magas késleltetés vagy csomag-veszteség rontja a hívásminőséget
    • Ha lehetséges, próbálj másik hálózatot
    • Zárj be sávszélesség-igényes alkalmazásokat

  3. Ellenőrizd a böngésző-kompatibilitást

    • Használj modern böngészőt (Chrome, Firefox, Safari, Edge)
    • Győződj meg, hogy a WebRTC és a Web Audio API támogatott
    • Frissítsd a böngészőt a legújabb verzióra

  4. Próbálj másik hangot

    • Egyes hangok jobban teljesítenek különböző kapcsolatokon
    • Tesztelj alternatívákat az ügynök beállításaiban

  5. Böngészős teszthívásokhoz

    • Zárd be a többi lapot/alkalmazást
    • Ha lehetséges, használj vezetékes headsetet
    • Ellenőrizd, hogy a mikrofon nincs némítva

Az ügynök nem érti a hívót​

Tünetek:

  • Az ügynök ismétlést kér
  • Félreérti a szavakat
  • Rossz átirat

Megoldások:

  1. Nyelvi beállítások

    • Ellenőrizd a helyes nyelv kiválasztását
    • Egyezzen a hívó elvárt nyelvével

  2. Prompt a tisztaságért Add hozzá a prompthoz:

    Ha nem érted, udvariasan kérd meg a hívót, hogy ismételje.

  3. Tesztelj beszédfelismerést önállóan

    • Használd a teszthívás funkciót
    • Beszélj világosan és jegyezd fel a problémákat
    • Lehet akcentus vagy hangminőség

Számlázási problémák​

A funkció nem elérhető​

Tünetek:

  • A gomb szürkített
  • „Upgrade required" üzenet
  • Nem tudok több ügynököt létrehozni

Megoldások:

  1. Ellenőrizd a jelenlegi csomagot

    • Settings → Billing
    • Tekintsd át a csomag-korlátozásokat és funkciókat

  2. Nem tudok ügynököt létrehozni

    • A Free csomag 1 ügynökre korlátozott
    • Frissíts Starter vagy magasabb csomagra korlátlan ügynökért

  3. Ellenőrizd a használatot

    • Közel vagy a korláthoz?
    • Várj a következő számlázási ciklusig, vagy frissíts

  4. Csomag frissítése

    • Ha szükséges, frissíts a Billing oldalról

A fizetés meghiúsult​

Tünetek:

  • „Payment failed" hiba
  • A szolgáltatás megszakadt
  • Nem tudom frissíteni az előfizetést

Megoldások:

  1. Ellenőrizd a kártya-adatokat

    • A kártya nem járt le?
    • Elegendő fedezet?
    • Helyes számlázási cím?

  2. Lépj kapcsolatba a bankkal

    • Nemzetközi fizetések blokkolva?
    • Gyanús tevékenység jelzése?

  3. Frissítsd a fizetési módot

    • Settings → Billing → Update Payment
    • Próbálj másik kártyát

  4. Lépj kapcsolatba a támogatással

Widget-problémák​

A widget nem töltődik be​

Tünetek:

  • A widget-gomb nem jelenik meg a weboldalon
  • A widget hibát vagy üres helyet mutat
  • A widget betöltődik, de a hívás nem csatlakozik

Megoldások:

  1. Ellenőrizd a domain-engedélylistát

    • Lépj az ügynök widget-beállításaira
    • Győződj meg, hogy a weboldalad domainje hozzá van adva az engedélyezett domainek listájához
    • Tartalmazzon minden variációt (www-vel/anélkül)

  2. Ellenőrizd a böngésző-követelményeket A Hanc.AI widget az alábbi böngésző-képességeket igényli:

    • WebGL 2.0 — a widget UI megjelenítéséhez
    • Web Audio API — audio-feldolgozáshoz
    • WebRTC — valós idejű hangkommunikációhoz

    A legtöbb modern böngésző (Chrome, Firefox, Safari, Edge) támogatja ezeket. Ha a felhasználók problémát jelentenek, kérd meg őket, hogy frissítsék a böngészőjüket.

  3. Ellenőrizd a widget-beágyazó kódot

    • Ellenőrizd, hogy a beágyazó szkript helyesen van a HTML-edben
    • Ellenőrizd a böngésző konzolt JavaScript-hibákra
    • Győződj meg, hogy nincs hirdetésblokkoló vagy szkript-blokkoló, amely zavar

  4. Tesztelj inkognitó módban

    • Nyisd meg a weboldalad egy inkognitó/privát ablakban
    • Ez kizárja a bővítmény-ütközéseket

Callback Widget problémák​

A látogató beküldött egy számot, de nem jött visszahívás​

  1. Ellenőrizd, hogy az ügynök engedélyezve van a visszahívásokhoz — Nyisd meg az ügynököt → Widgets lap → győződj meg, hogy az „Enable callback widget" be van kapcsolva, és mentsd.
  2. Ellenőrizd, hogy a kimenő telefonszám hozzá van rendelve — Az ügynöknek egy ellenőrzött kimenő számra van szüksége a számlistáján. Anélkül a visszahívás-küldések meghiúsulnak.
  3. Ellenőrizd a jogosultsági figyelmeztetést — A Widgets lap egy bannert jelenít meg, ha bármi (fizetős csomag / kimenő szám / ellenőrzött e-mail) hiányzik.
  4. Nézd meg az ügynök hívásnaplóját — A meghiúsult visszahívások egyértelmű hibaokkal jelennek meg a naplóban (pl. „destination number unreachable", „no outbound number available").
  5. Ellenőrizd, hogy a látogató száma nem volt-e rossz formátumú — A widget a kiválasztott ország formátumához validál, de egy ország-eltérés átengedhet egy olyan számot, amelyet a szolgáltató később elutasít.

„Queue full" üzenet​

Minden ügynök legfeljebb 10 visszahívást dolgoz fel párhuzamosan. Amikor a sor megtelt, az új beküldések várakoznak. Várj egy percet és frissíts — a kapacitás visszatér, ahogy a folyamatban lévő hívások befejeződnek. Ha rendszeresen ütközöl ebbe, fontold meg a forgalom megosztását több ügynök között.

A látogató országa nincs a választóban​

A lefedettség gondozott. Ha olyan országra van szükséged, amely nincs felsorolva, írj a support@hanc.ai címre — a lefedettséget igény szerint bővítjük.

A widget UI angolul jelenik meg az ügynök konfigurált nyelve helyett​

A widget három forrásból olvassa a nyelvet, prioritási sorrendben: a beágyazó locale="…" HTML-attribútumából, az ügynök Widget nyelve beállításából az irányítópulton, majd az angolból mint visszaesés. Ha angolul látod egy német oldalon, az ügynök beállítása lehet, hogy még en — változtasd meg az ügynök Widgets lapján, és mentsd.

Visszahívás közbeni újratöltés friss űrlapot mutat, nem a sorba állított státuszt​

Ez szokatlan — a widget általában újra hozzákapcsolódik egy folyamatban lévő visszahíváshoz újratöltéskor. Győződj meg, hogy a beágyazó snippet ugyanaz mindkét oldalbetöltéskor (ugyanaz az agent-id, ugyanaz a szám ugyanabból a böngészőből beküldve), és hogy nincs adatvédelmi bővítmény, amely újratöltéskor letöröli az oldalt.

Kredit-problémák​

A hívás megszakad „No Credits" üzenettel​

Tünetek:

  • A hívás hirtelen véget ér a beszélgetés közepén
  • A megszakadás oka NO_CREDITS-et mutat
  • Az ügynök egy aktív hívás során abbahagyja a választ

Ok: A fiókodból kifogyott a kredit egy folyamatban lévő hívás során. A platform megszakítja a hívásokat, ha nincs maradék kredit a felhasználás fedezésére.

Megoldások:

  1. Ellenőrizd a kreditegyenleged

    • Lépj a Settings → Billing menüpontra
    • Tekintsd át a maradék krediteket

  2. Adj hozzá több kreditet

    • Frissítsd a csomagod több havi kreditért
    • Az előfizetésből származó kreditek azonnal elérhetők

  3. Figyeld a használatot proaktívan

    • Tekintsd át az analitikát rendszeresen a kredit-fogyasztás követéséhez
    • Állíts be használati riasztásokat, ha elérhető

  4. Értsd meg a kredit-átgördülést

    • A fel nem használt kreditek átgördülnek a következő hónapra
    • Az előfizetési díjad 100%-a kreditté konvertálódik

Böngésző-problémák​

Az oldal nem töltődik be​

Megoldások:

  1. Frissítsd az oldalt (Ctrl/Cmd + R)
  2. Töröld a gyorsítótárat (Ctrl/Cmd + Shift + Delete)
  3. Próbáld inkognitó módban
  4. Próbálj másik böngészőt
  5. Ellenőrizd az internetkapcsolatot

A gombok nem működnek​

Megoldások:

  1. Tiltsd le a hirdetésblokkolókat a hanc.ai-hoz
  2. Engedélyezd a JavaScriptet
  3. Töröld a sütiket
  4. Frissítsd a böngészőt a legújabb verzióra

Integrációs problémák​

A telefonszámok nem csatlakoznak​

Megoldások:

  1. Ellenőrizd a telefonszám beállítását

    • A szám aktív?
    • Az ügynök hozzá van rendelve?

  2. Ellenőrizd a fiók státuszát

    • A fiók aktív és van krediteid?

  3. Próbáld újra csatlakoztatni

    • Válaszd le és csatlakoztasd újra a számot
    • Ha a problémák fennállnak, lépj kapcsolatba a támogatással

A webhook nem kap eseményeket​

Megoldások:

  1. Ellenőrizd az URL-t

    • Az URL nyilvánosan elérhető
    • HTTPS (nem HTTP)
    • Nincs szükséges hitelesítés

  2. Ellenőrizd a szerver válaszát

    • 200-as státuszt kell visszaadnia
    • 30 másodpercen belül

  3. Tesztelj webhook.site-tal

    • Használj teszt URL-t az események küldésének ellenőrzésére
    • Onnan hibakeress

Segítségkérés​

Mielőtt kapcsolatba lépnél a támogatással​

Gyűjtsd össze ezeket az információkat:

  • Fiók e-mailje
  • Ügynök neve/ID-ja (ha alkalmazható)
  • Képernyőkép a hibáról
  • A probléma reprodukálásának lépései
  • Használt böngésző és eszköz

Lépj kapcsolatba a támogatással​

E-mail: support@hanc.ai

Tartalmazza:

  • A probléma világos leírása
  • Mikor kezdődött
  • Mit próbáltál
  • Képernyőképek, ha segítenek

Válaszidő:

  • Standard: 24 órán belül
  • Pro/Business: 4 órán belül

Státusz-oldal​

Ellenőrizd a platform státuszát kiesésekre:

  • Rendszer-státusz közlemények
  • Tervezett karbantartási ablakok
  • Korábbi rendelkezésre állás

Kapcsolódó témák​