Widget oddzwaniania
Widget oddzwaniania to mały, osadzalny formularz, który pozwala odwiedzającym Twoją stronę zostawić numer telefonu i otrzymać oddzwonienie od agenta głosowego AI — zwykle w ciągu kilku sekund. Zamiast prosić odwiedzających, by dzwonili sami, rozmowa przychodzi do nich.
To piąty typ widgetu, obok widgetów Floating, Pill, Inline i Popup — ale działa zupełnie inaczej. Pozostałe widgety rozpoczynają rozmowę głosową w przeglądarce. Widget oddzwaniania kolejkuje prawdziwą rozmowę telefoniczną wykonaną przez agenta z Twojego numeru wychodzącego.
Kiedy go używać
| Scenariusz | Dlaczego widget oddzwaniania pasuje |
|---|---|
| Landing page'e do generowania leadów | Odwiedzający zobowiązuje się numerem telefonu, agent kwalifikuje go w ciągu minuty |
| Strony produktów o wysokiej intencji | "Porozmawiaj ze specjalistą" bez konieczności dzwonienia przez odwiedzającego |
| Strony zorientowane na mobilne | Jedno dotknięcie pigułki, bez pytania o uprawnienia, bez słuchawek |
| Obsługa poza godzinami pracy | Odwiedzający zostawia numer po godzinach, agent dzwoni po otwarciu kolejki |
| Mniejsze tarcie niż formularze | Odwiedzający wypełniają jedno pole i dostają natychmiastową odpowiedź |
Wymagania
Widget oddzwaniania wymaga trzech rzeczy na Twoim koncie, zanim będzie mógł zostać włączony:
| Wymaganie | Dlaczego |
|---|---|
| Płatny plan (Starter lub wyższy) | Minuty wychodzące zużyte podczas oddzwonienia są rozliczane za minutę |
| Zweryfikowany wychodzący numer telefonu przypisany do agenta | Agent potrzebuje prawdziwego numeru, z którego będzie dzwonił |
| Zweryfikowany adres email w Twojej przestrzeni roboczej | Potwierdza własność, zanim odblokowane zostaną połączenia wychodzące |
Jeśli któregoś z nich brakuje, sekcja widgetu oddzwaniania w zakładce Widgety agenta pokazuje alert mówiący dokładnie, co naprawić. Widget pozostaje wyłączony, dopóki wszystkie trzy nie są na miejscu.
Widget oddzwaniania nie jest dostępny w planie Free, ponieważ wykonuje wychodzące połączenia telefoniczne. Wszystkie pozostałe typy widgetów (Floating, Pill, Inline) pozostają darmowe.
Konfiguracja
1. Włącz oddzwanianie u agenta
- Otwórz swojego agenta i przejdź do zakładki Widgety.
- Przewiń do sekcji Widget oddzwaniania.
- Przełącz „Włącz widget oddzwaniania" na włączony.
- Skonfiguruj:
- Liczba prób — ile razy agent ponawia próbę, jeśli odwiedzający nie odbierze (1–5, domyślnie 3).
- Odstęp między próbami — minuty między próbami (1–30, domyślnie 5).
- Język widgetu — język, w którym formularz, komunikaty statusu i wybór kraju mówią do Twojego odwiedzającego (dostępnych 14 języków — patrz poniżej).
- Motyw — schemat kolorów dla pływającej pigułki i okna dialogowego (używa tej samej palety motywów co pozostałe widgety).
- Zapisz.
Podgląd na żywo widgetu pojawia się obok ustawień, dzięki czemu możesz natychmiast zobaczyć zmiany — nie ma potrzeby wdrażania, by przetestować wygląd.
2. Skopiuj fragment do osadzenia
W tej samej sekcji skopiuj fragment HTML:
<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>
Wklej go raz na swojej stronie, zwykle tuż przed </body>. Widget pojawi się jako pływająca pigułka w rogu strony.
Tag @latest oznacza, że Twoja strona automatycznie pobiera nowe wersje widgetu, gdy zostaną wydane. Przypnij do konkretnej wersji (np. hanc-webrtc-widgets@1.4.0), jeśli chcesz mieć pełną kontrolę nad aktualizacjami.
Co widzi odwiedzający
Widget prowadzi odwiedzających przez cztery stany:
| Stan | Co widzi odwiedzający |
|---|---|
| Formularz | Pływająca pigułka w rogu. Kliknij, aby otworzyć. Wybór kraju po lewej, pole numeru telefonu po prawej, przycisk wyślij. |
| W kolejce | „Jesteś w kolejce — około N sekund do oddzwonienia." Aktualizuje się na żywo. |
| Dzwonimy | „Dzwonimy do Ciebie teraz." Pozostaje, dopóki połączenie się nie nawiąże lub nie zakończy niepowodzeniem. |
| Zakończone / Nieudane | Krótkie potwierdzenie lub życzliwy błąd z podpowiedzią „przeładuj stronę, aby ponowić oddzwonienie". |
Formularz automatycznie waliduje numer telefonu względem narodowego formatu wybranego kraju i odmawia wysłania, jeśli numer nie jest wiarygodny.
Zasięg krajów
Wybór kraju obejmuje Europę (UE + DACH + Wielka Brytania), Amerykę Północną (USA + Kanada) oraz wyselekcjonowany zestaw dodatkowych szeroko wspieranych krajów. Każdy kraj pokazuje swoją flagę, nazwę i przykładowy placeholder w natywnym formacie, dzięki czemu odwiedzający wie, co wpisać.
Jeśli kraju używanego przez Twoich odwiedzających nie ma na liście, skontaktuj się z support@hanc.ai — zasięg jest regularnie rozszerzany.
Atrybuty HTML
Widget akceptuje następujące atrybuty na tagu <hanc-ai-callback>:
| Atrybut | Wymagany | Opis |
|---|---|---|
agent-id | Tak | Unikalny identyfikator Twojego agenta |
locale | Nie | Nadpisz język UI widgetu dla tej strony (np. locale="de"). Przydatne, jeśli Twoja strona jest wielojęzyczna, a język strony nie pasuje do domyślnego języka agenta. |
theme | Nie | Nadpisz motyw kolorów dla tej strony |
position | Nie | Gdzie zakotwiczona jest pływająca pigułka (bottom-right, bottom-left, top-right, top-left) |
Wszystko, czego nie podasz, wraca do tego, co skonfigurowałeś dla agenta w panelu.
Przykład: niemiecka strona w witrynie wielojęzycznej
<hanc-ai-callback agent-id="YOUR_AGENT_ID" locale="de"></hanc-ai-callback>
<script src="https://unpkg.com/hanc-webrtc-widgets@latest" async></script>
Tekst pigułki, etykiety okna dialogowego, wybór kraju i komunikaty statusu — wszystko przełącza się na język niemiecki. Sam agent nadal mówi w języku, na który jest skonfigurowany — locale wpływa tylko na to, co odwiedzający czyta na stronie.
Język widgetu
Interfejs widgetu jest dostarczany z 14 wbudowanymi językami:
| Kod | Język |
|---|---|
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 wybiera swój język z trzech miejsc, w kolejności priorytetu:
- Atrybut
locale="…"przy osadzeniu (najwyższy priorytet) - Język widgetu ustawiony w zakładce Widgety agenta
- Angielski (domyślnie)
Język widgetu wpływa tylko na tekst na ekranie, który odwiedzający czyta — etykiety, wybór kraju, komunikaty statusu. Rzeczywista rozmowa głosowa odbywa się w języku, na który agent jest skonfigurowany.
Zachowanie ponawiania prób
Jeśli odwiedzający nie odbierze za pierwszym razem, agent czeka skonfigurowany odstęp i dzwoni ponownie — do skonfigurowanej liczby prób.
- Próby: 1–5 (domyślnie 3)
- Odstęp: 1–30 minut (domyślnie 5)
Widget pokazuje odwiedzającemu status każdej próby. Po wszystkich nieudanych próbach widget przełącza się w stan „nie udało się do Ciebie dodzwonić" z uprzejmą wiadomością.
Trzy próby w odstępie pięciu minut sprawdzają się dobrze dla większości landing page'y do generowania leadów — wystarczająco szybko, by odwiedzający wciąż przeglądał stronę, wystarczająco delikatnie, by nie czuć nacisku. Zwiększ wartości, jeśli Twoja publiczność zwykle ignoruje nieznane numery.
Jedno oddzwonienie na załadowanie strony
Gdy odwiedzający wyśle swój numer, widget blokuje się na resztę życia tej strony:
- Zamknięcie okna dialogowego zwija pigułkę, ale nie resetuje formularza.
- Ponowne otwarcie pokazuje bieżący stan (w kolejce / dzwonimy / zakończone / nieudane), a nie świeży formularz.
- Aby wykonać drugie oddzwonienie, odwiedzający musi przeładować stronę.
Zapobiega to przypadkowemu duplikowaniu wysłań, gdy połączenie jest już w drodze. Jeśli odwiedzający wyraźnie anuluje swoje zakolejkowane oddzwonienie z okna dialogowego (przycisk „Anuluj" na ekranie kolejki), blokada zostaje zwolniona i może wysłać ponownie natychmiast.
Co się stanie, jeśli przeładują stronę w trakcie oddzwaniania?
Jeśli odwiedzający przeładuje stronę, gdy agent wciąż ponawia próby do jego numeru, widget wykrywa, że aktywne oddzwonienie dla tego samego numeru już istnieje i cicho się do niego ponownie łączy — bez podwójnego wybierania, bez drugiego wpisu w kolejce. Odwiedzający po prostu widzi swój istniejący status w miejscu, w którym został przerwany.
Współbieżność i przepustowość
Pojedynczy agent może mieć do 10 oddzwonień w toku jednocześnie. Wysłania ponad tę liczbę czekają w kolejce i są wybierane w miarę zwalniania się przepustowości.
Pętla zwolnij-agenta-i-dzwoń opróżnia kolejkę nieprzerwanie — większość odwiedzających jest wybierana w ciągu kilku sekund od wysłania, jeśli nie jesteś blisko limitu współbieżności.
Istnieje limit szybkości na numer (numer może być zakolejkowany tylko kilka razy na godzinę dla tego samego agenta), aby zapobiec nadużyciom. Odwiedzający, którzy go osiągną, widzą życzliwy komunikat „skontaktujemy się wkrótce" zamiast ekranu kolejki.
Podgląd na żywo w panelu
Zakładka Widgety pokazuje podgląd na żywo widgetu oddzwaniania obok ustawień. Każda zmiana, której dokonasz — motyw, język, liczby ponawiania — aktualizuje podgląd natychmiast. Nie musisz wdrażać swojej strony, by zobaczyć, jak widget będzie wyglądał.
Podgląd używa makietowego manifestu z pełną listą krajów i demo wymagań, więc widget renderuje się nawet w planach, gdzie oddzwonienia wychodzące nie są jeszcze dostępne.
Wbudowane śledzenie
Widget emituje te same zdarzenia call-start i call-end co pozostałe widgety. Nasłuchuj ich w JavaScript, jeśli chcesz uruchomić własną analitykę:
const widget = document.querySelector('hanc-ai-callback');
widget.addEventListener('call-start', () => {
// Oddzwonienie odwiedzającego zostało właśnie połączone — śledź jako konwersję
});
widget.addEventListener('call-end', () => {
// Oddzwonienie zakończone — śledź czas trwania, wynik itp.
});
Dostępność w planach
| Plan | Widget oddzwaniania |
|---|---|
| Free | Niedostępny (wymaga połączeń wychodzących) |
| Starter / Pro / Business / Enterprise | Dostępny |
Wszystkie płatne plany otrzymują ten sam zestaw funkcji widgetu. Koszt za połączenie wynika z Twojej standardowej stawki wychodzącej — patrz Rozliczenia.
Powiązane
- Widgety witryny — typy widgetów Floating, Pill, Inline i Popup do rozmów w przeglądarce
- Ustawienia — ustawienia połączeń na poziomie agenta, w tym Maks. czas rozmowy, który ogranicza także oddzwonienia
- Numery telefonów — podłącz numer wychodzący, z którego będzie dzwonił Twój widget oddzwaniania
- FAQ — częste pytania i przypadki brzegowe