Voice SDK: голосовой AI-агент, которого легко встроить в сайт

Что такое Voice SDK и кому он нужен

Voice SDK — это браузерная версия канала Calls в MyChatBot. Вместо подключения номера телефона или оператора вы выбираете провайдера Web SDK, и посетители нажимают кнопку на вашем сайте, чтобы поговорить с AI-агентом голосом через свои микрофон и динамики.

Это тот же агент, который отвечает в ваших чатах. Он работает по инструкциям агента и Knowledge Base, говорит выбранным голосом, а каждый разговор становится обычным диалогом с расшифровкой и записью.

Типичные сценарии:

• кнопка «Поговорить с нами» на сайте;
• ассистент на страницах товаров;
• демонстрации продукта или услуги;
• голосовая витрина, где агент ищет товары и наполняет корзину, пока покупатель говорит.

Voice SDK подходит бизнесу, которому нужен голос на сайте без покупки телефонии, и разработчикам, которые хотят подключить агента к собственному интерфейсу. Если агент должен принимать или совершать телефонные звонки, посмотрите AI Voice Agent: он работает на том же канале Calls через SIP Trunk или Twilio.

Как проходит звонок через Voice SDK в MyChatBot

1. Вы создаете SDK-агента. В разделе Channels откройте канал Calls своего агента, выберите Provider Web SDK, выберите голос и нажмите Create SDK Agent. MyChatBot выдаст Agent ID.
2. Вы вставляете код. Два тега script добавляют на страницу плавающую кнопку с микрофоном.
3. Посетитель начинает звонок. Он нажимает кнопку, разрешает доступ к микрофону и слышит первое сообщение агента.
4. Агент говорит и действует. Он отвечает на основе ваших инструкций и Knowledge Base, а если вы разрешите — вызывает функции на странице, например ищет в каталоге или применяет промокод.
5. Звонок становится чатом. После завершения расшифровка добавляется в ветку клиента как сообщения агента и посетителя, а запись можно прослушать, перемотать и скачать прямо в браузере.

Браузер каждого посетителя автоматически получает собственный идентификатор, поэтому разговоры разных людей не сливаются в одну ветку. Во время звонка кнопка превращается в компактную панель: она показывает, кто говорит, и содержит кнопки отключения микрофона, завершения звонка и просмотра расшифровки в реальном времени.

Ключевые возможности

Голос и языки

В панели Calls вы выбираете Voice с предварительным прослушиванием, модель LLM для ответов, Speech Speed от 0.7 до 1.2, First Message и Max Call Duration — по умолчанию 10 минут. Голос также задает основной язык агента. Additional languages добавляет языки, на которые агент может перейти посреди разговора, при желании с отдельным приветствием для каждого, а Automatic language switching определяет язык собеседника.

Client tools: агент действует на вашей странице

Через client_tools вы открываете агенту функции страницы, которые он может вызывать во время разговора: найти товар в каталоге, применить код, перейти к разделу. У каждого инструмента есть описание для агента с параметрами типа string, number или boolean и обработчик, который пишете вы. То, что возвращает обработчик, агент произносит вслух, поэтому лучше возвращать короткое подтверждение.

Готовая кнопка или собственный интерфейс

Код встраивания содержит собственные стили. Можно задать имя агента, акцентный цвет, расположение справа или слева внизу, вывести элемент управления внутри выбранного блока страницы, а расшифровку — свернутой, развернутой или убрать совсем. Колбэки onCallStart и onCallEnd сообщают вашему коду, когда звонок начался и закончился, с причиной и длительностью в секундах. Для JavaScript-сборок есть npm-пакет @mychatbot/client: с ним звонки запускаются с вашей кнопки и из вашего интерфейса.

Каналы, данные и интеграции

Voice SDK — один из трех провайдеров канала Calls наряду с SIP Trunk и Twilio Account. Веб-звонки появляются на экране Chats так же, как текстовые разговоры, так что команда видит все в одном месте.

Знания. Голосовой агент собирается из инструкций и Knowledge Base агента в момент подключения канала. Загрузите каталог в Knowledge Base — и во время звонка агент будет отвечать на вопросы о наличии, ценах и характеристиках. Поскольку посетитель говорит с ассистентом продаж, разговор может создать лид для дальнейшей работы.

CRM. Если вы настроите Post-Call Functions, они будут выполнять действия после звонка, например записывать лид в CRM. Системы, с которыми работает MyChatBot, в том числе KeyCRM, Bitrix24, Kommo и HubSpot, собраны на странице интеграций.

Claude. Если вы настраиваете агента через коннектор MyChatBot в Claude, достаточно попросить код встраивания для голосового агента — Claude вернет фрагмент с вашим настоящим Agent ID.

Когда подключается человек и какие есть ограничения

Звонки через Web SDK работают в браузере посетителя, поэтому у них есть границы:

• Без перевода звонка. Transfer to human operator доступен только для телефонных звонков. На сайте команда продолжает работу с разговором в Chats, где расшифровка и запись дают полный контекст. Как устроена передача человеку в разных каналах, смотрите отдельно.
• Без исходящих звонков и автоперезвона. Web SDK никому не звонит: он отвечает, когда посетитель нажимает кнопку. Для обзвонов и повторных попыток подключите SIP Trunk или Twilio.
• Открытая страница и микрофон. Звонок возможен, только пока страница открыта и посетитель разрешил доступ к микрофону.
• Один SDK-канал на ассистента. У каждого ассистента может быть один канал Calls типа Web SDK.
• Синхронизация. После изменения инструкций агента нажмите Sync Agent. Knowledge Base фиксируется при создании канала, поэтому, чтобы изменить набор интеграций, из которых агент берет данные, канал придется создать заново.
• Формат инструментов. Параметры инструмента — это плоский список, а не JSON Schema. JSON Schema отклоняется без какого-либо сообщения на странице: звонок соединяется, но агент инструмент не получает.

Как настроить Voice SDK

1. Откройте Channels, выберите агента и перейдите в Calls.
2. В поле Provider выберите Web SDK.
3. Выберите Voice и настройте первое сообщение, LLM, скорость, максимальную длительность и языки.
4. Нажмите Create SDK Agent и скопируйте Agent ID из блока Connection Details.
5. Включите Connect agent to this channel. Новые каналы Calls создаются выключенными.
6. Вставьте код на сайт со своим Agent ID и добавьте client tools, если агент должен действовать на странице.

Для быстрого старта выберите Create a voice agent for my website в Quick start на Sales Platform. Укажите адрес сайта или фида товаров и короткий бриф. Quick start создаст ассистента продаж с голосом и канал Web Voice, а также выдаст Agent ID и код встраивания с примерами действий на странице: searchItem, navigateTo, addToCartById и applyDiscountCode.

Веб-звонки тарифицируются по длительности в AI-сообщениях по тем же ставкам, что и телефонные: голоса высокого качества списывают больше AI-сообщений в минуту, чем стандартные, посекундно и без минимальной оплаты за звонок. Тарифы Voice SDK — на странице цен.