Виджет ElevenLabs позволяет посетителям задавать вопросы голосом. Руководство для управляющего страницей и агентом: от настройки узкого публичного FAQ до проверки сайта, доступа, записей и расхода. Основано на документации от 20 октября 2026 года. BIG CHANGE не создавал агента, не встраивал виджет и не совершал тестовый звонок.

Главное изменение

  • Что: ElevenLabs описывает виджет для публичного агента ElevenAgents с голосовым режимом по умолчанию.
  • Как: Страница загружает элемент с видимым ID агента. Список разрешённых хостов определяет, с каких сайтов возможна связь.
  • Почему это важно: Владелец может проверить голосовую помощь на странице, но перед публикацией должен одобрить информацию, уведомление и возможные расходы. Список хостов не идентифицирует отдельных посетителей.

Подготовьте публичный FAQ и небольшой тест

Нужны права управлять одним агентом, менять и публиковать страницу. Подготовьте HTTPS-страницу, браузер с микрофоном и человека, одобряющего FAQ и слушающего ответы. Система публикации должна поддерживать элемент и скрипт; используйте её текущий способ добавления HTML. Пример — обычная HTML-вставка поставщика, не инструкция для конкретной платформы.

Запишите несколько одобренных публичных фактов и контакт человека для прочих обращений. Выберите вопрос с ответом в фактах и вопрос для отказа или передачи человеку. Исключите клиентские записи, внутренние правила, аккаунты и API-секреты. Назначьте согласующего голос и уведомление. Проверьте права на голос и условия использования: универсального коммерческого права руководство не устанавливает.

Перед тестом проверьте тариф, остаток кредитов, оплату по факту и цену модели. Создание агента, по ElevenLabs, бесплатно, но подключённые звонки расходуют ресурсы, а LLM может оплачиваться отдельно. Время соединения бывает дольше речи. Получите разрешение расходов для панели и сайта до тестов. Ограничение одного звонка не является месячным пределом расходов.

Настройте отдельного агента

  1. Создайте отдельного публичного FAQ-агента в панели ElevenLabs. Начните с одобренной пустой настройки или шаблона, изучите унаследованные знания и инструменты. Уберите частные сведения, бронирование, CRM, webhook и ненужные действия. Задайте цель, границы ответа, контакт человека, разрешённые голос и язык. Не превращайте существующего частного агента в публичного отключением аутентификации.
  2. В разделе Channels → Widget → Interfaceвыберите голосовой интерфейс, проверьте текст и условия для посетителей. Часть интерфейса также названа вкладкой Widget , поэтому сверяйте сохранённые настройки. Встраивание требует публичного агента с отключённой аутентификацией, настройка которого по руководству находится в Advanced. ID виден в исходнике страницы и не является секретом. Не помещайте API-ключи, личные и посетительские сведения в разметку или переопределения виджета.
  3. На вкладке Security добавьте точное имя хоста в Allowlist, сохраните и прочтите обратно. ElevenLabs указывает точное совпадение, до десяти хостов и отдельную запись поддоменов. Локальный тестовый хост добавляйте лишь при необходимости. Список ограничивает источник соединения, а не подтверждает личность говорящего.
  4. Проверьте хранение расшифровок и аудио, одобрите уведомление и согласие для сайта. Виджет может показать условия до звонка, но этот экран и разрешение микрофона не решают юридические обязанности сайта. В Advanced → Call limitsзадайте и сохраните подходящее значение Max conversation duration. Документированы 600 секунд по умолчанию и диапазон 60–7 200 секунд. Перед оплачиваемым тестом перечитайте настройки конфиденциальности, времени и доступа.

Вставьте код на одну черновую страницу

Добавьте код в тело страницы через поддерживаемую функцию HTML или скрипта. Замените YOUR_PUBLIC_AGENT_ID на ID отдельного агента. Первое размещение ограничьте одной одобренной страницей.

HTML
<elevenlabs-convai agent-id="YOUR_PUBLIC_AGENT_ID"></elevenlabs-convai>
<script src="https://unpkg.com/@elevenlabs/convai-widget-embed" async type="text/javascript"></script>

Это текущая официальная вставка виджета. URL скрипта не закрепляет версию; запишите установленное и сверяйтесь при обслуживании. В черновике должен быть один виджет, не закрывающий важные элементы. При Content Security Policy администратор проверяет конкретные блокировки и делает узкое согласованное изменение. Отключать политику или добавлять широкие шаблоны не требуется для установки.

Проверьте агента, затем реальный путь посетителя

После согласования расходов и конфиденциальности задайте оба вопроса в голосовом тесте панели. Сравните с фактами и правилом передачи человеку. Небезопасный или необоснованный ответ исправьте и повторите. Звонок из панели проверяет только панель, не сайт.

До публикации владелец проверяет содержание, уведомление, размещение и результат. На опубликованной странице разрешённого хостаоткройте виджет, осознанно разрешите микрофон, задайте два вопроса, выслушайте и завершите звонок. Проверьте выключение индикатора и удобство на экране телефона. Сверьте сказанное с одобренными ответами; беглость не доказывает факты. Запишите время и агента для расхода. Это проверка читателя, не наблюдение BIG CHANGE.

Откройте Call history , если политика сохраняет запись, и сопоставьте разговор с вопросами. В Analyticsвыберите агента и короткий период: число, длительность и стоимость. Итоги сами не доказывают, какой звонок создал начисление. При удалении записей сохраняйте лишь минимальное разрешённое наблюдение ответа и проверяйте доступные итоги. Не увеличивайте срок хранения ради теста. Отсутствие записи не означает бесплатность.

Если проверка не удалась

При отсутствии виджета сравните опубликованный код с документированной вставкой, найдите дубли элементов или скриптов и конкретные ошибки браузера или CSP. Если он виден без связи, проверьте публичную аутентификацию, точный хост, микрофон, кредиты и ошибку панели. При отказе речи проверьте микрофон, разрешения, безопасный контекст и запись. Завершите неопределённую сессию и посмотрите расход до нового платного теста.

При выдуманных ответах или выходе за FAQ уберите вставку на время правки фактов и инструкций. Перед возвратом повторите два вопроса в панели и на сайте. При перерасходе удалите её, проверьте статистику и счёт, пересмотрите длительность и масштаб. Это прекращает новые звонки с данной страницы, но не доказывает завершение текущего и не убирает доступ с другого разрешённого хоста.

Для локального голосового приложения браузера наш гид OpenAI Realtime описывает другую задачу. Здесь используется размещённый публичный виджет. Руководство в другом разделе упоминает атрибут signed-url , но базовая вставка прямо требует публичного агента; один атрибут не является проверенным рецептом частного виджета.

Источники и дополнительное чтение