Виджет для сайта
Встраиваемый веб-компонент голосового агента Voxagent
Voxagent предоставляет встраиваемый веб-компонент, который добавляет голосового агента на любой сайт.
Обзор
Виджет — это Angular веб-компонент, упакованный как <speaknode-agent>. Он подключается к опубликованному агенту и позволяет посетителям сайта вести голосовой разговор прямо в браузере.
Установка
Добавьте скрипт виджета на сайт и разместите элемент:
<speaknode-agent agent-id="your-agent-id"></speaknode-agent>Настройка
Атрибуты
| Атрибут | Тип | Описание |
|---|---|---|
agent-id | string | ID опубликованного агента |
agent-token | string | Предгенерированный JWT-токен (опционально) |
language | string | Переопределение языковой локали |
initialized | boolean | Режим внешней конфигурации |
Передача переменных через URL
Динамические переменные можно передавать как query-параметры URL. Виджет считывает их автоматически и передаёт агенту при запуске.
Пример:
https://yoursite.com/page?customer_name=Иван&order_id=12345Настройка виджета в админ-панели
На странице редактирования агента вкладка Widget позволяет:
- Настроить расположение и внешний вид виджета
- Сгенерировать код для встраивания
- Задать кастомные цвета темы
Как это работает
- Виджет загружается на странице и получает публичную конфигурацию агента
- Пользователь нажимает, чтобы начать разговор
- Виджет запрашивает токен диспатча у бэкенда
- Создаётся LiveKit-комната, запускается агент
- Виджет подключается к комнате через WebRTC
- Голосовой разговор начинается в реальном времени
- После завершения разговора сессия сохраняется
Требования
- Агент должен быть опубликован (
is_published: true) - Браузер пользователя должен поддерживать WebRTC
- Необходим доступ к микрофону