Инструкции по разделам

«Общая аналитика» – верхнеуровневая аналитика по выбранному сценарию за выбранный период времени: сколько всего было диалогов, воронка диалогов, среднее время диалога и т.п.
«Список диалогов» – таблица со всеми диалогами сценария за выбранное время. Здесь по каждому диалогу можно посмотреть любую информацию о нем:
- Базовые параметры: длительность диалога, результат завершения, дата начала и т.п.
- Расшифровка диалога: текст и аудиозапись самого диалога
- Данные из диалога, которые были записаны в переменные: н-р, ФИО абонента, дата приема и т.д.
- Ответы абонентов: что отвечали абоненты на определенном шаге диалога (их ответы на вопросы робота)

Рассмотрим вкладку «Список диалогов» более подробно

В боковом меню переходим в соответствующий раздел («Список диалогов»)
На странице «Список диалогов» заполняем базовые фильтры:
1. Выбираем нужный сценарий
2. Выбираем дату, за которую хотим посмотреть данные
3. Необязательно: Если хотим посмотреть данные по конкретному обзвону – выбираем название обзвона
4. Нажимаем на кнопку «Применить»

Получаем таблицу со списком наших диалогов

Действия с таблицей диалогов

№	Действие	Скрин
1	Добавление/удаление столбца: Нажимаем на плюсик справа от заголовков таблицы Чтобы добавить/удалить столбец – нажимаем на нужный параметр Ждем загрузки столбца/таблицы
1.1	Описание параметров: Базовые параметры – параметры по умолчанию, относящиеся к любому диалогу (длительность, результат и тд) Переменные – переменные из сценария, в которые добавляли какую-либо информацию по мере прохождения диалога (н-р, фио абонента) Ответы абонентов – что отвечали абоненты на различные вопросы робота (блоки интентов). Н-р, “Да-да, я приду” Присвоенные ответ – вариант ответа интента, который был присвоен ответу абонента. Если абонент ответил “Да-да, я приду” (см. выше), то присвоенные ответ будет – “Да”
2	Чтобы прослушать/прочитать конкретный диалог, добавьте столбец “Расшифровка диалога” (если он еще не добавлен) и нажмите на кнопку “Открыть диалог”
3	Применение фильтров к столбцам / Сортировка Нажмите на шестеренку возле столбца, по которому хотите отсортировать или отфильтровать Выберите соответствующий пункт в выпавшем меню

Обзвоны

Загрузка контактов. Таблица с данными для создания обзвона

Запустите Excel, если у вас не установлена эта программа или ее аналог, можете воспользоваться сервисом Google Таблицы или Яндекс документы. Таблицы.

Теперь давайте создадим таблицу с заголовками, соответствующими параметрам в начальном блоке вашего сценария для обзвона. (если сценарий для вас создавали мы, заголовки столбцов вам должен был сообщить ваш менеджер, если нет, можете посмотреть сами по инструкции ниже)

Сценарий для обзвона — это тот, что вы выбрали на первом шаге создания обзвона

Если забыли или не знаете, какие параметры передаются в начальный блок этого сценария, перейдите в раздел «Сценарии» (лучше открыть в другой вкладке, чтобы не сбросить введенные данные для создания обзвона), найдите в списке сценариев тот, что был выбран для вашего обзвона и кликните по нему, чтобы открыть редактор сценариев.

Найдите начальный блок, который выбирали для обзвона на первом шаге создания обзвона в поле Сценарий (блок указан после «/», на скрине выше название начального блока «Начало сценария»). Начальный блок обычно крайний слева в сценарии. Кликните на него.

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

Столбец «phone» обязателен для обзвонов.

Параметр «fio»* требует создания столбца с заголовком fio и списком ФИО абонентов.
«message»* — заголовок message и тексты сообщений, которые будут озвучены роботом в диалоге
«name»* — заголовок name и имена, по которым робот должен обратиться к абонентам.
*Если в начальном блоке вашего сценария нет этих параметров, не нужно добавлять соответствующие столбцы в таблицу, эти данные все равно не будут учтены.

Сценарий можно закрыть, вернемся к созданию обзвона, а именно, к созданию таблицы с данными для обзвона.

Создадим столбцы с нужными заголовками и данными.

Сохраним таблицу в формате Excel/csv с любым названием. Пример сохранения из гугл-таблиц:

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

Дальше нужно проверить, все ли так с данными. У меня все в порядке, я могу нажать на кнопку «Продолжить» и завершить загрузку контактов, перейти на шаг «График» в создании обзвона. Данные загруженной мной таблицы в интерфейсе выглядят вот так:

Рассмотрим возможные варианты отображения данных и ошибок:

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

Допустим, я создам столбец с заголовком «телефон» вместо «phone», интерфейс будет выглядеть вот так:

Выбираем нужное название столбца «телефон» и нажимаем «Продолжить»

2 случай. В ячейках таблицы добавлены некорректные данные или есть незаполненные ячейки.

Тогда будут показаны ячейки с ошибками, интерфейс будет выглядеть таким образом:

Можете исправить ошибки в таблице и загрузить заново, нажав на кнопку «Назад» или создать обзвон, не используя строки, в которых содержатся ошибки, нажав на кнопку «Продолжить».

Также вы можете скачать таблицу со строками, содержащими ошибки, нажав на кнопку «Скачать ошибки» и посмотреть все строки таблице, а не только строки с ошибками, отжав галочку на опции «Только ошибки»

Обзвоны

Настройка графика обзвона

После загрузки контактов и проверки таблицы переходим к четвертому, финальному шагу «График» в создании обзвона. По умолчанию все поля предзаполнены для совершения обзвона в ближайшее время с двумя попытками дозвониться с интервалом в 2 минуты. Если вас устраивают такие параметры, нажимаем на кнопку «Создать». Поздравляю, обзвон создан!

Если вам необходимо изменить какие-то настройки в графике, давайте посмотрим, как это сделать:

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

Для того, чтобы выбрать время обзвона, в поле «Начать обзвон с» вместо «Сейчас» выберите «Другое время» и введите нужное время при помощи клавиатуры.

Также важно задать время, когда мы принудительно закончим совершать звонки, чтобы из-за большой очереди и нескольких попыток дозвониться, мы не побеспокоили абонента среди ночи. Введите в поле «Закончить обзвон в» время, в которое вы ходите принудительно завершить обзвон в случае, если не все звонки успеют отработать.

Количество попыток дозвониться — сколько раз мы будем пытаться звонить абоненту в случае, если он не взял трубку или сбросил звонок при дозвоне. Кликните на поле «Количество попыток дозвониться» и выберите нужное количество попыток.

Интервал между попытками — время в минутах между двумя попытками дозвониться до одного абонента. Для редактирования кликните на поле «Интервал между попытками» и введите нужное время в минутах.

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

Обзвоны

Повторный запуск обзвона

Вы можете повторно запустить обзвон по номерам, до которых не удалось дозвониться, с которыми сработал автоответчик или по другим выбранным статусам.

Где запустить повторный обзвон

Местоположение кнопки запуска зависит от вашего интерфейса:

Если вы используете поминутную тарификацию, откройте карточку обзвона, кликнув на строку нужного обзвона на странице «Обзвоны».
Если вы используете поканальную тарификацию, откройте карточку обзвона, кликнув на строку нужного обзвона на странице «История обзвонов».

В карточке нажмите кнопку «Выбрать номера для повторного обзвона».

Эта функциональность доступна только для завершенных или отмененных обзвонов.

Шаг 1. Выбор номеров по статусам

В открывшемся окне отобразятся все статусы номеров из завершённого обзвона. Отметьте те, по которым вы хотите запустить повторный обзвон (например, «Не дозвонились», «Автоответчик»). Статусы с нулевым количеством недоступны для выбора.

Платформа автоматически покажет расчётную длительность обзвона в зависимости от количества выбранных номеров.

Нажмите «Создать обзвон».

Шаг 2. Настройка нового обзвона

Процесс настройки повторного обзвона аналогичен созданию нового. При этом:

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

Дальнейшие шаги:

Проверяете таблицу с выбранными записями (шаг загрузки таблицы пропущен).
Настраиваете график — дату, время старта и окончания, количество попыток и интервал между ними.

Если вернуться на шаг назад, загруженная таблица будет удалена (появится окно подтверждения).

Где отобразится созданный повторный обзвон

При поминутной тарификации — в общем списке обзвонов на странице «Обзвоны».
При поканальной тарификации — в разделе «Очередь обзвонов».

Готово! Повторный обзвон будет запущен по заданным параметрам. Вы сможете отслеживать его статус так же, как и для обычного обзвона.

Обзвоны

Очередь и история обзвонов (для пользователей с поканальной тарификацией)

Разделы «Очередь обзвонов» и «История обзвонов» позволяют удобно управлять запланированными и завершёнными обзвонами. Они разделены по назначению:

Очередь — для активных и ожидающих запуска обзвонов.

История — для уже завершённых.

Очередь обзвонов

Чтобы перейти к очереди, выберите пункт «Очередь обзвонов» в боковом меню платформы.

В списке отображаются:

Номер в очереди — порядковый номер обзвона в очереди на текущую дату.
Дата начала обзвона — дата, на которую запланирован запуск.
Время обзвона — запланированное время начала и конца обзвона.
Статус:
- В работе — X% — обзвон запущен, и звонки выполняются. Процент отражает, какая часть номеров уже прозвонена.
- В очереди — обзвон ожидает своей очереди на запуск.
- Запланирован — обзвон создан, но ещё не перешёл в очередь на выполнение.
Название обзвона.
Название сценария.
Расчётная длительность — приблизительное время выполнения обзвона.

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

Правила очереди:

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

Что делать, если обзвон не завершился вовремя:

Он получит статус «Не успел завершиться». На странице «История обзвонов»
Перезапуск происходит вручную.
Вы можете создать новый обзвон на основе номеров со статусом «Не успели дозвониться» без загрузки новой таблицы.

История обзвонов

Чтобы перейти к истории, выберите пункт «История обзвонов» в меню платформы.

В списке отображаются завершённые обзвоны со следующей информацией о них:

Дата начала обзвона. (если обзвон не стартовал, отображается прочерк).
Статус.
Название обзвона.
Название сценария.

Вы можете кликнуть на строку, чтобы открыть карточку обзвона с:

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

Повторный запуск обзвона

Из карточки завершённого или отмененного обзвона можно:

Выбрать номера по нужному статусу (например, «не дозвонились»).
Создать новый обзвон по этим номерам.
Платформа предложит предзаполненный график обзвона (можно изменить).
Загружать таблицу номеров заново не нужно.

Подробнее о функциональности в инструкции по повторному запуску обзвона

Обзвоны

Раздел "Обзвоны" (для пользователей с поминутной тарификацией)

Раздел «Обзвоны» — это центральное место, где отображаются все обзвоны проекта: запущенные, завершённые и запланированные для пользователей с поминутной тарификацией.

Как попасть в раздел «Обзвоны»

Нажмите на пункт «Обзвоны» в левом боковом меню.

Что отображается в списке обзвонов

Каждая строка в таблице — это один обзвон. Для каждого обзвона указывается:

Название обзвона — задаётся пользователем при создании.
Сценарий, по которому проводился обзвон
Статус обзвона:
- Создан — обзвон создан, но ещё не запущен.
- В работе — X% — обзвон запущен, звонки выполняются. Процент отображает, какая часть номеров уже обработана.
- Завершён — обзвон завершён.
- Отменён — обзвон был отменён пользователем.
- Ошибка — возникла техническая ошибка при выполнении обзвона.Название сценария, по которому проводился обзвон.
Дата и время начала обзвона

Действия со списком обзвонов

Над таблицей обзвонов есть:

Кнопка создания обзвона.
Поиск по названию — введите часть названия, чтобы найти нужный обзвон.

Просмотр подробной информации об обзвоне

Чтобы открыть карточку обзвона, кликните по строке нужного обзвона в списке. Откроется модальное окно, в котором:

Отображается полный сценарий, по которому проходил обзвон.
Видно распределение номеров по статусам.
Есть кнопка «Перейти к аналитике», которая откроет страницу со всеми диалогами в рамках этого обзвона.

Повторный обзвон по статусам

В карточке завершенного или отмененного обзвона можно выбрать номера с определёнными статусами (например, «не дозвонились») и создать новый обзвон на основе этих номеров:

Таблицу повторно загружать не нужно.
Будет предложен предзаполненный график, который можно изменить.

Подробнее см. в инструкции по повторному запуску обзвонов.

Обновление статусов обзвонов

После завершения обзвона статус может не обновиться сразу. Чтобы увидеть актуальные данные:

Нажмите F5 на клавиатуре или кнопку обновить страницу в браузере.

Сценарии

Создание нового сценария

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

Нажмите на кнопку Она находится в правом верхнем углу. Далее выберите «Создать новый».

В появившемся окне введите:

Название сценария — любое. Желательно, чтобы оно соответствовало вашей цели
Описание сценария — необязательно
Тип сценария — выберите в зависимости от задачи (если создаете голосового ассистента - то «Звонок», если чат-бота, то «Чат»)
Поле «Создать на основе» можете не заполнять. Оно нужна для того, чтобы не создавать сценарий с нуля, а использовать существующий сценарий в проекте.

Нажмите кнопку «Создать сценарий». Затем модальное окно создания сценария закроется, и ваш сценарий окажется в верхней части списка всех сценариев. Найдите его и нажмите на него.

Интенты

Интенты. Общая информация

Интенты — предполагаемые намерения или смысловые группы возможных ответов абонентов

Из чего состоит Интент

Название. Оно отображается в списках интентов и нужно для того, чтобы вы сами понимали, какую смысловую группу ключевых фраз объединяет этот интент. Название не учитывается при сравнении интента с реальной фразой абонента, только ключевые/исключающие фразы (2 и 4)
Ключевые фразы — фразы, которые сравниваются с фразой абонента и в случае совпадения по заданному условию попадания под интент (3), относят ответ абонента к интенту, содержащему совпавшую ключевую фразу.
Условия попадания под интент — условия совпадения фразы, содержащейся в ответе абонента, с ключевой фразой для попадания ответа под интент. Есть четыре возможных условия попадания под интент, они совпадают также с правилами исключения для исключающих фраз (4):
- Полное совпадение — правило считается выполненным, если абонент произнес в точности то, что было указано в поле «‎Ключевые фразы»‎. Если абонент сказал длинную фразу, в которой встречается ваша ключевая фраза, то фраза абонента попадет под интент.
- Совпадение начальных форм — ответ попадет под интент, если в нем будет содержаться фраза, совпадающая с ключевой при приведении всех слов, содержащихся в фразах, к начальной форме
- Частичное совпадение —Подсчитывается число операций с символами до полного совпадения фразы. Возможные операции с символами: добавление, перестановка, удаление, замена.
Ответ попадет под интент, если в нем будет содержаться фраза, совпадающая с ключевой через несколько операций. Количество зависит от длины фразы.
Например: дверь/тверь (1 замена), австрия/австралия (2 добавления). При этом рим/мир (1 перестановка) не будут частично совпадающими, потому что длина фраз слишком мала.
- Регулярное выражение - это последовательность специальных символов, формирующих паттерн или шаблон, который сопоставляется со строкой.
Ответ попадет под интент, если будет соответствовать составленному шаблону.
Исключающие фразы имеют те же условия совпадения, как и у ключевых фраз, но при совпадении исключают ответ из интента, даже если по ключевым фразам ответ должен был попасть под интент.

Инструкции для работы с интентами по страницам/разделам:

Настройка интентов в блоке: раздел платформы, где можно добавить в любой блок обработки ответа любого сценария в проекте интенты, отредактировать их, протестировать работу отдельного интента или блока обработки ответа целиком, а также посмотреть, как реальные ответы абонентов распределялись по интентам в диалогах.
Общедоступные и шаблонные интенты: раздел платформы со списком общедоступных и шаблонных интентов. Общедоступные интенты — интенты, которые можно переиспользовать в разных блоках обработки ответа и сценариях. Их особенность в том, что изменения в общедоступном интенте применяются сразу во всех блоках и сценариях, где был использован этот интент. Шаблонные интенты — системные интенты, которые создаются автоматически при создании проекта. Это набор наиболее часто используемых интентов, которых достаточно для того, чтобы создать простой, но эффективный сценарий. Особенность шаблонных интентов в том, что их невозможно отредактировать или создать самостоятельно. Но вы можете создать новый интент на основе шаблонного.
Добавление интента в блок: модальное окно, появляющееся при добавлении интента в блок обработки ответа в редакторе сценариев или на странице настройки интентов в блоке. Здесь можно добавить интент в блок несколькими способами: создать с нуля или на основе любого существующего интента в проекте, использовать созданный общедоступный или шаблонный интент. Созданный новый интент можно сделать общедоступным, тогда он добавится в список общедоступных и его возможно будет переиспользовать.
Создание общедоступного интента: модальное окно, появляющееся при создании общедоступного интента на странице списка общедоступных и шаблонных интентов. Можно создать новый интент с нуля или на основе любого существующего интента в платформе.
Тестирование интента и тестирование блока: модальные окна, появляющиеся при клике на кнопки «Протестировать интент» и «Протестировать блок»
Блок обработки ответа: блок в редакторе сценариев.
Рекомендации для улучшения обработки ответов: практические советы по доработке интентов с использованием функционала платформы.

Интенты

Настройка интентов в блоке

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

Страница предназначена для редактирования блоков «Обработать ответ» в сценариях вашего проекта. Выберите сценарий и блок «Обработать ответ», созданный в сценарии. После выбора блока на странице появится список интентов, которые в нем используются.

Часть интентов из списка можно редактировать: добавлять и удалять ключевые и исключающие слова в интентах, изменять условия попадания под интент и условия исключения. Нельзя редактировать только интенты с типом «Шаблонный».

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

Также на странице доступен функционал тестирования. Протестировать можно как отдельный интент так и весь блок со всеми интентами, которые в нем находятся.

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

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

Выбор сценария и блока

При переходе на страницу «Настройка интентов в блоке» вы увидите пустую страницу с двумя полями, которые нужно заполнить. В поле «Сценарий» нужно выбрать сценарий, в котором находится вам необходимый блок обработки ответа. После выбора сценария вам будет доступно для редактирования поле «Блок обработки ответа». В нем нужно выбрать конкретный блок из сценария. В результате на странице появится список всех интентов находящихся в выбранном вами блоке.

Настройка блока

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

Интент «Остальное» есть во всех блоках обработки ответа и всегда расположен последним в списке интентов в блоке. В него попадают те ответы, что не попали ни под один из добавленных в блок интентов. «Остальное» отлично помогает в доработке блока после запуска сценария для реальных диалогов. Изучите «Рекомендации для улучшения обработки ответов», чтобы узнать, как именно.

Также вы можете добавить или удалить интенты из блока:

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

Для удаления интента нужно развернуть его карточку, кликнув в любом месте строки интента в списке (при наведении выделится стрелка справа). При клике на кнопку откроется модальное окно подтверждения удаления, чтобы обезопасить вас от ненужного, случайного удаления.

Чтобы лучше понимать, как будет отрабатывать блок с текущими настройками, воспользуйтесь тестированием блока, кликнув на кнопку . Ниже вы найдете инструкцию по тестированию блока.

Редактирование интента

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

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

: эта кнопка обновляет панель «Ответы абонентов, попавшие под интент», а также статистику справа от заголовков интентов в списке.

Особенности изменения ключевых фраз для Общедоступных и Шаблонных интентов: все изменения в общедоступных интентах применяются во всех блоках и сценариях, где был использован интент, а также на странице списка общедоступных и шаблонных интентов, после применения изменений к сценарию. Шаблонные интенты невозможно редактировать. Но вы можете отвязать (1.1) для конкретного блока интент от общедоступного или шаблонного, тогда изменения применятся только к нему, интент будет существовать только в этом блоке, поэтому изменения интентов другими людьми в других блоках никак не повлияют на настройки вашего интента.
Для каждой ключевой фразы необходимо выбрать одно из четырех условий попадания под интент:
- Полное совпадение — правило считается выполненным, если абонент произнес в точности то, что было указано в поле «‎Ключевые фразы»‎. Если абонент сказал длинную фразу, в которой встречается ваша ключевая фраза, то фраза абонента попадет под интент.
- Совпадение начальных форм — ответ попадет под интент, если в нем будет содержаться фраза, совпадающая с ключевой при приведении всех слов, содержащихся в фразах, к начальной форме
- Частичное совпадение —Подсчитывается число операций с символами до полного совпадения фразы. Возможные операции с символами: добавление, перестановка, удаление, замена.
Ответ попадет под интент, если в нем будет содержаться фраза, совпадающая с ключевой через несколько операций. Количество зависит от длины фразы.
Например: дверь/тверь (1 замена), австрия/австралия (2 добавления). При этом рим/мир (1 перестановка) не будут частично совпадающими, потому что длина фраз слишком мала.
- Регулярное выражение - это последовательность специальных символов, формирующих паттерн или шаблон, который сопоставляется со строкой.
Ответ попадет под интент, если будет соответствовать составленному шаблону.
Для удаления ключевой фразы кликните на , а затем подтвердите удаление в открывшемся диалоговом окне.
Для добавления новой ключевой фразы введите ее в поле с подсказкой «Введите фразу» в конце списка ключевых фраз, затем выберите условие попадания под интент. После выбора условия ключевая фраза автоматически добавляется в интент и под ней появляется новое поле для ввода ключевой фразы.
У раздела «Исключающие фразы» аналогичный функционал и те же условия, как для ключевых фраз, но при совпадении с исключающей фразой, ответ не попадет под интент, даже если по ключевым фразам должен был. Кликните на вкладку для просмотра, добавления и редактирования исключающих фраз
Тестирование интента покажет, попадет или не попадет фраза, используемая для тестирования, в интент при текущих ключевых и исключающих словах с заданными условиями попадания/исключения.

Ответы абонентов, попавшие под интент

Панель «Ответы абонентов попавших под интент» предназначена для просмотра ответов абонентов, которые прошли через блок обработки ответа и попали под определенный интент. С помощью этой панели можно собирать статистику по ответам абонентов, находить новые ключевые фразы для текущих и новых интентов, проверять как повлияют изменения в настройках блока на точность интентов.

Список ответов

По умолчанию в панели «Ответы абонентов, попавшие под интент» отображается список ответов за последнюю неделю, которые относятся к интенту «Остальное».

Вы можете изменить «Период выгрузки ответов», кликнув на соответствующее поле. В выпадающем списке будет четыре временных интервала на выбор: сутки, неделя, месяц или 3 месяца. От периода будет зависеть скорость загрузки статистики. Чем больше период, тем дольше будет подгружаться информация.

В поле «Интент» вы можете выбрать интент из добавленных в блок, чтобы получить список ответов, которые попали под него.

Для всех интентов, кроме «Остального», ответы в списке группируются по ключевым фразам. Рядом с каждой группой указано количество ответов, попавших в нее. Для удобства работы с определенной группой можете свернуть остальные, кликнув на их заголовок.

Рядом с некоторыми ответами в списке есть число в скобках, например (х1234): столько раз такой ответ в подобной формулировке встречался в диалогах, прошедших через этот блок обработки ответа за заданный период.

Список фраз можно отсортировать по частоте повторений и по времени попадания под интент. Если вы хотите посмотреть самые последние фразы, которые произносили абоненты в блоке обработки ответа, то нужно выбрать тип сортировки «Сначала новые»

Обновление с учетом изменений

Данные в панели «Ответы абонентов,..» отображаются в соответствии с настройками, примененными к сценарию.

После внесения изменений в настройки блока и интентов на странице настройки интентов в блоке вы можете нажать кнопку «Обновить с учетом изменений». Тогда данные перераспределятся в соответствии с текущими настройками на странице. При этом изменения, которые вы внесли, не применятся к реальным диалогам с вашими абонентами.

Так вы получаете возможность проверить, как блок будет работать с новыми настройками: если вы внесете изменения в блок или интент, которые повлияли на распределение ответов абонентов по интентам, то при клике на «Обновить с учетом изменений» над кнопкой появится уведомление «Есть добавленные ответы в интентах». При наведении на иконку info в этом уведомлении появится подсказка со списком интентов, для которых есть добавленные ответы. Можно кликнуть по названию интента, чтобы посмотреть, какие именно ответы добавились в него. Справа от названия — количество ответов, добавленных в интент.

Чтобы не показывать уведомление «Есть добавленные ответы в интентах», кликните на «Скрыть уведомления» в сплывающей подсказке. Если вы скрыли уведомление случайно, нажмите повторно на кнопку «Обновить с учетом изменений», чтобы вызвать его.

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

Сохранение изменений

Для того чтобы применить все настройки к реальным диалогам вам необходимо:

Нажать на кнопку «Применить изменения к сценарию»
Перейти в редактор сценариев, проверить, у всех ли интентов в блоке есть исходящие связи, если нет — добавить.
Опубликовать сценарий с изменениями

Интенты

Общедоступные и шаблонные интенты

Общедоступные и шаблонные интенты: раздел платформы со списком общедоступных и шаблонных интентов.

Общедоступные интенты — интенты, которые можно переиспользовать в разных блоках обработки ответа и сценариях. Их особенность в том, что изменения в общедоступном интенте применяются сразу во всех блоках и сценариях, где был использован этот интент.

Шаблонные интенты — системные интенты, которые создаются автоматически при создании проекта. Это набор наиболее часто используемых интентов, которых достаточно для того, чтобы создать простой, но эффективный сценарий. Особенность шаблонных интентов в том, что их невозможно отредактировать или создать самостоятельно. Но вы можете создать новый интент на основе шаблонного.

Интерфейс страницы

Каждый интент можно развернуть, кликнув на пустое пространство в строке интента. В развернутой карточке интента из списка общедоступных можно изменить название интента, посмотреть/изменить ключевые/исключающие фразы, протестировать интент, а также удалить интент, если он не используется ни в одном из сценариев. Для шаблонных интентов возможны только просмотр ключевых/исключающих фраз и тестирование.

Для удобства в разделе есть поиск по названию интента и фильтр по сценариям. У каждого интента в списке есть теги. Теги соответствуют названиям сценариев, в которых используется интент. Если интент используется в большом количестве сценариев, весь список можно посмотреть, развернув карточку интента.

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

Интенты

Добавление интента в блок

Добавление интента в блок — модальное окно, появляющееся при добавлении интента в блок обработки ответа в сценарии или на странице настройки интентов в блоке. Здесь можно добавить интент в блок несколькими способами: создать с нуля или на основе любого существующего интента в проекте, использовать созданный общедоступный или шаблонный интент. Созданный новый интент можно сделать общедоступным, тогда он добавится в список общедоступных и его возможно будет переиспользовать.

Создание нового интента

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

Есть дополнительные опции при создании интента: «Сделать общедоступным» и «Создать на основе»

Сделать общедоступным — опция, присваивающая вашему интенту тип «Общедоступный». Интент с таким типом будет отображаться в списке общедоступных интентов в разделе «Общедоступные и шаблонные интенты», и может быть использован в других сценариях проекта.

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

Для добавления уже существующего интента нужно нажать на «Использовать интент из списка общедоступных или шаблонных». Выбрать группу и интент.

Будьте внимательными при использовании уже существующего общедоступного интента. Общедоступные интенты, могут быть изменены другими пользователями. Для избежания нежелательных изменений в интенте лучше «Создать на основе» или «Отвязать от общедоступного» сразу после добавления в блок.

Интенты

Создание общедоступного интента

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

Создание с нуля

Введите название нового общедоступного интента и кликните на кнопку «Создать общедоступный интент»

Созданный интент появится в списке. В этом списке интенты отсортированы в алфавитном порядке по названию. Ваш новый интент сразу развернется для настройки ключевых фраз, давайте сделаем это.

Введем ключевые фразы и зададим для них условия попадания под интент. Изменения применяются автоматически, сохранять ничего не нужно. Здесь же можно настроить исключающие фразы, кликнув на соответствующую вкладку (справа от вкладки «Ключевые фразы»), если нужно.

Обратите внимание, если общедоступный интент используется в сценариях, то изменения, которые вы внесете в него, применятся во всех сценариях, в которых он используется

Создание на основе

Для создания нового общедоступного интента на основе любого интента в проекте кликните на соответствующую опцию в модальном окне создания для активации ее.

Выберите группу интентов: «Шаблонные», «Общедоступные» или «Группа по сценарию». После выборе «Группы по сценарию» вам потребуется еще выбрать конкретный сценарий, в котором используется интересующий вас интент.

Теперь выберите интент. Для удобства можете воспользоваться поиском по названию интента прямо в поле выбора

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

Интент, созданный на основе, также после создания добавится в список и развернется для редактирования. Можете изменить/добавить/удалить ключевые/исключающие фразы

Интенты

Тестирование интента. Тестирование блока

При клике на кнопки «Протестировать интент» или «Протестировать блок» в редакторе сценариев, в разделе «Настройки интентов в блоке» или «Список общедоступных или шаблонных интентов» откроется модальное окно тестирования, где можно ввести тестовую фразу при помощи клавиатуры и посмотреть, как отработает блок/интент при обработке подобного ответа абонента.

Протестировать интент

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

Например, при тестировании фразы «угу» для интента «Да», мы получили результат «Попадает под интент», потому что в интент добавлена ключевая фраза «угу» с условием «Полное совпадение»

А для тестовой фразы «нет» при тестировании того же интента результат вышел «Не попадает под интент». Причина в данном случае не отобразилась, потому что фраза не попала под интент из-за отсутствия причин для попадания.

Кроме результата и причины при тестировании интента отображается предобработанный текст: так робот воспринимает ответы абонентов: без учета регистра и знаков препинания.

Протестировать блок

Модальное окно тестирования блока открывается при клике на кнопку «Протестировать блок». Такая кнопка есть в «Свойствах» блока «Обработать ответ» в редакторе сценария и на странице «Настройка интентов в блоке». Здесь при введении тестовой фразы, можно проверить, под какой интент в блоке она попадет и почему.

Для попадания под интент «Остальное», который есть по умолчанию во всех блоках обработки ответа, причины может не быть, потому что фраза попадет в него из-за отстутствия причин для попадания под другие интенты в блоке.

Например, при тестировании фразы «да» для блока, в который добавлены интенты «Да», «Нет» и «не знаю» мы получили результат «интент "Да"», потому что в интент «Да» добавлена ключевая фраза «да» с условием «Полное совпадение»

А при тестировании фразы «Хочу поговорить с оператором» для того же блока получили результат «интент "Остальное"», потому что не нашлось причин для попадания под другие добавленные в блок интенты.

Интенты

Данные для сценариев

HTTP-запросы

Работа с HTTP-запросами

Это руководство поможет вам научиться создавать HTTP-запросы, редактировать их и использовать в сценариях на платформе.

1. Работа с HTTP-запросами

1.1. Просмотр списка запросов

Перейдите в раздел "HTTP-запросы".
На странице отображается список всех существующих запросов:
- Поле поиска позволяет найти запрос по названию.
- Фильтры помогут выбрать запросы, связанные с определёнными сценариями.
Чтобы создать новый запрос, нажмите кнопку "Создать HTTP-запрос".

1.2. Создание HTTP-запроса

После нажатия кнопки "Создать HTTP-запрос" откроется редактор.
В разделе "Основные данные":
- Укажите название запроса.
- Выберите тип запроса (например, GET или POST).
- Вставьте URL-адрес для отправки запроса.
- После заполнения основных данных вопрос можно сохранять, но лучше не делайте этого до получения результатов, совпадающих с настроенными принимаемыми результатами, чтобы избежать ошибок в реальных звонках при использовании запроса в сценариях.
В разделе "Входные параметры":
- На вкладке "Параметры" добавьте ключи и значения параметров.
- На вкладке "Заголовки" укажите заголовки запроса.
- На вкладке "Тело" укажите структуру тела запроса, если это POST-запрос.
- Обратите внимание, что если мы передаем либо в сам ключ, либо в значение название в «{{}}», то этот параметр будет передаваться из самого сценария в виде переменной. И он отобразится в поле «Переменные во входных параметрах»
В разделе "Принимаемые результаты":
- Добавьте параметры, которые сервер возвращает в ответе.
- Укажите вложенные параметры (до 5 уровней вложенности).
- После добавления параметров нажмите "Сохранить запрос". Затем перейдите в раздел "Результаты", чтобы протестировать запрос.

1.3. Работа с разделом "Результаты"

После настройки нажмите кнопку "Получить результаты".
Запрос отправится, и вы увидите статус выполнения (например, 200 OK), а также время обработки запроса.
Сравните возвращённые результаты с указанными принимаемыми параметрами: совпадения подсвечиваются зелёным цветом, а несоответствия красным. Вы можете редактировать или удалять принимаемые параметры в этом разделе, чтобы уточнить настройки.

1.4. Сохранение запроса

Сохраняйте запрос только после того, как убедитесь, что принимаемые результаты совпадают с полученными в разделе "Результаты".
Если результаты не совпадают, скорректируйте принимаемые параметры или настройте запрос повторно, чтобы избежать ошибок в реальных звонках.

2. Использование HTTP-запросов в сценариях

2.1. Добавление блока "Отправить HTTP-запрос"

Перейдите в редактор сценариев.
Щелкните правой кнопкой мыши по рабочему пространству и выберите "Отправить HTTP-запрос".

2.2. Настройка блока

Выберите ранее созданный запрос из выпадающего списка.
Настройте входные параметры:
- Для каждого параметра выберите переменную сценария, которая будет передавать значение.

Настройте принимаемые результаты:

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

№	Действие	Скрин
1	Нажмите ПКМ по полотну и в появившемся списке выберите блок «Отправить HTTP-запрос»
2	В выпадающем списке выбираем наш созданный запрос
3	После выбора запроса в разделе «Входные параметры» как раз-таки появляется параметр, который мы добавляли
4	Присваиваем ему переменную сценария «agent_id» (как создать переменную в сценарии читай тут) Таким образом, мы передаем значение переменной из сценария в значение ключа нашего HTTP-запроса
5	Нажимаем на вкладку «Результаты запроса» и видим, что наш запрос возвращает значение «doctor_call» Теперь также выбираем/создаем переменную из сценария, которой мы присвоим возвращаемое http-запросом значение
6	Сохраняем блок

2.3. Проверка и сохранение

Убедитесь, что все входные параметры и результаты настроены корректно.
Сохраните изменения сценария.

3. Советы и рекомендации

Тестируйте запросы отдельно в редакторе запросов перед сохранением и перед добавлением в сценарий: это поможет избежать ошибок при настройке сценария.
Следите за вложенностью: Максимальная глубина вложенности принимаемых параметров — 5 уровней.
Используйте понятные названия переменных в редакторе сценариев: Это упростит их использование в сценариях.

Примечание

Для дополнительной информации по настройке блоков сценариев ознакомьтесь с разделом "Редактор сценариев" в документации.

Данные для сценариев

SQL-запросы (Запросы к БД)

Работа с SQL-запросами

Данное руководство поможет вам разобраться с настройкой баз данных, созданием SQL-запросов и их использованием в сценариях на платформе.

1. Работа с базами данных

1.1. Просмотр списка баз данных

1.2. Добавление новой базы данных

1.3. Настройка базы данных

2. Работа с SQL-запросами

2.1. Просмотр списка SQL-запросов

2.2. Создание SQL-запроса

2.3. Редактирование SQL-запроса

$image.png$

2.4. Удаление SQL-запроса

3. Использование SQL-запросов в сценариях

3.1. Добавление блока "Выполнить SQL-запрос"

3.2. Настройка блока

№	Действие	Скрин
1	Нажмите ПКМ по рабочему пространству и в появившемся списке выберите блок «Отправить запрос в базу»
2	В правом боковом меню в выпадающем списке выбираем наш созданный запрос
3	После выбора запроса в разделе «Входные параметры» как раз-таки появляется параметр, который мы добавляли (параметр, который будет передан в запрос)
4	Присваиваем ему переменную сценария «phone» (как создать переменную в сценарии читайте на странице «Работа с переменными») Таким образом, мы передаем значение переменной из сценария в наш запрос
5	Нажимаем на вкладку «Результаты запроса» и видим, что наш запрос возвращает столбец «user_id» Теперь также выбираем/создаем переменную из сценария, которой мы присвоим возвращаемое sql-запросом значение
6	Сохраняем блок

3.3. Проверка и сохранение сценария

4. Советы и рекомендации

Примечание

Телефония

SIP-транки: добавление, настройки, статусы. Номера: добавление, настройки. Использование SIP-транков и номеров: в обзвонах, для входящих звонков и для переадресации из сценария

Телефония

SIP-транки

SIP-транк — виртуальная линия связи между платформой и вашим провайдером. Эта линия связи позволяет осуществлять или принимать звонки. То есть, для запуска обзвонов или приема входящих звонков, в общем, для функционирования голосового ассистента, наличие добавленного SIP-транка необходимо.

Хорошо, если настройкой телефонии займется специалист по телефонии, если у вас есть такой специалист, лучше дайте эту инструкцию ему.

Добавление SIP-транка

Чтобы добавить SIP-транк в проект, сперва нужно попасть в раздел «SIP-транки» из меню платформы.

Выше показана страница SIP-транков без добавленных SIP-транков. Нам нужно кликнуть на кнопку , чтобы добавить новый.

При клике на кнопку открывается модальное окно добавления SIP-транка, в нем автоматически задано название по названию проекта, в котором создается транк, его можно изменить, чтобы вы не запутались в добавленных транках, если их станет несколько. Если вы знаете, что вам нужен транспортный протокол TCP или TLS, выберите нужный. Но почти все провайдеры поддерживают UDP.

Далее заполняем пустые поля в разделе Данные вашего SIP-аккаунта. Данные необходимо взять в аккаунте вашего провайдера, в разделе виртуальной АТС, обычно там есть страница или подраздел с SIP-настройками/SIP-аккаунтами/SIP-устройствами/SIP-подключениями, на ней/в нем и содержатся нужные нам данные.

Например, в виртуальной АТС в Новофоне (my.novofon.com) есть страница «Настройки подключения по SIP», выглядит она так:

Логин и пароль нам нужно скопировать в соответствующие поля в нашем модальном окне добавления SIP-транка. А в поле Хост необходимо скопировать адрес Сервера. Порт 5060 подойдет в большинстве случаев, но если вы знаете, что вам необходимо его изменить, сделайте это.

Поле Хост принимает адрес сервера или IP-адрес. На текущий момент при работе с этим полем есть особенность: если в адресе сервера есть дефис, платформа не сможет его обработать и выдаст ошибку 422 при попытке добавления SIP-транка. В таких случаях необходимо использовать IP-адрес.

Простой способ узнать IP-адрес по адресу сервера

Нам подойдет любой сервис для получения IP сайта, например, 2ip.ru. Вводим адрес сервера в поле IP-адрес или домен и нажимаем на . Осталось скопировать IP-адрес в формате 111.111.111.1 и вставить в поле Хост в модальном окне добавления SIP-транка.

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

Теперь, когда все обязательные поля раздела Данные вашего SIP-аккаунта заполнены, можем добавлять транк, кликнув на кнопку в модальном окне добавления SIP-транка.

После клика на кнопку модальное окно закроется, а новый транк появится в списке на странице «SIP-транки». Если этого не произошло и при клике на кнопку «Добавить SIP-транк» всплывает уведомление с ошибкой, проверьте, все ли поля в разделе Данные вашего SIP-аккаунта заполнены, проверьте корректность данных в этих полях.

Статусы SIP-транков

У SIP-транков есть 3 возможных статуса, они отображаются в карточках SIP-транков в колонке «Статусы регистрации»: «Регистрируется», «Зарегистрирован» и «Ошибка»

После добавления SIP-транку присваевается статус «Регистрируется». Процесс регистрации занимает не больше минуты, в это время проверяются введенные вами данными и осуществляется попытка зарегистрировать нашу платформу как устройство в виртуальной АТС вашего провайдера.

Если с данными все в порядке и регистрация прошла успешно, статус изменится на «Зарегистрирован». Транк с таким статусом можно использовать в диалогах.

Если в данных обнаружится ошибка или в процессе регистрации мы столкнемся с какой-то проблемой, у SIP-транка будет статус «Ошибка». Проверьте данные для подключения транка, кликнув на в правой части карточки SIP-транка и измените некорректные данные. После проверки данных нажмите на кнопку возле заголовка «Статус регистрации» для повторной попытки регистрации и обновления статусов. В случае, если транку снова присвоился статус «Ошибка», напишите в техподдержку вашей телефонии или нам.

Настройки SIP-транков

При клике на откроется модальное окно «Настройки SIP-транка». В нем те же поля с данными, как и в модальном окне добавления SIP-транка. Их можно отредактировать при необходимости. Для применения изменений нужно нажать на кнопку , которая станет активной при внесении изменений.

Также в модальном окне SIP-транков есть кнопка , при клике на которую откроется модальное окно подтверждения удаления, а после подтверждения, SIP-транк удалится из списка. На стороне провайдера информация об удалении транка может обработаться не сразу, время обработки зависит от заложенного в их сервисе тайм-аута на проверку.

Телефония

Номера

Добавленные номера потребуются вам при создании обзвонов и для быстрого выбора при переадресации в сценарии. Если вы планируете запускать голосового ассистента для входящих линий, вам достаточно добавления SIP-транка.

Добавление номера

Добавить номер в проект можно только к соответствующему SIP-транку, поэтому, если у вас нет SIP-транка, добавьте сперва его. О том, как это сделать, мы рассказываем в инструкции по SIP-транкам.

Для добавления номера в проект перейдите в раздел SIP-транки и кликните на в карточке соответствующего SIP-транка. Список номеров, которые могут быть использованы соответствующим транком, определяет провайдер, чтобы ознакомиться с ним или отредактировать его, зайдите в аккаунт вашей виртуальной АТС.

При клике на кнопку «Добавить номер» откроется модальное окно добавления номера. В нем есть поле «Название номера», рекомендуем заполнить его, чтобы проще ориентироваться в списке номеров. Хорошие названия для номеров: Оператор, Менеджер call-центра, Главврач, Номер для обзвонов.

В поле номера можете ввести номер телефона в любом формате, желательно скопировать его из аккаунта вашего провайдера. Добавленный номер будет использован в диалогах только в том случае, если он есть в списке привязанных к SIP-транку номеров в аккаунте вашего провайдера.

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

Здесь мы можем сделать номер доступным для обзвонов, поставив галочку на опции Использовать номер для обзвонов и сделать номер доступным для переадресаций, поставив галочку на соответствующей опции. Вы можете выбрать обе опции или не выбирать ни одной. Также вы сможете изменить доступность номера позднее, в настройках номера.

Теперь давайте добавим номер, кликнув на кнопку в модальном окне добавления номера.

Модальное окно закрывается при клике на , и новый номер появляется в карточке SIP-транка в колонке «Привязан к номерам». Информацию о номерах, добавленных к SIP-транку, можно посмотреть, развернув карточку SIP-транка. Для этого кликните на пустое пространство карточки, которую хотите развернуть. При наведении на область разворачивания должна выделиться соответствующая иконка в левой части карточки

В разделе «Информация о номерах» в развернутой карточке SIP-транка есть сам номер, его название и показана возможность/невозможность использования номера в обзвонах и для переадресаций.

Изменить информацию о номере и сам номер можно, кликнув на в строке номера.

Настройка номера

При клике на в строке номера в разделе «Информация о номерах» развернутой карточки SIP-транка, откроется модальное окно «Настройка номера». В нем те же поля и опции, что и в модальном окне «Добавление номера». Здесь вы можете отредактировать любую информацию о номере и сам номер при необходимости, а также удалить номер.

Для применения изменений, нажмите на кнопку , которая станет активной при внесении изменений.

Чтобы удалить номер, нажмите на кнопку . При клике откроется модальное окно подтверждения удаления, при подтверждении модальное окно настройки закроется, а номер удалится из списка привязанных к транку.

Телефония

Использование SIP-транков и номеров в диалогах

Здесь мы рассмотрим ситуации, при которых в платформе будет необходимо выбрать SIP-транк или номер из добавленных в платформу в разделе «SIP-транки» . Инструкция по добавлению размещена на страницах SIP-транки и Номера.

Обзвоны

В 1 шаге создания обзвона в разделе «Обзвоны» вам будет предложено выбрать номер, с которого будет совершен обзвон.

Вы можете выбрать из списка номер для обзвона. В списке будут отображаться номера, в настройках использования которых разрешено использование для обзвонов. Проверить и настроить разрешения на использование можно в разделе «SIP-транки». Воспользуйтесь инструкцией по работе с номерами, если возникнут сложности.

Входящие звонки

В платформе можно использовать сценарии как для исходящих (обзвонов), так и для входящих звонков. Для того, чтобы использовать сценарий для входящих звонков, нужно привязать стартовый блок нужного сценария к SIP-транку в Настройках SIP-транка в разделе «SIP-транки».

Только опубликованные сценарии возможно привязать к SIP-транку и сделать входящими. Подробнее про статусы на странице «Версии и статусы сценариев»

После привязки все абоненты, позвонившие на внешний номер выбранного SIP-транка (можно узнать у вашего провайдера), попадут на голосового ассистента, в тот сценарий, который привязан к этому SIP-транку.

Инструкция по добавлению и настройке SIP-транка на странице «SIP-транки».

Переадресация в сценарии

В редакторе сценариев есть блок «Завершить и переадресовать», который является конечным блоком, то есть, завершает сценарий, а еще может переадресовать звонок на любой номер.

Вы можете выбрать номер для переадресации из списка добавленных в платформу, доступных к использованию для переадресаций, номеров. Разрешения на использование номеров настраиваются в разделе SIP-транков, подробнее об этом на странице «Номера».

Или можете ввести номер для переадресации вручную. Для перехода к вводу вручную нажмите на , появится поле выбора SIP-транка, с помощью которого будет осуществлен переадресованный звонок. После выбора SIP-транка появится поле для ввода номера для переадресации.

Не забудьте после выбора способа переадресации и ввода необходимых данных сохранить изменения в блоке, нажав на кнопку

Телефония

Типовые настройки Asterisk

Это базовая пользовательская документация для настройки Asterisk с использованием chan_sip и pjsip. Пожалуйста, убедитесь, что вы также выполнили другие необходимые шаги для настройки Asterisk в соответствии с вашими требованиями и окружением.

Настройка Asterisk с использованием chan_sip

Создайте файл конфигурации sip.conf (обычно располагается в /etc/asterisk/sip.conf) и добавьте следующие настройки:

[Ваш номер телефона]
type=peer
insecure=port,invite
secret=Ваш_пароль
username=Ваш номер телефона
host=78.29.0.42
fromuser=Ваш номер телефона
registertimeout=30
nat=yes  # или no, в зависимости от наличия NAT
disallow=all
allow=alaw
dtmfmode=rfc2833
fromdomain=interphone.is74.ru
context=incoming
canreinvite=no
register => Ваш номер телефона:Ваш_пароль@interphone.is74.ru/Ваш номер телефона

2. В Dialplan перед выполнением Dial обязательно установите SET (CALLERID(all)=Ваш номер телефона).

3. Разрешите IP-адреса 78.29.0.225, 78.29.0.236, 78.29.0.221 в вашем файерволе.

4. Добавьте следующие правила набора в ваш Dialplan: 8xxxxxxxxxx, [27]xxxxxx, 810x., 4xxxxxxxxxx, 410x., xx, xxx, xxxx.

Настройка Asterisk с использованием pjsip

1. Создайте файл конфигурации pjsip.conf (обычно располагается в /etc/asterisk/pjsip.conf) и добавьте следующие настройки:

[transport-udp]
type = transport
protocol = udp
bind=0.0.0.0:5060

[REG-AUTH-SIP-Ваш номер телефона]
type = auth
username = Ваш номер телефона
password = Ваш_пароль

[REG-SIP-Ваш номер телефона]
type = registration
outbound_auth = REG-AUTH-SIP-Ваш номер телефона
contact_user = Ваш номер телефона
retry_interval = 30
max_retries = 100
forbidden_retry_interval = 300
fatal_retry_interval = 300
expiration = 120
server_uri = sip:78.29.0.42:5060
client_uri = sip:Ваш номер телефона@78.29.0.42:5060

[SIP-Ваш номер телефона-AUTH]
type = auth
username = Ваш номер телефона
password = Ваш_пароль

[SIP-Ваш номер телефона]
type = identify
endpoint = SIP-Ваш номер телефона
match = 78.29.0.42

[SIP-Ваш номер телефона]
type = aor
max_contacts = 1
maximum_expiration = 3600
minimum_expiration = 60
default_expiration = 120
contact = sip:Ваш номер телефона@78.29.0.42:5060
qualify_frequency = 60
qualify_timeout = 3.0

[SIP-Ваш номер телефона]
type = endpoint
100rel = no
context = SIP-Ваш номер телефона-incoming
dtmf_mode = auto
disallow = all
allow = alaw
allow = ulaw
rtp_symmetric = yes
force_rport = yes
rewrite_contact = no
ice_support = no
direct_media = no
from_user = Ваш номер телефона; username
from_domain = interphone.is74.ru
contact_user = Ваш номер телефона; username
language = ru-ru
aors = SIP-Ваш номер телефона
timers = no
outbound_auth = SIP-Ваш номер телефона-AUTH
inband_progress = yes
tone_zone = ru
transport = transport-udp

Администрирование

Пользователи

Для добавления новых пользователей и управления доступами текущих пользователей используйте раздел Администрирование.

Для доступа к разделу Администрирование необходимы иметь роль Администратор проекта.

В разделе есть два под раздела:

Проекты - список доступных проектов
Пользователи - список пользователей в доступных проектах

Добавление новых пользователей

Для добавления новых пользователей в ваши проекты необходимо перейти в раздел Пользователи.

Далее нажать на кнопку "Создать пользователя" и заполнить поля: Имя пользователя, Логин и Пароль.

Затем вам необходимо установить права доступа для создаваемого пользователя. Для этого в разделе Роль пользователя выберите Проект и Роль.

Более подробно про досупы и роли вы можете узнать в разделе "Роли пользователей"

У пользователя может быть несколько ролей. Если у пользователя несколько ролей, то доступ предоставляется ко всем разделам в рамках данной роли. Т.е. если у одной из ролей не будет доступа например, к редактированию сценариев, а у второй роли будет, то пользователь получит доступ к редактированию сценариев.

Редактирование доступов пользователя

После создания пользователя вы всегда можете отредактировать его доступы на странице пользователя. На страницу пользователя можно попасть через раздел Администрирование -> Пользователи -> Нажать на пользователя в списке.

Изменения доступов к проекту. В разделе Доступ к проектам нажать на и добавить или убрать роли у пользователя.
Добавления пользователя в новый проект. В разделе Предоставить доступ выберете проект и роли, которые хотите предоставить пользователю.

Администрирование

Роли пользователей

Роль пользователя в платформе определяет к каким разделам у пользователя будет доступ.

Доступами к проектам может управлять только пользователь с ролью Администратор проекта.

Подробнее об управлении доступами и создании пользователь вы можете в разделе "Пользователи".

Всего в платформе 3 доступные роли. Каждая из них предназначена для выполнения определенных задач в платформе.

Пользователь - создание обзвонов
Разработчик - создание сценариев и настройка телефонии
Администратор проекта - управление доступами в платформе

	Пользователь	Разработчик	Администратор проекта
Сценарии	❌	✅	✅
Обзвоны	✅	✅	✅
Аналитика	✅	✅	✅
Интенты	❌	✅	✅
Данные для сценария	❌	✅	✅
Телефония	Только просмотр	✅	✅
Администрирование	❌	❌	✅

Чат-боты

Инструкция по созданию telegram-бота

🔧 Шаг 1: Создание бота в Telegram через BotFather

Откройте Telegram и найдите официального бота @BotFather (с синей галочкой).
Нажмите «Start» или введите команду /start, чтобы начать диалог.
Отправьте команду /newbot.
Следуйте инструкциям:
- Введите имя бота — это отображаемое имя, которое увидят пользователи.
- Укажите уникальный username, который должен заканчиваться на bot (например, MyCompanySupportBot).
После успешного создания BotFather предоставит вам API-токен — длинную строку символов, например:

123456789:ABCdefGhIJKlmNoPQRstuVWXyz123456789

Скопируйте и сохраните этот токен — он понадобится для интеграции.

⚙️ Шаг 2: Подключение бота к нашей платформе

Перейдите в раздел «Чат-боты»
Нажмите на кнопку «Добавить чат-бота»
Введите название и описание для бота, чтобы вам было легче найти позже вашего бота в списке.
Убедитесь, что выбран тип бота «Телеграм» и нажмите «Далее»
Введите API-токен бота, полученный через @BotFather
Выберите сценарий и стартовый блок, по которому будет проходить ваш бот при инициировании нового общения с ним.
Укажите максимальное время диалога — Когда заданное время истекает, диалог автоматически завершается и попадает в аналитику. Новые сообщения будут обрабатываться в рамках нового диалога. Для пользователя чата эта настройка ни на что не влияет.
Протестируйте подключение — проверьте, возможно ли подключиться к telegram с заданными настройками. А затем добавьте чат-бота, кликнув на соответствующую кнопку.

После этого ваш Telegram-бот будет успешно интегрирован с нашей платформой, и вы сможете использовать его в сценариях взаимодействия с пользователями.

🔒 Важные рекомендации по безопасности

Не передавайте API-токен третьим лицам. Если токен станет известен посторонним, они смогут управлять вашим ботом.
При подозрении на компрометацию токена, немедленно сгенерируйте новый токен через BotFather с помощью команды /token.

Центр знаний

База знаний

1. Назначение раздела

Раздел «База знаний» предназначен для хранения и организации документов, информация из которых используется интеллектуальными модулями платформы «Диалог».

2. Основной интерфейс

Элемент	Описание	Скриншот
Список документов	Перечень загруженных файлов и созданных материалов.
Строка поиска	Фильтрация списка по названию документа.
Создать новый документ	Создание пустого документа внутри платформы.
Загрузить документы	Импорт готовых файлов (PDF, DOCX, TXT и др.) с локального компьютера.

3. Добавление материалов

3.1 Загрузка существующего файла

Нажмите кнопку «Загрузить документы».
Укажите один или несколько файлов.
Дождитесь появления выбранных элементов в списке.

3.2 Создание документа в интерфейсе

Выберите «Создать новый документ».
В списке появится пункт «Новый документ».
Перейдите к документу одним щелчком.
Введите или вставьте текст.
Сохраните изменения кнопкой «Применить изменения».

4. Действия с документом

При наведении курсора на название открывается карточка с функциями:

Действие	Назначение	Скриншот
Переименовать	Изменяет название файла.
Удалить	Удаляет документ из базы знаний.
Открыть в новой вкладке	Открывает документ на отдельной странице.

Щелчок по названию файла также открывает страницу просмотра и редактирования.

5. Страница редактирования

Левая область	Правая область
Текст документа (редактируемый).	«Фрагменты знаний» — логические части текста, используемые системой.

5.1 Сохранение правок

После внесения изменений нажмите «Применить изменения».

5.2 Индивидуальные настройки разбиения

Справа расположен переключатель «Задать кастомные настройки разбивки».

Выключено — используется стандартная схема разбиения.
Включено — появляются поля для настройки:
- Фиксированная разбивка — указывается объём (например, 200 токенов).
- Логическая разбивка — выбор по абзацам, предложениям либо заголовкам.

После настройки нажмите «Применить изменения» для пересборки фрагментов.

5.3 Удаление документа

В боковой панели выберите «Удалить» и подтвердите действие.

6. Часто выполняемые задачи

Задача	Действия
Найти документ	Введите часть названия в строке поиска.
Исправить текст	Откройте документ, внесите правки, нажмите «Применить изменения».
Обновить загруженный файл	Загрузите новый файл с тем же названием; система заменит старую версию.
Настроить мелкие фрагменты	Включите кастомные настройки, выберите «По предложениям».
Удалить документ	Наведите курсор на название, кликните «Удалить».

7. Дополнительные сведения

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

Центр знаний

RAG-конфигурации

RAG-конфигурация определяет, какие документы базы знаний и с какими правилами будут использованы поисковым модулем во время работы сценария.

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

Что настраивается	Для чего применяется
Набор документов	Ограничить поиск нужной тематикой (например, только правила выдачи займов).
Модель векторизации	Выбрать алгоритм, по которому система находит подходящие фрагменты знаний.
Порог уверенности	Отсеять ответы, которые мало подходят по смыслу.
Максимальное число фрагментов	Ограничить объём «справки», передаваемой LLM: система вернёт не больше указанного количества наиболее подходящих кусочков текста. Чем число меньше, тем короче контекст и быстрее ответ; слишком большое значение — больше нагрузки и риск «размытого» ответа.

1. Переход в раздел

Выберите пункт «RAG-конфигурации». В левом боковом меню
На экране появится список всех конфигураций проекта.

2. Обзор списка

Карточка каждой конфигурации показывает:

название;
краткое описание;
число подключённых документов;
дату и время создания;
ссылку «Протестировать».

Дополнительно доступны:

строка поиска по названию;
кнопка «Добавить RAG-конфигурацию» — открывает окно создания новой конфигурации.

3. Создание RAG-конфигурации

Процесс создания состоит из трёх шагов.

Шаг	Действия
1. Название и описание	Укажите понятное название и коротко опишите назначение. При необходимости измените модель для векторизации (некоторые модели лучше работают для тех или иных задач, если не знаете, какую выбрать, оставьте модель по умолчанию). Нажмите «Продолжить».
2. Выбор документов	Отметьте документы, которые следует включить в поиск. При необходимости используйте строку поиска. Нажмите «Продолжить».

Шаг

Действия

1. Название и описание

Укажите понятное название и коротко опишите назначение. При необходимости измените модель для векторизации (некоторые модели лучше работают для тех или иных задач, если не знаете, какую выбрать, оставьте модель по умолчанию). Нажмите «Продолжить».

2. Выбор документов

Отметьте документы, которые следует включить в поиск. При необходимости используйте строку поиска. Нажмите «Продолжить».

После создания необходимо подтвердить индексацию документов - это нужно для того, чтобы LLM могла "считывать смысл" информации из документов. Более техническим языком - всем фрагментам знаний документов присваивается вектор, который в дальнейшем при использовании rag сравнивается с вектором пользовательского запроса. Длительность индексации зависит от объема документов.

4. Страница RAG-конфигурации

Зона интерфейса	Содержимое	Доступные действия
Информация (верх)	название, описание, дата/время создания, количество документов	—
Список документов (центр)	перечень подключённых файлов	«Управлять документами» — открыть окно выбора/снятия галочек
Панель настроек (справа)	Модель для векторизации (выпадающий список) • Порог уверенности (ползунок) • Максимальное число фрагментов (счётчик)	1) Измените параметры → «Применить и переиндексировать». 2) «Изменить название и описание» — откроет модальное окно. 3) «Удалить» — удалит конфигурацию после подтверждения. 4) «Протестировать» — откроет страницу тестирования работы RAG-конфигурации (поиск по подключённым документам).

5. Тестирование конфигурации

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

Введите запрос в строку поиска.
Нажмите «Найти» — система покажет подходящие фрагменты.

Для каждого фрагмента отображаются:

порядковый номер;
уровень уверенности;
название документа (ссылка);
короткая цитата.

Справа можно настроить поля Порог уверенности и Максимальное число фрагментов.

Порог уверенности определяет, насколько точные по смыслу ответы стоит отображать - где 1 = 100% уверенность модели в том, что фрагмент подходит для ответа на запрос

Максимальное число фрагментов позволяет ограничить число фрагментов в выдаче.

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

6. Подключение конфигурации в сценарий

Как подключить базу знаний в блоке «Диалог с LLM»

Откройте свойства блока «Диалог с LLM».
В поле «RAG-конфигурация» выберите нужную конфигурацию из списка добавленных.
При необходимости уточните порог уверенности и максимальное число фрагментов.
Сохраните блок.

После этого модель будет опираться на документы из выбранной конфигурации:

отвечать по их содержанию;
соблюдать правила, которые там описаны.

Что именно делать с этими данными, задаётся в промпте блока:

в «Задаче» коротко опишите требуемое действие;
в «Контексте» при необходимости добавьте подробности.

7. Удаление конфигурации

Откройте нужную конфигурацию.
В правой панели нажмите «Удалить» и подтвердите действие.

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

8. Практические рекомендации

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

Инструкции по разделам

Аналитика

Аналитика. + Работа с таблицей Списка диалогов

Действия с таблицей диалогов

Обзвоны

Загрузка контактов. Таблица с данными для создания обзвона

Настройка графика обзвона

Повторный запуск обзвона

Где запустить повторный обзвон

Шаг 1. Выбор номеров по статусам

Шаг 2. Настройка нового обзвона

Где отобразится созданный повторный обзвон

Очередь и история обзвонов (для пользователей с поканальной тарификацией)

Очередь обзвонов

Правила очереди:

Что делать, если обзвон не завершился вовремя:

История обзвонов

Повторный запуск обзвона

Раздел "Обзвоны" (для пользователей с поминутной тарификацией)

Как попасть в раздел «Обзвоны»

Что отображается в списке обзвонов

Действия со списком обзвонов

Просмотр подробной информации об обзвоне

Повторный обзвон по статусам

Обновление статусов обзвонов

Сценарии

Создание нового сценария

Интенты

Интенты. Общая информация

Из чего состоит Интент

Настройка интентов в блоке

Выбор сценария и блока

Настройка блока

Редактирование интента

Ответы абонентов, попавшие под интент

Список ответов

Обновление с учетом изменений

Сохранение изменений

Общедоступные и шаблонные интенты

Интерфейс страницы

Добавление интента в блок

Создание нового интента

Создание общедоступного интента

Создание с нуля

Создание на основе

Тестирование интента. Тестирование блока

Протестировать интент

Протестировать блок

Рекомендации для улучшения обработки ответов

Поиск новых ключевых фраз и добавление их в интенты

Данные для сценариев

HTTP-запросы

Работа с HTTP-запросами

1. Работа с HTTP-запросами

1.1. Просмотр списка запросов

1.2. Создание HTTP-запроса

1.3. Работа с разделом "Результаты"

1.4. Сохранение запроса

2. Использование HTTP-запросов в сценариях

2.1. Добавление блока "Отправить HTTP-запрос"

2.2. Настройка блока

2.3. Проверка и сохранение

3. Советы и рекомендации

Примечание

SQL-запросы (Запросы к БД)

Работа с SQL-запросами

1. Работа с базами данных

1.1. Просмотр списка баз данных

1.2. Добавление новой базы данных

1.3. Настройка базы данных

2. Работа с SQL-запросами

2.1. Просмотр списка SQL-запросов

2.2. Создание SQL-запроса

2.3. Редактирование SQL-запроса

2.4. Удаление SQL-запроса

3. Использование SQL-запросов в сценариях

3.1. Добавление блока "Выполнить SQL-запрос"

3.2. Настройка блока

3.3. Проверка и сохранение сценария

4. Советы и рекомендации