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

> Що таке AI Softphone, на чому він працює і де описано кожну частину програми.

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

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

Записи, розшифровки та історія зберігаються у файлі, який належить вам. Не потрібні ні обліковий запис, ні передплата, а сама програма — вільне програмне забезпечення за ліцензією GPL v2.

## Від розмови до обробки {#from-a-conversation-to-a-write-up}

1. Надходить розмова: виклик, зустріч або файл.
2. Її записують двома каналами, тож сказане вами і сказане іншою стороною лишається окремо.
3. Її розшифровують — мовець за мовцем, синхронно зі звуком.
4. Вибрана вами мовна модель її обробляє: підсумок, завдання, категорія, мітки й червоні прапорці — а ще розмові можна поставити запитання.

Під час виклику [Суфлер](https://docs.ai-softphone.com/uk/interface/prompter/index.md) може більше: він показує сказане тієї миті, коли його кажуть, і підказує, що відповісти.

## Завантаження і системні вимоги {#download-and-system-requirements}

Програму можна безкоштовно завантажити з [ai-softphone.com](https://ai-softphone.com/#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 МБ місця на диску, плюс записи. Для значка в треї потрібне робоче середовище з областю сповіщень про стан. |

У Linux AppImage працює на будь-якому дистрибутиві того ж віку: зробіть файл виконуваним і запустіть його. Пакунку `.deb` потрібні ще системні бібліотеки C++ з GCC 13, які є в Ubuntu 24.04 і Debian 13, але немає в Ubuntu 22.04; на будь-чому старшому беріть AppImage.

Інтерфейс доступний тридцятьма мовами; мову вибирають у [Вигляді](https://docs.ai-softphone.com/uk/program/appearance/index.md) і змінюють без перезапуску.

Знімки екрана в цій документації зроблено в macOS і показано зменшеними: клацніть знімок, щоб побачити його в повному розмірі. В інших системах програма виглядає і працює так само.

## Перші кроки {#first-steps}

1. [Додайте обліковий запис](https://docs.ai-softphone.com/uk/sip-accounts/setup/index.md) для вашої АТС або SIP-оператора.
2. [Виберіть мікрофон і динаміки](https://docs.ai-softphone.com/uk/sip-accounts/devices/index.md) та зробіть пробний виклик.
3. Вирішіть, [які виклики записувати](https://docs.ai-softphone.com/uk/recordings/index.md).
4. Додайте [розпізнавач](https://docs.ai-softphone.com/uk/ai-processing/transcription/index.md) і [мовну модель](https://docs.ai-softphone.com/uk/ai-processing/processing/index.md), якщо вам потрібні розшифровки й обробки.

**Налаштування → Огляд** веде цей список за вас: зелена крапка позначає виконаний крок, червона — крок, що лишився. Див. [Огляд налаштувань](https://docs.ai-softphone.com/uk/interface/settings-overview/index.md).

## Що читати далі {#where-to-read-next}

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

Сторінки йдуть у порядку вкладок у **Налаштуваннях**.

## Конфіденційність {#privacy}

- Типово все лишається на вашому комп'ютері: записи, розшифровки та історія зберігаються у файлі, який належить вам. Ніщо з розмови — ні номер, ні ім'я, ні слово зі сказаного — нікуди не потрапляє, якщо ви самі туди цього не надіслали.
- Паролі облікових записів, значення заголовка вебхука і токен API зберігаються у сховищі ключів операційної системи, ніколи — у файлі налаштувань.
- Нова версія повідомляє про себе, щойно виходить, — але ніколи під час виклику — і встановлюється лише тоді, коли ви скажете.
- Програма надсилає один невеликий звіт про використання на добу. Перед першим вам показують, що в ньому, і ви вибираєте, скільки він містить: **Базове** або **Розширене**. У ньому ніколи немає номерів, контактів, адреси вашої АТС чи будь-чого сказаного в розмові. Повний перелік — у розділі [Про програму](https://docs.ai-softphone.com/uk/application/about/index.md#telemetry).
- Програма — вільне програмне забезпечення за ліцензією GPL v2.
