Widget zpětného volání
Widget zpětného volání je malý, vložitelný formulář, který vašim návštěvníkům webu umožňuje zanechat telefonní číslo a získat zpětné volání od vašeho AI agenta — obvykle během několika sekund. Místo abyste návštěvníky nutili vytáčet, konverzace přijde za nimi.
Toto je pátý typ widgetu, vedle widgetů Floating, Pill, Pill Floating a Inline — 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ý váš agent uskuteční přes vaše odchozí číslo.
Kdy jej použít
| Scénář | Proč se widget zpětného volání hodí |
|---|---|
| Landing pages pro generování leadů | Návštěvník se zaváže telefonním číslem, agent jej v příští minutě kvalifikuje |
| Produktové stránky s vysokým záměrem | „Promluvte si se specialistou“ bez nutnosti návštěvníka vytáčet |
| Weby zaměřené primárně na mobil | Jedno klepnutí na pill, žádná žádost o oprávnění, žádná sluchátka |
| Pokrytí mimo pracovní dobu | Návštěvník zanechá číslo po pracovní době, agent vytočí, až se fronta otevře |
| Nižší 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ž jej lze povolit:
| Požadavek | Proč |
|---|---|
| Placený tarif (Starter nebo vyšší) | Odchozí minuty spotřebované během zpětného volání se účtují po minutách |
| Ověřené odchozí telefonní číslo přiřazené k agentovi | Agent potřebuje skutečné číslo, ze kterého bude vytáčet |
| Ověřený e-mail na vašem pracovním prostoru | Potvrzuje vlastnictví, než se odemknou odchozí hovory |
Pokud některá z těchto věcí chybí, sekce widgetu zpětného volání na kartě Widgets agenta zobrazí upozornění, které vám přesně řekne, co opravit. Widget zůstane zakázán, dokud nejsou splněny všechny tři podmínky.
Widget zpětného volání není v tarifu Free dostupný, 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í u agenta
- Otevřete svého agenta a přejděte na kartu Widgets.
- Přejděte dolů k sekci Callback widget.
- Zapněte přepínač „Enable callback widget“.
- Nakonfigurujte:
- Retry attempts — kolikrát to agent zkusí znovu, pokud návštěvník nezvedne (1–5, výchozí 3).
- Retry interval — minuty mezi pokusy (1–30, výchozí 5).
- Widget language — jazyk, kterým formulář, stavové zprávy a výběr země mluví s vaším návštěvníkem (14 dostupných jazyků — viz níže).
- Theme — barevné schéma pro plovoucí pill a dialog (používá stejnou paletu motivů jako ostatní widgety).
- Uložte.
Vedle nastavení se objeví živý náhled widgetu, takže své změny vidíte okamžitě — testovat vzhled můžete bez nasazování.
2. Zkopírujte vkládací úryvek
Ve stejné sekci zkopírujte HTML úryvek:
<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 jej jednou na svůj web, obvykle těsně před </body>. Widget se zobrazí jako plovoucí pill v rohu stránky.
Značka @latest znamená, že váš web automaticky přebírá nové verze widgetu, jakmile jsou vydány. Pokud chcete plnou kontrolu nad aktualizacemi, připněte konkrétní verzi (např. hanc-webrtc-widgets@1.4.0).
Co návštěvník vidí
Widget provede návštěvníky čtyřmi stavy:
| Stav | Co návštěvník vidí |
|---|---|
| Formulář | Plovoucí pill v rohu. Kliknutím jej otevřete. Výběr země vlevo, zadání telefonu 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řátelská chybová zpráva s nápovědou „znovu načtěte stránku pro další zpětné volání“. |
Formulář automaticky validuje telefonní číslo proti národnímu formátu zvolené země a odmítne odeslání, pokud číslo není věrohodné.
Pokrytí zemí
Výběr země pokrývá Evropu (EU + DACH + Velká Británie), Severní Ameriku (USA + Kanada) a pečlivě vybranou sadu dalších široce podporovaných zemí. Každá země zobrazuje svou vlajku, název a příklad zástupného textu v nativním formátu, takže návštěvník ví, co má 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 značce <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 locale stránky neodpovídá výchozímu nastavení agenta. |
theme | Ne | Přepíše barevný motiv pro tuto stránku |
position | Ne | Kde je plovoucí pill ukotven (bottom-right, bottom-left, top-right, top-left) |
Cokoli vynecháte, se vrátí k tomu, co jste nakonfigurovali u agenta 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 pill, 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 jazyce, pro který je nakonfigurován — locale ovlivňuje pouze to, co návštěvník na stránce čte.
Jazyk widgetu
UI widgetu je dodáváno s 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í priority:
- Atribut
locale="…"na vloženém kódu (nejvyšší priorita) - Widget language nastavený na kartě Widgets 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. Samotná hlasová konverzace probíhá v tom jazyce, pro který je váš agent nakonfigurován.
Chování při opakování
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. Poté, co všechny pokusy selžou, widget se přepne do stavu „nepodařilo se nám vás zastihnout“ se zdvořilou zprávou.
Tři pokusy v pětiminutových intervalech fungují dobře pro většinu stránek na generování leadů — dostatečně rychle na to, aby návštěvník ještě prohlížel, dostatečně jemně na to, aby to nepůsobilo dotěrně. Zvyšte je, pokud vaše publikum obvykle ignoruje 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 pro zbytek životnosti dané stránky uzamkne:
- Zavření dialogu sbalí pill, ale neresetuje formulář.
- Opětovné otevření zobrazí aktuální stav (ve frontě / vytáčení / dokončeno / selhalo), nikoli nový formulář.
- Pro provedení druhého zpětného volání musí návštěvník znovu načíst stránku.
To zabraňuje náhodnému duplicitnímu odeslání, zatímco je hovor už na cestě. Pokud návštěvník výslovně zruší své zpětné volání ve frontě z dialogu (tlačítko „Cancel“ na obrazovce fronty), zámek se uvolní a může znovu odeslat okamžitě.
Co se stane, když stránku znovu načte uprostřed zpětného volání?
Pokud návštěvník znovu načte stránku, zatímco agent stále zkouší jeho číslo, widget zjistí, že aktivní zpětné volání pro stejné číslo již existuje, a tiše se k němu znovu připojí — žádné duplicitní vytáčení, žádná druhá položka ve frontě. Návštěvník jen uvidí, jak jeho stávající stav pokračuje tam, kde skončil.
Souběžnost a propustnost
Jeden agent může mít současně až 10 probíhajících zpětných volání. Odeslání nad tento limit čekají ve frontě a jsou vytáčena, jak se uvolňuje kapacita.
Fronta se odbavuje průběžně — většina návštěvníků je vytočena během několika sekund od odeslání, pokud nejste blízko limitu souběžnosti.
Ochrana před spamem a zneužitím
Widget zpětného volání uskutečňuje skutečné telefonní hovory, takže má vestavěné pojistky, které brání tomu, aby vám špatný provoz navyšoval účet. Fungují automaticky — není co konfigurovat.
| Pojistka | Co návštěvník zažívá |
|---|---|
| Kontrola „Nejsem robot“ | Když je na platformě povolena ochrana před zneužitím, návštěvník před zařazením zpětného volání do fronty projde rychlým Google reCAPTCHA. Skuteční návštěvníci jej zvládnou za sekundu; boti jsou zastaveni. |
| Validace čísla | Formulář odmítne odeslat číslo, které není věrohodnou shodou pro zvolenou zemi, takže překlepy a nesmyslná čísla se nikdy nevytáčí. |
| Čísla s prémiovou sazbou a mimo pokrytí | Linky s prémiovou sazbou, některé rozsahy VoIP a čísla mimo podporované pokrytí nejsou volána zpět telefonicky. Pokud to prohlížeč návštěvníka podporuje, widget místo toho nabídne hlasový hovor v prohlížeči; jinak návštěvník uvidí zdvořilou zprávu „nemůžeme na toto číslo zavolat“. To brání zneužití widgetu k vytáčení drahých prémiových čísel. |
| Limit opakovaných odeslání | Stejné číslo lze pro agenta zařadit do fronty jen omezený počet za hodinu. Návštěvníci, kteří jej překročí, uvidí místo obrazovky fronty přátelskou zprávu „brzy se vám ozveme“. |
Tyto ochrany existují proto, že veřejný formulář zpětného volání je zjevný cíl pro zneužití — někdo by jej jinak mohl nasměrovat na čísla s prémiovou sazbou nebo jej zahltit boty, aby vám spálil odchozí minuty. Pojistky běží tiše na pozadí; běžní návštěvníci si jich nikdy nevšimnou.
Živý náhled v dashboardu
Karta Widgets zobrazuje živý náhled widgetu zpětného volání vedle nastavení. Jakákoli změna, kterou provedete — motiv, jazyk, čísla opakování — náhled okamžitě aktualizuje. Nemusíte nasazovat svůj web, abyste viděli, jak bude widget vypadat.
Náhled používá fiktivní manifest s kompletním seznamem zemí a ukázkovou způsobilostí, takže se widget vykreslí i v tarifech, kde odchozí zpětná volání zatím nejsou k dispozici.
Vestavěné sledování
Widget vydává 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', () => {
// Visitor's callback was just connected — track as conversion
});
widget.addEventListener('call-end', () => {
// Callback finished — track duration, outcome, etc.
});
Dostupnost v tarifech
| Tarif | Widget zpětného volání |
|---|---|
| Free | Není dostupný (vyžaduje odchozí volání) |
| Starter / Pro / Business / Enterprise | Dostupný |
Všechny placené tarify získávají stejnou sadu funkcí widgetu. Náklady na hovor se řídí vaší běžnou odchozí sazbou — viz Fakturace.
Související
- Webové widgety — Typy widgetů Floating, Pill, Pill Floating a Inline pro konverzace v prohlížeči
- Nastavení — Nastavení hovoru na úrovni agenta včetně Max Call Duration, 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