> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aiployees.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Web Widget
> Интегрирайте вашия AI асистент на уебсайта си с възможности за гласови обаждания и чат
Добавете вашия AI асистент към всеки уебсайт с персонализируем widget, който поддържа гласови обаждания, текстов чат или и двете.
## Общ преглед
Web Widget позволява на посетителите на уебсайта да взаимодействат с вашия AI асистент директно чрез:
* **Гласови разговори:** Гласови обаждания в реално време в браузъра
* **Текстов чат:** Интерфейс за съобщения за текстови взаимодействия
* **Хибриден режим:** Безпроблемно превключване между глас и чат
## Достъп до конфигурацията на Widget
1. Отидете на страницата за редактиране на вашия асистент
2. Кликнете върху бутона **"Web widget"** (жълт/предупредителен цвят)
3. Панелът за конфигуриране на widget се отваря с живо предварително виждане
Web Widget е премиум функция. Уверете се, че планът ви включва достъп до web widget преди конфигурирането.
## Режими на Widget
Изберете как посетителите взаимодействат с вашия асистент:
### Глас и Чат (Препоръчва се)
Потребителите могат безпроблемно да превключват между глас и текст по време на разговорите.
**Най-подходящ за:**
* Максимална гъвкавост за потребителите
* Достъпност (глас за мобилни устройства, чат за тихи среди)
* Сложни взаимодействия, изискващи двата режима
### Само Чат
Само интерфейс за текстови съобщения.
**Най-подходящ за:**
* Клиентска поддръжка и често задавани въпроси
* Среди, където гласът не е подходящ
* Формуляри за събиране и квалифициране на потенциални клиенти
### Само Глас
Само гласови разговори в реално време.
**Най-подходящ за:**
* Телефонно изживяване на уебсайта
* Случаи на употреба с приоритет на гласа
* Интерактивности без използване на ръце
## Опции за конфигуриране
### Основен раздел
**Режим на Widget:** Глас, Чат или Глас и Чат
**Размер на Widget:** Изберете между стандартно или **много голямо** оформление
* **Стандартно**: Компактен плаващ widget, подходящ за повечето случаи на употреба
* **Много Голямо**: Полуекранен панел на настолни компютри, цял екран на мобилни устройства — идеален за подробни разговори
**Позиция:** Изберете от 8 позиции (долу-дясно, долу-ляво, долу-център, средно-дясно, средно-ляво, горе-дясно, горе-ляво, горе-център)
**Основен цвят:** Цвят на марката за бутони и акценти
**Размер на бутона за превключване:** Малък или Нормален
**Стил на бутона за превключване:** Анимиран (стъклен морфизъм) или Прост (плосък дизайн)
**Автоматично отваряне при зареждане на страницата:** Когато е активирано, widget-ът се разширява автоматично при зареждане на страницата — не се изисква кликване от посетителя.
### Раздел Бутон
**Персонализиран аватар:** Качете собствено изображение за аватар, за да замените иконата по подразбиране на widget. Появява се на бутона за превключване и в заглавието на чата. Максимален размер на файл: 512KB, съотношение 1:1 (квадратно).
**Основен текст на бутона** (по подразбиране: "Need help?") — основен текст на бутона на widget
**Подтекст на бутона** (по подразбиране: "Chat with us") — вторичен текст, скрит при използване на малък размер на бутона
**Етикети на разделите (само за режим Глас и Чат):**
* Етикет на раздела за глас (по подразбиране: "Voice") — преименувайте, за да съответства на езика на вашата марка (напр. "Call Us", "Speak")
* Етикет на раздела за чат (по подразбиране: "Chat") — преименувайте, за да съответства на езика на вашата марка (напр. "Message", "Text")
### Раздел Заглавие и Модал
**Заглавие на заглавната част** (по подразбиране: "AI Assistant")
**Подзаглавие на заглавната част** (по подразбиране: "Ready to help you ✨")
**Заглавие на модала** (по подразбиране: "Ready to chat?")
**Текст на бутона за стартиране** (по подразбиране: "Start Voice Chat")
**Описание на модала** (по подразбиране: "Click below to start your conversation")
### Раздел Настройки на Чата
Този раздел е видим само когато режимът на widget включва чат (Само Чат или Глас и Чат).
**Заместител за чат** (по подразбиране: "Type your message...")
**Етикет на бутона за изпращане** (по подразбиране: "Send message") — етикет за достъпност на бутона за изпращане
**Показване на извиквания на функции:** Когато е деактивирано (по подразбиране), извикванията на LLM инструменти (напр. търсене в календар, заявки към база знания) са скрити от чата, запазвайки разговора чист за крайните потребители. Активирайте, за да покажете подробности за използването на инструменти.
### Кликваеми връзки в чата
Chat widget поддържа **markdown форматиране**, така че вашият AI асистент може да изпраща кликваеми връзки, удебелен текст, списъци и други.
За да включите кликваеми URL адреси в съобщенията в чата, използвайте markdown формат за връзки в подканата или началното съобщение на вашия асистент:
```
Разгледайте нашите [най-нови оферти](https://example.com/offers) или посетете нашия [център за помощ](https://example.com/help).
```
Добавете инструкция в подканата на вашия асистент като: *"Когато споделяте връзки или URL адреси, винаги ги форматирайте като кликваеми markdown връзки: [текст на връзката](url)"* — това гарантира, че AI последователно извежда кликваеми връзки вместо обикновени текстови URL адреси.
### Раздел Гласови настройки
Този раздел е видим само когато режимът на widget включва глас (Само Глас или Глас и Чат).
**Текст за свързване** (по подразбиране: "Connecting...")
**Текст за прекъсване** (по подразбиране: "Disconnect")
**Текст за грешка** (по подразбиране: "Connection failed. Please try again.")
### Формуляр преди чат
Събирайте информация преди започване на разговори:
**Конфигуриране на формуляр:**
* Заглавие на пред-формуляра (по подразбиране: "Before we start...")
* Описание на пред-формуляра (по подразбиране: "Please provide some information to help us assist you better")
* Текст на бутона за изпращане (по подразбиране: "Continue")
**Полета на формуляра:**
Добавете персонализирани полета за събиране на данни:
* **Име на променливата:** Вътрешно име на променливата (съпоставя се с променливи на асистента). Разрешени са само букви, цифри, тирета и долни черти.
* **Етикет на полето:** Етикет за показване, видим за потребителите
* **Тип на полето:** Текст, Email, Телефон или Текстова област
* **Задължително:** Направете полето задължително
* **Заместител:** Заместящ текст, показван в полето
* **Помощен текст:** Незадължително описание под полето
**Съпоставяне на променливи:**
Имената на полетата от формуляра се съпоставят автоматично с променливите на вашия асистент, правейки събраните данни достъпни по време на разговорите.
**Примерни полета на формуляр:**
```
Име: Пълно име (задължително, текст)
Email: Email адрес (задължително, email)
Компания: Име на компания (незадължително, текст)
Съобщение: Как можем да помогнем? (незадължително, текстова област)
```
### Настройки за AI отговори
**AI активиран:** Когато е включено (по подразбиране), AI асистентът автоматично отговаря на входящи съобщения. Изключете това, ако искате да използвате widget само за ръчни разговори — съобщенията се събират, но AI не отговаря.
### Webhook за разговор
**URL на Webhook:** Въведете URL за получаване на webhook уведомление всеки път, когато нов разговор започне чрез widget. Използвайте това за задействане на автоматизирани потоци, записване на събития в вашата CRM или уведомяване на екипа ви в реalno време.
### Показване на Widget
**Активиране на Widget:** Главен превключвател, който контролира дали widget се зарежда на вашия уебсайт. Когато е деактивиран, widget няма да се появи дори ако скриптът за вграждане е инсталиран на вашия сайт. Използвайте това за временно скриване на widget без премахване на код от вашия уебсайт.
## Живо предварително виждане на Widget
В горната част на панела за конфигуриране живото предварително виждане показва точно как вашият widget ще изглежда и ще се държи на уебсайт. Предварителният преглед се актуализира в реално време, докато променяте всяка настройка.
**Копиране на URL за предварителен преглед** — копира URL адреса за предварителен преглед в клипборда ви, така че да можете да го отворите в отделен раздел на браузъра или да го споделите с екипа си за преглед.
**Нулиране на данните** — изчиства цялата съхранена история на разговорите, изпращанията на формуляри и предпочитанията в предварителния преглед. Използвайте това за симулиране на изживяването на посетител за пръв път след тестване.
Предварителният преглед е напълно интерактивен — можете да кликнете върху бутона на widget, да попълните формуляра преди чат и да започнете истински разговор, за да тествате конфигурацията си преди внедряване.
### Код за вграждане
Секцията с кода за вграждане предоставя готов за копиране script таг. Кликнете **Copy**, за да го копирате в клипборда си, след което го поставете в уебсайта си преди затварящия `` таг:
```html theme={null}