Google Cloud Storage & Speech API V2 Транскрибирование записей разговоров/голосовой почты в 3CX V20

Примечание:

• Шаги 1 и 2 можно пропустить, если у вас уже есть учетная запись GCloud с соответствующими правами и Google buckets.
• Мы предлагаем интеграцию с сервисами Google с помощью мастера настройки. Этот документ служит кратким руководством для тех, кто хочет настроить данный компонент вручную.

Шаг 1: Необходимый доступ к аккаунту

Чтобы настроить Google storage buckets, перейдите в "IAM & Admin" > "IAM" в вашем дашборде Google Cloud и убедитесь, что аккаунт имеет, как минимум, следующие роли:

• “Service Account Admin”
• “Service Account Key Admin”
• “Project IAM Admin”
• “Storage Admin”

Шаг 2: Создайте Storage Bucket

Вы можете пропустить эту часть, если в проекте уже настроены Storage Buckets

Если у вас есть активная подписка с настроенными платежными опциями, создайте Storage bucket в проекте Google Cloud:

В основном меню навигации выберите "Storage" > "Browser" и нажмите "Create Bucket".

1. На странице "Create a bucket" настройте:
2. Name - уникальное постоянное имя
3. Where to store data - выберите тип местоположения под ваши требования
4. Storage class - выберите класс хранения под ваши требования
5. Access control - настройте управление доступом к объектам в хранилище
6. Advanced settings - при необходимости настройте шифрование и политику хранения
7. Нажмите "Create", чтобы создать Storage Bucket
8. После создания Storage Bucket нажмите “Create folder” для резервных копий и записей разговоров, например, "3cx_backups"

Используйте сохраненный JSON-ключ и установите настроенное хранилище Google Cloud storage bucket как место хранения резервных копий и архивных записей 3CX.

⚠ Важно: Сохраненные файлы резервных копий или архивные записи в состоянии "Hold" (или сохраненные/архивированные в соответствии с действующей политикой хранения), не могут быть удалены или перезаписаны средствами АТС.

Шаг 3: Включите Cloud Speech-to-Text API для вашего проекта

В Google Console перейдите в APIs & Services > Library и найдите Cloud Speech-to-Text API и нажмите “Enable”.

Шаг 4: Создайте Service Account и Key с доступом Storage and Speech

В GCloud Project перейдите в IAM & Admin > Service Accounts и нажмите “Create Service Account”. Укажите название и нажмите “Create and Continue”.

Добавьте следующие роли в Service Account, нажмите “Continue” и “Done”:

1. Storage Admin
2. Cloud Speech Administrator

Отредактируйте Service Account, выбрав вкладку "Keys", затем "Add Key"

Выберите тип Json и нажмите "Create"

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

Шаг 5: Включите Remote Archiving и Transcription

1. Чтобы настроить 3CX для транскрибирования голосовых сообщений и/или записей, перейдите в консоль администратора > “System” > “Storage.
2. Включите опцию “Enable Remote Archiving” и выберите “Google Storage” в Location Type (обязательно).
3. Загрузите json-файл, полученный на предыдущем шаге, в поле Private Key (JSON type) и выберите папку/путь в вашем хранилище Google Storage Bucket.
4. Включите опции “Recordings” и “Voicemails”, чтобы включить автоматическое архивирование в хранилище Google.
5. Сохраните и перейдите в раздел “Integrations” > “Transcription”.
6. Выберите “Google Speech” в качестве сервиса транскрибирования.
7. Используйте выпадающий список “Speech Language” для выбора языка транскрибирования.
8. Выберите, что транскрибировать:

1. “Voicemails Only” - ограничиться только голосовыми сообщениями.
2. “Recordings Only” - ограничиться только записями.
3. “Both Voicemails and Recordings” - голосовые сообщения и записи.

9. Нажмите “OK” для применения настроек. После включения транскрибирования голосовых сообщений, текст сообщения будет включен в тело электронного письма с аудиофайлом голосового сообщения. Кроме того, в разделах Voicemail/Recordings веб-клиента 3CX текстовая транскрипция будет отображаться рядом с каждым голосовым сообщением/записью.

После включения транскрипции голосовой почты распознанный текст добавляется в тело email-письма для полученных голосовых сообщений. Кроме того, в веб-клиенте 3CX в разделах «Голосовая почта» и «Записи» расшифрованный текст отображается рядом с каждым сообщением/записью.

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

Дополнительная информация

• Call Control API for Linux
• Call Control API for Windows
• Создание сценария Call Processing Script
• Call Processing Script для DTMF-ввода

Версия документа

Последнее обновление документа 10 сентября 2026

www.3cx.ru/docs/manual/google-speech-api-v2/