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
„Ez a szám nem használható"A szám típusa le van tiltvaA telefonszámomat elutasítottá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ó nem elfogadott
  • 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ással-beillesztéssel megadni

  2. Állítsd vissza a jelszót

    • Kattints a „Forgot Password" gombra
    • Ellenőrizd az e-mailt (a spam mappát is)
    • Kattints a visszaállítási 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 sütiket a hanc.ai-hoz
    • 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? Írj ide: support@hanc.ai

Nem tudok fiókot létrehozni​

Tünetek:

  • A regisztráció sikertelen
  • „Ez a szám nem használható, próbálj meg egy másikat" üzenet
  • Nem érkezik meg az ellenőrző kód

Megoldások:

  1. „Ez a szám nem használható"

    • A regisztráció telefonszám-alapú, és bizonyos számtípusok le vannak tiltva (lásd alább: A telefonszámomat elutasították)
    • Az emelt díjas, osztott díjas és strukturálisan érvénytelen számok sosem elfogadottak — használj egy szabványos mobil- vagy vezetékes számot

  2. Nem érkezik meg az ellenőrző kód

    • Győződj meg a helyes országhívószámról
    • A számot vezető nulla nélkül add meg
    • A kód SMS-ben érkezik; SMS fogadására képtelen vezetékes szám esetén automatizált hanghívásban kézbesítjük — vedd fel a telefont, és hallgasd meg a kódot
    • Az ellenőrző kódokat a felületed nyelvén mondjuk/írjuk
    • Várj 60 másodpercet, mielőtt új kódot kérsz
    • Próbálj meg egy másik telefonszámot

  3. A telefon már regisztrálva van

    • Próbáld a „Forgot Password" / bejelentkezés lehetőséget a meglévő fiók visszaszerzéséhez
    • Használj egy másik számot

  4. Oldalhibák

    • Frissíts, é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 válaszol​

Tünetek:

  • A teszthívás létrejön, de az ügynök néma
  • Az ügynök nem mondja el a köszöntést
  • Végtelen betöltés

Diagnosztikai lépések:

1. Check agent status is ACTIVE (not INACTIVE or DELETED)
2. Verify first message (greeting) is set
3. Check prompt is not empty
4. Check knowledge base is connected (if applicable)
5. Check you have available credits

Megoldások:

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

    • Menj a Voice Agents menüpontra
    • Győződj meg róla, hogy az ügynök állapota ACTIVE
    • Ha az állapot INACTIVE, aktiváld az ügynök beállításaiból

  2. Ellenőrizd a First Message-t

    • Agent settings → First Message
    • Győződj meg róla, hogy van szöveg
    • Mentés a módosítások után

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

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

  4. Tesztelj a böngészőben

    • Kattints a „Talk to agent" gombra
    • Engedélyezd a mikrofont
    • Várd meg a köszöntést

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

Tünetek:

  • Helytelen árakat mond
  • Rossz nyitvatartást közöl
  • 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

    • Ott van a helyes információ?
    • Egyértelműen formázott?
    • Van esetleg ellentmondó információ?

  2. Ellenőrizd, hogy a KB csatlakoztatva van

    • Agent settings → Knowledge Base
    • A megfelelő KB van kiválasztva?

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

    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. Csökkentsd a temperature-t

    • Csökkentsd a temperature-t 0.3-0.5 közé
    • 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étak helyett

Megoldások:

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

    • Agent settings → Knowledge Base szakasz
    • A kiválasztott KB-t kell mutatnia

  2. Ellenőrizd a KB tartalmának formátumát

    • Egyértelmű címsorok
    • Egyszerű szerkezet
    • Kérdés/válasz párok a GYIK-hoz

  3. Adj hozzá GYIK-formátumot

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

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

    • Menj a Knowledge Base menüpontra
    • Ellenőrizd, hogy a fájl megjelenik a listában
    • Ellenőrizd, hogy a fájl mérete nem nulla

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

Tünetek:

  • Nagyon hosszú válaszok
  • Nem várja meg a felhasználót
  • Túl sok információ

Megoldások:

  1. Add hozzá a prompthoz:

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

  2. Csökkentsd a max tokens értéket

    • 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 sikertelen​

Tünetek:

  • Hiba a feltöltéskor
  • A fájlt elutasítja
  • A feldolgozás elakad

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-, hang-, videofájlok

  2. Ellenőrizd a fájlméretet

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

  3. Ellenőrizd a fájl tartalmát

    • Nem jelszóval védett
    • Nem sérült
    • Tényleges szöveget tartalmaz (nem beszkennelt 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

Az információ nem található​

Tünetek:

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

Megoldások:

  1. Javítsd a szerkezetet

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

  2. Használj pontos kifejezéseket

    • Illeszkedj ahhoz, ahogyan az ügyfelek kérdeznek
    • Vegyél bele kérdésváltozatokat

  3. Adj hozzá több kontextust

    • Ne csak árakat sorolj fel
    • Szerepeltesd a szolgáltatások neveit és leírásait

Példa a javításra:

❌ Gyenge:

25, 35, 55

✅ Jó:

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

Telefon-problémák​

A hívások nem csatlakoznak​

Tünetek:

  • A hívások hangpostára vagy hibára futnak
  • Kicseng, de nincs válasz
  • A hívás azonnal megszakad

Megoldások:

  1. Ellenőrizd a telefonszám-csatlakozást

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

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

    • Phone Numbers szakasz
    • Van ügynök hozzárendelve a számhoz?
    • Az ügynök aktív?

  3. Ellenőrizd a telefonszám állapotát

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

  4. Tesztelj a böngészővel

    • Használd a „Talk to agent" lehetőséget az irányítópulton
    • Ha ez működik, a probléma a telefon oldalán van

Rossz ügynök válaszol​

Tünetek:

  • „A" ügynököt vártad, „B"-t kaptad
  • Rossz köszöntés

Megoldások:

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

    • Phone Numbers → Kattints a számra
    • Ellenőrizd, hogy a megfelelő bejövő ügynök van kiválasztva

  2. Ellenőrizd a webhook-konfliktusokat

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

A telefonszámomat elutasították​

Tünetek:

  • „Ez a szám nem használható, próbálj meg egy másikat" regisztráláskor, szám hozzáadásakor vagy ellenőrzésekor
  • Egy általad birtokolt szám nem ellenőrizhető

Ok: A Hanc.AI telefonszám-szűrőt alkalmaz a díjcsalás visszaélésének megelőzésére. Bizonyos számtípusok teljesen le vannak tiltva, és egyes vezetékes vonalak megbuknak egy automatizált szolgáltatói lekérdezésen.

Letiltott számtípusok:

  • Emelt díjas számok — különleges díjszabású számok, amelyek felárat számítanak fel a hívónak
  • Osztott díjas számok — megosztott díjazású számok (pl. 0180 típusú)
  • Strukturálisan érvénytelen számok — a kiválasztott országhoz nem illő hossz vagy formátum
  • Egyes vezetékes vonalak — olyan vezetékes vonalak, amelyek megbuknak egy szolgáltatói lekérdezésen

Megoldások:

  1. Próbálj meg egy másik számot

    • Ez szinte minden esetben megoldja
    • Egy szabványos mobil- vagy vezetékes szám elfogadott

  2. Ellenőrizd a formátumot

    • A helyes országhívószám van kiválasztva
    • Nincs vezető nulla az országhívószám után

  3. Vezetékes szám ellenőrzése

    • A vezetékes vonalak nem tudnak SMS-t fogadni, ezért az ellenőrző kódot automatizált hanghívásban kézbesítjük — vedd fel a telefont, és hallgasd meg a kódot
    • Az ellenőrző kódokat a felületed nyelvén adjuk meg

  4. Még mindig le van tiltva?

    • Ha egy jogszerűen birtokolt számot elutasít a rendszer, és semmilyen alternatíva nem működik, írj ide: support@hanc.ai

Audio-problémák​

Gyenge hívásminőség​

Tünetek:

  • Robotikus hang
  • Szaggatott hang
  • Késleltetések a beszélgetésben

Megoldások:

  1. Ellenőrizd az internetkapcsolatot

    • Legalább 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 csomagvesztés rontja a hívásminőséget
    • Próbálj másik hálózatot, ha lehetséges
    • Zárd be a sávszélesség-igényes alkalmazásokat

  3. Ellenőrizd a böngésző kompatibilitását

    • Használj modern böngészőt (Chrome, Firefox, Safari, Edge)
    • Győződj meg róla, 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
    • Használj vezetékes headsetet, ha lehet
    • 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, hogy a helyes nyelv van kiválasztva
    • Illeszkedjen a hívó várt nyelvéhez

  2. Prompt az érthetőségért Add hozzá a prompthoz:

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

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

    • Használd a teszthívás funkciót
    • Beszélj érthetően, és jegyezd fel a problémákat
    • Lehet, hogy akcentus vagy hangminőség a probléma

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

Egy funkció nem elérhető​

Tünetek:

  • A gomb ki van szürkítve
  • „Upgrade required" üzenet
  • Nem tudsz több ügynököt létrehozni

Megoldások:

  1. Ellenőrizd a jelenlegi csomagot

    • Settings → Billing
    • Tekintsd át a csomag korlátait és funkcióit

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

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

  3. Ellenőrizd a használatot

    • A korlátok közelében vagy azoknál jársz?
    • Várd meg a következő számlázási ciklust, vagy frissíts

  4. Frissítsd a csomagot

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

A fizetés sikertelen​

Tünetek:

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

Megoldások:

  1. Ellenőrizd a kártyaadatokat

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

  2. Lépj kapcsolatba a bankkal

    • Blokkolva vannak a nemzetközi fizetések?
    • Gyanús tevékenység jelzés?

  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élyezőlistát

    • Menj az ügynököd widget-beállításaihoz
    • Győződj meg róla, hogy a weboldalad domainje hozzá van adva az engedélyezett domainek listájához
    • Vedd bele az összes változatot (www-vel/www nélkül)

  2. Ellenőrizd a böngésző követelményeit A Hanc.AI widget a következő böngészőképességeket igényli:

    • WebGL 2.0 — a widget felületének megjelenítéséhez
    • Web Audio API — a hangfeldolgozáshoz
    • WebRTC — a 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ákat jeleznek, kérd meg őket, hogy frissítsék a böngészőjüket.

  3. Ellenőrizd a widget beágyazókódját

    • Ellenőrizd, hogy a beágyazó szkript helyesen van elhelyezve a HTML-edben
    • Ellenőrizd a böngészőkonzolt JavaScript-hibákért
    • Győződj meg róla, hogy semmilyen reklámblokkoló vagy szkriptblokkoló nem zavar bele

  4. Tesztelj inkognitó módban

    • Nyisd meg a weboldalad egy inkognitó/privát ablakban
    • Ez kizárja a bővítménykonfliktusokat

Visszahívási widget problémái​

A látogató megadta a számát, de nem érkezett visszahívás​

  1. Ellenőrizd, hogy az ügynök engedélyezve van visszahívásokra — Nyisd meg az ügynököt → Widgets lap → győződj meg róla, hogy az „Enable callback widget" be van kapcsolva, és mentsd el.
  2. Ellenőrizd, hogy a kimenő telefonszám hozzá van rendelve — Az ügynöknek szüksége van egy ellenőrzött kimenő számra a számlistáján. Enélkül a visszahívások kézbesítése sikertelen.
  3. Ellenőrizd a jogosultsági riasztást — A Widgets lap egy szalagcímet jelenít meg, ha bármelyik hiányzik (fizetős csomag / kimenő szám / ellenőrzött e-mail).
  4. Nézd meg az ügynök híváslistáját — A sikertelen visszahívások egyértelmű hibaokkal jelennek meg a listában (pl. „destination number unreachable", „no outbound number available").
  5. Ellenőrizd, hogy a látogató száma nem volt hibás — A widget a kiválasztott ország formátuma szerint ellenőriz, de egy országbeli 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 ezt rendszeresen eléred, fontold meg a forgalom több ügynök közötti szétosztását.

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

A lefedettség kurált. Ha egy nem szereplő országra van szükséged, írj ide: support@hanc.ai — a lefedettséget igény alapján bővítjük.

A widget felülete angolul jelenik meg az ügynök beállított nyelve helyett​

A widget három forrásból olvassa a nyelvet, prioritási sorrendben: a beágyazáson lévő locale="…" HTML-attribútum, az ügynök Widget language beállítása az irányítópulton, majd az angol mint tartalék. Ha egy német oldalon angolt látsz, az ügynök beállítása még mindig en lehet — módosítsd az ügynök Widgets lapján, és mentsd el.

Visszahívás közbeni újratöltés friss űrlapot mutat, nem a sorban álló állapotot​

Ez szokatlan — a widget általában újracsatlakozik egy folyamatban lévő visszahíváshoz újratöltéskor. Győződj meg róla, hogy a beágyazási kódrészlet 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 semmilyen adatvédelmi bővítmény nem törli az oldalt újratöltéskor.

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
  • Az ügynök abbahagyja a válaszadást egy aktív hívás közben

Ok: A fiókodból elfogytak a kreditek egy folyamatban lévő hívás közben. A platform megszakítja a hívásokat, ha nincs elegendő fennmaradó kredit a használat fedezésére.

Megoldások:

  1. Ellenőrizd a kreditegyenlegedet

    • Menj a Settings → Billing menüpontra
    • Tekintsd át a fennmaradó krediteket

  2. Adj hozzá több kreditet

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

  3. Kövesd figyelemmel a használatot proaktívan

    • Rendszeresen tekintsd át az analitikát a kreditfogyasztás nyomon követéséhez
    • Állíts be használati riasztásokat, ha elérhetők

  4. Értsd meg a kreditátvitelt

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

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 reklámblokkoló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?
    • Van ügynök hozzárendelve?

  2. Ellenőrizd a fiók állapotát

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

  3. Próbáld újracsatlakoztatni

    • Válaszd le és csatlakoztasd újra a számot
    • Lépj kapcsolatba a támogatással, ha a problémák továbbra is fennállnak

A webhook nem fogad eseményeket​

Megoldások:

  1. Ellenőrizd az URL-t

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

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

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

  3. Tesztelj a webhook.site segítségével

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

Segítségkérés​

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

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

  • Fiók e-mail-címe
  • Ügynök neve/azonosítója (ha van)
  • 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

Kapcsolatfelvétel a támogatással​

E-mail: support@hanc.ai

Tartalmazza:

  • A probléma egyértelmű leírását
  • Mikor kezdődött
  • Mit próbáltál már
  • Képernyőképeket, ha hasznos

Válaszidő:

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

Állapotoldal​

Ellenőrizd a platform állapotát üzemszünetek esetén:

  • Rendszerállapot-közlemények
  • Tervezett karbantartási időablakok
  • Korábbi rendelkezésre állás

Kapcsolódó témák​