Callback Widget
A Callback Widget egy kicsi, beágyazható űrlap, amely lehetővé teszi, hogy a weboldal-látogatóid megadják a telefonszámukat, és visszahívást kapjanak az AI ügynöködtől — általában másodperceken belül. Ahelyett, hogy a látogatóknak kellene tárcsázniuk, a beszélgetés jön hozzájuk.
Ez az ötödik widget-típus a Floating, Pill, Pill Floating és Inline widgetek mellett — de nagyon másképp működik. A többi widget a böngészőben indít hangbeszélgetést. A Callback Widget egy valódi telefonhívást állít sorba, amelyet az ügynököd a kimenő számodon keresztül kezdeményez.
Mikor használd
| Forgatókönyv | Miért illik ide a Callback Widget |
|---|---|
| Lead-generáló landing oldalak | A látogató elkötelezi magát egy telefonszámmal, az ügynök a következő percben minősíti |
| Magas szándékú termékoldalak | „Beszélj egy szakértővel" anélkül, hogy a látogatónak tárcsáznia kellene |
| Mobil-first oldalak | Egy koppintás a pillre, nincs engedélykérés, nincs szükség fülhallgatóra |
| Nyitvatartáson kívüli lefedettség | A látogató zárás után hagy egy számot, az ügynök tárcsáz, amikor a sor megnyílik |
| Kevesebb súrlódás az űrlapokhoz képest | A látogatók egyetlen mezőt küldenek be, és azonnali választ kapnak |
Jogosultság
A Callback Widget három dolgot igényel a fiókodon, mielőtt engedélyezhető lenne:
| Követelmény | Miért |
|---|---|
| Fizetős csomag (Starter vagy magasabb) | A visszahívás során felhasznált kimenő perceket percenként számlázzuk |
| Ellenőrzött kimenő telefonszám hozzárendelve az ügynökhöz | Az ügynöknek valódi számra van szüksége, ahonnan tárcsázhat |
| Ellenőrzött e-mail a munkaterületeden | Megerősíti a tulajdonjogot, mielőtt a kimenő hívások feloldódnának |
Ha ezek bármelyike hiányzik, a Callback widget szakasz az ügynök Widgets fülén egy figyelmeztetést jelenít meg, amely pontosan megmondja, mit kell javítanod. A widget mindaddig letiltva marad, amíg mind a három meg nem lesz.
A Callback Widget nem elérhető a Free csomagon, mert kimenő telefonhívásokat kezdeményez. Az összes többi widget-típus (Floating, Pill, Inline) továbbra is ingyenes.
Beállítás
1. A visszahívás engedélyezése az ügynökön
- Nyisd meg az ügynöködet, és lépj a Widgets fülre.
- Görgess a Callback widget szakaszhoz.
- Kapcsold be az „Enable callback widget" beállítást.
- Konfiguráld:
- Retry attempts — hányszor próbálkozzon újra az ügynök, ha a látogató nem veszi fel (1–5, alapértelmezett 3).
- Retry interval — a próbálkozások közötti percek száma (1–30, alapértelmezett 5).
- Widget language — az a nyelv, amelyen az űrlap, az állapotüzenetek és az országválasztó megszólal a látogatóhoz (14 nyelv elérhető — lásd lentebb).
- Theme — a lebegő pill és a párbeszédablak színsémája (ugyanazt a témapalettát használja, mint a többi widget).
- Mentsd el.
A widget élő előnézete a beállítások mellett jelenik meg, így azonnal láthatod a változtatásaidat — nem kell élesítened, hogy teszteld a megjelenést.
2. A beágyazási kódrészlet másolása
Ugyanabban a szakaszban másold ki a HTML-kódrészletet:
<hanc-ai-callback agent-id="YOUR_AGENT_ID"></hanc-ai-callback>
<script src="https://unpkg.com/hanc-webrtc-widgets@latest" async type="text/javascript"></script>
Illeszd be egyszer a weboldaladra, jellemzően közvetlenül a </body> elé. A widget egy lebegő pillként jelenik meg az oldal sarkában.
A @latest címke azt jelenti, hogy az oldalad automatikusan átveszi az új widget-verziókat, amikor megjelennek. Rögzíts egy adott verzióhoz (pl. hanc-webrtc-widgets@1.4.0), ha teljes irányítást szeretnél a frissítések felett.
Mit lát a látogató
A widget négy állapoton vezeti végig a látogatókat:
| Állapot | Mit lát a látogató |
|---|---|
| Form | Lebegő pill a sarokban. Kattints a megnyitáshoz. Országválasztó bal oldalon, telefonszám-beviteli mező jobb oldalon, elküldés gomb. |
| Queued | „Sorban vagy — körülbelül N másodperc, amíg felhívunk." Élőben frissül. |
| Dialing | „Most hívunk." Marad, amíg a hívás nem kapcsolódik vagy nem hiúsul meg. |
| Completed / Failed | Rövid visszaigazolás vagy barátságos hibaüzenet egy „töltsd újra az oldalt egy újabb visszahíváshoz" tipppel. |
Az űrlap automatikusan ellenőrzi a telefonszámot a kiválasztott ország nemzeti formátuma alapján, és nem engedi az elküldést, hacsak a szám nem hihető.
Országlefedettség
Az országválasztó lefedi Európát (EU + DACH + Egyesült Királyság), Észak-Amerikát (USA + Kanada), valamint egy válogatott, széles körben támogatott további országcsoportot. Minden ország megmutatja a zászlaját, nevét és egy példa-helykitöltőt a natív formátumban, hogy a látogató tudja, mit gépeljen.
Ha a látogatóid által használt ország nincs a listán, írj a support@hanc.ai címre — a lefedettséget rendszeresen bővítjük.
HTML-attribútumok
A widget a következő attribútumokat fogadja el a <hanc-ai-callback> tagen:
| Attribútum | Kötelező | Leírás |
|---|---|---|
agent-id | Igen | Az ügynököd egyedi azonosítója |
locale | Nem | Felülírja a widget felületi nyelvét ehhez az oldalhoz (pl. locale="de"). Hasznos, ha az oldalad többnyelvű, és az oldal nyelve nem egyezik az ügynök alapértelmezett nyelvével. |
theme | Nem | Felülírja a színtémát ehhez az oldalhoz |
position | Nem | Hová horgonyzódik a lebegő pill (bottom-right, bottom-left, top-right, top-left) |
Bármit, amit elhagysz, arra esik vissza, amit az ügynökön beállítottál az irányítópulton.
Példa: német oldal egy többnyelvű webhelyen
<hanc-ai-callback agent-id="YOUR_AGENT_ID" locale="de"></hanc-ai-callback>
<script src="https://unpkg.com/hanc-webrtc-widgets@latest" async></script>
A pill szövege, a párbeszédablak feliratai, az országválasztó és az állapotüzenetek mind németre váltanak. Maga az ügynök továbbra is azon a nyelven beszél, amelyre be van állítva — a locale csak azt befolyásolja, amit a látogató az oldalon olvas.
A widget nyelve
A widget felülete 14 beépített nyelvvel érkezik:
| Kód | Nyelv |
|---|---|
en | English |
de | Deutsch |
fr | Français |
es | Español |
it | Italiano |
pt | Português |
pl | Polski |
cs | Čeština |
hu | Magyar |
tr | Türkçe |
kk | Қазақша |
zh | 中文 |
ru | Русский |
uk | Українська |
Az ügynök három helyről választja ki a nyelvét, prioritási sorrendben:
- A
locale="…"attribútum a beágyazáson (legmagasabb prioritás) - A Widget language, amely az ügynök Widgets fülén van beállítva
- Angol (alapértelmezett)
A widget nyelve csak a látogató által olvasott képernyőszöveget befolyásolja — a feliratokat, az országválasztót, az állapotüzeneteket. A tényleges hangbeszélgetés azon a nyelven zajlik, amelyre az ügynököd beszélni van beállítva.
Újrapróbálkozási viselkedés
Ha a látogató nem veszi fel az első próbálkozásra, az ügynök megvárja a beállított intervallumot, és újra tárcsáz — a beállított próbálkozási számig.
- Próbálkozások: 1–5 (alapértelmezett 3)
- Intervallum: 1–30 perc (alapértelmezett 5)
A widget mutatja a látogatónak az egyes próbálkozások állapotát. Miután minden próbálkozás sikertelen, a widget átvált a „nem sikerült elérnünk" állapotra egy udvarias üzenettel.
Három próbálkozás öt perces intervallumokkal a legtöbb lead-generáló oldalon jól működik — elég gyors ahhoz, hogy a látogató még böngésszen, elég kíméletes ahhoz, hogy ne legyen tolakodó. Emeld meg, ha a közönséged hajlamos figyelmen kívül hagyni az ismeretlen számokat.
Egy visszahívás oldalbetöltésenként
Amint egy látogató beküldi a számát, a widget lezárja magát az adott oldal-életciklus hátralévő részére:
- A párbeszédablak bezárása összecsukja a pillt, de nem állítja vissza az űrlapot.
- Az újranyitás az aktuális állapotot mutatja (queued / dialing / completed / failed), nem egy friss űrlapot.
- Egy második visszahíváshoz a látogatónak újra kell töltenie az oldalt.
Ez megakadályozza a véletlen duplikált beküldéseket, miközben egy hívás már úton van. Ha a látogató kifejezetten megszakítja a sorba állított visszahívását a párbeszédablakból (a „Cancel" gomb a queued képernyőn), a zár feloldódik, és azonnal újra beküldhet.
Mi történik, ha újratöltenek a visszahívás közepén?
Ha egy látogató újratölti az oldalt, miközben az ügynök még próbálkozik a számával, a widget észleli, hogy ugyanahhoz a számhoz már létezik aktív visszahívás, és némán újracsatlakozik hozzá — nincs duplikált tárcsázás, nincs második sorba állítás. A látogató egyszerűen csak azt látja, hogy a meglévő állapota ott folytatódik, ahol abbamaradt.
Egyidejűség és áteresztőképesség
Egyetlen ügynöknek egyszerre akár 10 folyamatban lévő visszahívása lehet. Az ezen felüli beküldések a sorban várakoznak, és akkor kerülnek tárcsázásra, ahogy kapacitás szabadul fel.
A sor folyamatosan ürül — a legtöbb látogató a beküldéstől számított néhány másodpercen belül tárcsázásra kerül, ha nem vagy közel az egyidejűségi korláthoz.
Spam és visszaélés elleni védelem
A Callback Widget valódi telefonhívásokat kezdeményez, ezért beépített védelmekkel rendelkezik, amelyek megakadályozzák, hogy a rossz forgalom felverje a számládat. Ezek automatikusan működnek — neked semmit sem kell beállítanod.
| Védelem | Mit tapasztal a látogató |
|---|---|
| „Nem vagyok robot" ellenőrzés | Amikor a visszaélés elleni védelem engedélyezve van a platformon, a látogató egy gyors Google reCAPTCHA-t old meg, mielőtt a visszahívás sorba kerülne. A valódi látogatók egy másodperc alatt teljesítik; a botok elakadnak. |
| Szám-ellenőrzés | Az űrlap nem engedi elküldeni azt a számot, amely nem hihető találat a kiválasztott országhoz, így az elgépelések és a szemétszámok soha nem kerülnek tárcsázásra. |
| Emelt díjas és lefedettségen kívüli számok | Az emelt díjas vonalak, egyes VoIP-tartományok és a támogatott lefedettségen kívüli számok nem kerülnek visszahívásra telefonon. Ha a látogató böngészője támogatja, a widget helyette egy böngészőn belüli hanghívást kínál; egyébként egy udvarias „ezt a számot nem tudjuk felhívni" üzenetet lát. Ez megakadályozza, hogy a widgetet drága emelt díjas számok tárcsázására használják vissza. |
| Ismételt beküldési korlát | Ugyanaz a szám csak korlátozott számú alkalommal állítható sorba óránként egy ügynökhöz. Azok a látogatók, akik túllépik ezt, egy barátságos „hamarosan jelentkezünk" üzenetet látnak a queued képernyő helyett. |
Ezek a védelmek azért léteznek, mert egy nyilvános visszahívási űrlap nyilvánvaló célpontja a visszaélésnek — valaki egyébként emelt díjas számokra irányíthatná, vagy botokkal ostromolhatná, hogy elégesse a kimenő perceidet. A védelmek csendben futnak a háttérben; a normál látogatók soha nem veszik észre őket.
Élő előnézet az irányítópulton
A Widgets fül a beállítások mellett élő előnézetet mutat a visszahívó widgetről. Bármilyen változtatás, amit végzel — téma, nyelv, újrapróbálkozási számok — azonnal frissíti az előnézetet. Nem kell élesítened az oldaladat, hogy lásd, hogyan fog kinézni a widget.
Az előnézet egy mock manifestet használ a teljes országlistával és demó-jogosultsággal, így a widget még azokon a csomagokon is megjelenik, ahol a kimenő visszahívások még nem elérhetők.
Beágyazott követés
A widget ugyanazokat a call-start és call-end eseményeket bocsátja ki, mint a többi widget. Figyeld őket JavaScriptben, ha a saját analitikádat szeretnéd elindítani:
const widget = document.querySelector('hanc-ai-callback');
widget.addEventListener('call-start', () => {
// Visitor's callback was just connected — track as conversion
});
widget.addEventListener('call-end', () => {
// Callback finished — track duration, outcome, etc.
});
Csomag-elérhetőség
| Csomag | Callback Widget |
|---|---|
| Free | Nem elérhető (kimenő hívást igényel) |
| Starter / Pro / Business / Enterprise | Elérhető |
Minden fizetős csomag ugyanazt a widget-funkciókészletet kapja. A hívásonkénti költség a szokásos kimenő tarifádat követi — lásd Számlázás.
Kapcsolódó témák
- Weboldal-widgetek — Floating, Pill, Pill Floating és Inline widget-típusok böngészőn belüli beszélgetésekhez
- Beállítások — Ügynökszintű hívásbeállítások, köztük a Max Call Duration, amely a visszahívásokat is korlátozza
- Telefonszámok — Csatlakoztasd a kimenő számot, amelyről a visszahívó widgeted tárcsázni fog
- GYIK — Gyakori kérdések és szélső esetek