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

# Аналитика



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

<div class="translate-tooltip-mtz translator-hidden" id="bkmrk-translator"><div class="header">  
</div><div class="translated-text">  
</div></div><span style="font-size: 11pt; font-family: Arial,sans-serif; color: #000000; background-color: transparent; font-weight: 400; font-style: normal; font-variant: normal; text-decoration: none; vertical-align: baseline; white-space: pre-wrap;"><iframe allowfullscreen="allowfullscreen" height="401" src="https://www.youtube.com/embed/iuemkLruizU?feature=youtu" style="width: 715px; height: 401px;" width="715"></iframe>

</span>

В боковом меню платформы есть следующие разделы по аналитике:

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

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

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

[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-09/scaled-1680-/Xn5image.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-09/Xn5image.png)

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

[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-09/scaled-1680-/WJ4image.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-09/WJ4image.png)


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

<div align="left" dir="ltr" id="bkmrk-%E2%84%96-%D0%94%D0%B5%D0%B9%D1%81%D1%82%D0%B2%D0%B8%D0%B5-%D0%A1%D0%BA%D1%80%D0%B8%D0%BD-1-%D0%94" style="margin-left: 0pt;"><table border="1" style="border-collapse: collapse; width: 100%; height: 979.718px; border-width: 1px; background-color: rgb(255, 255, 255); border-color: rgb(219, 219, 248);"><colgroup><col style="width: 5.06799%;" width="34"></col><col style="width: 53.2756%;" width="330"></col><col style="width: 41.6564%;" width="306"></col></colgroup><tbody><tr style="height: 31.9062px;"><td style="vertical-align: top; background-color: rgb(246, 246, 253); padding: 5pt; overflow: hidden; overflow-wrap: break-word; border: 1pt solid rgb(219, 219, 248); height: 31.9062px;">**№**

</td><td style="background-color: rgb(246, 246, 253);">**Действие**

</td><td style="vertical-align: top; background-color: rgb(246, 246, 253); padding: 5pt; overflow: hidden; overflow-wrap: break-word; border: 1pt solid rgb(219, 219, 248); height: 31.9062px;">**<span style="font-size: 11pt; font-family: Arial, sans-serif; color: rgb(0, 0, 0); font-style: normal; font-variant: normal; text-decoration: none; vertical-align: baseline; white-space: pre-wrap;">Скрин</span>**

</td></tr><tr style="height: 289.703px;"><td style="vertical-align: top; padding: 5pt; overflow: hidden; overflow-wrap: break-word; border: 1pt solid rgb(219, 219, 248); height: 289.703px;">1

</td><td>Добавление/удаление столбца:

1. Нажимаем на плюсик справа от заголовков таблицы
2. Чтобы добавить/удалить столбец – нажимаем на нужный параметр
3. Ждем загрузки столбца/таблицы

</td><td style="vertical-align: top; padding: 5pt; overflow: hidden; overflow-wrap: break-word; border: 1pt solid rgb(219, 219, 248); height: 289.703px;">[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-09/scaled-1680-/iOximage.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-09/iOximage.png)

</td></tr><tr style="height: 289.703px;"><td style="vertical-align: top; padding: 5pt; overflow: hidden; overflow-wrap: break-word; border: 1pt solid rgb(219, 219, 248); height: 289.703px;">1.1

</td><td>Описание параметров:

- Базовые параметры – параметры по умолчанию, относящиеся к любому диалогу (длительность, результат и тд)
- Переменные – переменные из сценария, в которые добавляли какую-либо информацию по мере прохождения диалога (н-р, фио абонента)
- Ответы абонентов – что отвечали абоненты на различные вопросы робота (блоки интентов). Н-р, “Да-да, я приду”
- Присвоенные ответ – вариант ответа интента, который был присвоен ответу абонента. Если абонент ответил “Да-да, я приду” (см. выше), то присвоенные ответ будет – “Да”

  
</td><td style="vertical-align: top; padding: 5pt; overflow: hidden; overflow-wrap: break-word; border: 1pt solid rgb(219, 219, 248); height: 289.703px;">[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-09/scaled-1680-/TZKimage.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-09/TZKimage.png)

</td></tr><tr style="height: 127.703px;"><td style="vertical-align: top; padding: 5pt; overflow: hidden; overflow-wrap: break-word; border: 1pt solid rgb(219, 219, 248); height: 127.703px;">2

</td><td>Чтобы прослушать/прочитать конкретный диалог, добавьте столбец “Расшифровка диалога” (если он еще не добавлен) и нажмите на кнопку “Открыть диалог”

</td><td style="vertical-align: top; padding: 5pt; overflow: hidden; overflow-wrap: break-word; border: 1pt solid rgb(219, 219, 248); height: 127.703px;">[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-09/scaled-1680-/qB1image.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-09/qB1image.png)

</td></tr><tr style="height: 240.703px;"><td style="vertical-align: top; padding: 5pt; overflow: hidden; overflow-wrap: break-word; border: 1pt solid rgb(219, 219, 248); height: 240.703px;">3

</td><td>Применение фильтров к столбцам / Сортировка

  
1. Нажмите на шестеренку возле столбца, по которому хотите отсортировать или отфильтровать
2. Выберите соответствующий пункт в выпавшем меню

</td><td style="vertical-align: top; padding: 5pt; overflow: hidden; overflow-wrap: break-word; border: 1pt solid rgb(219, 219, 248); height: 240.703px;">[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-09/scaled-1680-/Nlsimage.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-09/Nlsimage.png)

</td></tr></tbody></table>

</div>

# Обзвоны



# Создание обзвонов (скрыто)

<iframe allowfullscreen="allowfullscreen" height="477" src="https://www.youtube.com/embed/5WFpJXUPYTU?feature=youtu" style="width: 851px; height: 477px;" width="851"></iframe>

<span style="font-size: 11pt; font-family: Arial,sans-serif; color: #000000; background-color: transparent; font-weight: 400; font-style: normal; font-variant: normal; text-decoration: none; vertical-align: baseline; white-space: pre-wrap;">1. Нажмите кнопку «Создать обзвон»</span>

<span style="font-size: 11pt; font-family: Arial,sans-serif; color: #000000; background-color: transparent; font-weight: 400; font-style: normal; font-variant: normal; text-decoration: none; vertical-align: baseline; white-space: pre-wrap;">Появилось диалоговое окно</span>

<span style="font-size: 11pt; font-family: Arial,sans-serif; color: #000000; background-color: transparent; font-weight: 400; font-style: normal; font-variant: normal; text-decoration: none; vertical-align: baseline; white-space: pre-wrap;"> </span>

<span style="font-size: 11pt; font-family: Arial,sans-serif; color: #000000; background-color: transparent; font-weight: 400; font-style: normal; font-variant: normal; text-decoration: none; vertical-align: baseline; white-space: pre-wrap;">2. Установите курсор и нажмите ЛКМ в поле «Номер для обзвона»</span>

<span style="font-size: 11pt; font-family: Arial,sans-serif; color: #000000; background-color: transparent; font-weight: 400; font-style: normal; font-variant: normal; text-decoration: none; vertical-align: baseline; white-space: pre-wrap;">Раскрылся список номеров</span>

<span style="font-size: 11pt; font-family: Arial,sans-serif; color: #000000; background-color: transparent; font-weight: 400; font-style: normal; font-variant: normal; text-decoration: none; vertical-align: baseline; white-space: pre-wrap;">3. Выберите номер (ЛКМ по элементу списка)</span>

<span style="font-size: 11pt; font-family: Arial,sans-serif; color: #000000; background-color: transparent; font-weight: 400; font-style: normal; font-variant: normal; text-decoration: none; vertical-align: baseline; white-space: pre-wrap;">Список свернулся</span>

<span style="font-size: 11pt; font-family: Arial,sans-serif; color: #000000; background-color: transparent; font-weight: 400; font-style: normal; font-variant: normal; text-decoration: none; vertical-align: baseline; white-space: pre-wrap;">Выбранный элемент отображается в поле</span>

<span style="font-size: 11pt; font-family: Arial,sans-serif; color: #000000; background-color: transparent; font-weight: 400; font-style: normal; font-variant: normal; text-decoration: none; vertical-align: baseline; white-space: pre-wrap;">4. Установите курсор и нажмите ЛКМ в поле «Сценарий»</span>

<span style="font-size: 11pt; font-family: Arial,sans-serif; color: #000000; background-color: transparent; font-weight: 400; font-style: normal; font-variant: normal; text-decoration: none; vertical-align: baseline; white-space: pre-wrap;">Раскрылся список для выбора Сценарий/Стартовый блок</span>

<span style="font-size: 11pt; font-family: Arial,sans-serif; color: #000000; background-color: transparent; font-weight: 400; font-style: normal; font-variant: normal; text-decoration: none; vertical-align: baseline; white-space: pre-wrap;">5. Выберите Сценарий/Стартовый блок (ЛКМ по элементу списка)</span>

<span style="font-size: 11pt; font-family: Arial,sans-serif; color: #000000; background-color: transparent; font-weight: 400; font-style: normal; font-variant: normal; text-decoration: none; vertical-align: baseline; white-space: pre-wrap;">Список свернулся</span>

<span style="font-size: 11pt; font-family: Arial,sans-serif; color: #000000; background-color: transparent; font-weight: 400; font-style: normal; font-variant: normal; text-decoration: none; vertical-align: baseline; white-space: pre-wrap;">Выбранный элемент отображается в поле</span>

<span style="font-size: 11pt; font-family: Arial,sans-serif; color: #000000; background-color: transparent; font-weight: 400; font-style: normal; font-variant: normal; text-decoration: none; vertical-align: baseline; white-space: pre-wrap;">6. Нажмите кнопку «Продолжить»</span>

<span style="font-size: 11pt; font-family: Arial,sans-serif; color: #000000; background-color: transparent; font-weight: 400; font-style: normal; font-variant: normal; text-decoration: none; vertical-align: baseline; white-space: pre-wrap;">Диалоговое окно изменилось</span>

<span style="font-size: 11pt; font-family: Arial,sans-serif; color: #000000; background-color: transparent; font-weight: 400; font-style: normal; font-variant: normal; text-decoration: none; vertical-align: baseline; white-space: pre-wrap;"><span style="border: none; display: inline-block; overflow: hidden; width: 602px; height: 365px;">![](https://lh6.googleusercontent.com/AH5FuwyUE_RSEN3qp-mV5aMe8ANaRHXHF2CNox-1LlyJygNx6Xau1yhbGfHiyh7A-k5mM0V4J23_0KW_yoCM-J8kx5usvrCsyPHjcrx79VCGqxpSmWD0dld0_fLWhajc6Uq6NFFz4NkRi9WG_aB0U6Y)</span></span>

<span style="font-size: 11pt; font-family: Arial,sans-serif; color: #000000; background-color: transparent; font-weight: 400; font-style: normal; font-variant: normal; text-decoration: none; vertical-align: baseline; white-space: pre-wrap;">7. Установите курсор и нажмите ЛКМ в поле загрузки.</span>

<span style="font-size: 11pt; font-family: Arial,sans-serif; color: #000000; background-color: transparent; font-weight: 400; font-style: normal; font-variant: normal; text-decoration: none; vertical-align: baseline; white-space: pre-wrap;">Открылось системное окно для выбора файла</span>

<span style="font-size: 11pt; font-family: Arial,sans-serif; color: #000000; background-color: transparent; font-weight: 400; font-style: normal; font-variant: normal; text-decoration: none; vertical-align: baseline; white-space: pre-wrap;">8. Выберите файл для загрузки.</span>

<span style="font-size: 11pt; font-family: Arial,sans-serif; color: #000000; background-color: transparent; font-weight: 400; font-style: normal; font-variant: normal; text-decoration: none; vertical-align: baseline; white-space: pre-wrap;">8.1 Наименования полей в файле соответствуют параметрам начального блока сценария</span>

<span style="font-size: 11pt; font-family: Arial,sans-serif; color: #000000; background-color: transparent; font-weight: 400; font-style: normal; font-variant: normal; text-decoration: none; vertical-align: baseline; white-space: pre-wrap;">Диалоговое окно изменилось. Параметры подставились автоматически.</span>

<span style="font-size: 11pt; font-family: Arial,sans-serif; color: #000000; background-color: transparent; font-weight: 400; font-style: normal; font-variant: normal; text-decoration: none; vertical-align: baseline; white-space: pre-wrap;"><span style="border: none; display: inline-block; overflow: hidden; width: 602px; height: 337px;">![](https://lh6.googleusercontent.com/Yv467AcEJp3PXyD9H4ql0Ckw5P9g3qmvagGQSHIyr3oNpCFT-WMPYexliciZH4WcVVVWoFAJ3nQluUnF6APW-tqyRnmjvykAXMrDOIAdj1oDlw7WxrXZuxL7fIl0MV-9dboGrLY3uKuRXS6vHDU2xD0)</span></span>

<span style="font-size: 11pt; font-family: Arial,sans-serif; color: #000000; background-color: transparent; font-weight: 400; font-style: normal; font-variant: normal; text-decoration: none; vertical-align: baseline; white-space: pre-wrap;">8.1.1 Нажмите кнопку «Продолжить»</span>

<span style="font-size: 11pt; font-family: Arial,sans-serif; color: #000000; background-color: transparent; font-weight: 400; font-style: normal; font-variant: normal; text-decoration: none; vertical-align: baseline; white-space: pre-wrap;">Переход к пункту 9</span>

<span style="font-size: 11pt; font-family: Arial,sans-serif; color: #000000; background-color: transparent; font-weight: 400; font-style: normal; font-variant: normal; text-decoration: none; vertical-align: baseline; white-space: pre-wrap;">8.2 Наименования полей в файле не соответствуют параметрам начального блока сценария (либо не все соответсвуют)</span>

<span style="font-size: 11pt; font-family: Arial,sans-serif; color: #000000; background-color: transparent; font-weight: 400; font-style: normal; font-variant: normal; text-decoration: none; vertical-align: baseline; white-space: pre-wrap;">Диалоговое окно изменилось. Соответствующие параметры подставились автоматически.</span>

<span style="font-size: 11pt; font-family: Arial,sans-serif; color: #000000; background-color: transparent; font-weight: 400; font-style: normal; font-variant: normal; text-decoration: none; vertical-align: baseline; white-space: pre-wrap;"><span style="border: none; display: inline-block; overflow: hidden; width: 602px; height: 351px;">![](https://lh4.googleusercontent.com/Dd-ZG-ojWVYcfgSxMJ8lhz8zB7C3-07iYdJkLfJFHsH8_MqPe0tyko_XCajunuxo609Q6QxbBvHSnOblFtDRghdrYUmIlUHBhDXVy1zP5X8_OKWGo_cExvMtaUpYdMv2W5WWDMvz9de0CWJ3qb4Xr_8)</span></span>

<span style="font-size: 11pt; font-family: Arial,sans-serif; color: #000000; background-color: transparent; font-weight: 400; font-style: normal; font-variant: normal; text-decoration: none; vertical-align: baseline; white-space: pre-wrap;">8.2.1 ЛКМ по полю выбора параметрам</span>

<span style="font-size: 11pt; font-family: Arial,sans-serif; color: #000000; background-color: transparent; font-weight: 400; font-style: normal; font-variant: normal; text-decoration: none; vertical-align: baseline; white-space: pre-wrap;">Раскрылся список с именами полей содержащихся в файле</span>

<span style="font-size: 11pt; font-family: Arial,sans-serif; color: #000000; background-color: transparent; font-weight: 400; font-style: normal; font-variant: normal; text-decoration: none; vertical-align: baseline; white-space: pre-wrap;">8.2.2 ЛКМ по элементу списка</span>

<span style="font-size: 11pt; font-family: Arial,sans-serif; color: #000000; background-color: transparent; font-weight: 400; font-style: normal; font-variant: normal; text-decoration: none; vertical-align: baseline; white-space: pre-wrap;">Список закрылся. Выбранный элемент отображается в поле.</span>

<span style="font-size: 11pt; font-family: Arial,sans-serif; color: #000000; background-color: transparent; font-weight: 400; font-style: normal; font-variant: normal; text-decoration: none; vertical-align: baseline; white-space: pre-wrap;">8.2.3 Нажмите на кнопку «Продолжить»</span>

<span style="font-size: 11pt; font-family: Arial,sans-serif; color: #000000; background-color: transparent; font-weight: 400; font-style: normal; font-variant: normal; text-decoration: none; vertical-align: baseline; white-space: pre-wrap;">Переход к пункту 8.1</span>

<span style="font-size: 11pt; font-family: Arial,sans-serif; color: #000000; background-color: transparent; font-weight: 400; font-style: normal; font-variant: normal; text-decoration: none; vertical-align: baseline; white-space: pre-wrap;">8.3 Файл содержит некорректные данные или пустые ячейки</span>

<span style="font-size: 11pt; font-family: Arial,sans-serif; color: #000000; background-color: transparent; font-weight: 400; font-style: normal; font-variant: normal; text-decoration: none; vertical-align: baseline; white-space: pre-wrap;">Диалоговое окно изменилось.</span>

<span style="font-size: 11pt; font-family: Arial,sans-serif; color: #000000; background-color: transparent; font-weight: 400; font-style: normal; font-variant: normal; text-decoration: none; vertical-align: baseline; white-space: pre-wrap;"><span style="border: none; display: inline-block; overflow: hidden; width: 602px; height: 381px;">![](https://lh5.googleusercontent.com/MtbbfR9vFXkIfZbWiPQ4J4bwKMI_98D4TTtESqaaJg4EnKCc7X_xEV5ZtVNEgdoTTVT196CnIEAz9iQvj93MKq3JE-IHUodJB8CsuC4eqR8N1762bPDAtjl33Z2OuSfIjfrTG6XtXlwMyZ3938hURgQ)</span></span>

<span style="font-size: 11pt; font-family: Arial,sans-serif; color: #000000; background-color: transparent; font-weight: 400; font-style: normal; font-variant: normal; text-decoration: none; vertical-align: baseline; white-space: pre-wrap;">8.3.1 Снимите галочку «Только ошибки»</span>

<span style="font-size: 11pt; font-family: Arial,sans-serif; color: #000000; background-color: transparent; font-weight: 400; font-style: normal; font-variant: normal; text-decoration: none; vertical-align: baseline; white-space: pre-wrap;">Таблица изменилась. Отображаются все строки таблицы.</span>

<span style="font-size: 11pt; font-family: Arial,sans-serif; color: #000000; background-color: transparent; font-weight: 400; font-style: normal; font-variant: normal; text-decoration: none; vertical-align: baseline; white-space: pre-wrap;">8.3.2 Нажмите кнопку «Скачать ошибки»</span>

<span style="font-size: 11pt; font-family: Arial,sans-serif; color: #000000; background-color: transparent; font-weight: 400; font-style: normal; font-variant: normal; text-decoration: none; vertical-align: baseline; white-space: pre-wrap;">Загрузился файл \*.xlsx содержащий строки с пустыми ячейками либо данными некорректного формата.</span>

<span style="font-size: 11pt; font-family: Arial,sans-serif; color: #000000; background-color: transparent; font-weight: 400; font-style: normal; font-variant: normal; text-decoration: none; vertical-align: baseline; white-space: pre-wrap;">8.3.3 Нажмите кнопку «Продолжить»</span>

<span style="font-size: 11pt; font-family: Arial,sans-serif; color: #000000; background-color: transparent; font-weight: 400; font-style: normal; font-variant: normal; text-decoration: none; vertical-align: baseline; white-space: pre-wrap;">Появилось диалоговое окно</span>

<span style="font-size: 11pt; font-family: Arial,sans-serif; color: #000000; background-color: transparent; font-weight: 400; font-style: normal; font-variant: normal; text-decoration: none; vertical-align: baseline; white-space: pre-wrap;"><span style="border: none; display: inline-block; overflow: hidden; width: 572px; height: 245px;">![](https://lh3.googleusercontent.com/8JOCjSrCZ9SjtbtDN-RaTjJob0WQqExuTNUswtRrr4dk7lk6-GLVQm_DYvvUNNSeAf2JZqZDrZraOYp-200AzjvO0RuXe25Xp8Yj_17xjmh9GJVZmb7YPt0D-1JYhu_Bri7h0VSSs01_zN6OOckiMRk)</span></span>

<span style="font-size: 11pt; font-family: Arial,sans-serif; color: #000000; background-color: transparent; font-weight: 400; font-style: normal; font-variant: normal; text-decoration: none; vertical-align: baseline; white-space: pre-wrap;">8.3.4.1 Нажмите кнопку «Отменить»</span>

<span style="font-size: 11pt; font-family: Arial,sans-serif; color: #000000; background-color: transparent; font-weight: 400; font-style: normal; font-variant: normal; text-decoration: none; vertical-align: baseline; white-space: pre-wrap;">Переход к пункту 8.3</span>

<span style="font-size: 11pt; font-family: Arial,sans-serif; color: #000000; background-color: transparent; font-weight: 400; font-style: normal; font-variant: normal; text-decoration: none; vertical-align: baseline; white-space: pre-wrap;">8.3.4.2 Нажмите кнопку «Продолжить»</span>

<span style="font-size: 11pt; font-family: Arial,sans-serif; color: #000000; background-color: transparent; font-weight: 400; font-style: normal; font-variant: normal; text-decoration: none; vertical-align: baseline; white-space: pre-wrap;">Переход к пункту 9</span>

<span style="font-size: 11pt; font-family: Arial,sans-serif; color: #000000; background-color: transparent; font-weight: 400; font-style: normal; font-variant: normal; text-decoration: none; vertical-align: baseline; white-space: pre-wrap;">9 Диалоговое окно изменилось</span>

<span style="font-size: 11pt; font-family: Arial,sans-serif; color: #000000; background-color: transparent; font-weight: 400; font-style: normal; font-variant: normal; text-decoration: none; vertical-align: baseline; white-space: pre-wrap;"><span style="border: none; display: inline-block; overflow: hidden; width: 602px; height: 288px;">![](https://lh4.googleusercontent.com/GnFfhFSJQjbCjwDmBUn09w5TsT5tvp_s-XYfwbM9BRNr-v2TuNFeVnoEWCtj0iV-17FRkLOyQ7ezlAPxrGU9Zwm9njqdkzAhskmSut8jDRj16JqpQNSn2BVLR82q5M9aoXNekMo3e0_IrKcc1dr2D84)</span></span>

<span style="font-size: 11pt; font-family: Arial,sans-serif; color: #000000; background-color: transparent; font-weight: 400; font-style: normal; font-variant: normal; text-decoration: none; vertical-align: baseline; white-space: pre-wrap;">10. ЛКМ в поле «Дата озвона»</span>

<span style="font-size: 11pt; font-family: Arial,sans-serif; color: #000000; background-color: transparent; font-weight: 400; font-style: normal; font-variant: normal; text-decoration: none; vertical-align: baseline; white-space: pre-wrap;">Появился календарь</span>

<span style="font-size: 11pt; font-family: Arial,sans-serif; color: #000000; background-color: transparent; font-weight: 400; font-style: normal; font-variant: normal; text-decoration: none; vertical-align: baseline; white-space: pre-wrap;"><span style="border: none; display: inline-block; overflow: hidden; width: 374px; height: 497px;">![](https://lh3.googleusercontent.com/eUrW9H_3Ptx1lWWSUYMLr_r7miwK525GlUhq9VfXTPwoHeKfNp6v4KJ4SHbjG08JxsSq_GuqEjJr14NnAz7R94wmCFQHNOYk7udE7tqRN1OkuCOdw7vZtgizYPld62txeMmmNJb8jhyrgJqwWyKtrLo)</span></span>

<span style="font-size: 11pt; font-family: Arial,sans-serif; color: #000000; background-color: transparent; font-weight: 400; font-style: normal; font-variant: normal; text-decoration: none; vertical-align: baseline; white-space: pre-wrap;">11. Выберите дату</span>

<span style="font-size: 11pt; font-family: Arial,sans-serif; color: #000000; background-color: transparent; font-weight: 400; font-style: normal; font-variant: normal; text-decoration: none; vertical-align: baseline; white-space: pre-wrap;">Календарь исчез. Выбранная дата отображается в поле.</span>

<span style="font-size: 11pt; font-family: Arial,sans-serif; color: #000000; background-color: transparent; font-weight: 400; font-style: normal; font-variant: normal; text-decoration: none; vertical-align: baseline; white-space: pre-wrap;">12. ЛКМ в поле «Начать обзвон с»</span>

<span style="font-size: 11pt; font-family: Arial,sans-serif; color: #000000; background-color: transparent; font-weight: 400; font-style: normal; font-variant: normal; text-decoration: none; vertical-align: baseline; white-space: pre-wrap;">Появился список</span>

<span style="font-size: 11pt; font-family: Arial,sans-serif; color: #000000; background-color: transparent; font-weight: 400; font-style: normal; font-variant: normal; text-decoration: none; vertical-align: baseline; white-space: pre-wrap;"><span style="border: none; display: inline-block; overflow: hidden; width: 169px; height: 188px;">![](https://lh6.googleusercontent.com/9eXmXj6WvLykvQ0KyQ6o2tnbitki9HjKIByPP-ey3fiysoaH5gNwD6V6D3-l6jZWXTQIH8Bj69nNBVzoGA8jsBvmqbaHpypBWOyqlU4uyE0UuIQL4iRWxQI0dkc9qur_Z_2VNpLIjhPQnzG3xVOdlUU)</span></span>

<span style="font-size: 11pt; font-family: Arial,sans-serif; color: #000000; background-color: transparent; font-weight: 400; font-style: normal; font-variant: normal; text-decoration: none; vertical-align: baseline; white-space: pre-wrap;">13. Выберите «Другое время»</span>

<span style="font-size: 11pt; font-family: Arial,sans-serif; color: #000000; background-color: transparent; font-weight: 400; font-style: normal; font-variant: normal; text-decoration: none; vertical-align: baseline; white-space: pre-wrap;">Время начала редактируется.</span>

<span style="font-size: 11pt; font-family: Arial,sans-serif; color: #000000; background-color: transparent; font-weight: 400; font-style: normal; font-variant: normal; text-decoration: none; vertical-align: baseline; white-space: pre-wrap;"><span style="border: none; display: inline-block; overflow: hidden; width: 173px; height: 61px;">![](https://lh4.googleusercontent.com/fbwBqXDE90wa6qrSxF4WbEAasurnsu87F_zRurOFOtePohSUsw7NVRLAik1KDJ46dC8wB8uIJywUOa3DVpkxjXDh7xEiKCAOXwjHWh5m1eoQRm4FlLJSokQG8zCDIgT25k4zgYFKktAhbbGRjhjTBgg)</span></span>

<span style="font-size: 11pt; font-family: Arial,sans-serif; color: #000000; background-color: transparent; font-weight: 400; font-style: normal; font-variant: normal; text-decoration: none; vertical-align: baseline; white-space: pre-wrap;">14. Введите время окончания обзвона в поле «Закончить обзвон в»</span>

<span style="font-size: 11pt; font-family: Arial,sans-serif; color: #000000; background-color: transparent; font-weight: 400; font-style: normal; font-variant: normal; text-decoration: none; vertical-align: baseline; white-space: pre-wrap;">Введенное время отображается в поле</span>

<span style="font-size: 11pt; font-family: Arial,sans-serif; color: #000000; background-color: transparent; font-weight: 400; font-style: normal; font-variant: normal; text-decoration: none; vertical-align: baseline; white-space: pre-wrap;">15. ЛКМ в поле «Количество попыток дозвониться»</span>

<span style="font-size: 11pt; font-family: Arial,sans-serif; color: #000000; background-color: transparent; font-weight: 400; font-style: normal; font-variant: normal; text-decoration: none; vertical-align: baseline; white-space: pre-wrap;">Раскрылся список с числами от 1 до 5</span>

<span style="font-size: 11pt; font-family: Arial,sans-serif; color: #000000; background-color: transparent; font-weight: 400; font-style: normal; font-variant: normal; text-decoration: none; vertical-align: baseline; white-space: pre-wrap;">16 Выберите элемент из списка</span>

<span style="font-size: 11pt; font-family: Arial,sans-serif; color: #000000; background-color: transparent; font-weight: 400; font-style: normal; font-variant: normal; text-decoration: none; vertical-align: baseline; white-space: pre-wrap;">Список закрылся. Выбранный элемент отображается в полезные</span>

<span style="font-size: 11pt; font-family: Arial,sans-serif; color: #000000; background-color: transparent; font-weight: 400; font-style: normal; font-variant: normal; text-decoration: none; vertical-align: baseline; white-space: pre-wrap;">17 ЛКМ в поле интервал между попытками</span>

<span style="font-size: 11pt; font-family: Arial,sans-serif; color: #000000; background-color: transparent; font-weight: 400; font-style: normal; font-variant: normal; text-decoration: none; vertical-align: baseline; white-space: pre-wrap;">Курсор встал в поле</span>

<span style="font-size: 11pt; font-family: Arial,sans-serif; color: #000000; background-color: transparent; font-weight: 400; font-style: normal; font-variant: normal; text-decoration: none; vertical-align: baseline; white-space: pre-wrap;">18 Введите значение</span>

<span style="font-size: 11pt; font-family: Arial,sans-serif; color: #000000; background-color: transparent; font-weight: 400; font-style: normal; font-variant: normal; text-decoration: none; vertical-align: baseline; white-space: pre-wrap;">Введенное значение отображается в поле с единицей измерения «мин»</span>

<span style="font-size: 11pt; font-family: Arial,sans-serif; color: #000000; background-color: transparent; font-weight: 400; font-style: normal; font-variant: normal; text-decoration: none; vertical-align: baseline; white-space: pre-wrap;">19 Нажмите кнопку «Создать»</span>

<span style="font-size: 11pt; font-family: Arial,sans-serif; color: #000000; background-color: transparent; font-weight: 400; font-style: normal; font-variant: normal; text-decoration: none; vertical-align: baseline; white-space: pre-wrap;">Появилось диалоговое окно</span>

<span style="font-size: 11pt; font-family: Arial,sans-serif; color: #000000; background-color: transparent; font-weight: 400; font-style: normal; font-variant: normal; text-decoration: none; vertical-align: baseline; white-space: pre-wrap;"><span style="border: none; display: inline-block; overflow: hidden; width: 570px; height: 285px;">![](https://lh6.googleusercontent.com/EkwY-jkXW7sWgk4Wcgv6j6VW7Uk8nUsQt3FQXmBGtrM7RY3cXVnWtoKHfq68WV-4-F4oOMDC5Z_o6fW3nqA5G6S823Ke1fPLFy-hXvEjfaVxCsVOM_CNmpv8PZnyOMr28y7aNUjwXNGVP95kcR847pw)</span></span>

<span style="font-size: 11pt; font-family: Arial,sans-serif; color: #000000; background-color: transparent; font-weight: 400; font-style: normal; font-variant: normal; text-decoration: none; vertical-align: baseline; white-space: pre-wrap;">20 Измените название обзвона</span>

<span style="font-size: 11pt; font-family: Arial,sans-serif; color: #000000; background-color: transparent; font-weight: 400; font-style: normal; font-variant: normal; text-decoration: none; vertical-align: baseline; white-space: pre-wrap;">Введенное название отображается в поле.</span>

<span style="font-size: 11pt; font-family: Arial,sans-serif; color: #000000; background-color: transparent; font-weight: 400; font-style: normal; font-variant: normal; text-decoration: none; vertical-align: baseline; white-space: pre-wrap;">Диалоговое окно закрылось. Обзвон появился в списке.</span>

<div class="translate-tooltip-mtz translator-hidden" id="bkmrk-transl"><div class="header"><div class="header-controls">Transl</div></div><div class="translated-text">  
</div></div>

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

**Запустите Excel**, если у вас не установлена эта программа или ее аналог, можете воспользоваться сервисом[ Google Таблицы](https://docs.google.com/spreadsheets) или [Яндекс документы. Таблицы](https://docs.yandex.ru/docs?type=xlsx).

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

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

[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/scaled-1680-/vOpimage.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/vOpimage.png)

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

[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/scaled-1680-/DM7image.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/DM7image.png)

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

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

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

[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/scaled-1680-/dhOimage.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/dhOimage.png)

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

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

[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/scaled-1680-/xTgimage.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/xTgimage.png)

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

[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/scaled-1680-/81Iimage.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/81Iimage.png)

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

[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/scaled-1680-/tehimage.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/tehimage.png)

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

[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/scaled-1680-/b41image.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/b41image.png)

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

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

[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/scaled-1680-/Jjaimage.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/Jjaimage.png)

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

[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/scaled-1680-/DeFimage.png)\\](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/DeFimage.png)

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

[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/scaled-1680-/Sdiimage.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/Sdiimage.png)

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

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

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

После [загрузки контактов и проверки таблицы](https://docs.ai-assistant.is74.ru/books/instrukcii-po-razdelam/page/zagruzka-kontaktov-tablica-s-dannymi-dlia-sozdaniia-obzvona) переходим к четвертому, финальному шагу **«График»** в создании обзвона. По умолчанию все поля предзаполнены для совершения обзвона **в ближайшее время** с двумя попытками дозвониться с интервалом в 2 минуты. Если вас устраивают такие параметры, нажимаем на кнопку **«Создать»**. Поздравляю, обзвон создан!

[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/scaled-1680-/SLTimage.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/SLTimage.png)

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

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

[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/scaled-1680-/jVNimage.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/jVNimage.png)

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

[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/scaled-1680-/1sFimage.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/1sFimage.png)

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

[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/scaled-1680-/TQKimage.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/TQKimage.png)

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

[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/scaled-1680-/FmSimage.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/FmSimage.png)

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

[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/scaled-1680-/NsEimage.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/NsEimage.png)

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

# Сценарии



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

<div class="translate-tooltip-mtz translator-hidden" id="bkmrk-translator-2"></div>По умолчанию, когда вы заходите на платформу, должна быть открыта вкладка «Сценарии». Если нет, перейдите в раздел «Сценарии» в боковом меню.

[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-09/scaled-1680-/ubhimage.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-09/ubhimage.png)

Нажмите на кнопку ![create](https://i.ibb.co/R0SWRmZ/image.png) Она находится в правом верхнем углу. Далее выберите «Создать новый».

[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-09/scaled-1680-/0LCimage.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-09/0LCimage.png)

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

- **Название сценария** — любое. Желательно, чтобы оно соответствовало вашей[ цели](https://docs.ai-assistant.is74.ru/books/3-saga-dlia-zapuska-golosovogo-assistenta/page/1-sag-sozdanie-scenariia#bkmrk-%D0%9E%D0%BF%D1%80%D0%B5%D0%B4%D0%B5%D0%BB%D0%B5%D0%BD%D0%B8%D0%B5-%D1%86%D0%B5%D0%BB%D0%B5%D0%B9)
- **Описание сценария** — необязательно
- **Тип сценария** — выберите в зависимости от задачи (если создаете голосового ассистента - то «Звонок», если чат-бота, то «Чат»)
- Поле **«Создать на основе»** можете не заполнять. Оно нужна для того, чтобы не создавать сценарий с нуля, а использовать существующий сценарий в проекте.[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-09/scaled-1680-/WN4image.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-09/WN4image.png)

<span style="font-size: 11pt; font-family: Arial,sans-serif; color: #000000; background-color: transparent; font-weight: 400; font-style: normal; font-variant: normal; text-decoration: none; vertical-align: baseline; white-space: pre-wrap;">Нажмите кнопку **«Создать сценарий»**. </span><span style="font-size: 11pt; font-family: Arial,sans-serif; color: #000000; background-color: transparent; font-weight: 400; font-style: normal; font-variant: normal; text-decoration: none; vertical-align: baseline; white-space: pre-wrap;">Затем модальное окно создания сценария закроется, и ваш сценарий окажется в верхней части списка всех сценариев. Найдите его и нажмите на него.</span>

# Интенты



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

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

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

Созданные нами интенты (предполагаемые группы ответов абонентов) сравниваются с реальными ответами абонентов в блоке **Обработать ответ**, и, если ключевая фраза интента совпадает с распознанной фразой абонента при заданном условии, диалог проходит по ветке сценария, выведенной из интента, с которым произошло совпадение.

[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/scaled-1680-/lUdimage.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/lUdimage.png)

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

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

[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/scaled-1680-/kc4image.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/kc4image.png)

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

- **[Настройка интентов в блоке:](https://docs.ai-assistant.is74.ru/books/instrukcii-po-razdelam/page/nastroika-intentov-v-bloke)** раздел платформы, где можно **добавить** в любой блок обработки ответа любого сценария в проекте интенты, **отредактировать** их, **протестировать** работу отдельного интента или блока обработки ответа целиком, а также посмотреть, как **реальные ответы абонентов** распределялись по интентам в диалогах.
- **[Общедоступные и шаблонные интенты:](https://docs.ai-assistant.is74.ru/books/instrukcii-po-razdelam/page/obshhedostupnye-i-sablonnye-intenty)** раздел платформы со списком общедоступных и шаблонных интентов. **Общедоступные интенты** — интенты, которые можно **переиспользовать** в разных блоках обработки ответа и сценариях. Их особенность в том, что изменения в общедоступном интенте применяются сразу **во всех блоках** и сценариях, где был использован этот интент. **Шаблонные интенты** — системные интенты, которые создаются автоматически при создании проекта. Это набор наиболее часто используемых интентов, которых достаточно для того, чтобы создать простой, но эффективный сценарий. Особенность шаблонных интентов в том, что их **невозможно отредактировать или создать** самостоятельно. Но вы можете создать новый интент на основе шаблонного.
- **[Добавление интента в блок: ](https://docs.ai-assistant.is74.ru/books/instrukcii-po-razdelam/page/dobavlenie-intenta-v-blok)**модальное окно, появляющееся при добавлении интента в блок обработки ответа в **редакторе сценариев** или на странице **настройки интентов в блоке**. Здесь можно добавить интент в блок несколькими способами: **создать с нуля** или **на основе** любого существующего интента в проекте, **использовать созданный** общедоступный или шаблонный интент. Созданный новый интент можно сделать общедоступным, тогда он добавится в список общедоступных и его возможно будет переиспользовать.
- **[Создание общедоступного интента:](https://docs.ai-assistant.is74.ru/books/instrukcii-po-razdelam/page/sozdanie-obshhedostupnogo-intenta)** модальное окно, появляющееся при создании общедоступного интента на странице списка общедоступных и шаблонных интентов. Можно создать новый интент **с нуля** или **на основе** любого существующего интента в платформе.
- **[Тестирование интента и тестирование блока:](https://docs.ai-assistant.is74.ru/books/instrukcii-po-razdelam/page/testirovanie-intenta-testirovanie-bloka)** модальные окна, появляющиеся при клике на кнопки «Протестировать интент» и «Протестировать блок»
- **[Блок обработки ответа: ](https://docs.ai-assistant.is74.ru/link/4#bkmrk-%D0%91%D0%BB%D0%BE%D0%BA-%E2%80%9C%D0%9E%D0%B1%D1%80%D0%B0%D0%B1%D0%BE%D1%82%D0%BA%D0%B0-%D0%BE%D1%82%D0%B2%D0%B5)**блок в редакторе сценариев.
- **[Рекомендации для улучшения обработки ответов:](https://docs.ai-assistant.is74.ru/books/instrukcii-po-razdelam/page/rekomendacii-dlia-ulucseniia-obrabotki-otvetov)** практические советы по доработке интентов с использованием функционала платформы.

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

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

[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/scaled-1680-/BWzimage.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/BWzimage.png)

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

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

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

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

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

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

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

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

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

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

Интент **«Остальное»** есть во всех блоках обработки ответа и всегда расположен последним в списке интентов в блоке. В него попадают те ответы, что не попали ни под один из добавленных в блок интентов. «Остальное» отлично помогает в доработке блока после запуска сценария для реальных диалогов. Изучите [«Рекомендации для улучшения обработки ответов»](https://docs.ai-assistant.is74.ru/books/instrukcii-po-razdelam/page/rekomendacii-dlia-ulucseniia-obrabotki-otvetov), чтобы узнать, как именно.

[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/scaled-1680-/m1Himage.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/m1Himage.png)

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

Для **добавления** нужно воспользоваться кнопкой [![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/scaled-1680-/bYvimage.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/bYvimage.png) над списком интентов в блоке. После того, как вы добавите новый интент и примените изменения в блоке к сценарию, у вас появится предупреждение «Нет исходящей связи» или просто иконка [![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/scaled-1680-/C2Nimage.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/C2Nimage.png) в правой части строки интента. Это напоминание о том, что следует перейти в сценарий и добавить исходящую связь в блоке обработки ответа для добавленного интента.   
Подробнее о функционале модального окна добавления рассказываем ниже.

Для **удаления** интента нужно развернуть его карточку, кликнув в любом месте строки интента в списке (при наведении выделится стрелка справа). При клике на кнопку [![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/scaled-1680-/C3Fimage.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/C3Fimage.png) откроется модальное окно подтверждения удаления, чтобы обезопасить вас от ненужного, случайного удаления.

Чтобы лучше понимать, как будет отрабатывать блок с текущими настройками, воспользуйтесь тестированием блока, кликнув на кнопку ![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/scaled-1680-/UyMimage.png). Ниже вы найдете инструкцию по тестированию блока.

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


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

1. Для **изменения ключевой фразы**, кликните по ней и воспользуйтесь клавиатурой для ввода. Изменения в поле ключевой фразы применятся при клике в любое другое место на странице, но до нажатия кнопки [![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/scaled-1680-/qgQimage.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/qgQimage.png) все примененные изменения будут существовать только на текущей странице настройки интентов в блоке. Здесь же можно посмотреть, как изменения повлияют на распределение по интентам прошедших через выбранный блок ответов абонентов, для этого кликните
    
    [![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/scaled-1680-/tICimage.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/tICimage.png): эта кнопка обновляет панель «Ответы абонентов, попавшие под интент», а также статистику справа от заголовков интентов в списке.
    
      
    Особенности изменения ключевых фраз для **Общедоступных и Шаблонных** интентов: все изменения в общедоступных интентах применяются **во всех блоках и сценариях**, где был использован интент, а также на странице списка общедоступных и шаблонных интентов, после применения изменений к сценарию. Шаблонные интенты **невозможно редактировать**. Но вы можете **отвязать** (1.1) для конкретного блока интент от общедоступного или шаблонного, тогда изменения применятся только к нему, интент будет существовать только в этом блоке, поэтому изменения интентов другими людьми в других блоках никак не повлияют на настройки вашего интента.
2. Для каждой ключевой фразы необходимо выбрать одно из четырех **условий попадания под интент**:  
    - *Полное совпадение* — правило считается выполненным, если абонент произнес в точности то, что было указано в поле «‎Ключевые фразы»‎. Если абонент сказал длинную фразу, в которой встречается ваша ключевая фраза, то фраза абонента попадет под интент.  
    - *Совпадение начальных форм* **—** ответ попадет под интент, если в нем будет содержаться фраза, совпадающая с ключевой при приведении всех слов, содержащихся в фразах, к начальной форме  
    - *Частичное совпадение* —Подсчитывается число операций с символами до полного совпадения фразы. Возможные операции с символами: добавление, перестановка, удаление, замена.  
    Ответ попадет под интент, если в нем будет содержаться фраза, совпадающая с ключевой через несколько операций. Количество зависит от длины фразы.  
    Например: дверь/тверь (1 замена), австрия/австралия (2 добавления). При этом рим/мир (1 перестановка) не будут частично совпадающими, потому что длина фраз слишком мала.  
    - *Регулярное выражение* - это последовательность специальных символов, формирующих паттерн или шаблон, который сопоставляется со строкой.  
    Ответ попадет под интент, если будет соответствовать составленному шаблону.
3. Для **удаления ключевой фразы** кликните на ![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/scaled-1680-/qJVimage.png), а затем подтвердите удаление в открывшемся диалоговом окне.
4. Для **добавления** новой ключевой фразы введите ее в поле с подсказкой «Введите фразу» в конце списка ключевых фраз, затем выберите условие попадания под интент. После выбора условия ключевая фраза автоматически добавляется в интент и под ней появляется новое поле для ввода ключевой фразы.
5. У раздела **«Исключающие фразы»** аналогичный функционал и те же условия, как для ключевых фраз, но при совпадении с исключающей фразой, ответ не попадет под интент, даже если по ключевым фразам должен был. Кликните на вкладку ![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/scaled-1680-/NY1image.png)для просмотра, добавления и редактирования исключающих фраз
6. **Тестирование интента** покажет, попадет или не попадет фраза, используемая для тестирования, в интент при текущих ключевых и исключающих словах с заданными условиями попадания/исключения.

[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/scaled-1680-/E5Aimage.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/E5Aimage.png)

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

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

[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/scaled-1680-/Tdsimage.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/Tdsimage.png)

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

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

[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/scaled-1680-/5v1image.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/5v1image.png)

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

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

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

[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/scaled-1680-/WPQimage.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/WPQimage.png)

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

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

[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/scaled-1680-/XR1image.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/XR1image.png)

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

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

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

[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/scaled-1680-/fjKimage.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/fjKimage.png)

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

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

![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/scaled-1680-/rfHimage.png)

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

[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/scaled-1680-/q9gimage.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/q9gimage.png)

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

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

1. Нажать на кнопку **«Применить изменения к сценарию»**  
    [![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/scaled-1680-/QWpimage.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/QWpimage.png)
2. Перейти в редактор сценариев, проверить, у всех ли интентов в блоке есть **исходящие связи**, если нет — добавить.  
    [![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/scaled-1680-/6MTimage.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/6MTimage.png)
3. **Опубликовать сценарий** с изменениями  
    [![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/scaled-1680-/K1Yimage.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/K1Yimage.png)

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

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

[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/scaled-1680-/yt4image.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/yt4image.png)

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

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

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

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

[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/scaled-1680-/sXfimage.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/sXfimage.png)

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

[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/scaled-1680-/IyOimage.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/IyOimage.png)

[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/scaled-1680-/o6eimage.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/o6eimage.png)

Также в разделе общедоступных и шаблонных интентов можно создать общедоступный интент, нажав на соответствующую кнопку в правой верхней части экрана. Подробнее об этом функционале на странице[ Создание общедоступного интента](https://docs.ai-assistant.is74.ru/books/instrukcii-po-razdelam/page/sozdanie-obshhedostupnogo-intenta)

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

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

[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/scaled-1680-/0ZBimage.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/0ZBimage.png)

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

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

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

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

[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/scaled-1680-/WbYimage.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/WbYimage.png)

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

[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/scaled-1680-/IUHimage.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/IUHimage.png)

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

[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/scaled-1680-/MpMimage.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/MpMimage.png)

<p class="callout info">Будьте внимательными при использовании уже существующего общедоступного интента. Общедоступные интенты, **могут быть изменены другими пользователями**. Для избежания нежелательных изменений в интенте лучше «Создать на основе» или «Отвязать от общедоступного» сразу после добавления в блок.</p>

[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/scaled-1680-/L4Dimage.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/L4Dimage.png)

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

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

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

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

[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/scaled-1680-/agHimage.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/agHimage.png)

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

[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/scaled-1680-/bOaimage.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/bOaimage.png)

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

[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/scaled-1680-/eerimage.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/eerimage.png)

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

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

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

[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/scaled-1680-/gwCimage.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/gwCimage.png)

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

[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/scaled-1680-/Jtjimage.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/Jtjimage.png)

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

[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/scaled-1680-/xSJimage.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/xSJimage.png)

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

[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/scaled-1680-/HZdimage.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/HZdimage.png)

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

[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/scaled-1680-/lUVimage.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/lUVimage.png)

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

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

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

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

[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/scaled-1680-/TZJimage.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/TZJimage.png)

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

[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/scaled-1680-/Hg8image.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/Hg8image.png)

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

[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/scaled-1680-/a04image.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/a04image.png)

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

[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/scaled-1680-/Rumimage.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/Rumimage.png)

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

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

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

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

[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/scaled-1680-/fKDimage.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/fKDimage.png)

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

[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/scaled-1680-/MXpimage.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/MXpimage.png)

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

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

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

Для этого перейдите в раздел[ «Настройка интентов в блоке»](https://docs.ai-assistant.is74.ru/books/instrukcii-po-razdelam/page/nastroika-intentov-v-bloke), выберите сценарий, участвующий в диалогах с реальными абонентами и блок обработки ответа, который хотите доработать.

Рассмотрим в панели [«Ответы абонентов, попавшие под интент»](https://docs.ai-assistant.is74.ru/link/33#bkmrk-%D0%98%D0%B7%D0%BC%D0%B5%D0%BD%D0%B5%D0%BD%D0%B8%D0%B5-%D0%BD%D0%B0%D1%81%D1%82%D1%80%D0%BE%D0%B5%D0%BA-%D0%B8) интент «Остальное». Вы увидите список всех фраз, которые попали под этот интент. В данном списке будут показаны ответы абонентов, прошедшие через блок за последние сутки. Период можно изменить в поле «Период выгрузки ответов».

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

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

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

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

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

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



# HTTP-запросы

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

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

<div id="bkmrk-">---

</div>### **1. Работа с HTTP-запросами**

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

[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2025-01/scaled-1680-/25Nimage.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2025-01/25Nimage.png)

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

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

[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2025-01/scaled-1680-/QYuimage.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2025-01/QYuimage.png)

1. После нажатия кнопки **"Создать HTTP-запрос"** откроется редактор.
2. В разделе **"Основные данные"**:
    
    
    - Укажите название запроса.
    - Выберите тип запроса (например, GET или POST).
    - Вставьте URL-адрес для отправки запроса.
    - После заполнения основных данных вопрос можно сохранять, но лучше не делайте этого до получения результатов, совпадающих с настроенными принимаемыми результатами, чтобы избежать ошибок в реальных звонках при использовании запроса в сценариях.
3. В разделе **"Входные параметры"**:
    
    
    - На вкладке **"Параметры"** добавьте ключи и значения параметров.
    - На вкладке **"Заголовки"** укажите заголовки запроса.
    - На вкладке **"Тело"** укажите структуру тела запроса, если это POST-запрос.
    - Обратите внимание, что если мы передаем либо в сам ключ, либо в значение название в «{{}}», то этот параметр будет передаваться из самого сценария в виде переменной. И он отобразится в поле «Переменные во входных параметрах»  
         [![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2025-01/scaled-1680-/AtPimage.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2025-01/AtPimage.png)
4. В разделе **"Принимаемые результаты"**:
    
    
    - Добавьте параметры, которые сервер возвращает в ответе.
    - Укажите вложенные параметры (до 5 уровней вложенности).
    - После добавления параметров нажмите **"Сохранить запрос"**. Затем перейдите в раздел **"Результаты"**, чтобы протестировать запрос.
        
        [![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2025-01/scaled-1680-/vnuimage.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2025-01/vnuimage.png)

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

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

[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2025-01/scaled-1680-/Cz2image.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2025-01/Cz2image.png)

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

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

[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2025-01/scaled-1680-/dWfimage.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2025-01/dWfimage.png)

<div id="bkmrk--5">---

</div>### **2. Использование HTTP-запросов в сценариях**

[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2025-01/scaled-1680-/N4fimage.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2025-01/N4fimage.png)

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

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

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

1. Выберите ранее созданный запрос из выпадающего списка.
2. Настройте входные параметры:
    
    
    - Для каждого параметра выберите переменную сценария, которая будет передавать значение.
3. Настройте принимаемые результаты:
    
    
    - Для каждого возвращаемого значения выберите переменную, которая будет использоваться в сценарии.
        
        <table border="1" style="border-collapse: collapse; width: 100%; height: 849.999px; border-width: 1px; border-color: #DBDBF8;"><colgroup><col style="width: 34px;" width="34"></col><col style="width: 388px;" width="388"></col><col style="width: 248px;" width="248"></col></colgroup><tbody><tr style="height: 35.3906px;"><td style="height: 35.3906px; border-color: rgb(219, 219, 248); background-color: rgb(246, 246, 253);">**№**
        
        </td><td style="height: 35.3906px; border-color: rgb(219, 219, 248); background-color: rgb(246, 246, 253);">**Действие**
        
        </td><td style="height: 35.3906px; border-color: rgb(219, 219, 248); background-color: rgb(246, 246, 253);">**Скрин**
        
        </td></tr><tr style="height: 94.3906px;"><td style="height: 94.3906px; border-color: rgb(219, 219, 248);">1
        
        </td><td style="height: 94.3906px; border-color: rgb(219, 219, 248);">Нажмите ПКМ по полотну и в появившемся списке выберите блок «Отправить HTTP-запрос»
        
        </td><td style="height: 94.3906px; border-color: rgb(219, 219, 248);">[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-09/scaled-1680-/pyRimage.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-09/pyRimage.png)
        
        </td></tr><tr style="height: 256.906px;"><td style="height: 256.906px; border-color: rgb(219, 219, 248);">2
        
        </td><td style="height: 256.906px; border-color: rgb(219, 219, 248);">В выпадающем списке выбираем наш созданный запрос
        
        </td><td style="height: 256.906px; border-color: rgb(219, 219, 248);">[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-09/scaled-1680-/jI4image.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-09/jI4image.png)
        
        </td></tr><tr style="height: 114.078px;"><td style="height: 114.078px; border-color: rgb(219, 219, 248);">3
        
        </td><td style="height: 114.078px; border-color: rgb(219, 219, 248);">После выбора запроса в разделе «Входные параметры» как раз-таки появляется параметр, который мы добавляли
        
        </td><td style="height: 114.078px; border-color: rgb(219, 219, 248);">[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-09/scaled-1680-/nWwimage.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-09/nWwimage.png)
        
        </td></tr><tr style="height: 119.359px;"><td style="height: 119.359px; border-color: rgb(219, 219, 248);">4
        
        </td><td style="height: 119.359px; border-color: rgb(219, 219, 248);">Присваиваем ему переменную сценария «agent\_id» ([как создать переменную в сценарии читай тут](https://docs.ai-assistant.is74.ru/books/redaktor-scenariev/page/rabota-s-peremennymi))
        
          
        Таким образом, мы передаем значение переменной из сценария в значение ключа нашего HTTP-запроса
        
        </td><td style="height: 119.359px; border-color: rgb(219, 219, 248);">[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-09/scaled-1680-/bjBimage.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-09/bjBimage.png)
        
        </td></tr><tr style="height: 121.734px;"><td style="height: 121.734px; border-color: rgb(219, 219, 248);">5
        
        </td><td style="height: 121.734px; border-color: rgb(219, 219, 248);">Нажимаем на вкладку «Результаты запроса» и видим, что наш запрос возвращает значение «doctor\_call»
        
          
        Теперь также выбираем/создаем переменную из сценария, которой мы присвоим возвращаемое http-запросом значение
        
        </td><td style="height: 121.734px; border-color: rgb(219, 219, 248);">[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-09/scaled-1680-/zIoimage.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-09/zIoimage.png)
        
        </td></tr><tr style="height: 108.141px;"><td style="height: 108.141px; border-color: rgb(219, 219, 248);">6
        
        </td><td style="height: 108.141px; border-color: rgb(219, 219, 248);">Сохраняем блок
        
        </td><td style="height: 108.141px; border-color: rgb(219, 219, 248);">[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-09/scaled-1680-/8DDimage.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-09/8DDimage.png)
        
        </td></tr></tbody></table>

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

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

<div id="bkmrk--7">---

</div>### **3. Советы и рекомендации**

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

<div id="bkmrk--8">---

</div>### ***Примечание***

*Для дополнительной информации по настройке блоков сценариев ознакомьтесь с разделом "[Редактор сценариев](https://docs.ai-assistant.is74.ru/books/redaktor-scenariev)" в документации.*

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

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

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

<div class="translate-tooltip-mtz translator-hidden" id="bkmrk-"><div class="translated-text"><div>---

</div></div></div>### **1. Работа с базами данных**

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

[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2025-01/scaled-1680-/9rsimage.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2025-01/9rsimage.png)

<div class="translate-tooltip-mtz translator-hidden" id="bkmrk-%D0%9F%D0%B5%D1%80%D0%B5%D0%B9%D0%B4%D0%B8%D1%82%D0%B5-%D0%B2-%D1%80%D0%B0%D0%B7%D0%B4%D0%B5%D0%BB-%22"><div class="translated-text">1. Перейдите в раздел **"Базы данных"**.
2. На странице отображается список подключённых баз данных:
    
    
    - Статус подключения (например, "Подключена" или "Ошибка") отображает текущее состояние доступа к базе данных.
    - Если статус "Ошибка", попробуйте обновить статусы подключений. Если ошибка сохраняется, проверьте настройки базы данных.
3. Для добавления новой базы данных нажмите кнопку **"Добавить базу данных"**.

</div></div>#### **1.2. Добавление новой базы данных[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2025-01/scaled-1680-/t5timage.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2025-01/t5timage.png)**

<div class="translate-tooltip-mtz translator-hidden" id="bkmrk-%D0%9D%D0%B0%D0%B6%D0%BC%D0%B8%D1%82%D0%B5-%D0%BA%D0%BD%D0%BE%D0%BF%D0%BA%D1%83-%22%D0%94%D0%BE%D0%B1%D0%B0"><div class="translated-text">1. Нажмите кнопку **"Добавить базу данных"**.
2. Введите следующие параметры:
    
    
    - Название базы данных.
    - Тип базы данных (например, Oracle, MySQL, PostgreSQL).
    - Хост, порт, имя пользователя, пароль и имя базы данных.
3. Нажмите кнопку **"Добавить базу данных"** для сохранения.
4. После добавления база появится в списке. Убедитесь, что статус подключения отображается как "Подключена".

</div></div>#### **1.3. Настройка базы данных**

[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2025-01/scaled-1680-/Pg7image.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2025-01/Pg7image.png)

<div class="translate-tooltip-mtz translator-hidden" id="bkmrk-%D0%9D%D0%B0%D0%B6%D0%BC%D0%B8%D1%82%D0%B5-%D0%BD%D0%B0-%D0%B8%D0%BA%D0%BE%D0%BD%D0%BA%D1%83-%D0%BF%D0%B0"><div class="translated-text">1. Нажмите на иконку параметров (шестерёнка) напротив нужной базы данных в списке.
2. Откроется модальное окно с параметрами базы данных:
    
    
    - Вы можете изменить название, тип базы данных, хост, порт, имя пользователя, пароль и имя базы данных.
    - Для сохранения изменений нажмите **"Сохранить изменения"**.
3. Для удаления базы данных нажмите кнопку **"Удалить базу данных"**.
    
    
    - Если база данных используется в запросах, система уведомит вас о невозможности удаления и покажет список связанных запросов.

</div></div><div class="translate-tooltip-mtz translator-hidden" id="bkmrk--3"><div class="translated-text"><div>---

</div></div></div>### **2. Работа с SQL-запросами**

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

[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2025-01/scaled-1680-/siQimage.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2025-01/siQimage.png)

<div class="translate-tooltip-mtz translator-hidden" id="bkmrk-%D0%9F%D0%B5%D1%80%D0%B5%D0%B9%D0%B4%D0%B8%D1%82%D0%B5-%D0%B2-%D1%80%D0%B0%D0%B7%D0%B4%D0%B5%D0%BB-%22-1"><div class="translated-text">1. Перейдите в раздел **"SQL-запросы"**.
2. На странице отображается список всех созданных SQL-запросов:
    
    
    - Колонка "Базы данных и сценарии" отображает, к каким базам данных и в каких сценариях использован запрос.
    - Используйте поле поиска для поиска запросов по названию.
    - Вы можете фильтровать запросы по базам данных или сценариям.
3. Для создания нового SQL-запроса нажмите кнопку **"Создать SQL-запрос"**.

</div></div>#### **2.2. Создание SQL-запроса**

[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2025-01/scaled-1680-/qlSimage.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2025-01/qlSimage.png)

<div class="translate-tooltip-mtz translator-hidden" id="bkmrk-%D0%9D%D0%B0%D0%B6%D0%BC%D0%B8%D1%82%D0%B5-%D0%BA%D0%BD%D0%BE%D0%BF%D0%BA%D1%83-%22%D0%A1%D0%BE%D0%B7%D0%B4"><div class="translated-text">1. Нажмите кнопку **"Создать SQL-запрос"**.
2. В открывшемся редакторе выполните следующие действия:
    
    
    - В разделе **"Основные данные"** укажите название запроса и выберите базу данных из выпадающего списка.
    - В разделе **"SQL-запрос"** введите текст SQL-запроса.
    - После этого доступно сохранение запроса, но сохранять запрос без успешного получения результата крайне не рекомендуется, потому что это может привести к ошибкам в реальных диалогах при использовании такого запроса в сценарии впоследствии.
    - В разделе **"Переменные во входных параметрах"**, если такие есть, добавьте параметры запроса:
        
        
        - Укажите имя переменной.
        - Задайте тип переменной ("Число" или "Строка").
3. Для проверки запроса нажмите кнопку **"Получить результаты"**:
    
    
    - Отобразятся результаты выполнения запроса.
    - Убедитесь, что запрос выполняется корректно, и результаты соответствуют ожидаемым.
4. Нажмите кнопку **"Сохранить запрос"** для завершения.

</div></div>#### **2.3. Редактирование SQL-запроса**

[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2025-01/scaled-1680-/IWYimage.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2025-01/IWYimage.png)

<div class="translate-tooltip-mtz translator-hidden" id="bkmrk-%D0%94%D0%BB%D1%8F-%D1%80%D0%B5%D0%B4%D0%B0%D0%BA%D1%82%D0%B8%D1%80%D0%BE%D0%B2%D0%B0%D0%BD%D0%B8%D1%8F-%D1%81"><div class="translated-text">1. Для редактирования существующего запроса выберите его из списка и нажмите на его название.
2. Внесите изменения в открывшемся редакторе.
3. Нажмите кнопку **"Сохранить запрос"** для сохранения изменений.

</div></div>#### **2.4. Удаление SQL-запроса**

<div class="translate-tooltip-mtz translator-hidden" id="bkmrk-%D0%9D%D0%B0%D0%B6%D0%BC%D0%B8%D1%82%D0%B5-%D0%B8%D0%BA%D0%BE%D0%BD%D0%BA%D1%83-%D1%83%D0%B4%D0%B0%D0%BB%D0%B5"><div class="translated-text">1. Нажмите иконку удаления рядом с запросом в списке.
2. Если запрос используется в сценариях, система уведомит вас о невозможности удаления и покажет список связанных сценариев. Удалите ссылки на запрос из сценариев в блоках "Выполнить SQL-запрос", чтобы завершить удаление.
    
    [![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2025-01/scaled-1680-/3fRimage.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2025-01/3fRimage.png)

<div>---

</div></div></div>### **3. Использование SQL-запросов в сценариях**

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

<div class="translate-tooltip-mtz translator-hidden" id="bkmrk-%D0%9F%D0%B5%D1%80%D0%B5%D0%B9%D0%B4%D0%B8%D1%82%D0%B5-%D0%B2-%D1%80%D0%B5%D0%B4%D0%B0%D0%BA%D1%82%D0%BE%D1%80"><div class="translated-text">1. Перейдите в редактор сценариев.
2. Щелкните правой кнопкой мыши по рабочему пространству и выберите **"Выполнить SQL-запрос"**.

</div></div>#### **3.2. Настройка блока**

<div class="translate-tooltip-mtz translator-hidden" id="bkmrk-%D0%92%D1%8B%D0%B1%D0%B5%D1%80%D0%B8%D1%82%D0%B5-%D1%81%D0%BE%D0%B7%D0%B4%D0%B0%D0%BD%D0%BD%D1%8B%D0%B9-s"><div class="translated-text">1. Выберите созданный SQL-запрос из выпадающего списка.
2. Настройте входные параметры:
    
    
    - Для каждого параметра выберите переменную сценария, которая будет передавать значение.
3. Настройте результаты запроса:
    
    
    - Для каждого возвращаемого значения выберите переменную, которая будет использоваться в сценарии.

</div></div><table border="1" id="bkmrk-%E2%84%96-%D0%94%D0%B5%D0%B9%D1%81%D1%82%D0%B2%D0%B8%D0%B5-%D0%A1%D0%BA%D1%80%D0%B8%D0%BD-1-%D0%9D" style="border-collapse: collapse; width: 100%; height: 746.014px; border-width: 1px; border-color: #DBDBF8;"><colgroup><col style="width: 34px;" width="34"></col><col style="width: 388px;" width="388"></col><col style="width: 248px;" width="248"></col></colgroup><tbody><tr style="height: 35.3906px;"><td style="border-width: 1px; height: 35.3906px; background-color: rgb(246, 246, 253); border-color: rgb(219, 219, 248);">**№**

</td><td style="border-width: 1px; height: 35.3906px; background-color: rgb(246, 246, 253); border-color: rgb(219, 219, 248);">**Действие**

</td><td style="border-width: 1px; height: 35.3906px; background-color: rgb(246, 246, 253); border-color: rgb(219, 219, 248);">**Скрин**

</td></tr><tr style="height: 92.3906px;"><td style="border-width: 1px; height: 92.3906px; border-color: rgb(219, 219, 248);">1

</td><td style="border-width: 1px; height: 92.3906px; border-color: rgb(219, 219, 248);">Нажмите ПКМ по рабочему пространству и в появившемся списке **выберите блок** «Отправить запрос в базу»

</td><td style="border-width: 1px; height: 92.3906px; border-color: rgb(219, 219, 248);">[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/scaled-1680-/671image.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/671image.png)

</td></tr><tr style="height: 209.812px;"><td style="border-width: 1px; height: 209.812px; border-color: rgb(219, 219, 248);">2

</td><td style="border-width: 1px; height: 209.812px; border-color: rgb(219, 219, 248);">В правом боковом меню в выпадающем списке **выбираем наш созданный запрос**

</td><td style="border-width: 1px; height: 209.812px; border-color: rgb(219, 219, 248);">[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/scaled-1680-/bWcimage.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/bWcimage.png)

</td></tr><tr style="height: 85.25px;"><td style="border-width: 1px; height: 85.25px; border-color: rgb(219, 219, 248);">3

</td><td style="border-width: 1px; height: 85.25px; border-color: rgb(219, 219, 248);">После выбора запроса в разделе «Входные параметры» как раз-таки появляется параметр, который мы добавляли (параметр, который будет передан в запрос)

</td><td style="border-width: 1px; height: 85.25px; border-color: rgb(219, 219, 248);">[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/scaled-1680-/N8kimage.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/N8kimage.png)

</td></tr><tr style="height: 132.734px;"><td style="border-width: 1px; height: 132.734px; border-color: rgb(219, 219, 248);">4

</td><td style="border-width: 1px; height: 132.734px; border-color: rgb(219, 219, 248);">**Присваиваем ему переменную** сценария «phone» (как создать переменную в сценарии читайте на странице[ «Работа с переменными»](https://docs.ai-assistant.is74.ru/books/redaktor-scenariev/page/rabota-s-peremennymi))

  
Таким образом, мы передаем значение переменной из сценария в наш запрос

</td><td style="border-width: 1px; height: 132.734px; border-color: rgb(219, 219, 248);">[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/scaled-1680-/mYJimage.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/mYJimage.png)

</td></tr><tr style="height: 119.359px;"><td style="border-width: 1px; height: 119.359px; border-color: rgb(219, 219, 248);">5

</td><td style="border-width: 1px; height: 119.359px; border-color: rgb(219, 219, 248);">Нажимаем на вкладку **«Результаты запроса»** и видим, что наш запрос возвращает столбец «user\_id»

  
Теперь **также выбираем/создаем переменную** из сценария, которой мы присвоим возвращаемое sql-запросом значение

</td><td style="border-width: 1px; height: 119.359px; border-color: rgb(219, 219, 248);">[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/scaled-1680-/uPVimage.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/uPVimage.png)

</td></tr><tr style="height: 71.0781px;"><td style="border-width: 1px; height: 71.0781px; border-color: rgb(219, 219, 248);">6

</td><td style="border-width: 1px; height: 71.0781px; border-color: rgb(219, 219, 248);">**Сохраняем блок**

</td><td style="border-width: 1px; height: 71.0781px; border-color: rgb(219, 219, 248);">[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/scaled-1680-/e50image.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/e50image.png)

</td></tr></tbody></table>

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

<div class="translate-tooltip-mtz translator-hidden" id="bkmrk-%D0%A3%D0%B1%D0%B5%D0%B4%D0%B8%D1%82%D0%B5%D1%81%D1%8C%2C-%D1%87%D1%82%D0%BE-%D0%B2%D1%81%D0%B5-%D0%B2"><div class="translated-text">1. Убедитесь, что все входные параметры и результаты настроены корректно.
2. Сохраните изменения сценария.

<div>---

</div></div></div>### **4. Советы и рекомендации**

<div class="translate-tooltip-mtz translator-hidden" id="bkmrk-%D0%A2%D0%B5%D1%81%D1%82%D0%B8%D1%80%D1%83%D0%B9%D1%82%D0%B5-%D0%B7%D0%B0%D0%BF%D1%80%D0%BE%D1%81%D1%8B-%D0%BE"><div class="translated-text">- **Тестируйте запросы отдельно перед сохранением в редакторе SQL-запросов:** это поможет избежать ошибок при настройке сценария.
- **Следите за статусом подключения баз данных:** корректная работа SQL-запросов зависит от доступности баз данных.
- **Используйте понятные названия переменных:** это упростит их использование в сценариях.

<div>---

</div></div></div>### **Примечание**

*Для дополнительной информации по настройке блоков сценариев ознакомьтесь с разделом "[Редактор сценариев](https://docs.ai-assistant.is74.ru/books/redaktor-scenariev)" в документации.*

# Телефония

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

# SIP-транки

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

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

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

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

[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-09/scaled-1680-/Lmcimage.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-09/Lmcimage.png)

Выше показана страница SIP-транков без добавленных SIP-транков. Нам нужно кликнуть на кнопку ![add_trunk](https://i.ibb.co/W01CSnb/add-trunk.png), чтобы **добавить новый**.

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

[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-09/scaled-1680-/RPwimage.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-09/RPwimage.png)

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

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

[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-09/scaled-1680-/XsRimage.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-09/XsRimage.png)

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

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

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


Нам подойдет любой сервис для **получения IP сайта**, например, [2ip.ru](https://2ip.ru/lookup/). Вводим адрес сервера в поле IP-адрес или домен и нажимаем на ![add_trunk](https://i.ibb.co/W0Fnb1G/check.png). Осталось скопировать IP-адрес в формате 111.111.111.1 и вставить в поле Хост в модальном окне добавления SIP-транка.[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-09/scaled-1680-/0Rdimage.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-09/0Rdimage.png)

Входящий сценарий и стартовый блок в разделе **Привязка SIP-транка к входящему сценарию** можно не выбирать, если у вас нет сценариев для входящих звонков. Или добавить позднее через настройки добавленного SIP-транка. Соответствующая инструкция есть на странице [Использование SIP-транков и номеров](https://docs.ai-assistant.is74.ru/books/instrukcii-po-razdelam/page/ispolzovanie-sip-trankov-i-nomerov-v-dialogax)

Теперь, когда все обязательные поля раздела **Данные вашего SIP-аккаунта** заполнены, можем добавлять транк, кликнув на кнопку ![add_trunk](https://i.ibb.co/BGbHs5B/image.png) в модальном окне добавления SIP-транка.

[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-09/scaled-1680-/0HOimage.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-09/0HOimage.png)

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

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

У SIP-транков есть 3 возможных статуса, они отображаются в карточках SIP-транков в колонке «Статусы регистрации»: **<span style="color: rgb(165, 166, 246);">«Регистрируется»</span>**, **<span style="color: rgb(0, 213, 97);">«Зарегистрирован»</span>** и <span style="color: rgb(248, 128, 120);">**«Ошибка»**</span>

[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-09/scaled-1680-/dvsimage.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-09/dvsimage.png)

После добавления SIP-транку присваевается статус **<span style="color: rgb(165, 166, 246);">«Регистрируется»</span>**. Процесс регистрации занимает не больше минуты, в это время проверяются введенные вами данными и осуществляется попытка зарегистрировать нашу платформу как устройство в виртуальной АТС вашего провайдера.

Если с данными все в порядке и регистрация прошла успешно, статус изменится на **<span style="color: rgb(0, 213, 97);">«Зарегистрирован»</span>**. Транк с таким статусом можно использовать в диалогах.

Если в данных обнаружится ошибка или в процессе регистрации мы столкнемся с какой-то проблемой, у SIP-транка будет статус <span style="color: rgb(248, 128, 120);">**«Ошибка»**</span>. Проверьте данные для подключения транка, кликнув на ![add_trunk](https://i.ibb.co/ZgyGdzB/image.png) в правой части карточки SIP-транка и измените некорректные данные. После проверки данных нажмите на кнопку ![reload](https://i.ibb.co/VmjBf4F/image.pngg) возле заголовка «Статус регистрации» для повторной попытки регистрации и обновления статусов. В случае, если транку снова присвоился статус «Ошибка», напишите в техподдержку вашей телефонии или нам.

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

При клике на ![add_trunk](https://i.ibb.co/ZgyGdzB/image.png) откроется модальное окно **«Настройки SIP-транка»**. В нем те же поля с данными, как и в модальном окне [добавления SIP-транка](https://docs.ai-assistant.is74.ru/books/instrukcii-po-razdelam/page/sip-tranki#bkmrk-%D0%94%D0%BE%D0%B1%D0%B0%D0%B2%D0%BB%D0%B5%D0%BD%D0%B8%D0%B5-sip-%D1%82%D1%80%D0%B0%D0%BD%D0%BA). Их можно отредактировать при необходимости. Для применения изменений нужно нажать на кнопку ![save](https://i.ibb.co/qMGShfg/image.png), которая станет активной при внесении изменений.

Также в модальном окне SIP-транков есть кнопка ![delete](https://i.ibb.co/3TsRqXk/image.png), при клике на которую откроется модальное окно подтверждения удаления, а после подтверждения, SIP-транк **удалится из списка**. На стороне провайдера информация об удалении транка может обработаться не сразу, время обработки зависит от заложенного в их сервисе тайм-аута на проверку.

[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-09/scaled-1680-/qXYimage.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-09/qXYimage.png)

# Номера

Добавленные номера потребуются вам при создании обзвонов и для быстрого выбора при переадресации в сценарии. Если вы планируете запускать голосового ассистента для входящих линий, вам достаточно [добавления SIP-транка](https://docs.ai-assistant.is74.ru/books/instrukcii-po-razdelam/page/sip-tranki#bkmrk-%D0%94%D0%BE%D0%B1%D0%B0%D0%B2%D0%BB%D0%B5%D0%BD%D0%B8%D0%B5-sip-%D1%82%D1%80%D0%B0%D0%BD%D0%BA).

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

Добавить номер в проект можно только к соответствующему SIP-транку, поэтому, если у вас нет SIP-транка, добавьте сперва его. О том, как это сделать, мы рассказываем в инструкции по[ SIP-транкам](https://docs.ai-assistant.is74.ru/books/instrukcii-po-razdelam/page/sip-tranki).

Для добавления номера в проект перейдите в раздел SIP-транки и кликните на ![add_number](https://i.ibb.co/5KjcvrX/image.png) в карточке соответствующего SIP-транка. Список номеров, которые могут быть использованы соответствующим транком, определяет провайдер, чтобы ознакомиться с ним или отредактировать его, зайдите в аккаунт вашей виртуальной АТС.

[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-09/scaled-1680-/3hsimage.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-09/3hsimage.png)

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

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

[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-09/scaled-1680-/Lu5image.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-09/Lu5image.png)

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

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

[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-09/scaled-1680-/eA9image.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-09/eA9image.png)

Теперь давайте **добавим номер**, кликнув на кнопку ![add_number_button](https://i.ibb.co/M6MgMqy/image.png) в модальном окне добавления номера.

Модальное окно закрывается при клике на ![add_number_button](https://i.ibb.co/M6MgMqy/image.png), и новый номер появляется в карточке SIP-транка в колонке **«Привязан к номерам»**. Информацию о номерах, добавленных к SIP-транку, можно посмотреть, **развернув карточку SIP-транка**. Для этого кликните на пустое пространство карточки, которую хотите развернуть. При наведении на область разворачивания должна выделиться соответствующая иконка в левой части карточки ![hover](https://i.ibb.co/qW34SbM/image.png)

[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-09/scaled-1680-/5ynimage.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-09/5ynimage.png)

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

Изменить информацию о номере и сам номер можно, кликнув на ![add_trunk](https://i.ibb.co/ZgyGdzB/image.png) в строке номера.

[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-09/scaled-1680-/AIQimage.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-09/AIQimage.png)

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

При клике на ![add_trunk](https://i.ibb.co/ZgyGdzB/image.png) в строке номера в разделе «Информация о номерах» развернутой карточки SIP-транка, откроется модальное окно **«Настройка номера»**. В нем те же поля и опции, что и в модальном окне «Добавление номера». Здесь вы можете отредактировать любую информацию о номере и сам номер при необходимости, а также удалить номер.

Для применения изменений, нажмите на кнопку ![save](https://i.ibb.co/qMGShfg/image.png), которая станет активной при внесении изменений.

Чтобы **удалить номер**, нажмите на кнопку ![delete_number](https://i.ibb.co/cTdTZCM/image.png). При клике откроется модальное окно подтверждения удаления, при подтверждении модальное окно настройки закроется, а номер удалится из списка привязанных к транку.

[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-09/scaled-1680-/hQ3image.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-09/hQ3image.png)

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

Здесь мы рассмотрим ситуации, при которых в платформе будет необходимо выбрать SIP-транк или номер из добавленных в платформу в разделе «SIP-транки» . Инструкция по добавлению размещена на страницах [SIP-транки ](https://docs.ai-assistant.is74.ru/link/29#bkmrk-%D0%94%D0%BE%D0%B1%D0%B0%D0%B2%D0%BB%D0%B5%D0%BD%D0%B8%D0%B5-sip-%D1%82%D1%80%D0%B0%D0%BD%D0%BA)и [Номера](https://docs.ai-assistant.is74.ru/link/31#bkmrk-%D0%94%D0%BE%D0%B1%D0%B0%D0%B2%D0%BB%D0%B5%D0%BD%D0%B8%D0%B5-%D0%BD%D0%BE%D0%BC%D0%B5%D1%80%D0%B0).

### Обзвоны

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

[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-09/scaled-1680-/TQgimage.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-09/TQgimage.png)

Вы можете выбрать из списка номер для обзвона. В списке будут отображаться номера, в настройках использования которых **разрешено использование для обзвонов**. Проверить и настроить разрешения на использование можно в разделе «SIP-транки». Воспользуйтесь и[нструкцией по работе с номерами](https://docs.ai-assistant.is74.ru/books/instrukcii-po-razdelam/page/nomera), если возникнут сложности.

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

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

<p class="callout info">Только **опубликованные** сценарии возможно привязать к SIP-транку и сделать входящими. Подробнее про статусы на странице [«Версии и статусы сценариев»](https://docs.ai-assistant.is74.ru/books/redaktor-scenariev/page/versii-i-statusy-scenariev)</p>

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

[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-09/scaled-1680-/ID3image.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-09/ID3image.png)

Инструкция по добавлению и настройке SIP-транка на странице [«SIP-транки»](https://docs.ai-assistant.is74.ru/books/instrukcii-po-razdelam/page/sip-tranki).

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

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

Вы можете **выбрать номер** для переадресации из списка добавленных в платформу, доступных к использованию для переадресаций, номеров. Разрешения на использование номеров настраиваются в разделе SIP-транков, подробнее об этом на странице [«Номера»](https://docs.ai-assistant.is74.ru/books/instrukcii-po-razdelam/page/nomera).

[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-09/scaled-1680-/tNZimage.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-09/tNZimage.png)

Или можете **ввести номер** для переадресации вручную. Для перехода к вводу вручную нажмите на ![write_number](https://i.ibb.co/jvdK8FP/image.png), появится поле **выбора SIP-транка**, с помощью которого будет осуществлен переадресованный звонок. После выбора SIP-транка появится поле для **ввода номера** для переадресации.

[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-09/scaled-1680-/Etmimage.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-09/Etmimage.png)

Не забудьте после выбора способа переадресации и ввода необходимых данных **сохранить изменения** в блоке, нажав на кнопку ![write_number](https://i.ibb.co/TbVF2zZ/image.png)

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

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

#### Настройка Asterisk с использованием chan\_sip

1. Создайте файл конфигурации 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
```

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



# Пользователи проекта



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

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

> Для доступа к разделу **Администрирование** необходимы иметь роль <span style="text-decoration: underline;">Администратор проекта.</span>

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

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

---

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

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

**[![Снимок экрана 2024-09-26 115922.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2024-09/scaled-1680-/snimok-ekrana-2024-09-26-115922.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2024-09/snimok-ekrana-2024-09-26-115922.png)**

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

[![Снимок экрана 2024-09-26 120032.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2024-09/scaled-1680-/snimok-ekrana-2024-09-26-120032.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2024-09/snimok-ekrana-2024-09-26-120032.png) [![Снимок экрана 2024-09-26 120349.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2024-09/scaled-1680-/snimok-ekrana-2024-09-26-120349.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2024-09/snimok-ekrana-2024-09-26-120349.png)

Затем вам необходимо установить права доступа для создаваемого пользователя. Для этого в разделе <span style="text-decoration: underline;">Роль пользователя</span> выберите <span style="text-decoration: underline;">Проект </span>и <span style="text-decoration: underline;">Роль.</span>

> Более подробно про досупы и роли вы можете узнать в разделе "[Роли пользователей](https://docs.ai-assistant.is74.ru/books/instrukcii-po-razdelam/page/roli-polzovatelei "Роли пользователей")"

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

---

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

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

[![Снимок экрана 2024-09-26 120448.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2024-09/scaled-1680-/snimok-ekrana-2024-09-26-120448.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2024-09/snimok-ekrana-2024-09-26-120448.png)

- **Изменения доступов к проекту**. В разделе <span style="text-decoration: underline;">Доступ к проектам</span> нажать на [![Снимок экрана 2024-09-26 123209.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2024-09/scaled-1680-/snimok-ekrana-2024-09-26-123209.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2024-09/snimok-ekrana-2024-09-26-123209.png) и добавить или убрать роли у пользователя.
- **Добавления пользователя в новый проект**. В разделе <span style="text-decoration: underline;">Предоставить доступ</span> выберете проект и роли, которые хотите предоставить пользователю.

[![Снимок экрана 2024-09-26 120603.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2024-09/scaled-1680-/snimok-ekrana-2024-09-26-120603.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2024-09/snimok-ekrana-2024-09-26-120603.png)

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

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

<span style="text-decoration: underline;">Доступами к проектам может управлять только пользователь с ролью Администратор проекта</span>.

> Подробнее об управлении доступами и создании пользователь вы можете в разделе "[Пользователи](https://docs.ai-assistant.is74.ru/books/instrukcii-po-razdelam/page/polzovateli "Пользователи")".

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

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

<table border="1" id="bkmrk-%D0%9F%D0%BE%D0%BB%D1%8C%D0%B7%D0%BE%D0%B2%D0%B0%D1%82%D0%B5%D0%BB%D1%8C-%D0%A0%D0%B0%D0%B7%D1%80%D0%B0%D0%B1%D0%BE" style="border-collapse: collapse; width: 100%; height: 235.666px;"><colgroup><col style="width: 24.9588%;"></col><col style="width: 24.9588%;"></col><col style="width: 24.9588%;"></col><col style="width: 24.9588%;"></col></colgroup><tbody><tr style="height: 29.4583px;"><td style="height: 29.4583px;">  
</td><td class="align-center" style="height: 29.4583px;">**Пользователь**</td><td class="align-center" style="height: 29.4583px;">**Разработчик**</td><td class="align-center" style="height: 29.4583px;">**Администратор проекта**</td></tr><tr style="height: 29.4583px;"><td style="height: 29.4583px;">**Сценарии**</td><td class="align-center" style="height: 29.4583px;">❌</td><td class="align-center" style="height: 29.4583px;">✅</td><td class="align-center" style="height: 29.4583px;">✅</td></tr><tr style="height: 29.4583px;"><td style="height: 29.4583px;">**Обзвоны**</td><td class="align-center" style="height: 29.4583px;">✅</td><td class="align-center" style="height: 29.4583px;">✅</td><td class="align-center" style="height: 29.4583px;">✅</td></tr><tr style="height: 29.4583px;"><td style="height: 29.4583px;">**Аналитика**</td><td class="align-center" style="height: 29.4583px;">✅</td><td class="align-center" style="height: 29.4583px;">✅</td><td class="align-center" style="height: 29.4583px;">✅</td></tr><tr style="height: 29.4583px;"><td style="height: 29.4583px;">**Интенты**</td><td class="align-center" style="height: 29.4583px;">❌</td><td class="align-center" style="height: 29.4583px;">✅</td><td class="align-center" style="height: 29.4583px;">✅</td></tr><tr style="height: 29.4583px;"><td style="height: 29.4583px;">**Данные для сценария**</td><td class="align-center" style="height: 29.4583px;">❌</td><td class="align-center" style="height: 29.4583px;">✅</td><td class="align-center" style="height: 29.4583px;">✅</td></tr><tr style="height: 29.4583px;"><td style="height: 29.4583px;">**Телефония**</td><td class="align-center" style="height: 29.4583px;">Только просмотр</td><td class="align-center" style="height: 29.4583px;">✅</td><td class="align-center" style="height: 29.4583px;">✅</td></tr><tr style="height: 29.4583px;"><td style="height: 29.4583px;">**Администрирование**</td><td class="align-center" style="height: 29.4583px;">❌</td><td class="align-center" style="height: 29.4583px;">❌</td><td class="align-center" style="height: 29.4583px;">✅</td></tr></tbody></table>