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 — на сторінці цін.