# Text-to-Speech (TTS)

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

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

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

{% hint style="info" %}
В отличие от каналов авторизации [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 используется для передачи произвольного голосового текста: уведомлений, напоминаний, сервисных сообщений и рекламных предложений.
{% endhint %}

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

{% 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>.

{% hint style="info" %}
Text2Speech работает только через интеграцию. Ручная отправка сообщений в личном кабинете i-digital direct недоступна.
{% endhint %}

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

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

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

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

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

{% hint style="info" %}
Интерактивное голосовое меню `IVR` в канале Text2Speech на данный момент не поддерживается.
{% endhint %}

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

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

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

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

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

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

{% hint style="info" %}
Использовать собственный номер для отправки нельзя. Номера не предоставляются на выбор: звонки выполняются с выделенного номера, который запрашивается через техническую поддержку <support@i-dgtl.ru>.&#x20;
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://faq.docs.direct.i-dgtl.ru/kanaly-otpravki/golosovye-rassylki-i-zvonki/text-to-speech-tts.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.