Yandex SpeechKit — как озвучить номер заказа, дату и сумму

Yandex SpeechKit
озвучка номера заказа
SSML SpeechKit
TTS-разметка
голосовой бот для доставки
Yandex SpeechKit — как озвучить номер заказа, дату и сумму

Подготовьте для Yandex SpeechKit отдельный текст реплики из полей заказа. Номер 004207 передайте как «ноль ноль четыре два ноль семь», дату разверните с месяцем, сумму произнесите вместе с денежной единицей. Затем добавьте ударения или паузы в формате, который поддерживает ваша версия API. Так можно проверить цифры и смысл ещё до синтеза, а в тестовом звонке выяснить, различимы ли они на слух.

Материал подготовила AI студия Владимира Ломтева. Документация проверена 19 ноября 2026 года. Инструкция рассчитана на команду, у которой уже есть доступ к синтезу речи в Yandex SpeechKit и тестовый контур голосового бота. Сквозной пример — сообщение о доставке с оплатой при получении. Все данные в примерах вымышлены.

1. Выберите разметку по версии API

TTS (text-to-speech) — синтез речи из текста. В Yandex SpeechKit есть два формата подсказок для синтеза. В TTS-разметке ударение и паузы задаются спецсимволами внутри текста. SSML (Speech Synthesis Markup Language) — XML-разметка с тегами для пауз и произношения. Обзор и синтаксис TTS-разметки · Документация SSML

Что уже использует бот Куда передать реплику Как задать произношение
SpeechKit API v1, текст Поле text формы TTS-разметка, например курь+ер
SpeechKit API v1, SSML Поле ssml формы Корневой тег <speak>, внутри — поддерживаемые теги
SpeechKit API v3, gRPC UtteranceSynthesis с текстом Поле text запроса TTS-разметка для русской реплики

Посмотрите в настройках интеграции или в запросе тестового контура, какую версию и поле использует бот. В API v1 передайте реплику в одном из двух полей, text или ssml. Для примера с API v3 ниже используется текстовый режим метода UtteranceSynthesis. Если у вас сторонняя платформа телефонии, проверьте, передаёт ли она разметку в SpeechKit и какие параметры доступны в её интерфейсе. Метод SpeechKit API v1 · Метод gRPC UtteranceSynthesis v3

2. Подготовьте речевые значения полей заказа

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

Поле в системе Учебное значение Правило для этой реплики Что должен услышать клиент
Номер заказа "004207" Каждую цифру произнести своим словом Ноль ноль четыре два ноль семь
Дата доставки 2026-11-21 Назвать число и месяц, год добавить, если без него дата неоднозначна Двадцать первого ноября
Сумма к оплате 1250.50 RUB Отдельно обработать рубли и копейки и согласовать формы Тысяча двести пятьдесят рублей пятьдесят копеек
Режим оплаты Оплата при получении Сообщить подтверждённый режим При получении к оплате…

При сборке фразы используйте форму, которая подходит к шаблону. В «Курьер приедет двадцать первого ноября» нужен родительный падеж. Для суммы подставляйте согласованную пару числительного и денежной единицы. Например, «один рубль», «два рубля» или «пять рублей». Если сумма нужна внутри оборота «на сумму…», проверьте падеж числительного и единицы в полной фразе.

В примере бизнес-логика сообщает сумму только для подтверждённой оплаты при получении. Для предоплаты используйте отдельную реплику «Заказ уже оплачен», если этот статус подтверждён. Для неизвестной суммы предусмотрите переход к уточнению в вашем сценарии. Пустое поле само по себе ничего не говорит о размере платежа.

3. Соберите реплику для SpeechKit

Для поля text поставьте плюс перед ударной гласной в слове «курьер». Тег sil<[400]> задаёт паузу между двумя предложениями в примере. Паузы в начале и конце предложения игнорируются, поэтому проверяйте их в составе полной реплики. Ударения и паузы в TTS-разметке

Номер заказа ноль ноль четыре два ноль семь. sil<[400]> Курь+ер приедет двадцать первого ноября. При получении к оплате тысяча двести пятьдесят рублей пятьдесят копеек.

Для поля ssml в API v1 можно сохранить цифры в содержимом <sub> и задать их чтение в атрибуте alias. Дату и сумму здесь уже развернули в слова при сборке текста. В перечне поддерживаемых тегов Yandex SpeechKit есть <sub> и <break>. Для посимвольного чтения этого номера достаточно заранее составить строку для alias. Теги SSML в SpeechKit

<speak>
  Номер заказа <sub alias="ноль ноль четыре два ноль семь">004207</sub><break time="400ms"/>
  Курьер приедет двадцать первого ноября.
  При получении к оплате тысяча двести пятьдесят рублей пятьдесят копеек.
</speak>

При автоматической подстановке формируйте SSML как XML. Сериализатор экранирует специальные символы в тексте и атрибутах. При отправке формы API v1 используйте URL-кодирование для всего значения поля: если вставить Курь+ер в форму без кодирования, декодер может прочитать плюс как пробел. Для API v3 gRPC передайте TTS-разметку строкой в соответствующем поле запроса. Параметры формы API v1 · Поля запроса API v3

На учебных строках статьи локально проверены разбор XML и обратимость кодирования формы API v1. После декодирования поля text плюс в Курь+ер сохранился. XML-парсер прочитал номер 004207, его речевую замену и атрибут паузы 400ms. Облачный синтез и тестовый звонок остаются шагами для вашей команды.

4. Синтезируйте и прослушайте тестовый звонок

Отправьте реплику через существующую тестовую интеграцию. Сначала прослушайте аудио, полученное от API, затем ту же реплику через тестовый номер или другой канал, которым воспользуется клиент. Укажите в тесте фактический голос и темп. Для API v1 успешный ответ содержит бинарное аудио в выбранном формате. Ответ API v1

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

Учебная проверка Критерий прохождения
Номер с ведущими нулями Слушатель записал 004207 с первого прослушивания
Дата у границы месяца Слушатель записал нужный день и месяц по часовому поясу доставки
Оплата с копейками Слушатель записал 1250,50 ₽, смысл «к оплате при получении» сохранился
Предоплата или отсутствующая сумма Прозвучала предусмотренная ветка сценария без неподтверждённой суммы

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

5. Найдите этап, на котором возникла ошибка

Проверьте по очереди поля заказа, строку перед отправкой, аудио от SpeechKit и запись тестового звонка. Так можно вернуться к месту появления ошибки и исправить конкретное правило.

  • Нули исчезли в строке до синтеза. Проверьте тип номера в выгрузке и шаблоне. Подставьте слова из исходной строки.
  • День сдвинулся на сутки. Сверьте время источника и пояс доставки до формирования календарной даты. Повторите проверку на примере около полуночи.
  • Ударение сбилось после отправки формы. Посмотрите, что происходит со знаком + после URL-кодирования. Если поле отправлено корректно, прослушайте полную фразу с выбранным голосом.
  • Робот читает теги или не воспроизводит паузу. Сверьте версию API, поле и синтаксис. Если поле и формат верны, проверьте расположение паузы и результат в полной фразе. Документация описывает разметку как подсказку для синтеза. TTS-разметка · SSML
  • Аудиофайл понятен, а в звонке цифры сливаются. Повторите проверку с рабочим трактом телефонии. Попробуйте изменить темп или разбивку номера на группы, сохранив исходный порядок цифр, и снова попросите коллегу записать услышанное.

Если вы только собираете систему звонков, схема подключения синтеза, телефонии и данных заказов описана в отдельном материале. Архитектура голосового ИИ для колл-центра

Как настроить реплику в процессе доставки

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

Обсудить задачу

Что передать команде после настройки

Сохраните шаблон реплики, правила чтения номера, даты и суммы, версию API и настройки голоса. Добавьте учебные заказы с ожидаемыми значениями и результатами прослушивания. Если коллега восстановил 004207, верную дату и сумму через тот же канал, что и клиент, у команды есть проверенный пример для повторного теста после смены шаблона, голоса или телефонии.

Оставить заявку

Заполните форму и мы свяжемся с вами

← Все статьи

Комментарии (0)

Пока нет комментариев. Будьте первым!

Оставить комментарий
Регистрация не требуется