> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hubtalk.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Фразы автоответчика

> Список фраз, по которым агенты организации узнают голосовую почту: какие фразы там лежат, как их править и кто может это делать.

# Фразы автоответчика

Страница **«Фразы автоответчика»** в меню кабинета хранит список фраз, по которым агенты организации узнают голосовую почту: «Оставьте сообщение после сигнала», «Вы позвонили абоненту», «Leave a message». Если приветствие на звонке совпало с фразой из списка, детектор сразу решает, что ответил автоответчик, и агент делает то, что задано в его [настройках определения автоответчика](https://docs.hubtalk.ai/ru/v4/platform/agent-settings/voicemail-detection.md).

![Страница «Фразы распознавания автоответчика»: поле для новой фразы, кнопки «Загрузить файл (добавить)», «Загрузить файл (заменить)» и «Выгрузить CSV», фильтр, галочки у фраз, кнопка «Сохранить» и рекомендуемый список фраз](https://mintcdn.com/hubtalk/zuNdClFKsDxX2Uid/images/v4_voicemail_phrases.png?fit=max\&auto=format\&n=zuNdClFKsDxX2Uid\&q=85\&s=6437daf0a1e432573b962ed187ee4506)

Список один на организацию, и его используют все её агенты. У каждого агента есть ещё своё поле фраз — они добавляются к списку организации, а не заменяют его.

Если у агента включена **«Обработка фильтра звонков»**, до этих двух списков платформа проверяет [фразы фильтров звонков](https://docs.hubtalk.ai/ru/v4/platform/screener-phrases.md): фраза группы «предлагает оставить сообщение» тоже означает автоответчик. Там же работают встроенные фразы о переполненном ящике («The mailbox is full» и похожие) — на этой странице их нет.

## Рекомендуемый список

Новая организация получает **рекомендуемый список** — 41 фразу: 29 стандартных приветствий голосовой почты на русском, казахском, английском, испанском, узбекском и киргизском и 12 полных приветствий мексиканских операторов.

Кнопка **«Вернуть рекомендуемые»** видна, только когда список отличается от рекомендуемого. Она подставляет рекомендуемый набор в черновик — чтобы он начал работать, нажмите **«Сохранить»**.

## Как работает фраза

* **Фраза от трёх слов срабатывает, если встретилась в любом месте приветствия**, и решает сразу, без модели. Она сработает, даже если её произнесёт живой человек, поэтому не добавляйте фраз, которые может сказать абонент.
* **Более короткие фразы — подсказки для модели.** Они работают, только если у агента включена проверка «Модель».
* **Фраза организации проверяется раньше фразы агента.** Если одна и та же фраза есть в обоих списках, в истории звонка источником будет организация.
* Регистр, знаки препинания, лишние пробелы и диакритика (ё и е, й и и, á и a) при сравнении не учитываются.

Модель получает фразы обоих списков в пределах 4000 символов: сначала короткие фразы организации, затем фразы агента, затем длинные фразы организации. Что не поместилось, модель не видит, но длинные фразы при этом продолжают срабатывать как точные.

## Как изменить список

1. Откройте **«Фразы автоответчика»** в меню кабинета. Страница показывает список вашей организации.
2. Введите фразу в поле под подсказкой и нажмите **«Добавить фразу»** или Enter. Новая фраза встаёт в начало списка. Как добавить сразу много фраз, описано в разделе [«Массовые операции»](#массовые-операции).
3. Чтобы изменить фразу, нажмите карандаш в её строке и поправьте текст: Enter применяет правку, Esc отменяет. Корзина удаляет фразу.
4. Поле **«Фильтр…»** помогает найти фразу в длинном списке; рядом видно, сколько фраз подошло: «Показано N из M».
5. Нажмите **«Сохранить»** — кнопка активна, только когда есть несохранённые изменения. Пока они есть, видна кнопка **«Отменить изменения»**: она возвращает список к последнему сохранённому виду.

После сохранения кабинет показывает уведомление «Фразы распознавания автоответчика сохранены.». Каждый агент начинает использовать новый список со следующего набора номера. Звонки, которые идут прямо сейчас, доживают со своим списком.

**Ограничения:** до 500 фраз в списке, до 120 символов в фразе, без повторов — повтором считается фраза, которая отличается от другой только регистром, знаками, пробелами или диакритикой. Если фраза не проходит проверку, под полем появляется пояснение, например: «Leave a message» уже есть в списке.

> [!WARNING]
>
> **Список можно сохранить пустым, но тогда автоответчик по фразам будут узнавать только собственные фразы агентов.** Пока список пуст, страница показывает предупреждение «Без фраз здесь автоответчик распознают только собственные подсказки агента.»

## Массовые операции

Массовые операции, как и правка по одной фразе, меняют только черновик. Список меняется, когда вы нажмёте **«Сохранить»**; **«Отменить изменения»** возвращает его к последнему сохранённому виду. Черновик живёт на открытой странице: если уйти с неё, не нажав **«Сохранить»**, изменения не сохранятся.

### Удалить несколько фраз

1. Отметьте галочками фразы в списке. Галочка над списком, в строке фильтра, отмечает все **показанные** фразы — с учётом поля **«Фильтр…»**; повторное нажатие снимает отметку.
2. Внизу страницы появится панель **«Выбрано: N»**. Нажмите **«Удалить выбранные»**.
3. Подтвердите удаление в окне **«Удалить выбранные фразы (N)?»** кнопкой **«Удалить»**.
4. Нажмите **«Сохранить»**.

Выбор сбрасывается при любом изменении черновика, при смене фильтра, после сохранения и после **«Отменить изменения»** — поэтому скрытые фильтром фразы незаметно не удалятся.

### Вставить столбец фраз

Скопируйте столбец из таблицы или текст, где каждая фраза на своей строке, и вставьте в поле добавления. Каждая строка становится отдельной фразой, пустые строки пропускаются. Принятые фразы встают в начало списка в том же порядке. Вставка одной строки просто попадает в поле, как при обычном вводе.

### Загрузить файл

Кнопки над списком:

* **«Загрузить файл (добавить)»** — добавляет фразы файла в начало черновика;
* **«Загрузить файл (заменить)»** — заменяет черновик фразами файла целиком. Отчёт показывает ещё, сколько прежних фраз ушло из черновика: **«Удалено: N»**.

Файл — CSV или XLSX до 10 МБ, не больше 500 строк с фразами. Одна фраза в строке:

| Колонка | Что в ней |
| - | - |
| 1 | фраза |

* Если первая непустая строка — заголовок `phrase`, она пропускается.
* Пустые строки пропускаются.
* Из XLSX читается первый лист. В CSV разделителем может быть запятая, точка с запятой или табуляция; фразу с запятой возьмите в кавычки.
* Старый формат `.xls` не принимается — сохраните файл как `.xlsx` или `.csv`.

Файл, который не подошёл целиком (не тот формат, больше 10 МБ, не читается, больше 500 строк с фразами), отклоняется с пояснением, и черновик не меняется. Загрузка сама ничего не сохраняет: фразы попадают в черновик.

### Отчёт о вставке и загрузке

После вставки или загрузки над списком появляется отчёт: **«Добавлено: N»**, **«Отклонено: M»**, а при замене — **«Удалено: K»**. Отклонённые строки перечислены в таблице **«Строка»**, **«Фраза»**, **«Причина»**. Номер строки — порядковый номер во вставленном тексте или номер строки в файле, с учётом заголовка и пустых строк. Причины отказа:

* фраза длиннее 120 символов;
* фраза уже есть в черновике или выше в той же пачке — по тем же правилам сравнения, что и при обычном добавлении;
* в списке не больше 500 фраз: строки сверх лимита отклоняются;
* в строке файла лишние колонки — возьмите фразу в кавычки.

Отчёт пропадает после сохранения, после **«Отменить изменения»** и при следующей вставке или загрузке.

### Выгрузить список

**«Выгрузить CSV»** скачивает файл `voicemail-phrases.csv` с **сохранённым** списком: заголовок `phrase` и по фразе в строке. Фильтр на выгрузку не влияет. Файл в том же формате, что и для загрузки, поэтому его можно поправить и загрузить обратно как есть. Если в черновике есть несохранённые изменения, под кнопкой появляется подсказка «В файл попадёт сохранённый список — сначала нажмите «Сохранить».»

## Кто может править список

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

## Что видно в истории звонка

Когда автоответчик пойман по фразе, событие в [карточке звонка](https://docs.hubtalk.ai/ru/v4/platform/campaign-history/call-details) показывает, как принято решение — **«точная фраза»**, **«подсказка модели»** или **«модель»**, — саму фразу и её источник: **«список организации»** или **«фразы агента»**. Фраза «mailbox is full» с источником «список организации» — встроенное правило фильтра звонков, а не фраза с этой страницы.

По этому событию удобно разбирать ошибки: если живого человека приняли за автоответчик из-за конкретной фразы, её видно сразу, и её можно убрать из списка.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.