# Text-to-Speech (TTS)

<mark style="color:$info;">Удобный способ передавать клиентам информационные и рекламные сообщения в голосовом формате</mark>

### Общая информация

Text2Speech — это сервис, в котором текст сообщения автоматически озвучивается в телефонном звонке. Канал подходит для передачи информационных и рекламных сообщений и не предназначен для отправки одноразовых кодов подтверждения.

::::::{tip}
В отличие от каналов авторизации [FlashCall](https://faq.docs.direct.i-dgtl.ru/kanaly-otpravki/golosovye-rassylki-i-zvonki/flashcall) и [VoiceCode](https://faq.docs.direct.i-dgtl.ru/kanaly-otpravki/golosovye-rassylki-i-zvonki/voicecode), Text2Speech используется для передачи произвольного голосового текста: уведомлений, напоминаний, сервисных сообщений и рекламных предложений.
::::::

### Как работает канал

{% stepper %}
{% step %}
Ваша система передает `sender name`, текст сообщения и номер телефона абонента.
{% endstep %}

{% step %}
Сервис формирует голосовой звонок с автоматической озвучкой текста.
{% endstep %}

{% step %}
Абонент получает входящий звонок и прослушивает сообщение.
{% endstep %}

{% step %}
После завершения вызова передается статус доставки.
{% endstep %}
{% endstepper %}

### Подключение канала

Канал можно подключить двумя способами:

* `Direct API` — более гибкий вариант, который позволяет настраивать голос и скорость озвучки через [HTTP API](https://api.docs.direct.i-dgtl.ru/messages/text-to-speech-sending;);
* `SMPP` — вариант для крупных объемов данных, параметры подключения предоставляет техническая поддержка [support@i-dgtl.ru](mailto:support@i-dgtl.ru).

::::::{tip}
Text2Speech работает только через интеграцию. Ручная отправка сообщений в личном кабинете i-digital direct недоступна.
::::::

### Настройка сервиса

При работе через API доступны:

* мужской и женский голос;
* настройка скорости воспроизведения сообщения.

Прослушать выбранный голос можно, отправив тестовое сообщение.

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

::::::{tip}
Интерактивное голосовое меню `IVR` в канале Text2Speech на данный момент не поддерживается.
::::::

### Основные параметры канала

* направление трафика: только РФ;
* тип сообщений: любой информационный или рекламный текст;
* срок доставки сообщения: в среднем 10 секунд;
* передача статуса доставки: сразу по завершении вызова;
* максимальное количество запросов в секунду: без ограничений;
* повторный вызов на номер абонента: без ограничений;
* средний показатель доставки: 95%;
* тарификация: за доставленные сообщения;
* звонки тарифицируются по длине соединения каждые 15 секунд.&#x20;

::::::{tip}
С актуальными тарифами по каналу можно ознакомиться в разделе [Тарифы](https://direct.i-dgtl.ru/tariffs/voice/#text-to-speech).
::::::

### Номера отправителя

Звонки могут поступать:

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

::::::{tip}
Использовать собственный номер для отправки нельзя. Номера не предоставляются на выбор: звонки выполняются с выделенного номера, который запрашивается через техническую поддержку [support@i-dgtl.ru](mailto:support@i-dgtl.ru).&#x20;
::::::