Виджет для сайта¶

SpeakNode предоставляет встраиваемый веб-компонент, который добавляет голосового агента на любой сайт.

Обзор¶

Виджет — это 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
Необходим доступ к микрофону