Widget zpětného volání
Widget zpětného volání je malý vložitelný formulář, který návštěvníkům vašeho webu umožňuje nechat své telefonní číslo a získat zpětné volání od vašeho AI agenta — obvykle během několika sekund. Místo aby návštěvníci museli vytáčet, konverzace přijde k nim.
Toto je pátý typ widgetu vedle widgetů Floating, Pill, Inline a Popup — funguje ale velmi odlišně. Ostatní widgety zahájí hlasovou konverzaci v prohlížeči. Widget zpětného volání zařadí do fronty skutečný telefonní hovor, který agent uskuteční přes vaše odchozí číslo.
Kdy ho použít
| Scénář | Proč widget zpětného volání sedí |
|---|---|
| Landing pages pro generování leadů | Návštěvník se zaváže telefonním číslem, agent ho během minuty kvalifikuje |
| Produktové stránky s vysokým záměrem | "Promluvte si se specialistou" bez nutnosti vytáčení |
| Mobile-first weby | Jeden tap na pill, žádná žádost o oprávnění, žádná sluchátka |
| Pokrytí mimo pracovní dobu | Návštěvník nechá číslo po hodinách, agent vytočí, jakmile se fronta otevře |
| Snížené tření oproti formulářům | Návštěvníci odešlou jediné pole a získají okamžitou odpověď |
Způsobilost
Widget zpětného volání vyžaduje na vašem účtu tři věci, než ho lze povolit:
| Požadavek | Proč |
|---|---|
| Placený plán (Starter nebo vyšší) | Odchozí minuty spotřebované během zpětného volání se účtují za minutu |
| Ověřené odchozí telefonní číslo přiřazené agentovi | Agent potřebuje skutečné číslo, ze kterého bude vytáčet |
| Ověřený e-mail ve vašem workspace | Potvrzuje vlastnictví předtím, než se odchozí hovory odemknou |
Pokud některá z těchto věcí chybí, sekce widgetu zpětného volání na kartě Widgety agenta zobrazí upozornění, které vám přesně řekne, co opravit. Widget zůstává deaktivovaný, dokud nejsou všechny tři podmínky splněny.
Widget zpětného volání není dostupný na plánu Free, protože uskutečňuje odchozí telefonní hovory. Všechny ostatní typy widgetů (Floating, Pill, Inline) zůstávají zdarma.
Nastavení
1. Povolte zpětné volání na agentovi
- Otevřete agenta a přejděte na kartu Widgety.
- Sjeďte na sekci Widget zpětného volání.
- Zapněte přepínač "Povolit widget zpětného volání".
- Konfigurujte:
- Počet pokusů — kolikrát agent zopakuje pokus, pokud návštěvník nezvedne (1–5, výchozí 3).
- Interval mezi pokusy — minuty mezi pokusy (1–30, výchozí 5).
- Jazyk widgetu — jazyk, kterým s návštěvníkem mluví formulář, stavové zprávy a výběr země (k dispozici 14 jazyků — viz níže).
- Téma — barevné schéma pro plovoucí pill a dialog (používá stejnou paletu jako ostatní widgety).
- Uložte.
Vedle nastavení se zobrazuje živý náhled widgetu, takže své změny vidíte okamžitě — není potřeba nasazovat, abyste otestovali vzhled.
2. Zkopírujte vložený snippet
Ve stejné sekci zkopírujte HTML snippet:
<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>
Vložte ho jednou na svůj web, obvykle těsně před </body>. Widget se zobrazí jako plovoucí pill v rohu stránky.
Tag @latest znamená, že váš web automaticky převezme nové verze widgetu, jakmile vyjdou. Zafixujte na konkrétní verzi (např. hanc-webrtc-widgets@1.4.0), pokud chcete mít plnou kontrolu nad aktualizacemi.
Co návštěvník vidí
Widget provádí návštěvníka čtyřmi stavy:
| Stav | Co návštěvník vidí |
|---|---|
| Formulář | Plovoucí pill v rohu. Kliknutím se otevře. Výběr země vlevo, pole pro telefon vpravo, tlačítko odeslat. |
| Ve frontě | "Jste ve frontě — asi N sekund, než vám zavoláme." Aktualizuje se živě. |
| Vytáčení | "Právě vám voláme." Zůstává, dokud se hovor nespojí nebo neselže. |
| Dokončeno / Selhalo | Krátké potvrzení nebo přívětivá chyba s nápovědou "obnovte stránku pro další zpětné volání". |
Formulář automaticky ověřuje telefonní číslo proti národnímu formátu zvolené země a odmítne ho odeslat, dokud není číslo věrohodné.
Pokrytí zemí
Výběr země pokrývá Evropu (EU + DACH + UK), Severní Ameriku (US + Kanada) a kurátorovaný soubor dalších široce podporovaných zemí. Každá země zobrazuje svou vlajku, název a příklad placeholderu v nativním formátu, aby návštěvník věděl, co napsat.
Pokud země, kterou vaši návštěvníci používají, není uvedena, kontaktujte support@hanc.ai — pokrytí se pravidelně rozšiřuje.
HTML atributy
Widget přijímá tyto atributy na tagu <hanc-ai-callback>:
| Atribut | Povinný | Popis |
|---|---|---|
agent-id | Ano | Jedinečný identifikátor vašeho agenta |
locale | Ne | Přepíše jazyk UI widgetu pro tuto stránku (např. locale="de"). Užitečné, pokud je váš web vícejazyčný a jazyk stránky se neshoduje s výchozím jazykem agenta. |
theme | Ne | Přepíše barevné téma pro tuto stránku |
position | Ne | Kde se plovoucí pill ukotví (bottom-right, bottom-left, top-right, top-left) |
Cokoli vynecháte, použije se hodnota, kterou jste nakonfigurovali na agentovi v dashboardu.
Příklad: německá stránka na vícejazyčném webu
<hanc-ai-callback agent-id="YOUR_AGENT_ID" locale="de"></hanc-ai-callback>
<script src="https://unpkg.com/hanc-webrtc-widgets@latest" async></script>
Text pilulky, popisky dialogu, výběr země a stavové zprávy se všechny přepnou do němčiny. Samotný agent stále mluví v jakémkoli jazyce, na který je nakonfigurován — locale ovlivňuje pouze to, co návštěvník čte na stránce.
Jazyk widgetu
UI widgetu se dodává se 14 vestavěnými jazyky:
| Kód | Jazyk |
|---|---|
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 | Українська |
Agent vybírá svůj jazyk ze tří míst v pořadí podle priority:
- Atribut
locale="…"na vloženém kódu (nejvyšší priorita) - Jazyk widgetu nastavený na kartě Widgety agenta
- Angličtina (výchozí)
Jazyk widgetu ovlivňuje pouze text na obrazovce, který návštěvník čte — popisky, výběr země, stavové zprávy. Skutečná hlasová konverzace probíhá v jakémkoli jazyce, na který je váš agent nakonfigurován mluvit.
Chování opakovaných pokusů
Pokud návštěvník nezvedne při prvním pokusu, agent počká nakonfigurovaný interval a vytočí znovu — až do nakonfigurovaného počtu pokusů.
- Pokusy: 1–5 (výchozí 3)
- Interval: 1–30 minut (výchozí 5)
Widget zobrazuje návštěvníkovi stav každého pokusu. Po neúspěchu všech pokusů se widget přepne do stavu "nemohli jsme vás zastihnout" se zdvořilou zprávou.
Tři pokusy v pětiminutových intervalech fungují dobře pro většinu landing pages na generování leadů — dostatečně rychle, aby návštěvník stále prohlížel, dostatečně jemně, aby to nepůsobilo dotěrně. Zvyšte je, pokud má vaše cílová skupina tendenci ignorovat neznámá čísla.
Jedno zpětné volání na načtení stránky
Jakmile návštěvník odešle své číslo, widget se uzamkne na zbytek životnosti té stránky:
- Zavření dialogu sbalí pill, ale neresetuje formulář.
- Opětovné otevření zobrazí aktuální stav (ve frontě / vytáčení / dokončeno / selhalo), ne čerstvý formulář.
- Pro druhé zpětné volání musí návštěvník obnovit stránku.
To zabraňuje náhodnému duplicitnímu odeslání, zatímco je hovor již na cestě. Pokud návštěvník explicitně zruší své zpětné volání zařazené do fronty z dialogu (tlačítko "Zrušit" na obrazovce fronty), zámek se uvolní a může okamžitě znovu odeslat.
Co se stane, když znovu načtou stránku uprostřed zpětného volání?
Pokud návštěvník znovu načte stránku, zatímco agent stále zkouší jejich číslo, widget zjistí, že již existuje aktivní zpětné volání pro stejné číslo, a tiše se k němu znovu připojí — žádné duplicitní vytáčení, žádný druhý záznam ve frontě. Návštěvník jednoduše vidí, že jeho stávající stav pokračuje tam, kde skončil.
Souběžnost a propustnost
Jediný agent může mít až 10 zpětných volání probíhajících současně. Odeslání nad tento limit čekají ve frontě a vytáčejí se, jakmile se uvolní kapacita.
Smyčka "agent uvolněn — pak vytočit" odčerpává frontu nepřetržitě — většina návštěvníků je vytočena během několika sekund od odeslání, pokud nejste blízko stropu souběžnosti.
Existuje limit rychlosti na číslo (číslo lze pro stejného agenta zařadit do fronty jen několikrát za hodinu), aby se zabránilo zneužití. Návštěvníci, kteří jej dosáhnou, vidí přívětivou zprávu "brzy se vám ozveme" místo obrazovky fronty.
Živý náhled v dashboardu
Karta Widgety zobrazuje vedle nastavení živý náhled widgetu zpětného volání. Jakákoli změna, kterou provedete — téma, jazyk, počet pokusů — okamžitě aktualizuje náhled. Nemusíte nasazovat svůj web, abyste viděli, jak bude widget vypadat.
Náhled používá maketový manifest s úplným seznamem zemí a demo způsobilostí, takže widget se vykresluje i na plánech, kde odchozí zpětná volání zatím nejsou k dispozici.
Vložené sledování
Widget vyzařuje stejné události call-start a call-end jako ostatní widgety. Naslouchejte jim v JavaScriptu, pokud chcete spustit vlastní analytiku:
const widget = document.querySelector('hanc-ai-callback');
widget.addEventListener('call-start', () => {
// Zpětné volání návštěvníka bylo právě spojeno — sledujte jako konverzi
});
widget.addEventListener('call-end', () => {
// Zpětné volání skončilo — sledujte trvání, výsledek atd.
});
Dostupnost podle plánu
| Plán | Widget zpětného volání |
|---|---|
| Free | Není dostupný (vyžaduje odchozí volání) |
| Starter / Pro / Business / Enterprise | Dostupný |
Všechny placené plány získají stejnou sadu funkcí widgetu. Náklady za hovor sledují vaši běžnou odchozí sazbu — viz Fakturace.
Související
- Webové widgety — Typy widgetů Floating, Pill, Inline a Popup pro konverzace v prohlížeči
- Nastavení — Nastavení hovorů na úrovni agenta včetně Maximální doby trvání hovoru, která omezuje i zpětná volání
- Telefonní čísla — Připojte odchozí číslo, ze kterého bude váš widget zpětného volání vytáčet
- FAQ — Časté otázky a okrajové případy