> ## 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.

# Фразы фильтров звонков

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

# Фразы фильтров звонков

Страница **«Фразы фильтров звонков»** (раздел меню **«Библиотека»**) хранит фразы, которые произносят фильтры звонков абонента — iOS Call Screening, Call Assist, Cloaked AI, секретарские службы: «If you record your name and reason for calling», «Please stay on the line», «The person you're calling is busy now». Каждый агент с включённой [обработкой фильтра звонков](https://docs.hubtalk.ai/ru/v4/platform/agent-settings/voicemail-detection.md#фильтры-звонков) по этому списку отличает фильтр от человека и понимает, что делать дальше.

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

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

## Группы фраз

У каждой фразы есть группа. **Группа определяется тем, что делает фильтр, когда произносит фразу**, а реакция агента к группе привязана и отдельно не выбирается. Поэтому подпись группы в раскрытом списке называет обе части: «Фильтр держит линию → агент ждёт, пока ответит человек». В закрытом поле — короткая форма: «Фильтр: держит линию». Добавляя фразу, спросите себя: «что делает фильтр, когда это говорит?» Подсказка по группам показана и на странице над списком.

| Группа (короткая подпись) | Пример фразы | Что делает агент |
| - | - | - |
| **«Фильтр спрашивает, кто звонит → агент отвечает о себе»** («Фильтр: кто звонит?») | «Please say who you are and why you're calling» | Отвечает о себе: сначала шаблоном первого ответа, дальше моделью. Что говорить, задаётся в блоке **«Кто звонит»** окна [«Обработка фильтра звонков»](https://docs.hubtalk.ai/ru/v4/platform/agent-settings/voicemail-detection.md#окно-обработка-фильтра-звонков) в настройках агента. |
| **«Фильтр держит линию → агент ждёт, пока ответит человек»** («Фильтр: держит линию») | «Please hold while I connect you» | Молча ждёт, пока ответит человек или выйдет таймаут удержания. |
| **«Фильтр отклоняет звонок → звонок завершается»** («Фильтр: отклоняет») | «The person you're calling is busy now» | Завершает звонок с исходом **«Отклонил фильтр звонков»**. |
| **«Фильтр предлагает оставить сообщение → агент действует как на автоответчике»** («Фильтр: просит сообщение») | «Start talking after the tone» | Выполняет [реакцию на автоответчик](https://docs.hubtalk.ai/ru/v4/platform/agent-settings/voicemail-detection.md#что-происходит-после-решения) из настроек агента: оставляет сообщение, кладёт трубку или продолжает разговор. По умолчанию кладёт трубку. |

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

* **Во фразе не меньше трёх слов**, и она совпадает точно. Реплику, которая совпала с фразой лишь частично, решает быстрая модель.
* **Фраза ищется в любом месте реплики**, поэтому достаточно ключевой части длинной фразы фильтра.
* Регистр, диакритические знаки, знаки препинания и лишние пробелы при сравнении не учитываются.
* **Фразы фильтров проверяются раньше фраз автоответчика.**

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

Пока организация не сохранила свой список, её агенты используют **рекомендованный список** её рынка:

* организации рынка США — 30 фраз: 20 на английском и 10 на испанском;
* организации других рынков — 10 фраз на испанском.

Среди испанских фраз — короткие формы приветствия скринера iPhone: его начало («Si dejas tu nombre y el motivo») и вторая половина («Revisaré si esta persona está disponible»). Так скринер узнаётся, даже если агент услышал только часть фразы.

Первое сохранение запоминает ровно то, что вы сохранили, и дальше рекомендованный список ваш список не меняет. Если в вашем списке нет каких-то рекомендованных фраз вашего рынка — в том числе тех, что вы удалили сами, — страница показывает **«Новых рекомендованных фраз: N»** с кнопкой **«Добавить»**. Кнопка добавляет все такие фразы в конец списка с рекомендованными группами и ничего больше не меняет; чтобы применить, сохраните список.

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

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

Каждый агент использует новый список со следующего набора. Текущие звонки держат свой список до конца.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

| Колонка | Что в ней |
| - | - |
| 1 | фраза |
| 2 | код группы: `asks` — «Фильтр: кто звонит?», `hold` — «Фильтр: держит линию», `declined` — «Фильтр: отклоняет», `message` — «Фильтр: просит сообщение» |

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

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

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

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

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

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

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

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

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

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


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