> For the complete documentation index, see [llms.txt](https://docs.mikopbx.com/mikopbx/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.mikopbx.com/mikopbx/modules/miko/module-cloud-speech-to-text.md).

# Облачная транскрибация

Описание модуля

**Модуль облачной транскрибации** автоматически распознает записанные звонки MikoPBX и сохраняет готовые расшифровки на станции.

{% hint style="info" %}
Модуль полностью автономен: отдельное приложение-обработчик не требуется. Если аудиозаписи нельзя передавать во внешний сервис, используйте [Модуль локальной транскрибации](/mikopbx/modules/miko/module-local-speech-to-text.md).
{% endhint %}

{% hint style="warning" %}
Отправка записи на распознавание - платное действие: стоимость списывается с баланса вашей лицензии MIKO (посмотреть стоимость и пополнить можно по ссылке - [lm.miko.ru](https://lm.miko.ru)).
{% endhint %}

<figure><img src="https://3704471835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MPK4TuzRBnP7rt8htho-887967055%2Fuploads%2Fgit-blob-b824005bc3ac9f26d90356154d34cd470b886870%2FCloudSTTTranscriptCard.png?alt=media" alt=""><figcaption><p>Пример расшифровки звонка, сделанной модулем облачной транскрибации</p></figcaption></figure>

### Требования и совместимость

* Действующая лицензия MIKO с опцией облачной транскрибации и положительный баланс.
* Включенная запись разговоров для нужных маршрутов, очередей или сотрудников.
* Прямой исходящий доступ по HTTPS к `speech.mikolab.ru:443`.

### Установка модуля

1. Откройте веб-интерфейс MikoPBX. Перейдите в раздел **Модули** → **Маркетплейс модулей**.

<figure><img src="https://3704471835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MPK4TuzRBnP7rt8htho-887967055%2Fuploads%2FYNsPFrcW8A5FQHEbExIP%2FModulesMarketplaceSection2026.png?alt=media&amp;token=338a6f48-1a33-46f3-80dc-ca4666a152ec" alt=""><figcaption><p>Раздел "Маркетплейс модулей"</p></figcaption></figure>

2. Найдите модуль "**Облачная транскрибация"** и установите его.

<figure><img src="https://3704471835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MPK4TuzRBnP7rt8htho-887967055%2Fuploads%2Fgit-blob-453613d889b2fbf51c13e21b36795c9ef37ae511%2FCloudSTTMarketplace.png?alt=media" alt=""><figcaption><p>Модуль облачной транскрибации в разделе "Маркетплейс"</p></figcaption></figure>

3. Откройте список установленных модулей и включите модуль. Нажмите кнопку настроек справа от версии модуля.

<figure><img src="https://3704471835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MPK4TuzRBnP7rt8htho-887967055%2Fuploads%2Fgit-blob-6f1e6fe94aa46a3f119633ef75a258f91118bb2c%2FClouddSTTModuleInstalled.png?alt=media" alt=""><figcaption><p>Включение модуля и переход к его странице</p></figcaption></figure>

### Первый запуск

При первом запуске модуля, откроется мастер его настройки. На первой странице модуль предупреждает, что выбранные записи звонков передаются на `speech.mikolab.ru` для распознавания. Подтвердите согласие кнопкой **Продолжить**.

<figure><img src="https://3704471835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MPK4TuzRBnP7rt8htho-887967055%2Fuploads%2Fgit-blob-c10b8f39e19062691985e5f5b15a9437939218ca%2FCloudSTTOnboardingStep1.png?alt=media" alt=""><figcaption><p>Шаг «Конфиденциальность» мастера первого запуска</p></figcaption></figure>

На втором шаге онбоардинга, нажмите **Проверить подключение**: модуль проверит доступность API сервиса, авторизацию по лицензии и состояние баланса.

<figure><img src="https://3704471835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MPK4TuzRBnP7rt8htho-887967055%2Fuploads%2Fgit-blob-52fc9cba6b685f09b023056a39e146fd0422bbd5%2FCloudSTTOnboardingStep2.png?alt=media" alt=""><figcaption><p>Шаг «Подключение» мастера первого запуска</p></figcaption></figure>

На следующем эатпе проверьте правила отбора звонков (направления, сотрудники, лимиты). Подтвердите включение автоматического отбора и нажмите **Активировать модуль**. Первая отправка произойдет только после появления подходящей записи.

<figure><img src="https://3704471835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MPK4TuzRBnP7rt8htho-887967055%2Fuploads%2Fgit-blob-2713fa96f4ef3844d24a898f4a457ab5a3e646e2%2FCloudSTTOnboardingStep3p1.png?alt=media" alt=""><figcaption></figcaption></figure>

<figure><img src="https://3704471835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MPK4TuzRBnP7rt8htho-887967055%2Fuploads%2Fgit-blob-ea0a8d7360c9defddd81561b401eb8ecfebee894%2FCloudSTTOnboardingStep3p2.png?alt=media" alt=""><figcaption><p>Шаг «Правила и активация» мастера первого запуска</p></figcaption></figure>

### Вкладка «Обзор»

Вкладка открывается по умолчанию и показывает состояние модуля:

* карточки **В обработке**, **Транскриптов**, **Инцидентов** и **Баланс** с кнопкой обновления;
* график **Успешно транскрибировано за 7 дней** — минуты распознанного аудио по дням;
* список **Последние задания** со статусами и переходом в очередь.

<figure><img src="https://3704471835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MPK4TuzRBnP7rt8htho-887967055%2Fuploads%2Fgit-blob-771ac897b5cc92eed58c5a562a5c07d789159986%2FCloudSTTOverview.png?alt=media" alt=""><figcaption><p>Главный экран модуля (вкладка «Обзор»)</p></figcaption></figure>

### Вкладка «Транскрипты»

Здесь собраны локально сохраненные результаты распознавания. Список фильтруется по периоду звонков (календарь или «Сегодня») и ищет по номеру, сотруднику или тексту расшифровки. В таблице отображаются дата, направление, контрагент, сотрудник, статус (полный или частичный), длительность и время обновления.

<figure><img src="https://3704471835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MPK4TuzRBnP7rt8htho-887967055%2Fuploads%2Fgit-blob-80729926ad88ff97d28d268caff755ac517ab1d9%2FCloudSTTTranscripts.png?alt=media" alt=""><figcaption><p>Раздел «Транскрипты» в Модуле облачной транскрибации</p></figcaption></figure>

Нажмите на интересующий траснкрипт - откроется его карточка. Она содержит:

* реплики с таймкодами и ролями участников - сотрудник/клиент
* встроенный проигрыватель с регулировкой скорости и скачиванием записи
* поиск
* экспорт в **JSON** или **TXT**
* удаление транскрипта

Нажатие на реплику переводит проигрыватель к соответствующему моменту записи.

<figure><img src="https://3704471835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MPK4TuzRBnP7rt8htho-887967055%2Fuploads%2Fgit-blob-b824005bc3ac9f26d90356154d34cd470b886870%2FCloudSTTTranscriptCard.png?alt=media" alt=""><figcaption><p>Карточка транскрипта с репликами и проигрывателем</p></figcaption></figure>

### Вкладка «Очередь»

На этой вкладке управляется локальная очередь задач. Доступны фильтр по статусу, период (1 день или все время), поиск по номеру или направлению и постраничная навигация.

| Группа фильтра       | Состояния задач                                                                                                               |
| -------------------- | ----------------------------------------------------------------------------------------------------------------------------- |
| **Ожидают**          | Найдена, Ожидает запись, Готова к отправке, Безопасное ожидание отправки                                                      |
| **Обрабатываются**   | Отправляется, Принята сервисом, Распознаётся                                                                                  |
| **Требуют внимания** | Исход отправки неизвестен, Локальная ошибка, Ошибка сервиса, Некорректный результат, Обработка зависла, Истёк срок результата |
| **Завершены**        | Готово, Результат не сохранён после удаления, Отменена                                                                        |

По задаче доступна техническая информация: ID задачи, номер запуска (поколение), этап обработки, код ошибки, HTTP-код и тип сетевой ошибки, CDR ID, размер и формат аудио.

| Действие               | Когда доступно и что делает                                                                                                               |
| ---------------------- | ----------------------------------------------------------------------------------------------------------------------------------------- |
| **Отменить задачу**    | Только до начала загрузки аудио. Подтверждение не требуется.                                                                              |
| **Повторить задачу**   | Явное платное подтверждение. Создает новое поколение задачи и может привести к повторному списанию. Автоматических повторов у модуля нет. |
| **Открыть транскрипт** | Переход к готовой расшифровке на вкладке «Транскрипты».                                                                                   |

<figure><img src="https://3704471835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MPK4TuzRBnP7rt8htho-887967055%2Fuploads%2Fgit-blob-7751ed55da3ef5898c21707938b92d8652f8a7c1%2FCloudSTTQueue.png?alt=media" alt=""><figcaption><p>Раздел «Очередь» в Модуле облачной транскрибации</p></figcaption></figure>

### Вкладка «Настройки»

Здесь настраиваются настройки распознавания звонков: что распознавать, а что пропускать. Ниже представлена сводка по параметрам в каждом разделе настроек:

#### **Направления и участники**

<table><thead><tr><th width="248.546875">Настройка</th><th>Назначение</th></tr></thead><tbody><tr><td><strong>Обрабатывать входящие</strong></td><td>Распознавать ли звонки, поступающие на внутренние номера.</td></tr><tr><td><strong>Обрабатывать исходящие</strong></td><td>Распознавать ли звонки, инициированные сотрудниками на внешние номера.</td></tr><tr><td><strong>Обрабатывать внутренние</strong></td><td>Распознавать ли разговоры между сотрудниками.</td></tr><tr><td><strong>Сотрудники</strong></td><td>Звонки каких сотрудников нужно/не нужно распознавать.</td></tr></tbody></table>

#### **Правила для номеров**

Правила включают или исключают номера из обработки. У каждого правила задаются направление (любое, входящее или исходящее), тип совпадения (точный номер или префикс), номер и действие (включить или исключить).

<figure><img src="https://3704471835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MPK4TuzRBnP7rt8htho-887967055%2Fuploads%2Fgit-blob-c918ca6c7d459e06bdfd2af3dfcc4e5263a3945e%2FCloudSTTSettingsRules.png?alt=media" alt=""><figcaption><p>Блок «Правила для номеров»</p></figcaption></figure>

#### **Лимиты обработки**

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

<table><thead><tr><th width="312.39453125">Настройка</th><th>Назначение</th></tr></thead><tbody><tr><td><strong>Минимальная длительность</strong></td><td>Звонки короче этого значения не отправляются.</td></tr><tr><td><strong>Максимальная длительность</strong></td><td>Звонки длиннее этого значения не отправляются.</td></tr><tr><td><strong>Суточный лимит</strong></td><td>Сколько минут аудио в сутки можно отправить на распознавание.</td></tr><tr><td><strong>Одновременных облачных задач</strong></td><td>Сколько записей сервис распознает одновременно; остальные ждут в локальной очереди.</td></tr></tbody></table>

{% hint style="info" %}
Когда суточный лимит минут исчерпан, новые задачи ждут наступления следующих суток. Если администратор увеличит лимит - отправка возобновится сразу.
{% endhint %}

#### **Режим и хранение**

В этом блоке настраивается язык и режим распознавания, а так же срок хранения готовых транскриптов.

<table><thead><tr><th width="174.875">Настройка</th><th>Назначение</th></tr></thead><tbody><tr><td><strong>Режим распознавания</strong></td><td>Отложенный (deferred-general) - дешевле, но обработка записи может занимать до ~12 часов. Стандартный (general) быстрее, но дороже.</td></tr><tr><td><strong>Язык распознавания</strong></td><td>Язык на котором будет произведено распознавания записей.</td></tr><tr><td><strong>Хранение транскриптов</strong></td><td>Ограниченное (1–3650 дней) или без ограничения.</td></tr></tbody></table>

{% hint style="info" %}
По истечении срока хранения транскрипты удаляются при плановой ежедневной очистке. CDR и аудиозаписи MikoPBX не затрагиваются.
{% endhint %}

### Приостановка обработки

Кнопка **Приостановить обработку записей** в шапке модуля временно останавливает отбор и отправку новых записей — например, на время работ или при разбирательстве инцидента. Уже принятые сервисом задачи продолжают опрашиваться до готовности. Кнопка **Возобновить обработку записей** возвращает модуль в рабочий режим.

<figure><img src="https://3704471835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MPK4TuzRBnP7rt8htho-887967055%2Fuploads%2Fgit-blob-21b7fa33771357e37e6f4b72ff48b9e79df1cde2%2FCloudSTTStopScanner.png?alt=media" alt=""><figcaption><p>Кнопка для остановки обработки записей</p></figcaption></figure>

### Расшифровка в истории звонков

В разделе **История звонков** MikoPBX у звонка с готовым транскриптом появляется диалог **Расшифровка звонка** с текстом разговора и кнопкой **Открыть расшифровку** для перехода в модуль.

<figure><img src="https://3704471835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MPK4TuzRBnP7rt8htho-887967055%2Fuploads%2Fgit-blob-2fc3ab92698a5e3a0ad7061c16f424d300500820%2FCloudSTTCDR.png?alt=media" alt=""><figcaption><p>Кнопка для открытия расшифровки звонка из журнала звонков MikoPBX</p></figcaption></figure>

<figure><img src="https://3704471835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MPK4TuzRBnP7rt8htho-887967055%2Fuploads%2Fgit-blob-d36560f6ab3f046a530cbd78d8f8f961157592f9%2FCloudSTTTranscriptCardFromCDRv2.png?alt=media" alt=""><figcaption><p>Расшифровка открытая из журнала звонков в MikoPBX</p></figcaption></figure>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

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

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.mikopbx.com/mikopbx/modules/miko/module-cloud-speech-to-text.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.