Віджет зворотного дзвінка
Віджет зворотного дзвінка — це невелика форма для вбудовування, яка дозволяє відвідувачам вашого сайту залишити свій номер телефону й отримати дзвінок від вашого AI агента — зазвичай протягом кількох секунд. Замість того, щоб просити відвідувачів самим набирати номер, розмова приходить до них.
Це п'ятий тип віджета, поряд із плаваючим (Floating), pill, вбудованим (Inline) і випливаючим (Popup) — але працює він зовсім інакше. Інші віджети починають голосову розмову в браузері. Віджет зворотного дзвінка ставить у чергу справжній телефонний дзвінок, який ваш агент здійснює через ваш вихідний номер.
Коли використовувати
| Сценарій | Чому віджет зворотного дзвінка підходить |
|---|---|
| Лід-генеруючі лендінги | Відвідувач залишає номер телефону, агент кваліфікує його протягом наступної хвилини |
| Сторінки продуктів із високим наміром | «Поговоріть зі спеціалістом» без необхідності набирати номер |
| Сайти, орієнтовані на мобільні пристрої | Один тап на pill, без запиту дозволу, без навушників |
| Покриття поза робочими годинами | Відвідувач залишає номер після годин роботи, агент телефонує, коли черга відкривається |
| Менше тертя порівняно з формами | Відвідувачі заповнюють лише одне поле й отримують миттєву відповідь |
Доступність
Віджет зворотного дзвінка вимагає трьох речей у вашому акаунті, перш ніж його можна буде увімкнути:
| Вимога | Чому |
|---|---|
| Платний тариф (Starter або вище) | Вихідні хвилини, використані під час зворотного дзвінка, тарифікуються похвилинно |
| Верифікований вихідний номер телефону, призначений агенту | Агенту потрібен справжній номер, з якого телефонувати |
| Верифікований email у вашому робочому просторі | Підтверджує право власності, перш ніж розблокувати вихідні дзвінки |
Якщо чогось із цього не вистачає, у розділі віджета зворотного дзвінка на вкладці Widgets агента з'явиться сповіщення, яке точно скаже, що треба виправити. Віджет залишатиметься вимкненим, доки всі три умови не виконано.
Віджет зворотного дзвінка недоступний на тарифі Free, оскільки він здійснює вихідні телефонні дзвінки. Усі інші типи віджетів (Floating, Pill, Inline) залишаються безкоштовними.
Налаштування
1. Увімкнути зворотний дзвінок для агента
- Відкрийте свого агента та перейдіть на вкладку Widgets.
- Прогорніть до розділу Callback widget.
- Увімкніть перемикач «Enable callback widget».
- Налаштуйте:
- Retry attempts — скільки разів агент повторюватиме спробу, якщо відвідувач не бере слухавку (1–5, за замовчуванням 3).
- Retry interval — хвилин між спробами (1–30, за замовчуванням 5).
- Widget language — мова, якою форма, статусні повідомлення та селектор країни говорять із вашим відвідувачем (доступно 14 мов — див. нижче).
- Theme — кольорова схема для плаваючої pill і діалогу (використовує ту саму палітру тем, що й інші віджети).
- Збережіть.
Поряд із налаштуваннями з'являється живий попередній перегляд віджета, тож ви можете відразу бачити зміни — не треба деплоїти, щоб перевірити вигляд.
2. Скопіювати фрагмент вбудовування
У тому ж розділі скопіюйте 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>
Вставте його один раз на свій сайт, зазвичай прямо перед </body>. Віджет з'явиться у вигляді плаваючої pill у кутку сторінки.
Тег @latest означає, що ваш сайт автоматично отримує нові версії віджета, коли вони виходять. Закріпіть конкретну версію (наприклад, hanc-webrtc-widgets@1.4.0), якщо хочете повністю контролювати оновлення.
Що бачить відвідувач
Віджет проводить відвідувачів через чотири стани:
| Стан | Що бачить відвідувач |
|---|---|
| Form | Плаваюча pill у кутку. Клац — і вона відкривається. Селектор країни ліворуч, поле телефону праворуч, кнопка надсилання. |
| Queued | «Ви в черзі — приблизно N секунд до того, як ми вам зателефонуємо.» Оновлюється в реальному часі. |
| Dialing | «Зараз ми вам телефонуємо.» Залишається, доки дзвінок не з'єднається або не зірветься. |
| Completed / Failed | Коротке підтвердження або доброзичливе повідомлення про помилку з підказкою «перезавантажте сторінку, щоб зробити ще один зворотний дзвінок». |
Форма автоматично перевіряє номер телефону на відповідність національному формату обраної країни й відмовляється надсилати, якщо номер виглядає неправдоподібно.
Покриття країн
Селектор країни охоплює Європу (ЄС + DACH + Велика Британія), Північну Америку (США + Канада) та підібраний набір додаткових країн із широкою підтримкою. Кожна країна показує свій прапор, назву та зразок-плейсхолдер у рідному форматі, щоб відвідувач знав, що вводити.
Якщо країни, яку використовують ваші відвідувачі, немає у списку, зв'яжіться з support@hanc.ai — покриття регулярно розширюється.
HTML-атрибути
Віджет приймає такі атрибути на тегу <hanc-ai-callback>:
| Атрибут | Обов'язковий | Опис |
|---|---|---|
agent-id | Так | Унікальний ідентифікатор вашого агента |
locale | Ні | Перевизначає мову інтерфейсу віджета для цієї сторінки (наприклад, locale="de"). Корисно, якщо ваш сайт багатомовний і мова сторінки не збігається зі стандартною мовою агента. |
theme | Ні | Перевизначає кольорову тему для цієї сторінки |
position | Ні | Куди прикріпляється плаваюча pill (bottom-right, bottom-left, top-right, top-left) |
Усе, що ви не вкажете, повертається до того, що ви налаштували для агента в дашборді.
Приклад: німецька сторінка на багатомовному сайті
<hanc-ai-callback agent-id="YOUR_AGENT_ID" locale="de"></hanc-ai-callback>
<script src="https://unpkg.com/hanc-webrtc-widgets@latest" async></script>
Текст pill, мітки діалогу, селектор країни та статусні повідомлення перемикаються на німецьку. Сам агент усе ще говорить тією мовою, на яку він налаштований — locale впливає лише на те, що відвідувач читає на сторінці.
Мова віджета
Інтерфейс віджета постачається з 14 вбудованими мовами:
| Код | Мова |
|---|---|
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 | Українська |
Агент обирає свою мову з трьох місць, у порядку пріоритету:
- Атрибут
locale="…"на вбудовуванні (найвищий пріоритет) - Widget language, налаштована на вкладці Widgets агента
- Англійська (за замовчуванням)
Мова віджета впливає лише на текст на екрані, який читає відвідувач — мітки, селектор країни, статусні повідомлення. Сама голосова розмова відбувається тією мовою, яку налаштовано для агента.
Поведінка повторних спроб
Якщо відвідувач не бере слухавку з першої спроби, агент чекає налаштований інтервал і телефонує знову — до налаштованої кількості спроб.
- Спроби: 1–5 (за замовчуванням 3)
- Інтервал: 1–30 хвилин (за замовчуванням 5)
Віджет показує відвідувачу статус кожної спроби. Після того, як усі спроби невдалі, віджет перемикається у стан «нам не вдалося до вас додзвонитися» з ввічливим повідомленням.
Три спроби з п'ятихвилинним інтервалом добре працюють для більшості лід-генеруючих сторінок — досить швидко, щоб відвідувач ще переглядав сайт, досить делікатно, щоб не здаватися нав'язливим. Збільшіть, якщо ваша аудиторія схильна ігнорувати невідомі номери.
Один зворотний дзвінок на одне завантаження сторінки
Щойно відвідувач надсилає свій номер, віджет блокується до кінця життя цієї сторінки:
- Закриття діалогу згортає pill, але не скидає форму.
- Повторне відкриття показує поточний стан (queued / dialing / completed / failed), а не свіжу форму.
- Щоб зробити другий зворотний дзвінок, відвідувачу треба перезавантажити сторінку.
Це запобігає випадковим дублюючим надсиланням, поки дзвінок уже на шляху. Якщо відвідувач явно скасовує свій зворотний дзвінок із діалогу (кнопка «Cancel» на екрані queued), блокування знімається й він може надіслати знову одразу.
Що станеться, якщо вони перезавантажать сторінку посеред зворотного дзвінка?
Якщо відвідувач перезавантажує сторінку, поки агент усе ще повторює спроби з його номером, віджет виявляє, що активний зворотний дзвінок для того ж номера вже існує, і тихо перепідключається до нього — без дублюючого набору, без другого запису в черзі. Відвідувач просто бачить, як його існуючий статус продовжується з того місця, де зупинився.
Конкурентність і пропускна спроможність
Один агент може мати до 10 одночасних зворотних дзвінків у роботі. Подання понад це чекають у черзі й набираються в міру звільнення потужності.
Цикл «агент звільнився — далі набирає» безперервно спустошує чергу — більшість відвідувачів набирається протягом кількох секунд після подання, якщо ви не наближаєтеся до межі конкурентності.
Існує обмеження швидкості на номер (один номер можна поставити в чергу лише кілька разів на годину для того ж агента), щоб запобігти зловживанням. Відвідувачі, які його досягнуть, побачать доброзичливе повідомлення «ми незабаром зв'яжемося з вами» замість екрана queued.
Живий попередній перегляд у дашборді
Вкладка Widgets показує живий попередній перегляд віджета зворотного дзвінка поряд із налаштуваннями. Будь-яка зміна, яку ви вносите — тема, мова, числа повторних спроб — миттєво оновлює попередній перегляд. Вам не треба деплоїти свій сайт, щоб побачити, як виглядатиме віджет.
Попередній перегляд використовує макетний маніфест із повним списком країн і демо-доступністю, тож віджет рендериться навіть на тарифах, де вихідні зворотні дзвінки ще недоступні.
Вбудоване відстеження
Віджет генерує ті ж події call-start і call-end, що й інші віджети. Слухайте їх у JavaScript, якщо хочете запускати власну аналітику:
const widget = document.querySelector('hanc-ai-callback');
widget.addEventListener('call-start', () => {
// Зворотний дзвінок відвідувача щойно з'єднався — відстежуйте як конверсію
});
widget.addEventListener('call-end', () => {
// Зворотний дзвінок завершено — відстежуйте тривалість, результат тощо
});
Доступність на тарифах
| Тариф | Віджет зворотного дзвінка |
|---|---|
| Free | Недоступно (вимагає вихідних дзвінків) |
| Starter / Pro / Business / Enterprise | Доступно |
Усі платні тарифи отримують той самий набір функцій віджета. Вартість одного дзвінка слідує вашому звичайному вихідному тарифу — див. Білінг.
Пов'язане
- Віджети сайту — типи віджетів Floating, Pill, Inline та Popup для розмов у браузері
- Налаштування — налаштування дзвінків на рівні агента, включно з Max Call Duration, яке також обмежує зворотні дзвінки
- Номери телефонів — підключіть вихідний номер, з якого ваш віджет зворотного дзвінка телефонуватиме
- FAQ — поширені запитання та крайні випадки