Skip to main content
Добавете вашия AI асистент към всеки уебсайт с персонализируем widget, който поддържа гласови обаждания, текстов чат или и двете.

Общ преглед

Web Widget позволява на посетителите на уебсайта да взаимодействат с вашия AI асистент директно чрез:
  • Гласови разговори: Гласови обаждания в реално време в браузъра
  • Текстов чат: Интерфейс за съобщения за текстови взаимодействия
  • Хибриден режим: Безпроблемно превключване между глас и чат

Достъп до конфигурацията на Widget

  1. Отидете на страницата за редактиране на вашия асистент
  2. Кликнете върху бутона “Web widget” (жълт/предупредителен цвят)
  3. Панелът за конфигуриране на widget се отваря с живо предварително виждане
Web Widget Button Location
Web Widget е премиум функция. Уверете се, че планът ви включва достъп до web widget преди конфигурирането.

Режими на Widget

Изберете как посетителите взаимодействат с вашия асистент:

Глас и Чат (Препоръчва се)

Потребителите могат безпроблемно да превключват между глас и текст по време на разговорите. Най-подходящ за:
  • Максимална гъвкавост за потребителите
  • Достъпност (глас за мобилни устройства, чат за тихи среди)
  • Сложни взаимодействия, изискващи двата режима

Само Чат

Само интерфейс за текстови съобщения. Най-подходящ за:
  • Клиентска поддръжка и често задавани въпроси
  • Среди, където гласът не е подходящ
  • Формуляри за събиране и квалифициране на потенциални клиенти

Само Глас

Само гласови разговори в реално време. Най-подходящ за:
  • Телефонно изживяване на уебсайта
  • Случаи на употреба с приоритет на гласа
  • Интерактивности без използване на ръце

Опции за конфигуриране

Основен раздел

Widget General Tab
Режим на Widget: Глас, Чат или Глас и Чат Размер на Widget: Изберете между стандартно или много голямо оформление
  • Стандартно: Компактен плаващ widget, подходящ за повечето случаи на употреба
  • Много Голямо: Полуекранен панел на настолни компютри, цял екран на мобилни устройства — идеален за подробни разговори
Позиция: Изберете от 8 позиции (долу-дясно, долу-ляво, долу-център, средно-дясно, средно-ляво, горе-дясно, горе-ляво, горе-център) Основен цвят: Цвят на марката за бутони и акценти Размер на бутона за превключване: Малък или Нормален Стил на бутона за превключване: Анимиран (стъклен морфизъм) или Прост (плосък дизайн) Автоматично отваряне при зареждане на страницата: Когато е активирано, widget-ът се разширява автоматично при зареждане на страницата — не се изисква кликване от посетителя.

Раздел Бутон

Widget Button Tab
Персонализиран аватар: Качете собствено изображение за аватар, за да замените иконата по подразбиране на widget. Появява се на бутона за превключване и в заглавието на чата. Максимален размер на файл: 512KB, съотношение 1:1 (квадратно). Основен текст на бутона (по подразбиране: “Need help?”) — основен текст на бутона на widget Подтекст на бутона (по подразбиране: “Chat with us”) — вторичен текст, скрит при използване на малък размер на бутона Етикети на разделите (само за режим Глас и Чат):
  • Етикет на раздела за глас (по подразбиране: “Voice”) — преименувайте, за да съответства на езика на вашата марка (напр. “Call Us”, “Speak”)
  • Етикет на раздела за чат (по подразбиране: “Chat”) — преименувайте, за да съответства на езика на вашата марка (напр. “Message”, “Text”)

Раздел Заглавие и Модал

Widget Header & Modal Tab
Заглавие на заглавната част (по подразбиране: “AI Assistant”) Подзаглавие на заглавната част (по подразбиране: “Ready to help you ✨”) Заглавие на модала (по подразбиране: “Ready to chat?”) Текст на бутона за стартиране (по подразбиране: “Start Voice Chat”) Описание на модала (по подразбиране: “Click below to start your conversation”)

Раздел Настройки на Чата

Widget Chat Settings Tab
Този раздел е видим само когато режимът на widget включва чат (Само Чат или Глас и Чат).
Заместител за чат (по подразбиране: “Type your message…”) Етикет на бутона за изпращане (по подразбиране: “Send message”) — етикет за достъпност на бутона за изпращане Показване на извиквания на функции: Когато е деактивирано (по подразбиране), извикванията на LLM инструменти (напр. търсене в календар, заявки към база знания) са скрити от чата, запазвайки разговора чист за крайните потребители. Активирайте, за да покажете подробности за използването на инструменти.

Кликваеми връзки в чата

Chat widget поддържа markdown форматиране, така че вашият AI асистент може да изпраща кликваеми връзки, удебелен текст, списъци и други. За да включите кликваеми URL адреси в съобщенията в чата, използвайте markdown формат за връзки в подканата или началното съобщение на вашия асистент:
Разгледайте нашите [най-нови оферти](https://example.com/offers) или посетете нашия [център за помощ](https://example.com/help).
Добавете инструкция в подканата на вашия асистент като: “Когато споделяте връзки или URL адреси, винаги ги форматирайте като кликваеми markdown връзки: текст на връзката — това гарантира, че AI последователно извежда кликваеми връзки вместо обикновени текстови URL адреси.

Раздел Гласови настройки

Widget Voice Settings Tab
Този раздел е видим само когато режимът на widget включва глас (Само Глас или Глас и Чат).
Текст за свързване (по подразбиране: “Connecting…”) Текст за прекъсване (по подразбиране: “Disconnect”) Текст за грешка (по подразбиране: “Connection failed. Please try again.”)

Формуляр преди чат

Pre-Chat Form Configuration
Събирайте информация преди започване на разговори: Конфигуриране на формуляр:
  • Заглавие на пред-формуляра (по подразбиране: “Before we start…”)
  • Описание на пред-формуляра (по подразбиране: “Please provide some information to help us assist you better”)
  • Текст на бутона за изпращане (по подразбиране: “Continue”)
Полета на формуляра: Добавете персонализирани полета за събиране на данни:
  • Име на променливата: Вътрешно име на променливата (съпоставя се с променливи на асистента). Разрешени са само букви, цифри, тирета и долни черти.
  • Етикет на полето: Етикет за показване, видим за потребителите
  • Тип на полето: Текст, Email, Телефон или Текстова област
  • Задължително: Направете полето задължително
  • Заместител: Заместящ текст, показван в полето
  • Помощен текст: Незадължително описание под полето
Съпоставяне на променливи: Имената на полетата от формуляра се съпоставят автоматично с променливите на вашия асистент, правейки събраните данни достъпни по време на разговорите. Примерни полета на формуляр:
Име: Пълно име (задължително, текст)
Email: Email адрес (задължително, email)
Компания: Име на компания (незадължително, текст)
Съобщение: Как можем да помогнем? (незадължително, текстова област)

Настройки за AI отговори

Widget AI Response Settings
AI активиран: Когато е включено (по подразбиране), AI асистентът автоматично отговаря на входящи съобщения. Изключете това, ако искате да използвате widget само за ръчни разговори — съобщенията се събират, но AI не отговаря.

Webhook за разговор

Widget Conversation Webhook
URL на Webhook: Въведете URL за получаване на webhook уведомление всеки път, когато нов разговор започне чрез widget. Използвайте това за задействане на автоматизирани потоци, записване на събития в вашата CRM или уведомяване на екипа ви в реalno време.

Показване на Widget

Widget Display Toggle
Активиране на Widget: Главен превключвател, който контролира дали widget се зарежда на вашия уебсайт. Когато е деактивиран, widget няма да се появи дори ако скриптът за вграждане е инсталиран на вашия сайт. Използвайте това за временно скриване на widget без премахване на код от вашия уебсайт.

Живо предварително виждане на Widget

Widget Live Preview
В горната част на панела за конфигуриране живото предварително виждане показва точно как вашият widget ще изглежда и ще се държи на уебсайт. Предварителният преглед се актуализира в реално време, докато променяте всяка настройка. Копиране на URL за предварителен преглед — копира URL адреса за предварителен преглед в клипборда ви, така че да можете да го отворите в отделен раздел на браузъра или да го споделите с екипа си за преглед. Нулиране на данните — изчиства цялата съхранена история на разговорите, изпращанията на формуляри и предпочитанията в предварителния преглед. Използвайте това за симулиране на изживяването на посетител за пръв път след тестване.
Предварителният преглед е напълно интерактивен — можете да кликнете върху бутона на widget, да попълните формуляра преди чат и да започнете истински разговор, за да тествате конфигурацията си преди внедряване.

Код за вграждане

Widget Embed Code
Секцията с кода за вграждане предоставя готов за копиране script таг. Кликнете Copy, за да го копирате в клипборда си, след което го поставете в уебсайта си преди затварящия </body> таг:
<script src="https://call.aiployees.com/embed.js"
        data-assistant-id="your-assistant-id">
</script>
Запазете настройките на widget преди копиране на кода за вграждане. Скриптът зарежда цялата конфигурация от сървъра, така че всички незапазени промени няма да се появят на вашия уебсайт.

Инсталация

  1. Конфигурирайте и запазете настройките на вашия widget
  2. Копирайте кода за вграждане от секцията Embed Code
  3. Поставете script тага преди затварящия </body> таг на вашия уебсайт
  4. Посетете уебсайта си и проверете дали widget се появява в конфигурираната позиция
  5. Тествайте функционалността за глас/чат и формуляра преди чат (ако е конфигуриран)

Поведение на Widget

Първо посещение

  • Бутонът на widget се появява в конфигурираната позиция
  • Кликването отваря модален/чат интерфейс
  • Показва се формулярът преди чат (ако е конфигуриран)
  • След изпращане на формуляра започва разговор

Повторни посещения

  • Предишното състояние на разговора може да бъде възстановено
  • Данните от формуляра се запомнят (ако посетителят не е изчистил cookies)
  • Безпроблемно продължение на изживяването за поддръжка

Проследяване на разговори

Всички разговори от widget се появяват в страницата ви Conversations за преглед и анализ.
HTTPS (SSL сертификат) се изисква за гласова функционалност. HTTP сайтове могат да използват само чат режим поради ограничения за сигурност на браузъра.

Отстраняване на проблеми

За проблеми с настройката и конфигурацията вижте Web Widget Troubleshooting.

Следващи стъпки

  • Тествайте widget, използвайки живото предварително виждане
  • Вградете кода в уебсайта си
  • Наблюдавайте разговорите в страницата Conversations