Visszahívás widget
A Visszahívás widget egy kis, beágyazható űrlap, amely lehetővé teszi a webhely látogatói számára, hogy megadják telefonszámukat, és visszahívást kapjanak az AI hangügynökétől — általában másodperceken belül. Ahelyett, hogy a látogatóknak tárcsázniuk kellene, a beszélgetés érkezik hozzájuk.
Ez az ötödik widget-típus a Lebegő, a Pill, az Inline és a Felugró widgetek mellett — de egészen másképp működik. A többi widget a böngészőben indít hangbeszélgetést. A Visszahívás widget egy valódi telefonhívást sorba állít, amelyet az ügynök hajt végre az Ön kimenő számán keresztül.
Mikor használja
| Forgatókönyv | Miért illik ide a Visszahívás 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 vásárlási szándékú termékoldalak | „Beszéljen egy szakértővel" anélkül, hogy a látogatónak tárcsáznia kellene |
| Mobilelsődleges oldalak | Egy érintés a pillen, nincs engedélykérés, nem kell fejhallgató |
| Munkaidőn kívüli lefedettség | A látogató munkaidő után megadja a számát, az ügynök tárcsáz, amikor a sor megnyílik |
| Csökkentett súrlódás az űrlapokhoz képest | A látogatók egyetlen mezőt töltenek ki, és azonnali választ kapnak |
Jogosultság
A Visszahívás widget három dolgot igényel a fiókján, mielőtt engedélyezhető lenne:
| Követelmény | Miért |
|---|---|
| Fizetős előfizetés (Starter vagy magasabb) | A visszahívás alatt elfogyasztott kimenő perceket percenként számlázzuk |
| Az ügynökhöz rendelt ellenőrzött kimenő telefonszám | Az ügynöknek valódi szám kell, ahonnan tárcsázhat |
| Ellenőrzött e-mail a munkaterületen | Megerősíti a tulajdonjogot, mielőtt a kimenő hívások feloldódnak |
Ha bármelyik hiányzik, az ügynök Widgetek lapján a Visszahívás widget szakaszban riasztás jelenik meg, amely pontosan megmondja, mit kell javítani. A widget letiltva marad, amíg mindhárom feltétel teljesül.
A Visszahívás widget nem elérhető a Free előfizetésen, mert kimenő telefonhívásokat indít. Az összes többi widget-típus (Lebegő, Pill, Inline) továbbra is ingyenes.
Beállítás
1. Visszahívás engedélyezése az ügynökön
- Nyissa meg az ügynököt, és lépjen a Widgetek lapra.
- Görgessen a Visszahívás widget szakaszhoz.
- Kapcsolja be a „Visszahívás widget engedélyezése" kapcsolót.
- Konfigurálja:
- Újrapróbálkozások száma — hányszor próbálkozzon újra az ügynök, ha a látogató nem veszi fel (1–5, alapértelmezett 3).
- Újrapróbálkozási intervallum — percek a próbálkozások között (1–30, alapértelmezett 5).
- Widget nyelve — a nyelv, amelyen az űrlap, az állapotüzenetek és az országválasztó megszólalnak a látogató felé (14 nyelv elérhető — lásd alább).
- Téma — a lebegő pill és a párbeszédpanel színsémája (ugyanazt a témapalettát használja, mint a többi widget).
- Mentse.
A beállítások mellett megjelenik a widget élő előnézete, így azonnal láthatja a módosításokat — nem kell telepítenie a teszteléshez.
2. Másolja a beágyazási kódrészletet
Ugyanebben a szakaszban másolja 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>
Illessze be egyszer a webhelyébe, általában közvetlenül a </body> elé. A widget a lap sarkában lebegő pillként jelenik meg.
A @latest címke azt jelenti, hogy az oldala automatikusan átveszi az új widget-verziókat, amikor megjelennek. Rögzítsen egy konkrét verziót (pl. hanc-webrtc-widgets@1.4.0), ha teljes irányítást szeretne 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ó |
|---|---|
| Űrlap | Lebegő pill a sarokban. Kattintásra megnyílik. Bal oldalon országválasztó, jobb oldalon telefonszám-mező, küldés gomb. |
| Sorban | „A sorban van — körülbelül N másodperc, mielőtt felhívjuk." Élőben frissül. |
| Tárcsázás | „Most hívjuk." Marad, amíg a hívás létrejön vagy meghiúsul. |
| Befejezve / Sikertelen | Rövid megerősítés vagy barátságos hibaüzenet egy „töltse újra az oldalt egy újabb visszahíváshoz" tippel. |
Az űrlap automatikusan ellenőrzi a telefonszámot a kiválasztott ország nemzeti formátuma alapján, és nem küldi el, ha a szám nem életszerű.
Országlefedettség
Az országválasztó lefedi Európát (EU + DACH + UK), Észak-Amerikát (USA + Kanada), valamint egy gondosan válogatott további ország-csoportot. Minden ország mutatja a zászlaját, nevét és egy példa helyőrzőt natív formátumban, hogy a látogató tudja, mit írjon.
Ha a látogatók által használt ország nincs felsorolva, vegye fel a kapcsolatot a support@hanc.ai címen — a lefedettség rendszeresen bővül.
HTML attribútumok
A widget az alábbi attribútumokat fogadja el a <hanc-ai-callback> tagen:
| Attribútum | Kötelező | Leírás |
|---|---|---|
agent-id | Igen | Az ügynöke egyedi azonosítója |
locale | Nem | Felülírja a widget UI nyelvét ezen az oldalon (pl. locale="de"). Hasznos, ha az oldala többnyelvű, és az oldal locale-ja nem egyezik az ügynök alapértékével. |
theme | Nem | Felülírja a színtémát ezen az oldalon |
position | Nem | Ahol a lebegő pill rögzül (bottom-right, bottom-left, top-right, top-left) |
Bármit, amit elhagy, visszaesik arra, amit az ügynökön konfigurált az irányítópulton.
Példa: német nyelvű oldal 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édpanel 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 érinti, amit a látogató olvas az oldalon.
Widget nyelve
A widget UI 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 veszi a nyelvét, prioritási sorrendben:
- A beágyazás
locale="…"attribútuma (legmagasabb prioritás) - Az ügynök Widgetek lapján beállított Widget nyelve
- Angol (alapértelmezett)
A widget nyelve csak a látogató által olvasott képernyőszöveget érinti — feliratok, országválasztó, állapotüzenetek. A tényleges hangbeszélgetés azon a nyelven zajlik, amelyre az ügynök be van állítva.
Újrapróbálkozási viselkedés
Ha a látogató első alkalommal nem veszi fel, 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. Az összes próbálkozás sikertelensége után a widget átvált a „nem tudtuk elérni" állapotba egy udvarias üzenettel.
Három próbálkozás öt perces intervallumokkal jól működik a legtöbb lead-gen oldalon — elég gyors ahhoz, hogy a látogató még böngésszen, elég gyengéd ahhoz, hogy ne legyen tolakodó. Növelje, ha a közönsége hajlamos figyelmen kívül hagyni az ismeretlen számokat.
Egy visszahívás oldalbetöltésenként
Miután a látogató beküldte a számát, a widget az oldal hátralévő életciklusára lezárja magát:
- A párbeszédpanel bezárása összecsukja a pillt, de nem állítja vissza az űrlapot.
- Az újranyitás az aktuális állapotot mutatja (sorban / tárcsázás / befejezve / sikertelen), 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 ismételt küldéseket, amíg egy hívás már úton van. Ha a látogató kifejezetten lemondja sorban álló visszahívását a párbeszédpanelből (a sorban álló képernyőn lévő „Mégse" gomb), a zárolás feloldódik, és azonnal újra beküldhet.
Mi történik, ha a visszahívás közepén tölti újra az oldalt?
Ha a látogató újratölti az oldalt, miközben az ügynök még újrapróbálkozik a számukkal, a widget észleli, hogy ugyanahhoz a számhoz már aktív visszahívás létezik, és csendben újra csatlakozik hozzá — nincs duplikált tárcsázás, nincs második sorbejegyzés. A látogató egyszerűen csak látja, hogy a meglévő állapota ott folytatódik, ahol abbamaradt.
Egyidejűség és áteresztőképesség
Egyetlen ügynök egyszerre legfeljebb 10 visszahívást kezelhet. Az ezen felüli küldések a sorban várnak, és akkor tárcsázódnak, amint kapacitás szabadul fel.
Az ügynök-felszabadul-majd-tárcsáz hurok folyamatosan üríti a sort — a legtöbb látogatót a beküldést követő néhány másodpercen belül tárcsázzák, ha nincs a kapacitási korlát közelében.
Van egy szám-szintű sebességkorlát (egy számot csak néhányszor lehet egy óra alatt sorba állítani ugyanahhoz az ügynökhöz) a visszaélések elkerülése érdekében. Azok a látogatók, akik elérik, a sorban álló képernyő helyett egy barátságos „hamarosan jelentkezünk" üzenetet látnak.
Élő előnézet az irányítópulton
A Widgetek lap a beállítások mellett mutatja a visszahívás widget élő előnézetét. Bármilyen változtatás — téma, nyelv, próbálkozási számok — azonnal frissíti az előnézetet. Nem kell telepítenie az oldalát, hogy lássa, 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 olyan előfizetéseken is megjelenik, ahol a kimenő visszahívások még nem érhetők el.
Beágyazott követés
A widget ugyanazokat a call-start és call-end eseményeket bocsátja ki, mint a többi widget. Hallgassa őket JavaScripten, ha saját analitikát szeretne indítani:
const widget = document.querySelector('hanc-ai-callback');
widget.addEventListener('call-start', () => {
// A látogató visszahívása éppen most kapcsolódott — kövesse konverzióként
});
widget.addEventListener('call-end', () => {
// A visszahívás befejeződött — kövesse a időtartamot, kimenetelt stb.
});
Előfizetés szerinti elérhetőség
| Előfizetés | Visszahívás widget |
|---|---|
| Free | Nem elérhető (kimenő hívást igényel) |
| Starter / Pro / Business / Enterprise | Elérhető |
Az összes fizetős előfizetés ugyanazt a widget-funkciókészletet kapja. A hívásonkénti költség a szokásos kimenő tarifáját követi — lásd Számlázás.
Kapcsolódó
- Webhelywidgetek — Lebegő, Pill, Inline és Felugró widget-típusok böngészőbeli beszélgetésekhez
- Beállítások — Ügynök-szintű hívásbeállítások, beleértve a maximális hívási időtartamot, amely a visszahívásokat is korlátozza
- Telefonszámok — Csatlakoztassa a kimenő számot, amelyről a visszahívás widget tárcsázni fog
- GYIK — Gyakori kérdések és peremesetek