Все гайды
Голос Продвинутый уровень 12 мин чтения

Многоязычные Voice-агенты

Автоматическое определение языка собеседника, переключение посреди разговора, маршрутизация к специалистам.

Почему важна многоязычность

Если ваши клиенты звонят на разных языках, распределять звонки вручную долго. Канал Calls в MyChatBot решает это прямо во время звонка. Вы задаёте основной язык через выбранный голос, добавляете другие языки своих клиентов и включаете автоматическое переключение, чтобы голосовой AI-агент определял язык абонента и мог продолжить разговор на нём.

Гайд охватывает телефонные звонки (SIP Trunk или Twilio Account) и голосовую кнопку Web SDK на сайте.

Что вы настроите и что нужно заранее

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

  • Агент с инструкциями и базой знаний: голосовой агент создаётся из них в момент подключения канала. Если агента ещё нет, начните с гайда Создайте своего первого AI-агента.
  • Способ подключения: номер на вашем SIP-транке, номер в вашем аккаунте Twilio или вовсе без номера, если нужен только Web SDK.
  • Список языков, на которых говорят ваши клиенты, и какой из них самый распространённый. Он станет основным.

Пошаговая настройка

  1. Откройте Channels, выберите агента и перейдите в канал Calls.
  2. В поле Provider выберите SIP Trunk, Twilio Account или Web SDK.
  3. В поле Voice (Optional) выберите голос для самого распространённого языка. Прослушайте его кнопкой Play preview. Голос также задаёт основной язык, на котором говорит агент.
  4. Заполните поля провайдера. Для SIP Trunk нужны Phone Number и Address; для Twilio Account — Phone Number, Twilio Account SID и Twilio Auth Token. Для Web SDK эти поля не нужны.
  5. В блоке Additional languages добавьте каждый язык, на который агент может перейти, и при желании отдельное приветствие для него.
  6. Включите Automatic language switching, чтобы агент сам определял язык абонента.
  7. Проверьте First Message. По умолчанию это приветственное сообщение вашего агента.
  8. Нажмите Connect phone number или Create SDK Agent для Web SDK.
  9. Воспользуйтесь Make a test call, чтобы поговорить с агентом прямо в браузере на каждом добавленном языке.
  10. Включите Connect agent to this channel. Новые каналы Calls создаются выключенными, а само подключение провайдера звонки не активирует.

Параметры, на которые стоит обратить внимание

  • TTS Model. Подбирается автоматически под язык. Если добавить дополнительные языки, включается более качественная модель v3 Conversational.
  • Стоимость. Звонки тарифицируются по длительности, которая переводится в AI-сообщения вашего тарифа, посекундно. Высококачественные голоса (v3 Conversational или мультиязычные) стоят 5 AI-сообщений в минуту, и дополнительные языки переводят агента именно на эту ставку. Точная ставка для вашей настройки показана в панели. Подробнее — на странице Цены.
  • Max Call Duration (minutes). Жёсткое ограничение длительности звонка; по умолчанию 10 минут.
  • Transfer to human operator (только для телефонии). Укажите Operator number, при необходимости Phone line и Transfer Condition, например: абонент прямо просит соединить с менеджером.

Типичные проблемы и как их исправить

  • Агент не переключает язык. Проверьте, что язык абонента есть в списке Additional languages и что Automatic language switching включено, затем повторите проверку через Make a test call.
  • Звонок начинается не на том языке. Основной язык задаёт голос. Выберите голос для языка, на котором говорит большинство ваших абонентов, и проверьте First Message.
  • Во время звонков агент не учитывает новые инструкции. Нажмите Sync Agent, когда появится запрос на синхронизацию. База знаний — это снимок на момент создания канала, поэтому если вы изменили интеграции, из которых агент берёт данные, создайте канал Calls заново.
  • Звонки стоят дороже, чем ожидалось. Дополнительные языки переводят агента на более высокую ставку. Если вы обслуживаете только один язык, оставьте Additional languages пустым.
  • Ошибка «A channel with this phone number is already connected». Номер уже используется в другом канале Calls; каждый номер можно подключить только один раз.
  • Агент не отвечает на входящие звонки. Убедитесь, что Connect agent to this channel включено.
  • Исходящие звонки отклоняются. Так бывает, когда агент выключен или баланс аккаунта исчерпан. Включите агента или пополните баланс.

Что почитать дальше

Полная документацияПодробнее в документации на docs.mychatbot.app (на английском).