# Документация AI Softphone

> Что такое AI Softphone, на чём он работает и где описана каждая часть программы.

[AI Softphone](https://ai-softphone.ru/) — это софтфон для IP-АТС, который вдобавок превращает каждый разговор в текст и письменное содержание. Разговор попадает в него тремя путями, и все три оказываются в одной библиотеке — с той же записью, расшифровкой и разбором:

- **звонок**, сделанный или принятый в программе, через любую IP-АТС или SIP-провайдера;
- **встреча** в Zoom, Teams, Meet, Телемосте или любом другом приложении, записанная прямо с компьютера;
- **запись, которая у вас уже есть**, — с мобильного телефона, диктофона или из другой системы, — добавленная в библиотеку.

Записи, расшифровки и история хранятся в файле, который принадлежит вам. Ни учётной записи, ни подписки не нужно, а программа — свободное ПО под лицензией GPL v2.

## От разговора к разбору {#from-a-conversation-to-a-write-up}

1. Приходит разговор: звонок, встреча или файл.
2. Он записывается в два канала, поэтому сказанное вами и сказанное другой стороной не смешиваются.
3. Он расшифровывается — по говорящим, синхронно со звуком.
4. Выбранная вами языковая модель делает разбор: содержание, задачи, категорию, метки и красные флаги, — а разговору можно задать вопрос.

Во время звонка [Суфлёр](https://docs.ai-softphone.com/ru/interface/prompter/index.md) может больше: он показывает сказанное в тот момент, когда его говорят, и подсказывает, что ответить.

Для России программа предлагает отечественные сервисы: распознавание речи **Yandex SpeechKit** и языковую модель **YandexGPT** из Yandex AI Studio. Они появляются, когда в [«О программе»](https://docs.ai-softphone.com/ru/application/about/index.md#version-and-country) выбрана страна **Россия**; подробнее — в разделах [«Расшифровка»](https://docs.ai-softphone.com/ru/ai-processing/transcription/index.md#yandex-speechkit) и [«Обработка»](https://docs.ai-softphone.com/ru/ai-processing/processing/index.md#yandexgpt).

## Загрузка и системные требования {#download-and-system-requirements}

Программу можно бесплатно скачать на [ai-softphone.ru](https://ai-softphone.ru/#download): установщик (`.exe`) для Windows, образ диска (`.dmg`) для macOS и AppImage или `.deb` для Linux. Установщику, образу диска и AppImage ничего заранее устанавливать не нужно — Qt, OpenSSL и среда выполнения C++ уже внутри них. Исключение — `.deb`: он использует среду выполнения C++ самой системы, см. ниже. Понадобится SIP-учётная запись — от провайдера или от АТС, которую вы держите сами. Запись работает сразу после установки; для расшифровки и разбора нужен выбранный вами сервис или модель на собственной машине.

| Система | Требования |
| --- | --- |
| macOS | macOS 14.4 или новее; только Apple silicon — Mac на Intel её не откроет, даже через Rosetta; графика Metal; 160 МБ на диске плюс место под записи. Система один раз спрашивает доступ к микрофону. |
| Windows | Windows 10 версии 1809 (сборка 17763) или новее и Windows 11; 64-битный процессор Intel или AMD; Direct3D 11 или OpenGL 2.1; 250 МБ на диске плюс место под записи. |
| Linux | Ubuntu 22.04 LTS или новее, Debian 12 или новее и всё того же возраста — Fedora 36+, openSUSE Leap 15.5+, Mint 21+, Arch; библиотека GNU C 2.35 или новее; 64-битный процессор Intel или AMD; OpenGL 2.1 или OpenGL ES 2.0, на X11 или Wayland; PipeWire или PulseAudio (ALSA, если нет ни того ни другого); 200 МБ на диске плюс место под записи. Для значка в трее нужен рабочий стол с областью уведомлений (status notifier). |

В Linux AppImage работает на любом дистрибутиве такого возраста: сделайте файл исполняемым и запустите. Пакету `.deb` нужна ещё системная среда выполнения C++ из GCC 13 — она есть в Ubuntu 24.04 и Debian 13, но нет в Ubuntu 22.04; для более старых систем берите AppImage.

Интерфейс доступен на тридцати языках; язык выбирается в [«Оформлении»](https://docs.ai-softphone.com/ru/program/appearance/index.md) и меняется без перезапуска.

Скриншоты в этой документации сделаны в macOS и показаны уменьшенными: нажмите на скриншот, чтобы увидеть его в полном размере. На других системах программа выглядит и работает так же.

## Первые шаги {#first-steps}

1. [Добавьте учётную запись](https://docs.ai-softphone.com/ru/sip-accounts/setup/index.md) вашей АТС или SIP-провайдера.
2. [Выберите микрофон и динамики](https://docs.ai-softphone.com/ru/sip-accounts/devices/index.md) и сделайте пробный звонок.
3. Решите, [какие звонки записывать](https://docs.ai-softphone.com/ru/recordings/index.md).
4. Добавьте [распознаватель](https://docs.ai-softphone.com/ru/ai-processing/transcription/index.md) и [языковую модель](https://docs.ai-softphone.com/ru/ai-processing/processing/index.md), если нужны расшифровки и разборы. В России проще всего начать с Yandex SpeechKit и YandexGPT — для обоих хватит одного API-ключа сервисного аккаунта Яндекс Облака.

**Настройки → Сводка** ведёт этот список за вас: зелёная точка отмечает сделанный шаг, красная — ещё не сделанный. См. [Обзор настроек](https://docs.ai-softphone.com/ru/interface/settings-overview/index.md).

## Что читать дальше {#where-to-read-next}

| Если вы хотите… | Читайте |
| --- | --- |
| Освоиться в окнах программы | [Интерфейс](https://docs.ai-softphone.com/ru/interface/main-window/index.md) |
| Подключить телефон к АТС | [Настройка SIP-учётной записи](https://docs.ai-softphone.com/ru/sip-accounts/setup/index.md) |
| Выбрать микрофон, динамики и мелодию звонка | [Устройства](https://docs.ai-softphone.com/ru/sip-accounts/devices/index.md) |
| Настроить кодеки, ожидание вызова и журнал звонков | [Настройки звонков](https://docs.ai-softphone.com/ru/sip-accounts/calls/index.md) |
| Вынести коллег на кнопки быстрого набора | [Кнопки](https://docs.ai-softphone.com/ru/sip-accounts/buttons/index.md) |
| Решить, какие звонки записывать и сколько их хранить | [Записи](https://docs.ai-softphone.com/ru/recordings/index.md) |
| Слушать, искать и читать свои разговоры | [Окно записей](https://docs.ai-softphone.com/ru/interface/recordings/index.md) |
| Записать встречу в другом приложении | [Перехват](https://docs.ai-softphone.com/ru/capture/index.md) |
| Выбрать распознаватель, который превращает речь в текст, в том числе Yandex SpeechKit | [Расшифровка](https://docs.ai-softphone.com/ru/ai-processing/transcription/index.md) |
| Решить, какой ИИ разбирает разговоры (например, YandexGPT) и сколько это может стоить | [Обработка](https://docs.ai-softphone.com/ru/ai-processing/processing/index.md) |
| Изменить категории, метки и красные флаги | [Справочники](https://docs.ai-softphone.com/ru/ai-processing/dictionaries/index.md) |
| Видеть, что говорят во время звонка, и получать подсказки, что ответить | [Окно суфлёра](https://docs.ai-softphone.com/ru/interface/prompter/index.md) |
| Изменить раскладку, тему, запуск и горячие клавиши | [Оформление](https://docs.ai-softphone.com/ru/program/appearance/index.md), [Запуск](https://docs.ai-softphone.com/ru/program/startup/index.md) и [Горячие клавиши](https://docs.ai-softphone.com/ru/program/shortcuts/index.md) |
| Подключить CRM или другую программу | [Вебхуки](https://docs.ai-softphone.com/ru/integration/webhooks/index.md) и [Локальный REST API](https://docs.ai-softphone.com/ru/integration/rest-api/index.md) |
| Увидеть, что говорят друг другу телефон и АТС | [Диагностика](https://docs.ai-softphone.com/ru/troubleshooting/diagnostics/index.md) |
| Найти причину неполадки | [Частые проблемы](https://docs.ai-softphone.com/ru/troubleshooting/common-problems/index.md) |
| Отключить части программы | [Модули](https://docs.ai-softphone.com/ru/application/modules/index.md) |
| Узнать версию, обновления, страну и что входит в отчёт об использовании | [О программе](https://docs.ai-softphone.com/ru/application/about/index.md) |

Страницы идут в том же порядке, что и вкладки **Настроек**.

## Конфиденциальность {#privacy}

- По умолчанию всё остаётся на вашем компьютере: записи, расшифровки и история лежат в файле, который принадлежит вам. Ничто о разговоре — ни номер, ни имя, ни одно сказанное слово — не уходит туда, куда вы сами его не отправили.
- Пароли учётных записей, значение заголовка вебхука и токен API хранятся в хранилище ключей операционной системы, а не в файле настроек.
- Новая версия сообщает о себе, когда выходит, — никогда во время звонка — и устанавливается только по вашему слову.
- Программа отправляет один небольшой отчёт об использовании в день. Перед первой отправкой вам показывают, что в нём, и вы выбираете объём: **Базовые** или **Расширенные**. В нём никогда нет номеров, контактов, адреса вашей АТС и ничего из сказанного в разговоре. Полный перечень — в разделе [«О программе»](https://docs.ai-softphone.com/ru/application/about/index.md#telemetry).
- Если звук и текст не должны покидать страну, используйте распознаватель и модель, размещённые в России (Yandex SpeechKit и YandexGPT), или [собственные модели](https://docs.ai-softphone.com/ru/ai-processing/transcription/index.md#your-own-models) в вашей сети.
- Программа — свободное ПО под лицензией GPL v2.
