# Частые проблемы

> Что проверить, если учётная запись не регистрируется, нет звука, звонок или встреча не записались, нет расшифровки, не видно Yandex SpeechKit и YandexGPT, не запускается суфлёр, или ссылка, горячая клавиша или API ничего не делают, а также что значат сообщения самого телефона.

Каждый пункт указывает на настройку, которая за это отвечает. Если ответа здесь нет, откройте [Диагностику](https://docs.ai-softphone.com/ru/troubleshooting/diagnostics/index.md): она показывает, что говорят друг другу телефон и АТС.

## Учётная запись не регистрируется {#the-account-will-not-register}

Точка рядом с учётной записью в **Настройки → Учётные записи** остаётся серой или красной.

1. Проверьте **Имя пользователя**, **Пароль** и **Адрес сервера** в [форме учётной записи](https://docs.ai-softphone.com/ru/sip-accounts/setup/index.md).
2. Если АТС проверяет пароль под другим именем, чем внутренний номер, заполните **Пользователь для авторизации** в **Настройках сервера**.
3. Сверьте **Транспорт** и **Порт** с тем, что ожидает АТС.
4. Откройте вкладку **SIP** [окна диагностики](https://docs.ai-softphone.com/ru/troubleshooting/diagnostics/index.md) и посмотрите запрос `REGISTER` и ответ сервера.

## Меня не слышно, или я не слышу {#i-cannot-hear-or-i-cannot-be-heard}

Откройте [Настройки → Устройства](https://docs.ai-softphone.com/ru/sip-accounts/devices/index.md).

- Скажите что-нибудь: полоса под **Микрофоном** должна двигаться. Если нет — выберите другой микрофон.
- Нажмите **Проверить** под **Динамиками**, чтобы услышать звук на выбранном устройстве.
- Проверьте ползунки **Громкость**. Кнопка микрофона на карточке звонка и [горячая клавиша](https://docs.ai-softphone.com/ru/program/shortcuts/index.md) **Выключить микрофон** выключают микрофон во время звонка.
- Звонок может звучать не на том устройстве, на котором вы разговариваете, — второй выпадающий список в **Мелодии звонка**.

## Звонок звучит плохо или не начинается {#the-call-sounds-bad-or-does-not-start}

Кодеки предлагаются в порядке списка в [Настройки → Звонки](https://docs.ai-softphone.com/ru/sip-accounts/calls/index.md#audio-formats). Оставьте включёнными кодеки, которые использует ваша АТС, и поставьте лучший из них первым. Изменение действует со следующего звонка.

## Второй звонок не звонит {#a-second-call-does-not-ring}

Что происходит, когда вам звонят во время разговора, задаётся в [Ожидании вызова](https://docs.ai-softphone.com/ru/sip-accounts/calls/index.md#call-waiting).

## Звонок не записался {#a-call-was-not-recorded}

- Первый выпадающий список в **Настройки → Запись** решает, какие звонки записываются; по умолчанию — **Вручную**, то есть только когда вы нажимаете запись на карточке звонка. См. [Записи](https://docs.ai-softphone.com/ru/recordings/index.md).
- Запись начинается в момент ответа, поэтому у неотвеченного звонка файла нет.
- Модуль **Запись** должен быть включён в [Модулях](https://docs.ai-softphone.com/ru/application/modules/index.md).
- Записи удаляются ограничениями в блоке **Хранение**; закреплённая запись не удаляется никогда.

## Встреча в другом приложении не перехвачена {#a-meeting-in-another-application-was-not-captured}

См. [Перехват](https://docs.ai-softphone.com/ru/capture/index.md).

- **Разрешить перехват звука** в **Настройки → Перехват** должно быть включено.
- Если **Автоматический запуск** — **Спрашивать** (по умолчанию), ответьте на появившийся вопрос; если **Никогда** — нажмите кнопку записи сами.
- Воспользуйтесь **Проверкой** на той же вкладке: верхняя полоса должна двигаться, когда вы говорите, нижняя — когда что-то играет.
- Модуль **Перехват** должен быть включён в [Модулях](https://docs.ai-softphone.com/ru/application/modules/index.md).

## Запись есть, а расшифровки или содержания нет {#there-is-a-recording-but-no-transcript-or-summary}

- Разговор сам расшифровывается и разбирается, только если включено **Обрабатывать разговоры автоматически** в [Настройки → Обработка](https://docs.ai-softphone.com/ru/ai-processing/processing/index.md). Иначе попросите об этом в [окне записей](https://docs.ai-softphone.com/ru/interface/recordings/index.md).
- Нужны [распознаватель](https://docs.ai-softphone.com/ru/ai-processing/transcription/index.md) и [языковая модель](https://docs.ai-softphone.com/ru/ai-processing/processing/index.md#language-models), и каждый должен отвечать по своему адресу — проверьте кнопкой **Проверить** в их форме.
- Когда достигнут месячный **Лимит денег** или **Лимит токенов**, автоматические правила останавливаются до следующего месяца. То, о чём вы просите сами, не останавливается никогда.
- Шаги [Настройки → Сводка](https://docs.ai-softphone.com/ru/interface/settings-overview/index.md) показывают, что ещё не настроено.

## Задачи и темы не появились автоматически {#missing-automatic-write-ups}

В стандартном наборе есть промпты **Задачи**, **Темы**, **Имена и числа** и **Вопрос об этом разговоре**, но нет правил для их автоматического запуска. Откройте запись и выберите нужный промпт через **Искры → Обработка**. Для регулярных разборов можно добавить своё [правило](https://docs.ai-softphone.com/ru/ai-processing/processing/index.md#rules); вопрос к разговору вводится при ручном запуске.

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

## Почему нет оценки качества {#missing-quality-score}

Стандартные правила запускают оценку продажи только для категории `sales`, а оценку поддержки — для `support`. Для **Личного** и **Прочего** автоматической оценки качества нет. Проверьте категорию, включение соответствующего правила и порядок: определение категории должно предшествовать оценке. При необходимости запустите нужный промпт вручную в [окне записей](https://docs.ai-softphone.com/ru/interface/recordings/index.md#the-buttons-beside-the-drop-down).

## Помощник продаж отвечает «—» {#sales-assistant-dash}

Это предусмотрено стандартным промптом **Продажи** (`rt-objections`, на скриншотах — **Возражения в звонке**): если полезной следующей реплики нет, модель должна вернуть «—». Такой ответ сам по себе не означает ошибку подключения. [Описание помощника](https://docs.ai-softphone.com/ru/ai-processing/prompter/index.md#rt-objections) показывает, какую информацию он получает и что должен выдавать.

## Изменил Markdown с промптами, а поведение осталось прежним {#prompt-export-not-applied}

Markdown-выгрузка служит для чтения и подготовки правок. Программа не загружает её обратно. Перенесите роль и задание в карточку нужного промпта или помощника. Для возврата стандартного набора используйте [**Восстановить по умолчанию**](https://docs.ai-softphone.com/ru/ai-processing/processing/index.md#defaults).

## В списке нет Yandex SpeechKit или YandexGPT {#yandex-speechkit-or-yandexgpt-is-not-in-the-list}

Эти виды показываются, только когда в [Настройки → О программе](https://docs.ai-softphone.com/ru/application/about/index.md#what-russia-changes) выбрана страна **Россия** (или Беларусь, Казахстан, Узбекистан, Кыргызстан, Таджикистан, Туркменистан, Армения, Азербайджан). Выберите страну и снова откройте форму распознавателя или модели. Язык интерфейса на это не влияет.

## Yandex SpeechKit или YandexGPT отвечает отказом {#yandex-speechkit-or-yandexgpt-refuses}

**Проверить** в форме пишет *Отказ: …* с причиной.

- Ключ должен быть API-ключом сервисного аккаунта Яндекс Облака, вставленным целиком, без пробелов.
- У сервисного аккаунта должны быть роли: `ai.speechkit-stt.user` для SpeechKit и `ai.languageModels.user` для YandexGPT.
- Если вы входите IAM-токеном личного аккаунта, заполните **Каталог** в **Дополнительных настройках**.
- У платёжного аккаунта облака должен быть положительный баланс.
- Длинная запись может не пройти по **Пределу отправки** или **Пределу длины** в [дополнительных настройках SpeechKit](https://docs.ai-softphone.com/ru/ai-processing/transcription/index.md#yandex-speechkit-settings).

## Суфлёр не появляется или не запускается {#the-prompter-does-not-appear-or-does-not-start}

**Суфлёр** появляется в списке внизу телефона, только когда есть три вещи: распознаватель с заполненным **Адрес для суфлёра**, прошедший **Проверить** в [Настройки → Расшифровка](https://docs.ai-softphone.com/ru/ai-processing/transcription/index.md#live-recognition-for-the-prompter), языковая модель и флажок **Разрешить использование суфлёра** в [Настройки → Суфлёр](https://docs.ai-softphone.com/ru/ai-processing/prompter/index.md). Модуль **Суфлёр** должен быть включён в [Модули](https://docs.ai-softphone.com/ru/application/modules/index.md).

Если окно открывается, но суфлёр не запускается, строка под его кнопками говорит, чего не хватает. В разделе [Когда он не запускается](https://docs.ai-softphone.com/ru/interface/prompter/index.md#when-it-does-not-start) перечислены все сообщения и что делать.

## Телефон пропал, когда я закрыл окно {#the-phone-disappeared-when-i-closed-the-window}

Если включено **Оставлять телефон работать при закрытии окна**, телефон продолжает работать и звонки приходят. Значок в области уведомлений (в строке меню на macOS) возвращает окно. На рабочем столе без области уведомлений телефон свёрнут на панель задач. См. [Запуск](https://docs.ai-softphone.com/ru/program/startup/index.md).

## Номер в браузере или CRM не звонит {#a-phone-number-in-a-browser-or-a-crm-does-not-call}

Нажмите **Открывать ссылки на звонки этим телефоном** в [Настройки → Запуск](https://docs.ai-softphone.com/ru/program/startup/index.md#call-links). Нажатый номер попадает в наборник и ждёт там, если не включено **Звонить сразу, не нажимая «Позвонить»**.

## Лампа кнопки остаётся серой {#a-buttons-lamp-stays-grey}

АТС не сообщает, свободен ли номер. Кнопка всё равно набирает. См. [Кнопки](https://docs.ai-softphone.com/ru/sip-accounts/buttons/index.md).

## REST API не отвечает {#the-rest-api-does-not-answer}

- В [Настройки → Интеграция](https://docs.ai-softphone.com/ru/integration/rest-api/index.md) должно быть включено **Разрешить другим программам на этом компьютере управлять телефоном**, а в [Модулях](https://docs.ai-softphone.com/ru/application/modules/index.md) — модуль **Интеграция**.
- Адрес — `http://127.0.0.1:8377`, если вы не меняли **Порт**.
- Группа, не открытая в **Доступе**, отвечает на каждый запрос `404`.
- Если задан **Токен**, запросы, меняющие сохранённые данные, должны передавать его в заголовке `Authorization`.
- Другие признаки — в разделе [Если не работает](https://docs.ai-softphone.com/ru/integration/rest-api/index.md#when-it-does-not-work).

## Вебхуки не приходят {#webhooks-do-not-arrive}

Нажмите **Отправить тестовое событие** в [Настройки → Интеграция](https://docs.ai-softphone.com/ru/integration/webhooks/index.md). Счётчики REST API `webhooks_failed_total` и `webhooks_dropped_total` показывают, как идёт доставка; что значит каждый из них — в разделе [Если ничего не приходит](https://docs.ai-softphone.com/ru/integration/webhooks/index.md#when-nothing-arrives).

## Горячая клавиша ничего не делает {#a-hotkey-does-nothing}

Откройте [Горячие клавиши](https://docs.ai-softphone.com/ru/program/shortcuts/index.md). Сочетание работает, пока телефон — программа, с которой вы работаете; чтобы оно работало из любой программы, отметьте **Везде**. Если сочетание забрала другая программа, щёлкните по нему и нажмите клавиши ещё раз.

## Сообщения телефона {#messages-the-phone-shows}

Когда что-то не получается, телефон пишет почему отдельной строкой. Строка под списком сама исчезает через несколько секунд.

### Звонок не набирается {#when-a-call-is-not-placed}

| Сообщение | Что делать |
| --- | --- |
| *Учётная запись не настроена* | Добавьте учётную запись в [Настройки → Учётные записи](https://docs.ai-softphone.com/ru/sip-accounts/setup/index.md). |
| *Ни одна учётная запись не включена — звонить не с чего.* | Поставьте флажок учётной записи в **Настройки → Учётные записи**. |
| *Ни одна линия ещё не зарегистрирована.* | Учётная запись включена, но ещё не зарегистрирована на АТС. Дождитесь, пока её точка станет зелёной; если не станет, см. [Учётная запись не регистрируется](#the-account-will-not-register). |
| *Идёт столько звонков, сколько телефон может вести одновременно.* | Положите трубку на одном из звонков и позвоните снова. |
| *Учётной записи, с которой должен был уйти звонок, больше нет.* | Строка относится к учётной записи, которую с тех пор удалили. Наберите номер в номеронабирателе. |
| *В этой строке нет номера, на который можно перезвонить.* | Звонивший скрыл номер, поэтому перезвонить некуда. |

### Учётная запись не подключается {#when-an-account-does-not-connect}

| Сообщение | Что делать |
| --- | --- |
| *Не удалось найти такой адрес сервера. Проверьте, нет ли в нём опечатки.* | Проверьте **Адрес сервера** в [форме учётной записи](https://docs.ai-softphone.com/ru/sip-accounts/setup/index.md). |
| *Не удалось связаться с сервером. Проверьте адрес, порт и сеть.* | Проверьте **Адрес сервера**, а также **Транспорт** и **Порт** в разделе **Настройки сервера**. SIP может не пропускать и сетевой экран. |
| *Сервер отклонил имя пользователя или пароль.* | Проверьте **Имя пользователя** и **Пароль**. Если АТС проверяет пароль под другим именем, заполните **Пользователь для авторизации**. |
| *Не удалось проверить сертификат сервера. Если администратор сервера выпустил его сам, снимите «Проверять сертификат» в «Настройках сервера».* | Бывает при подключении по TLS. Если у АТС сертификат, который она сделала сама, снимите флажок **Проверять сертификат** в разделе **Настройки сервера**. |
| *Не удалось прочитать пароль этой учётной записи из хранилища ключей. Разблокируйте его и подключитесь ещё раз.* | Разблокируйте хранилище паролей компьютера (на macOS — связку ключей), затем нажмите **Подключить** у учётной записи. |

### Во время звонка {#during-a-call}

| Сообщение | Что делать |
| --- | --- |
| *Нет общего аудиоформата* | У АТС и телефона нет общего кодека. Включите тот, что использует АТС, в разделе [Аудиоформаты](https://docs.ai-softphone.com/ru/sip-accounts/calls/index.md#audio-formats). |
| *Нет микрофона или динамиков* | Выберите устройства в [Настройки → Устройства](https://docs.ai-softphone.com/ru/sip-accounts/devices/index.md). |
| *Запись не идёт: на диске кончается место. Освободите его или измените порог в настройках.* | Свободное место на диске дошло до порога (**Порог свободного места**) — см. [Записи](https://docs.ai-softphone.com/ru/recordings/index.md). Освободите место или уменьшите порог. |

### При запуске телефона {#when-the-phone-starts}

*Базу данных не прочитать* значит, что база данных сделана другой версией программы и эта прочитать её не может. Чаще всего более старую версию запустили на данных более новой: если снова поставить новую версию, она откроет базу как была. **Начать заново**, наоборот, делает пустую базу — все контакты и все звонки в истории пропадут, и это не отменить. Перед тем как нажать, можно сохранить копию файла базы; где он лежит, написано в разделе [Диагностика](https://docs.ai-softphone.com/ru/troubleshooting/diagnostics/index.md#files).
