Подготовьте для Yandex SpeechKit отдельный текст реплики из полей заказа. Номер 004207 передайте как «ноль ноль четыре два ноль семь», дату разверните с месяцем, сумму произнесите вместе с денежной единицей. Затем добавьте ударения или паузы в формате, который поддерживает ваша версия API. Так можно проверить цифры и смысл ещё до синтеза, а в тестовом звонке выяснить, различимы ли они на слух.
Материал подготовила AI студия Владимира Ломтева. Документация проверена 19 ноября 2026 года. Инструкция рассчитана на команду, у которой уже есть доступ к синтезу речи в Yandex SpeechKit и тестовый контур голосового бота. Сквозной пример — сообщение о доставке с оплатой при получении. Все данные в примерах вымышлены.
- 1. Выберите разметку по версии API
- 2. Подготовьте речевые значения полей заказа
- 3. Соберите реплику для SpeechKit
- 4. Синтезируйте и прослушайте тестовый звонок
- 5. Найдите этап, на котором возникла ошибка
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, верную дату и сумму через тот же канал, что и клиент, у команды есть проверенный пример для повторного теста после смены шаблона, голоса или телефонии.






