# Добро пожаловать в aiokk!

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

Бизнес нуждается в улучшении качества своих телефонных коммуникаций. Однако современные классические методы контроля качества имеют ряд серьезных недостатков, устранение которых воодушевило нашу команду на разработку сервиса aiokk!

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

### Если стало скучно, то можно сразу перейти в другой раздел...

<table data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-cover data-type="files"></th><th data-hidden></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><strong>Важная информация</strong></td><td>Эту страницу пропускать крайне не рекомендуем...</td><td></td><td></td><td><a href="/pages/TaIvNyZsb0KJJmVsg8qs">/pages/TaIvNyZsb0KJJmVsg8qs</a></td></tr><tr><td><strong>Регистрация в сервисе</strong></td><td>Без создания аккаунта - никак!</td><td></td><td></td><td><a href="/pages/bORzNWxNHJ2FTsIBfe3S">/pages/bORzNWxNHJ2FTsIBfe3S</a></td></tr><tr><td><strong>Настройка продукта</strong></td><td>Приступить к подключению сервиса</td><td></td><td></td><td><a href="/pages/Gjzcavij0n4TyaCzs9KP">/pages/Gjzcavij0n4TyaCzs9KP</a></td></tr></tbody></table>

### ... или дочитать пару коротких абзацев 😉

**aiokk** — это автоматизированная профессиональная система речевой аналитики для бизнеса, разработанная на базе технологий искусственного интеллекта.&#x20;

Название сервиса "**aiokk**" происходит от игры слов: **AI** (англ. *"искусственный интеллект"*) и **OKK** (рус. *"отдел контроля качества*), что отражает основное функциональное предназначение продукта - контроль качества телефонных коммуникаций бизнеса с применением передовых технологий на основе искусственного интеллекта.

Больше информации на нашем сайте👇

{% embed url="<https://aiokk.io/?utm_source=aiokk_gitbook>" %}

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


# Важная информация!

Эту страницу лучше не пропускать...

Чтобы наша система работала корректно, а ваши деньги работали на вас, необходимо учитывать несколько важных условий работы системы:

1. **Источник ваших звонков (CRM, отдельная телефония, самописная система и др.) должен быть в списке совместимых с нашим сервисом**, чтобы мы могли гарантировать корректную интеграцию систем между собой. Если вашей системы нет в списке доступных, но вы хотели бы, чтобы такая возможность появилась, то вы можете оставить заявку в наш технический отдел [**по этой ссылке**](https://aiokk.kz/request?utm_source=aiokk_gitbook). Мы обязательно рассмотрим ваш запрос и, по возможности, поставим его в план реализации.
2. **Ваши разговоры должны записываться в двухканальном формате.** Большинство современных телефоний поддерживает данный функционал по умолчанию - вам остается только включить его.
3. **Продукт вызывает привыкание!** Удобство использования и широкий функционал сервиса очень быстро превращают его в незаменимый инструмент помощи руководителю / аналитику / маркетологу, и приводят к повышению показателей эффективности компании уже с первых дней применения.
4. Используя наш сервис, вы **полностью соглашаетесь** с условиями нашего [**Лицензионного соглашения**](https://aiokk.io/ru/eula?utm_source=aiokk_gitbook), [**Политики конфиденциальности**](https://aiokk.io/ru/privacy?utm_source=aiokk_gitbook) и прочих официальных документов, на которые ссылаются эти документы.


# Преимущества и функции

Лучше один раз попробовать, чем несколько раз перечитать!

## Преимущества

* Автоматизированная аналитика **24/7, без перерывов, выходных и сверхурочных**.
* Простой процесс регистрации и **легкий старт**.
* **Беспристрастный** и **продуктивный** инструмент повышения прозрачности коммуникаций.
* Встроенные возможности **гибкой фильтрации** звонков перед отправкой на проверку.
* **Параллельная** обработка нескольких разговоров.
* Аналитика звонка любой длины занимает **считанные минуты**.
* ИИ со знанием отраслевых **особенностей** и возможностью **дообучения** (beta).
* Широкий набор настроек аналитики и поддержка **20+ языков**.
* **Готовые интеграции** с CRM-системами и SIP-телефониями ([**список**](/settings/datasource/podderzhivaemye-istochniki) постоянно пополняется).
* Собственная профессиональная клиентская **поддержка**.

Закажите презентацию нашего продукта для вашей компании прямо сейчас 👇

{% embed url="<https://aiokk.io/request?utm_source=aiokk_gitbook>" %}

## Функциональные возможности

Мы неустанно работаем над расширением функциональных возможностей сервиса, чтобы повышать качество результатов его работы и расширять сферы применения наших решений.&#x20;

Посмотреть актуальный список аналитических функций можно на странице "[**Состав аналитики**](/settings/analytics/sostav-analitiki#tekushii-sostav-analitiki)".

### Прочие функции, повышающие общую эффективность сервиса

<table><thead><tr><th width="205">Функция</th><th width="405">Описание</th><th>Статус</th></tr></thead><tbody><tr><td><strong>Мультисервисная авторизация</strong></td><td>Используйте аккаунт в других сервисах для создания профиля.</td><td>✅ Доступно</td></tr><tr><td><strong>Правила для индивидуальной аналитики</strong></td><td>Если источник данных поддерживает статусы сущностей, то вы можете настроить разный состав аналитики для звонков, совершенных на разных стадиях. Данный функционал имеет более высокий приоритет перед составом аналитики по умолчанию. После настройки не забудьте включить тумблер и активировать функцию.</td><td>✅ Доступно</td></tr><tr><td><strong>Исключение из аналитики</strong></td><td>Функция позволяет вручную отсеивать определенные звонки, чтобы результаты аналтики, полученные при помощи ИИ, не учитывались в отчетах и метриках. Это необходимо для повышения точности аналитики и исключения нерелевантных данных, которые могут искажать общую картину по компании / отделу / сотруднику.</td><td>✅ Доступно</td></tr><tr><td><strong>Светлая и темная тема</strong></td><td>Выбирайте между двумя режимами отображения интерфейса: с преобладанием светлых или темных тонов. Повысьте удобство работы с интерфейсом в разных условиях освещения, снизьте нагрузку на глаза и адаптируйте внешний вид сервиса под личные предпочтения.</td><td>🔧 В работе</td></tr><tr><td><strong>Многоязычный интерфейс</strong></td><td>Расширяем список доступных языков, чтобы сделать сервис удобным для пользователей по всему миру. Выберите подходящий язык в настройках профиля.</td><td>✅ Доступно<br>🔧 Добавляем</td></tr><tr><td><strong>Сводная аналитика и дашборды</strong></td><td>Инструмент для визуализации ключевых данных в удобной и наглядной форме таблиц и графиков. Отслеживайте показатели, анализируйте результаты и принимайте решения на основе актуальной информации в одном месте.<br>См. <a data-mention href="/pages/EImJt315dMsnbsMec9gh">/pages/EImJt315dMsnbsMec9gh</a> </td><td>✅ Доступно</td></tr><tr><td><strong>Переоценка</strong></td><td>Переоцените штучно или пакетно уже проанализированные звонки по другим критериям, чтобы посмотреть на один и тот же разговор с других точек зрения.</td><td>🔧 В работе</td></tr><tr><td><strong>Журналирование событий</strong></td><td>Отдельная страница для фиксации важных событий в аккаунте. </td><td>🔧 В работе</td></tr><tr><td><strong>Центр уведомлений</strong></td><td>Просматривайте все важные уведомления и обновления сервиса в одном месте. Не пропустите ничего!</td><td>🔧 В работе</td></tr><tr><td><strong>Настраиваемая таблица на главной</strong></td><td>Используйте настраиваемый состав столбцов, чтобы скрыть / отобразить те или иные столбцы и сконцентрироваться на наиболее важной информации.</td><td>✅ Доступно</td></tr><tr><td><strong>Интеграция с карточкой сущности в CRM</strong></td><td><ol><li>Возможность перейти в карточку сущности напрямую из карточки звонка в aiokk</li><li>Передача результатов аналитики напрямую в таймлайн сущности, подвязанной к разговору.</li></ol></td><td>✅ Доступно</td></tr><tr><td><strong>Уведомление в Telegram</strong></td><td>Получайте оповещения о важных результатах аналитики и ключевых событиях в аккаунте напрямую в Telegram. Удобный способ всегда оставаться в курсе событий, где бы вы ни находились.</td><td>✅ Доступно</td></tr><tr><td><strong>API для автоматического экспорта данных</strong></td><td>После завершения анализа в aiokk можно мгновенно передать результаты в Albato. Данные могут быть автоматически перенаправлены в любые подключённые сервисы и источники, что даст реальный прирост эффективности бизнеса.</td><td>✅ Доступно</td></tr></tbody></table>


# Сколько это стоит?

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

## Логика тарификации и стоимость

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

Система очень гибко настраивается, поэтому **стоимость минуты аналитики разговора зависит от заданий,** которые система должна выполнить с каждым разговором.&#x20;

<figure><img src="/files/aa22FOqmsPpRk3jLARS9" alt=""><figcaption><p>Состав аналитики по умолчанию и стоимость услуг</p></figcaption></figure>

Большинство заданий для аналитики тарифицируется по формуле **(Ц1+Ц2+ЦN)\*М,** где Ц1, Ц2 и ЦN - это цена за каждую активную задачу по аналитике, а М - это количество минут. На примере разговора длительностью 4 минуты, по которому нужно подготовить **пересказ** ($0,012/минута) и оценить удовлетворенность клиента ($0,005/минута), стоимость высчитывается как **($0,012 + $0,005) \* 4 минуты = $0,068** за весь разговор, исходя из общей цены **$0,017 за минуту** разговора.&#x20;

Есть ряд заданий, которые тарифицируются с применением повышающего коэффициента. Например, вы можете включить задачу на аналитику качества работы оператора по своим критериям, что стоит **$0.005 / критерий**. На примере того же 4-минутного разговора, к которому вы добавите оценку качества работы сотрудника по **3 критериям,** цена за минуту аналитики составит **\[$0,012 + $0,005 + ($0.005 \* 3 вопроса)] \* 4 минуты = $0,128** за весь разговор, исходя из общей цены **$0,032 за минуту** разговора.

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

## Стоимость аналитики одной минуты звонка в разных валютах

<table data-full-width="true"><thead><tr><th width="277">Задание</th><th width="100">KZT</th><th width="100">RUB</th><th width="100">USD</th><th width="100">EUR</th><th width="100">AED</th></tr></thead><tbody><tr><td><p><strong>Базовый минимум (1 мин):</strong></p><ol><li>Транскрибация диалога</li><li>Определение ролей</li><li>Фиксация перебиваний</li><li>Фиксация обоюдной тишины</li><li>Краткий пересказ разговора</li><li>Расширенная визуализация аудиозаписи</li><li>Realtime-измеритель громкости речи на записи</li></ol></td><td>5,00</td><td>1,00</td><td>0,012</td><td>0,010</td><td>0,040</td></tr><tr><td><strong>Проверка на наличие маяков (1 мин)</strong></td><td>3,00</td><td>0,60</td><td>0,007</td><td>0,006</td><td>0,024</td></tr><tr><td><strong>Оценка удовлетворенности клиента (1 мин)</strong></td><td>2,00</td><td>0,40</td><td>0,005</td><td>0,004</td><td>0,016</td></tr><tr><td><ul><li><strong>Развернутое обоснование оценки (1 мин)</strong></li></ul></td><td>3,00 </td><td>0,60</td><td>0,007</td><td>0,006</td><td>0,024</td></tr><tr><td><ul><li><strong>Рекомендации по повышению оценки (1 мин)</strong></li></ul></td><td>5,00</td><td>1,00</td><td>0,012</td><td>0,010</td><td>0,040</td></tr><tr><td><strong>Критерии оценки сотрудника (1 мин) * количество критериев</strong></td><td>2,00 </td><td>0,40</td><td>0,005</td><td>0,004</td><td>0,016</td></tr><tr><td><ul><li><strong>Развернутое обоснование оценки каждого критерия (1 мин)</strong></li></ul></td><td>3,00</td><td>0,60</td><td>0,007</td><td>0,006</td><td>0,024</td></tr><tr><td><ul><li><strong>Рекомендации по повышению общей оценки (1 мин)</strong></li></ul></td><td>2,00 </td><td>0,40</td><td>0,005</td><td>0,004</td><td>0,016</td></tr><tr><td><strong>Распознавание языков (1 мин)</strong></td><td>5,00</td><td>1,00</td><td>0,012</td><td>0,010</td><td>0,040</td></tr><tr><td><strong>Продвинутые скрипты (1 мин) * количество критериев</strong></td><td>3,00 </td><td>0,60</td><td>0,007</td><td>0,006</td><td>0,024</td></tr><tr><td><ul><li><strong>Рекомендации по повышению общей оценки (1 мин)</strong></li></ul></td><td>2,00 </td><td>0,40</td><td>0,005</td><td>0,004</td><td>0,016</td></tr><tr><td><strong>Маркеры (1 мин)</strong></td><td>1,00</td><td>0,20</td><td>0,003</td><td>0,002</td><td>0,012</td></tr></tbody></table>

{% hint style="danger" %}
Таблица цен носит справочный характер и может отличаться от цен, указанных в вашем личном кабинете. В случае разночтений **стоимость аналитики внутри личного кабинета имеет приоритет перед данной таблицей.**
{% endhint %}

{% hint style="warning" %}
Валюта биллинга и выставления счетов выбирается однократно при первичной регистрации аккаунта и не может быть изменена в дальнейшем.
{% endhint %}

Для вашего удобства мы разработали [**Бюджетный калькулятор**](/finances/budgeting), который поможет спрогнозировать затраты на аналитику на основе расчетов по наиболее частым каомбинациям заданий аналитики. Открывайте скорее! 👇

{% content-ref url="/pages/anbhCJptfaAHB0gttwe8" %}
[Бюджетирование](/finances/budgeting)
{% endcontent-ref %}

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

После проведения аналитики, внутри карточки разговора вам также становится доступна вкладка "[**Бюджетирование**](/finances/budgeting)", где приведенные выше расчеты показываются применительно к каждому конкретному звонку.


# Частые вопросы

<details>

<summary></summary>

</details>


# История обновлений

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

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

{% embed url="<https://aiokk.io/request?utm_source=aiokk_gitbook>" %}

## 2025

### Накопительный  отчет по релизам за первое полугодие

#### Что добавили

1. Доработали [**карточку звонка**](/glavnaya-stranica/kartochka-razgovora), добавив углубленную аналитику разговора:
   1. подсчет перебиваний с привязкой к тайм-коду;
   2. фиксация обоюдной тишины с привязкой к тайм-коду;
   3. контроль громкости речи;
   4. дополнительные элементы управления таймлайном.
2. Реализовали [**интеграцию с Telegram**](/integrations/telegram-uvedomleniya) для получения ключевых уведомлений.
3. Разработали [**внешнюю интеграцию с Albato**](/integrations/api-dlya-eksporta/albato), повысив ценность нашей аналитики и предоставив возможность нашим пользователям углублять внедрение aiokk в свои маркетинговые, учебные, операционные и иные процессы.
4. Разработали функционал [**нетиповых сценариев фильтрации**](/settings/analytics/rules#netipovye-pravila) для клиентов, которым не достаточно стандартных условий фильтрации и возможностей постобработки.
5. Дашборды с плавающими показателями на [**главной странице**](/glavnaya-stranica/osnovnaya-tablica), отображающие 4 ключевые метрики аккаунта по дням: проанализированные звонки, количество проанализированных минут, уникальные абоненты, расходы.
6. Интеграция с [**дашбордами**](/analitika/rasshirennye-dashbordy) Microsoft Power BI.

#### Что доработали / переделали

1. Упростили процесс [**онбординга**](/nachalo-raboty/registraciya-i-onbording), добавив **чек-лист для помощи** и **сократив количество вопросов** в анкете при первом входе.
2. Доработали **вид** [**карточки звонка**](/glavnaya-stranica/kartochka-razgovora)**:** удобные сайдбары с информацией и больше полезного пространства в основной части окна.
3. Повысили количество активных стандартных [**правил**](/settings/analytics/rules#obshie-svedeniya) до **100**.

### Накопительный  отчет по релизам за второе полугодие

#### Что добавили

1. [**Расширенные скрипты**](/settings/scripts) теперь доступны всем клиентам. Построение скриптов выходит на качественно новый уровень.
2. [**Ролевая модель доступов**](/settings/access_policy). Востребованная функция для крупных и энтерпраайз клиентов, желающих предоставлять доступ к личному кабинету нескольким сотрудникам, при этом разграничивать контент и возможности внутри.
3. [**Кастомизация аналитики.**](/settings/analytics/custom_analytics) Получите больше аналитических возможностей внутри нашего продукта.

## 2024

### 30.11.2024 (большой касдев №1)

#### Что добавили

1. В [**карточке звонка**](/glavnaya-stranica/kartochka-razgovora#obshaya-informaciya) появились новые элементы (сценарий; дата проведения аналитики).
2. Большой пакет изменений для [**правил**](/settings/analytics/rules):

* В списке действий внутри правила появилась опция "**Игнорировать и ничего не делать**". Не тратьте лишнее, если этот разговор подходит под критерии фильтрации, но не нуждается в проведении анализа.
* При настройке правила теперь сразу видно **стоимость минуты аналитики** по этому сценарию.
* Добавили функцию [**архивирования**](/settings/analytics/rules#udalenie-arkhivirovanie-i-vosstanovlenie-pravil) правил. Не теряйте исторические данные и работайте с правилами даже после потери их отключения.

3. Добавили функцию [**отложенного старта**](/settings/analytics#otlozhennyi-start) для запуска аналитики.

#### Что доработали / переделали&#x20;

1. Повысили максимальное количество знаков для каждого вопроса **с 140 до 200 символов**, чтобы вы могли составлять более ёмкие и правильные формулировки в своих наборах вопросов. Это ожидаемо должно будет повысить качество оценки.
2. Внесли косметические изменения в [**главную таблицу**](/glavnaya-stranica/osnovnaya-tablica)**:**

* отображение процентной величины на основе оценки по набору вопросов;&#x20;
* выделили стоимость аналитики в отдельный столбец;&#x20;
* добавили столбец c ID звонка;&#x20;
* передвинули кнопки управления звонком в начало таблицы;

3. Внесли косметические изменения в [**карточку разговора**](/glavnaya-stranica/kartochka-razgovora)**:**

* показываем напротив номера направление звонка;&#x20;
* на вкладке с оценкой показываем % качества вместо цифровой оценки;
* в заголовке вкладки "Удовлетворенность клиента" показываем оценку.&#x20;

Если вы дочитали до конца и у вас остались вопросы / запросы / предложения, пишите нам скорее 👇

{% embed url="<https://aiokk.io/request?utm_source=aiokk_gitbook>" %}


# Команда

**MASNAGET** — компания - разработчик инновационных IT-решений, направленных на автоматизацию и повышение эффективности бизнес-процессов. C **2015 года** мы создаем и интегрируем современные продукты, которые помогают компаниям достигать поставленных целей в автоматизации продаж и маркетинга, оставаясь при этом надежным технологическим партнером, которому доверяют.

{% embed url="<https://masnaget.digital/?utm_source=aiokk_gitbook>" %}
Перейти на сайт компании
{% endembed %}

Если вы хотите оставить заявку по нашему продукту, напишите нам 👇

{% embed url="<https://aiokk.io/request?utm_source=aiokk_gitbook>" %}

Если вы хотите стать часть истории успеха нашей команды, то заявите о себе! Мы всегда рады принять в свои ряды "заряженных" и высокоэффективных профессионалов!

{% embed url="<https://astana.hh.kz/employer/3541099>" %}
Откыть список вакансий на hh
{% endembed %}


# Контакты

**По вопросам сотрудничества:** <info@aiokk.team>

**Связь с CEO и основателем сервиса:** <ceo@aiokk.team>

**Для инвесторов, хабов и акселераторов:** <takemymoney@aiokk.team>

**Резюме, поиск работы:** [проверяйте на hh.kz](https://astana.hh.kz/employer/3541099)


# Регистрация и онбординг

Если вам потребуется помощь в настройке и внедрении продукта, напишите нам 👇

{% embed url="<https://aiokk.io/request?utm_source=aiokk_gitbook>" %}

## Процесс регистрации

{% stepper %}
{% step %}

### Укажите первичные данные для регистрации

1. Откройте в браузере страницу [**https://my.aiokk.io**](https://my.aiokk.io/signup?utm_source=aiokk_gitbook)
2. Укажите электронную почту, введите пароль и подтверждение пароля, соответствующие требованиям безопасности, чтобы перейти к следующему шагу.&#x20;
3. Если у вас имеется *промокод*, введите его сразу при регистрации. Ваш бонус будет начислен после подтверждения почты.

<img src="/files/qP1bWsHhVYKhkj8qLv5w" alt="" data-size="original">
{% endstep %}

{% step %}

### Укажите страну и примите условия сервиса

<img src="/files/cD89aGKGq0f4tbmNYGZ9" alt="" data-size="original">

После этого, в течение нескольких минут мы вышлем вам на почту письмо с ссылкой на подтверждение аккаунта.
{% endstep %}

{% step %}

### Подтвердите учетную запись

Перейдите по ссылке в письме, чтобы активировать аккаунт и получить доступ к личному кабинету.
{% endstep %}

{% step %}

### Авторизуйтесь в новосозданной учетной записи

Введите логин и пароль, указанные при регистрации, и нажмите кнопку "Войти".
{% endstep %}

{% step %}

### Заполните базовые данные и маркетинговую информацию

Заполните запрашиваемые сведения, чтобы мы произвели предварительную подготовку аккаунта. **Внимание:** после закрытия данного окна вам в дальнейшем будут доступны для [**редактирования**](/settings/profile) только часовой пояс и язык результатов аналитики.

<img src="/files/aUtyD54jnUvY1bXmjK5s" alt="" data-size="original">
{% endstep %}

{% step %}

### Верифицируйте свой телефон с Whatsapp

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

<img src="/files/rgg097MAuQwtobpr0Vwx" alt="" data-size="original">

<mark style="background-color:$primary;">**Если в течение 7 дней с получения приветственного бонуса не подключить источник данных и не запустить аналитику звонков или не пополнить баланс личного кабинета, то приветственный бонус будет обнулён.**</mark>
{% endstep %}

{% step %}

### Пройдите короткое пошаговое ознакомление с сервисом

Пройдите технический онбординг, чтобы ознакомиться с функциональными возможностями системы и этапами ее настройки.
{% endstep %}

{% step %}

### Приступите к настройке системы

Вот теперь точно можно начинать работу!
{% endstep %}
{% endstepper %}


# Промокоды

Активируйте промокод [**во время регистрации**](/nachalo-raboty/registraciya-i-onbording) аккаунта, чтобы получить дополнительные бонусы в системе.

{% hint style="warning" %}
**Внимание!** Для одного аккаунта может быть применен только один промокод.
{% endhint %}

## Последовательность шагов для получения бонуса по промокоду

1. Указать действующий промокод при регистрации стандартным через email (сторонние сервисы авторизации не допускаются).
2. Подтвердить свою электронную почту по ссылке из письма, отправленного почтовый ящик, указанный вами при регистрации.
3. Авторизоваться в новосозданной учетной записи.
4. Заполнить первые анкетные данные

   <figure><img src="/files/aUtyD54jnUvY1bXmjK5s" alt=""><figcaption></figcaption></figure>
5. Получить повышенный бонус. Размер бонуса зависит от конкретного промокода.

   <figure><img src="/files/JZl3mQy27FgFKw4iewfq" alt=""><figcaption><p>Пример повышенного бонуса при активации промокода соответствующего номинала</p></figcaption></figure>

## Условия активации промокодов

1. **Ограничение по крайнему сроку активации.** Если не активировать промокод в рамках выделенного срока, то его действие "сгорает".
2. **Ограничение по общему количеству.** Некоторые промокоды могут быть выпущены в ограниченном количестве. Например 100 штук. Это означает, что данный код можно активировать максимум на 100 аккаунтах.
3. **Ограничение по крайнему сроку и общему количеству.** Для особенных случаев могут быть выпущены промокоды повышенного спроса, которые нужно не только активировать в рамках обозначенного срока, но и быть в числе того количества аккаунтов, которое предусмотрено условиями промокода.

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

Полученные средства вы можете использовать для аналитики большего количества минут телефонных разговоров в нашей системе. Для прогнозирования будущих расходов и планирования бюджета вы можете воспользоваться [**бюджетным калькулятором**](/finances/budgeting).

<mark style="background-color:$primary;">**Если в течение 7 дней с активации промокода не подключить источник данных и не запустить аналитику звонков или не пополнить баланс личного кабинета, то номинал промокода будет обнулён.**</mark>


# Источники данных

<mark style="background-color:red;">Перед началом работы с системой, пожалуйста, ознакомьтесь с разделом</mark> <mark style="background-color:red;"></mark><mark style="background-color:red;">**"**</mark>[<mark style="background-color:red;">**Важная информация**</mark>](/aiokk/vazhnaya-informaciya)<mark style="background-color:red;">**",**</mark> <mark style="background-color:red;"></mark><mark style="background-color:red;">если вы еще этого не сделали.</mark>

{% content-ref url="/pages/TaIvNyZsb0KJJmVsg8qs" %}
[Важная информация!](/aiokk/vazhnaya-informaciya)
{% endcontent-ref %}

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

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

## ❗️❗️❗️Важно знать перед подключением!

Каждый из перечисленных ниже источников имеет свои особенности, ограничения и уникальные возможности при интеграции с нашей системой.&#x20;

{% hint style="info" %}
В зависимости от подключенного источника данных, **некоторые функции в aiokk могут быть недоступны.**
{% endhint %}

{% hint style="warning" %}
После подключения одного источника данных и анализа **хотя бы одного разговора**, вы в дальнейшем **не сможете в этот же аккаунт подключить другой тип источника или другой источник того же типа**.&#x20;

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

Это ограничение введено для того, чтобы сохранить единообразие данных и не допустить в них путаницы и коллизий.&#x20;
{% endhint %}

{% hint style="danger" %}
Один и тот же домен **не может быть подключен к двум разным аккаунтам**.

Например, у вас есть **портал Битрикс24 с доменом domain.bitrix24.com**, подключенный к аккаунту **<1@mail.ru>**, в таком случае портал Битрикс24 с доменом domain.bitrix24.com **нельзя будет подключить к другому аккаунту** в нашем сервисе, пока в аккаунте <1@mail.ru> не будет **разорвана связь** с этим источником данных.
{% endhint %}


# Поддерживаемые источники

На данный момент список поддерживаемых нами источников выглядит так

## Источники, уже доступные в системе

### CRM-системы

<table data-view="cards"><thead><tr><th></th><th data-hidden data-card-target data-type="content-ref"></th><th data-hidden data-card-cover data-type="files"></th></tr></thead><tbody><tr><td><p><strong>Битрикс24</strong></p><p>Поддержка правил: <strong>ДА</strong></p><p></p><p>Перейти к инструкции</p></td><td><a href="/pages/ELV9KnspfBx9KmTIBfSx">/pages/ELV9KnspfBx9KmTIBfSx</a></td><td><a href="/files/8lp7XRwJVEjuiDBSiLYH">/files/8lp7XRwJVEjuiDBSiLYH</a></td></tr><tr><td><p><strong>amoCRM / Kommo</strong></p><p>Поддержка правил: <strong>ДА</strong></p><p></p><p>Перейти к инструкции</p></td><td><a href="/pages/JtI1yu0dtP3UPlgesvF0">/pages/JtI1yu0dtP3UPlgesvF0</a></td><td><a href="/files/O1y6ScJmWbKKLEpdVGrZ">/files/O1y6ScJmWbKKLEpdVGrZ</a></td></tr></tbody></table>

### Виртуальные телефонии

<table data-view="cards"><thead><tr><th></th><th data-hidden data-card-target data-type="content-ref"></th><th data-hidden data-card-cover data-type="files"></th></tr></thead><tbody><tr><td><p><strong>SipUni</strong></p><p>Поддержка правил: <strong>НЕТ</strong></p><p></p><p>Перейти к инструкции</p></td><td><a href="/pages/yVJ9Vk3jH9HXtMKv6oTj">/pages/yVJ9Vk3jH9HXtMKv6oTj</a></td><td><a href="/files/60bsJC7MyDgsSiGzpP3x">/files/60bsJC7MyDgsSiGzpP3x</a></td></tr><tr><td><p><strong>Online PBX</strong></p><p>Поддержка правил: <strong>НЕТ</strong></p><p></p><p>Перейти к инструкции</p></td><td><a href="/pages/kZ7o3n7nVZeZMv1IXwrr">/pages/kZ7o3n7nVZeZMv1IXwrr</a></td><td><a href="/files/dgc9B5oXbkWcEgMJCzo0">/files/dgc9B5oXbkWcEgMJCzo0</a></td></tr></tbody></table>

### Универсальный вебхук

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

<table data-view="cards"><thead><tr><th></th><th data-hidden data-card-cover data-type="files"></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td>Перейти к инструкции</td><td><a href="/files/dqLv2hFbcAFBbF6zuGS4">/files/dqLv2hFbcAFBbF6zuGS4</a></td><td><a href="/pages/BXZ5aUFibAqXX9ypmYj3">/pages/BXZ5aUFibAqXX9ypmYj3</a></td></tr></tbody></table>

## Интеграция с новыми источниками

Мы постоянно работаем над расширением списка поддерживаемых источников данных, с которыми можно было бы интегрировать aiokk.&#x20;

Если вашей системы нет в списке поддерживаемых источников данных, но вы хотели бы, чтобы такая возможность появилась, то вы можете оставить заявку в наш технический отдел 👇

{% embed url="<https://aiokk.kz/request?utm_source=aiokk_gitbook>" %}

Мы обязательно рассмотрим ваш запрос и, по возможности, поставим его в план реализации.


# CRM-системы

<table data-view="cards"><thead><tr><th></th><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th><th data-hidden data-card-cover data-type="files"></th></tr></thead><tbody><tr><td><p><strong>Битрикс24</strong></p><p>Поддержка правил: <strong>ДА</strong></p><p></p><p>Перейти к инструкции</p></td><td></td><td></td><td><a href="/pages/ELV9KnspfBx9KmTIBfSx">/pages/ELV9KnspfBx9KmTIBfSx</a></td><td><a href="/files/8lp7XRwJVEjuiDBSiLYH">/files/8lp7XRwJVEjuiDBSiLYH</a></td></tr><tr><td><p><strong>amoCRM</strong></p><p>Поддержка правил: <strong>ДА</strong></p><p></p><p>Перейти к инструкции</p></td><td></td><td></td><td><a href="/pages/JtI1yu0dtP3UPlgesvF0">/pages/JtI1yu0dtP3UPlgesvF0</a></td><td><a href="/files/O1y6ScJmWbKKLEpdVGrZ">/files/O1y6ScJmWbKKLEpdVGrZ</a></td></tr></tbody></table>


# Битрикс24

## Условия успешного подключения

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

1. У вас должен **активный портал Битрикс24.** Облачный или коробочный - значения не имеет.&#x20;
   1. Если у вас всё еще нет своего Битрикс24, то исправить это досадное недоразумение можно, [**зарегистрировав свой облачный Битрикс24**](https://www.bitrix24.kz/create.php?p=8068335\&utm_source=aiokk_gitbook). Если вы хотите развернуть коробку, то команда MASNAGET Digital Studio поможет вам и в этом. Просто оставьте заявку [**на нашем сайте**](https://masnaget.digital/bitrix24.html?utm_source=aiokk.gitbook)!
   2. Если у вас **коробочный Битрикс24,** то убедитесь дополнительно, что у вас есть **активная подписка** и ваш портал **имеет выход в интернет**, а не работает в закрытом контуре.
2. У вас должно **быть право на установку приложений из Маркета**.
3. У вас должен быть зарегистрированный **аккаунт aiokk.** Если аккаунта нет, то создайте учетную запись согласно инструкции 👇

{% content-ref url="/pages/bORzNWxNHJ2FTsIBfe3S" %}
[Регистрация и онбординг](/nachalo-raboty/registraciya-i-onbording)
{% endcontent-ref %}

## Порядок действий при установке приложения

{% stepper %}
{% step %}

### Выберите "Битрикс24" в качестве источника данных

<figure><img src="/files/gju0oJQk572WpYVtO3YM" alt=""><figcaption><p>Процесс подключения портала  Битрикс24</p></figcaption></figure>

1. Откройте раздел **Настройки → Источник данных.**
2. Выберите **Битрикс24** из доступного списка источников.
3. Укажите в соответствующем поле **существующий домен** вашего Битрикс24.

4.1. Если у вас **облачный** портал Битрикс24, то нажмите на кнопку "**Далее**" и затем нажмите на кнопку "**Установить связь**".

4.2. Если вы используете **коробочный** портал Битрикс24, то после нажатия кнопки "**Далее**" необходимо будет дополнительно указать **страну лицензирования вашего портала**, чтобы мы смогли направить вас на страницу нашего приложения в Маркете Битрикс24 вашего региона. После повторного нажатия на кнопку "**Далее**" нажмите на кнопку "**Установить связь**".

<figure><img src="/files/PipbOhCuHCzoaVFypcuZ" alt=""><figcaption><p>Процесс подключения к коробочному порталу Битрикс24</p></figcaption></figure>
{% endstep %}

{% step %}

### Установите приложение aiokk из маркета Битрикс24

1. Мы проверим корректность вашего домена Битрикс24 и **откроем** вам этот портал в текущем окне браузера.
2. Если потребуется, **авторизуйтесь** на портале. Если вы уже авторизованы, то сразу откроется **страница приложения aiokk в Маркете Битрикс24**.
3. На открывшейся странице приложения aiokk в Маркете Битрикс24 нажмите на кнопку "**Установить**", ознакомьтесь и примите условия документов, повторно нажмите кнопку "**Установить**".

<img src="/files/45VKVwKLggBolVBIW2gT" alt="" data-size="original">

4. Откройте только что установленное приложение aiokk, нажав на кнопку "**Открыть приложение**" в окне установки или перезагрузив страницу и перейдя в него из левого меню.
   {% endstep %}

{% step %}

### Установите связь с аккаунтом

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

<img src="/files/L2YOdA3FxLHJLq9dWZS5" alt="" data-size="original">

3. Отлично! Источник данных подключен. Возвращайтесь в личный кабинет нашего сервиса и продолжите настройку.
   {% endstep %}
   {% endstepper %}


# amoCRM / kommo

Процесс подключения aiokk идентичный для amoCRM и Kommo

## Условия успешного подключения

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

1. У вас должен **активный портал amoCRM.**
2. У вас должно **быть право на установку приложений из amoMarket**.
3. У вас должен быть зарегистрированный **аккаунт aiokk.** Если аккаунта нет, то создайте учетную запись согласно инструкции 👇

{% content-ref url="/pages/bORzNWxNHJ2FTsIBfe3S" %}
[Регистрация и онбординг](/nachalo-raboty/registraciya-i-onbording)
{% endcontent-ref %}

## Процесс подключения

### Выберите "amoCRM" в качестве источника данных

<figure><img src="/files/KyIF3NMTAkRZahGQhSak" alt=""><figcaption></figcaption></figure>

1. Откройте раздел **Настройки → Источник данных.**
2. Выберите **amoCRM** из доступного списка источников.
3. Укажите в соответствующем поле **существующий домен** вашего amoCRM.
4. Нажмите на кнопку "**Установить связь**".
5. Если всё сделано правильно, то вы увидите инструкцию для дальнейших шагов на стороне amoCRM. Следуйте ей.

<figure><img src="/files/tf68lQDPTLUMnazYxkr7" alt=""><figcaption><p>Промежуточное состояние подключения на стороне aiokk</p></figcaption></figure>

На этом этапе статус подключения временно будет "**Не подключено**".

### Установите приложение aiokk из amoMarket

1. Перейдите в аmоМагket.
2. Найдите приложение "**aiokk | Профессиональная речевая аналитика на базе ИИ**", воспользовавшись поисковой строкой в Маркете или перейдя в раздел "**Аналитика**" внутри Маркета.
3. Поставьте галочку согласия с условиями Политики и нажмите на кнопку "**Внешняя оплата**" в карточке приложения. *Приложение устанавливается бесплатно, никаких списаний произведено не будет.*
4. Зайдите в только что установленное приложение aiokk в вашем аккаунте аmоСRМ. Если шаги выполнены по инструкции, то в приложении в правом верхнем углу вы увидите **логин** своего аккаунта aiokk.

<figure><img src="/files/L2YOdA3FxLHJLq9dWZS5" alt=""><figcaption><p>Интерфейс aiokk внутри amoCRM</p></figcaption></figure>

5. Вернитесь в раздел "**Настройки → Источник данных**" и обновите страницу. Статус подключения сменится на "**Подключено**". Готово, процесс установки связи завершен!
6. Отлично! Источник данных успешно подключен. Можно перейти к следующим шагам настройки кабинета.

{% content-ref url="/pages/ClEOOFYxUbrxxDLZBLIX" %}
[Фильтрация](/settings/filtraciya)
{% endcontent-ref %}


# SIP-телефонии

<table data-view="cards"><thead><tr><th></th><th></th><th></th><th data-hidden data-card-cover data-type="files"></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><p><strong>SipUni</strong></p><p>Поддержка правил: <strong>НЕТ</strong></p><p></p><p>Перейти к инструкции</p></td><td></td><td></td><td><a href="/files/60bsJC7MyDgsSiGzpP3x">/files/60bsJC7MyDgsSiGzpP3x</a></td><td><a href="/pages/yVJ9Vk3jH9HXtMKv6oTj">/pages/yVJ9Vk3jH9HXtMKv6oTj</a></td></tr><tr><td><p><strong>Online PBX</strong></p><p>Поддержка правил: <strong>НЕТ</strong></p><p></p><p>Перейти к инструкции</p></td><td></td><td></td><td><a href="/files/dgc9B5oXbkWcEgMJCzo0">/files/dgc9B5oXbkWcEgMJCzo0</a></td><td><a href="/pages/kZ7o3n7nVZeZMv1IXwrr">/pages/kZ7o3n7nVZeZMv1IXwrr</a></td></tr></tbody></table>


# SipUni

Материал дополняется...

**Документация в разработке. Скоро тут появится ценная информация 🤗**


# Online PBX

Материал дополняется...

**Документация в разработке. Скоро тут появится ценная информация 🤗**


# Универсальный вебхук

Подключите к aiokk свою систему, если для нее нет готово коннектора в списке наших интеграций.

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

> **Вебхук** – это способ автоматического обмена информацией между системами. Он позволяет одной системе (например, вашей базе данных / телефонии / ERP- или CRM-системе) отправлять данные в другую систему (например, в aiokk) сразу же, как только происходит какое-то событие. В нашем случае таким событием должно быть *завершение* *телефонного звонка*.

## Как это работает

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

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

### Первичная настройка

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

<figure><img src="/files/udPxkJjYttZlTCiDCdRa" alt=""><figcaption><p>Активация вебхука в разделе Настройки → Источники даных</p></figcaption></figure>

1. В разделе **Настройки → Источник данных** выберите в качестве источника **Универсальный вебхук**.
2. Активируйте вебхук
3. Убедитесь, что вебхук был активирован. Соответствующее состояние будет отображено рядом с заголовком страницы.

<figure><img src="/files/rFCfJgiyg5uYmDPBNCkR" alt=""><figcaption></figcaption></figure>

4. Скопируйте **токен**, который далее будете использовать для формирования ссылки для POST-запросов.

{% hint style="warning" %}
**Внимание!**&#x20;

1. Доступ к данным внутри вашего кабинета обеспечивается посредством верификации через уникальный токен, видимы только в вашем личном кабинете. Никогда не передавайте токен третьим лицам!
2. Техническая поддержка **никогда не будет запрашивать токен** вашей учетной записи!
   {% endhint %}

### Смена токена

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

<figure><img src="/files/c79vl0sUqCFiXgxG1Ak4" alt=""><figcaption><p>Кнопка перегенерации токена доступа</p></figcaption></figure>

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

{% hint style="danger" %}
**Очень важно!** Если вы ранее задействовали старый токен в своих запросах, то после перегенерации токена **вебхуки со старым токеном перестанут работать**, и для восстановления работоспособности вебхука вам нужно будет **самостоятельно заменить старый токен на новый** во всех сценариях, где был задействован старый вебхук, т.к. вебхуки с недействительным токеном перестанут работать, получая в ответе статус 401 (см. подробнее [**тут**](#otvet-na-zapros-tbd)).
{% endhint %}

### Отключение вебхука

В разделе **Настройки → Источник данных** нажмите на кнопку "Отключить вебхук", если хотите разорвать соединение aiokk c вашим источником данных. Запросы, отправляемые после отключения вебхука, будут завершаться со статусом 403 (подробности см.[ **тут**](#otvet-na-zapros-tbd)), новые данные не будут попадать в личный кабинет, аналитика новых звонков производиться не будет.

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

## Составляем запрос

<mark style="color:green;">`POST`</mark> **`https://my.aiokk.{domain_zone}/api/v1/{token}/call/new`**

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

### Подготовка ссылки эндпоинта

Для подготовки корректной ссылки эндпоинта вам необходимо подставить в приведенный выше URL `https://my.aiokk.{domain_zone}/api/v1/{token}/call/new` две переменные:

1. **<https://my.aiokk.{domain\\_zone}>** - соответствует доменной зоне, на которой зарегистрирован ваш кабинет aiokk. Чтобы уточнить вашу доменную зону, авторизуйтесь в своём личном кабинете aiokk и проверьте домен в адресной строке вашего браузера.

   <figure><img src="/files/UvWNfpV8nbuj0HnmiGQs" alt=""><figcaption><p>Проверка доменной зоны аккаунта aiokk</p></figcaption></figure>

   В данном конкретном примере, доменная зона - **kz**
2. **{token} -** уникальный токен доступа, видимый только в вашем личном кабинете на странице **"Настройки → Источник данных"** при выборе **вебхука** в качестве источника.

### **Заголовки**

<table data-full-width="false"><thead><tr><th>Заголовок</th><th>Значение</th></tr></thead><tbody><tr><td>Content-Type</td><td><code>application/json</code></td></tr></tbody></table>

### **Тело запроса**

Тело запроса представляет собой JSON-объект с тремя основными блоками: **call, employee и analytics.**

**Блок "call"**

<table data-full-width="false"><thead><tr><th>Поле</th><th>Тип</th><th>Обязательность</th><th>Описание</th></tr></thead><tbody><tr><td><strong>uid</strong></td><td>string</td><td>❌ Нет</td><td>Уникальный идентификатор вызова</td></tr><tr><td><strong>phone</strong></td><td>string</td><td>✅ Да</td><td>Номер телефона абонента в международном формате (например, +77771112233)</td></tr><tr><td><strong>duration</strong></td><td>int</td><td>✅ Да</td><td>Длительность звонка в секундах (поддерживается перевод string в integer) </td></tr><tr><td><strong>date</strong></td><td>datetime with timezone</td><td>✅ Да</td><td>Дата и время звонка в формате ISO 8601 (например, 2024-12-15T12:25:41+03:00)</td></tr><tr><td><strong>type</strong></td><td>int</td><td>✅ Да</td><td>Тип звонка: <br>1 - Исходящий, <br>2 - Входящий,<br>3 - Входящий с переадресацией<br>4 - Обратный вызов<br>(поддерживается перевод string в integer) </td></tr><tr><td><strong>url</strong></td><td>string</td><td>✅ Да</td><td>Ссылка на запись звонка</td></tr><tr><td><strong>extNumber</strong></td><td>string</td><td>❌ Нет</td><td>Внешний номер, на который поступил звонок</td></tr><tr><td><strong>ownerBacklink</strong></td><td>string</td><td>❌ Нет</td><td>Ссылка на сущность в вашей системе, к которой подвязан звонок <em>(используется для быстрого перехода из карточки звонка)</em></td></tr></tbody></table>

**Блок "employee"**

<table data-full-width="false"><thead><tr><th>Поле</th><th>Тип</th><th>Обязательность</th><th>Описание</th></tr></thead><tbody><tr><td><strong>id</strong></td><td>string</td><td>❌ Нет</td><td>Идентификатор сотрудника</td></tr><tr><td><strong>fullName</strong></td><td>string</td><td>✅ Да</td><td>Полное имя сотрудника</td></tr><tr><td><strong>intNum</strong></td><td>int</td><td>❌ Нет</td><td>Внутренний номер сотрудника</td></tr><tr><td><strong>departmentId</strong></td><td>string</td><td>❌ Нет</td><td>Идентификатор отдела, в котором работает сотрудник</td></tr><tr><td><strong>departmentName</strong></td><td>string</td><td>✅ Да</td><td>Название отдела, в котором работает сотрудник</td></tr></tbody></table>

**Блок "analytics"**

<table data-full-width="false"><thead><tr><th>Поле</th><th width="100">Тип</th><th>Обязательность</th><th>Описание</th></tr></thead><tbody><tr><td><strong>summary</strong></td><td>boolean</td><td>❌ Нет</td><td>Пересказ текста <em>(по умолчанию true)</em>. Используйте этот параметр <strong>только самостоятельно без других заданий на аналитику</strong>, если вам требуется исключительно пересказ звонка. Во всех остальных случаях значение параметра будет проигнорировано и по умолчанию будет принято значение <em>true.</em></td></tr><tr><td><strong>language</strong></td><td>boolean</td><td>❌ Нет</td><td>Определять применяемые языки <em>(по умолчанию false)</em></td></tr><tr><td><strong>customerSatisfaction</strong></td><td>object</td><td>❌ Нет</td><td>Блок задач на определение удовлетворенности клиента <em>(по умолчанию не задействован)</em></td></tr><tr><td><strong>→ assessment</strong></td><td>boolean</td><td>☝️Условно необязательное</td><td>Оценка удовлетворенности клиента <em>(если false, то motivation и recommendation не могут быть true)</em></td></tr><tr><td><strong>→ motivation</strong></td><td>boolean</td><td>☝️Условно необязательное</td><td>Развернутое обоснование оценки удовлетворенности клиента <em>(может быть true, только если assessment - true)</em></td></tr><tr><td><strong>→ recommendation</strong></td><td>boolean</td><td>☝️Условно необязательное</td><td>Рекомендации по повышению оценки удовлетворенности клиента <em>(может быть true, только если assessment - true)</em></td></tr><tr><td><strong>evaluationCriteria</strong></td><td>object</td><td>❌ Нет</td><td>Блок задач на оценку сотрудника по своим критериям <em>(по умолчанию не задействован)</em></td></tr><tr><td><strong>→ questionPack</strong></td><td>int</td><td>☝️Условно необязательное</td><td>Идентификатор набора вопросов для оценки сотрудника <em>(если false, то motivation и recommendation не могут быть true)</em></td></tr><tr><td><strong>→ motivation</strong></td><td>boolean</td><td>☝️Условно необязательное</td><td>Развернутое обоснование оценки по каждому критерию оценки <em>(может быть true, только если assessment - true)</em></td></tr><tr><td><strong>→ recommendation</strong></td><td>boolean</td><td>☝️Условно необязательное</td><td>Рекомендации по повышению оценки удовлетворенности клиента <em>(может быть true, только если assessment - true)</em></td></tr><tr><td><strong>signals</strong></td><td>int</td><td>❌ Нет</td><td>Идентификатор набора маяков для проверки на наличие в разговоре</td></tr><tr><td><strong>scripts</strong></td><td>int</td><td>❌ Нет</td><td>Идентификатор скрипта, на соответствие которому необходимо оценить разговор <em>(скоро)</em></td></tr><tr><td><strong>markers</strong></td><td>boolean</td><td>❌ Нет</td><td>Маркировка звонка тегами из заданного списка на основе содержания разговора</td></tr></tbody></table>

{% hint style="danger" %}
**Обратите внимание!** В блоке "analytics" не упоминается параметр, отвечающий за пересказ содержимого звонка, т.к. задание пересказа добавляется к любому составу аналитики **по умолчанию.** То есть, даже если в составе аналитики не будет указано ни одно задание, **пересказ будет произведен в любом случае.**
{% endhint %}

{% hint style="warning" %}
Оставьте массив **analytics{}** полностью пустым, если хотите запросить аналитику по стандартному составу аналитики, настроенному на стороне личного кабинета aiokk.
{% endhint %}

### **Пример запроса**

{% code title="Тело POST-запроса" overflow="wrap" fullWidth="false" %}

```json
{
    "call": {
        "uid": "abcd1234567890asdasdfsdf1231232123123", // Уникальный идентификатор вызова
        "phone": "+77771112233", // Номер телефона абонента в международном формате
        "duration": 78, // Длительность звонка в секундах
        "date": "2024-12-15T12:25:41+03:00", // Дата и время звонка с часовым поясом
        "type": 2, // Тип звонка
        "url": "https://source.to/your/audio.mp3" // Ссылка на запись звонка
        "extNumber": "88001119900", // Внешний номер, на который поступил звонок
        "ownerBacklink": "https://source.to/owner" // Ссылка на сущность в вашей системе, к которой подвязан звонок 
    },
    "employee": {
        "id": "123", // Идентификатор сотрудника
        "fullName": "Иван Иванов", // Полное имя сотрудника
        "intNum": "1309", // Внутренний номер сотрудника
        "departmentId": "98", // Идентификатор отдела, в котором работает сотрудник
        "departmentName": "Отдел продаж" // Название отдела сотрудника
    }, 
    "analytics": {
        "language": false, // Определять применяемые языки
        "customerSatisfaction":{
            "assessment": true, // Оценка удовлетворенности клиента
            "motivation": false, // Развернутое обоснование оценки удовлетворенности клиента
            "recommendation": true, // Рекомендации по повышению оценки удовлетворенности клиента
        },
        "evaluationCriteria": {
            "questionPack": 123, // Идентификатор набора вопросов для оценки сотрудника
            "motivation": true, // Развернутое обоснование оценки по каждому критерию оценки
            "recommendation": false, // Рекомендации по повышению оценки удовлетворенности клиента
        }, 
        "signals": 21, // Идентификатор набора маяков для проверки на наличие в разговоре
        "scripts": 55,  // Идентификатор скрипта, на соответствие которому необходимо оценить разговор
        "markers": true,  // Тематические маркеры на основе содержания звонка
    }
}
```

{% endcode %}

## **Ответ на запрос**

В результате выполнения запроса, вы получите ответ от нашей системы. Содержимое ответа может быть разным, в зависимости от статуса и результата проверки тела запроса. Ниже приведены варианты статусов, с которыми может завершиться запрос. Помимо общего статуса, в параметре "message" может прийти дополнительная полезная информация с кодами. Расшифровку кодов и пути решения ошибок вы можете получить ниже в [**Справочнике**](#spravochnik-kodov-oshibok-i-preduprezhdenii).

{% tabs %}
{% tab title="200" %}

```json
{
    "status": "success",
    "message": "Some warning text or null if not provided" 
}
```

{% endtab %}

{% tab title="401" %}

```json
{
    "status": "error",
    "message": "1000. Unauthorized: token is invalid"
}
```

{% endtab %}

{% tab title="403" %}

```json
{
    "status": "error",
    "message": "1001. Forbidden: Connection refused"
}
```

{% endtab %}

{% tab title="422" %}

```json
{
    "status": "Validation error",
    "messages": 
        "1100. The field 'field.name' is required."
    }
}
```

{% endtab %}
{% endtabs %}

## Итоговый набор аналитики

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

### Логика формирования итогового набора аналитики

{% hint style="danger" %}
**Внимание!** Учитывая разнообразие настроек в составе аналитики, а также возможные ошибки, которые могут возникнуть из-за некорректного заполнения полей или нарушения логических взаимосвязей между полями, **итоговый набор аналитики может отличаться от первичного состава, указываемого в теле запроса.**
{% endhint %}

#### Возможные варианты итогового набора аналитики

Возможны следующие варианты в зависимости от корректности заполнения данных в массиве **analytics{}.**

1. **Указан только параметр "summary":"true".** Мы понимаем, что вам нужен только пересказ звонка, и на полученном звонке будет произведен только пересказ.
2. **Указано несколько параметров, все прошли проверку на валидацию.** Конечный состав аналитики будет соответствовать запрошенному составу в вебхуке. При этом тег **"summary"** может отсутствовать или быть некорректно заполнен, но пересказ разговора в любом случае будет автоматически добавлен к запрошенному составу аналитики.
3. **Указано несколько параметров, но не все параметры прошли проверку на валидацию.** Конечный состав аналитики будет состоять только из корректно заполненных параметров, успешно прошедших все проверки на валидацию. При этом тег **"summary"** может отсутствовать или быть некорректно заполнен, но пересказ разговора в любом случае будет автоматически добавлен к запрошенному составу аналитики.
4. **Указано несколько параметров, но ни один параметр не прошел проверку на валидацию.**  Логика схожа с предыдущим случаем. Если ни один параметр не прошел успешную валидацию, то **будет применено задание на пересказ**, по умолчанию присутствующее во всех составах аналитики.
5. **Пустой массив analytics{}.** Именно **пустой, а не отсутствующий.** Массив обязательно должен быть в теле запроса, так мы поймем, что вы не забыли его прописать, а целенаправленно оставили пустым. Будет применен состав аналитики по умолчанию, настроенный в личном кабинете aiokk в разделе [**Настройки → Аналитика**](#sostav-analitiki-po-umolchaniyu). Он также **включает в себя пересказ** звонка.

### Состав аналитики по умолчанию

При работе с вебхуками возможно использование набора аналитики по умолчанию, настраиваемого в разделе [**Настройки → Аналитика**](/settings/analytics/sostav-analitiki#sostav-analitiki-po-umolchaniyu).&#x20;

{% hint style="warning" %}
Для того, чтобы произвести аналитику звонка по стандартному набору действий, **отправьте в вебхуке пустой параметр "analytics": {}**

Это послужит для нас сигналом, что вам требуется именно стандартный сценарий аналитики, согласно настройкам в личном кабинете (состав аналитики по умолчанию).
{% endhint %}

{% hint style="info" %}
Некоторые задания аналитики, такие как **критерии оценки, набор маяков** и др., для которых необходима привязка к отдельным сущностям в настройках кабинета, **нуждаются в дополнительном уточнении сущности по умолчанию** в случае работы по стандартному сценарию аналитики.
{% endhint %}

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

**Критерии оценки**

<figure><img src="/files/rULMB6D6ZwAijE6QMezh" alt=""><figcaption><p>Выбор набора вопросов по умолчанию для стандартного набора аналитики</p></figcaption></figure>

**Маяки**

<figure><img src="/files/aKpxhyvgBoKkrFhclH2c" alt=""><figcaption><p>Выбор списка маяков по умолчанию для стандартного набора аналитики</p></figcaption></figure>

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

## Справочник кодов ошибок и предупреждений

### Ошибки аутентификации и подключения (1000-1099)

<details>

<summary>1000 - Недействительный токен доступа (статус 401)</summary>

**Исходное сообщение**: 'error': '1000. Unauthorized: token is invalid' (401)&#x20;

**Описание**: Предоставленный токен доступа недействителен. Необходимо получить новый токен аутентификации.&#x20;

**Решение**:

* Проверьте правильность токена
* При необходимости получите новый токен на странице **Настройки → Источник данных** и перенастройте вебхук.

</details>

<details>

<summary>1001 - Отказ в подключении (статус 403)</summary>

**Исходное сообщение**: 'error': '1001. Forbidden: Connection refused' (403)&#x20;

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

**Решение**:

* Убедитесь в стабильности сетевого подключения.
* Проверьте правильность настроек файервол.
* Убедитесь, что на странице **Настройки → Источник данных** статус вебхука указан как "**Активный**".

</details>

### Ошибки валидации данных (1100-1199) (статус 422)

<details>

<summary>1100 - Некорректные данные запроса</summary>

**Исходное сообщение**: "error": "1100. The field '*field.name*' is required."

**Описание**: Единый код ошибки без привязки к конкретному полю. В запросе отсутствуют обязательные поля. См. раздел "[**Тело запроса**](#telo-zaprosa)".

**Решение**:

* Проверьте наличие всех обязательных полей в запросе
* Убедитесь, что значения полей соответствуют требуемому формату
* Сверьтесь с документацией API для уточнения требований к данным

</details>

<details>

<summary>1101 - Некорректный формат даты</summary>

**Исходное сообщение**: "1100. The field 'call.date' must be in ISO 8601 format with timezone."

**Описание**: Предоставленное значение даты не соответствует требуемому формату ISO 8601 с указанием временной зоны.&#x20;

**Решение**:

* Проверьте наличие информации о часовом поясе в передаваемой информации.
* Убедитесь, что дата указана в формате ISO 8601 (например: "2024-12-31T15:30:00+03:00")
* Используйте стандартные библиотеки для форматирования дат

</details>

<details>

<summary>1102 - Неверный тип данных поля call.type</summary>

**Исходное сообщение**: "1102. The field 'call.type' must be an integer."

**Описание**: Значение поля call.type должно быть целым числом, но предоставлено значение другого типа данных.

**Решение**:

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

</details>

<details>

<summary>1103 - Недопустимое значение типа звонка</summary>

**Исходное сообщение**: "1103. The field 'call.type' must be one of the following values: 1 (Outgoing), 2 (Incoming), 3 (Incoming with redirection), 4 (Callback)."

**Описание**: Указанное значение типа звонка не соответствует списку допустимых значений.

**Решение**:

* Убедитесь, что значение передается как целое число, а не строка
* Используйте только следующие значения для поля call.type:
  * 1: Исходящий звонок (Outgoing)
  * 2: Входящий звонок (Incoming)
  * 3: Входящий звонок с переадресацией (Incoming with redirection)
  * 4: Обратный звонок (Callback)
* Проверьте соответствие значения бизнес-логике вашего приложения

</details>

<details>

<summary>1104 - Некорректный формат URL</summary>

**Исходное сообщение**: "1104. The field 'call.url' must be a valid URL starting with http or https."

**Описание**: Предоставленный URL источника записи звонка не соответствует требуемому формату или не содержит необходимый протокол.

**Решение**:

* Убедитесь, что URL начинается с "http\://" или "https\://"
* Проверьте правильность написания URL
* Проверьте наличие всех необходимых компонентов URL (домен, путь и т.д.)

</details>

<details>

<summary>1105 - Некорректное расширение аудиофайла</summary>

**Исходное сообщение**: "1105. The audio file extension is not supported. Allowed extensions are: .mp3, .m4a, .wav, .ogg"

**Описание**: Загружаемый аудиофайл имеет неподдерживаемое расширение. Система принимает только определённые форматы аудиофайлов.

**Решение**:

* Используйте только следующие форматы аудиофайлов:
  * .mp3 (MPEG Layer-3)
  * .m4a (MPEG-4 Audio)
  * .wav (Waveform Audio File Format)
  * .ogg (Ogg Vorbis)
* Проверьте расширение загружаемого файла
* При необходимости конвертируйте файл в поддерживаемый формат перед отправкой вебхука
* Убедитесь, что файл не был переименован и действительно содержит аудиоданные в указанном формате

</details>

<details>

<summary>1106 - Некорректный формат длительности звонка</summary>

**Исходное сообщение**: "1106. The field 'call.duration' must be an integer or a numeric string."

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

**Решение**:

* Убедитесь, что значение длительности передается как целое число (например: 120) или числовая строка (например: "120")
* Проверьте, что значение не содержит десятичных дробей
* Удалите любые нечисловые символы (буквы, специальные символы)
* При необходимости выполните преобразование значения в подходящий формат

</details>

<details>

<summary>1107 - Недопустимые символы в номере телефона</summary>

**Исходное сообщение**: "1107. The field 'call.phone' can only contain digits, '+', '-', '(', and ')'. Spaces and other characters are not allowed."&#x20;

**Описание**: В номере телефона обнаружены недопустимые символы. Разрешены только цифры и специальные символы для форматирования номера.&#x20;

**Решение**:

* Используйте только следующие символы:
  * Цифры (0-9)
  * Плюс (+) для международного формата
  * Дефис (-) для разделения групп цифр
  * Круглые скобки ( ) для кода города/страны
* Удалите все пробелы из номера
* Удалите любые другие специальные символы
* Проверьте номер на соответствие допустимому формату

</details>

<details>

<summary>1108 - Слишком короткий номер телефона</summary>

**Исходное сообщение**: "1108. The field 'call.phone' must contain at least 3 characters."

**Описание**: Указанный номер телефона слишком короткий. Минимальная допустимая длина - 3 символа.&#x20;

**Решение**:

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

</details>

### Ошибки валидации необязательных полей (1200-1299) (статус 200)

<details>

<summary>1200 - Некорректное значение оценки удовлетворенности</summary>

**Исходное сообщение**: "1200. analytics.customerSatisfaction.assessment can only be true, false, or null."

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

**Решение**:

* Используйте только значения: true, false или null
* Проверьте формат передаваемых данных
* Убедитесь, что значение соответствует бизнес-логике

</details>

<details>

<summary>1201 - Некорректный формат ID элемента в aiokk</summary>

**Исходное сообщение**: "1201. The field '*field.name*" must be an integer or a numeric string."

**Описание**: Идентификатор набора вопросов должен быть целым числом или числовой строкой. Другие форматы данных не поддерживаются.

**Проверяемые поля:**&#x20;

* analytics.evaluationCriteria.questionPack,
* analytics.signals,
* analytics.scripts.

**Решение**:

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

</details>

<details>

<summary>1202 - Нарушение логики оценки удовлетворенности клиента</summary>

**Исходное сообщение**: "1202. If 'analytics.customerSatisfaction.assessment' is not true, then 'motivation' and 'recommendation' cannot be true."

**Описание**: Ошибка возникает в случае, если задача на мотивацию оценки удовлетворенности клиента и/или рекомендация по ее повышению активированы без активации непосредственно задачи на оценку удовлетворенности клиента.&#x20;

**Решение**:

* Убедитесь, что ваш запрос содержит "analytics.customerSatisfaction.assessment": "true"
* Проверьте логическую связь между полями
* Убедитесь в последовательности заполнения данных

</details>

<details>

<summary>1203 - Нарушение логики в разделе критериев оценки</summary>

**Исходное сообщение**: "1203. If 'analytics.evaluationCriteria.questionPack' is not specified, then 'motivation' and 'recommendation' cannot be true."

**Описание**: Ошибка возникает в случае, если задача на мотивацию оценки по критериям и/или рекомендация по повышению общей оценки активированы без указания непосредственно id набора вопросов.

**Решение**:

* Сначала укажите ID набора вопросов в числовое поле analytics.evaluationCriteria.questionPack
* Проверьте зависимости между полями
* Соблюдайте правильную последовательность заполнения

</details>

<details>

<summary>1204 - Некорректные значения флагов аналитики</summary>

**Исходное сообщение**: "1204. The field '*field.name*' must contain only true or false."

**Описание**: Проверяемые поля принимают только логические значения true или false.

**Проверяемые поля:**&#x20;

* 'analytics.language',
* 'analytics.evaluationCriteria.motivation',
* 'analytics.evaluationCriteria.recommendation',
* 'analytics.customerSatisfaction.motivation',
* 'analytics.customerSatisfaction.recommendation'

**Решение**:

* Используйте только значения true или false
* Проверьте формат данных
* Не используйте null или другие значения. Если вам необходимо оставить поле пустым, то уберите соответствующий ключ из тела запроса.

</details>

<details>

<summary>1205 - Отсутствует внутренний номер сотрудника</summary>

**Исходное сообщение**: "1205. For more comprehensive analytics, please provide the 'employee.intNum' field."

**Описание**: Рекомендуется указывать внутренний номер сотрудника для улучшения качества аналитики и дальнейшего формирования отчетов.

**Решение**:

* Проверьте наличие номера на стороне источника данных
* Заполните поле ''employee.intNum
* Укажите корректный внутренний номер в виде целого числа

</details>

<details>

<summary>1206 - Отсутствует ID отдела</summary>

**Исходное сообщение**: "1206. For more comprehensive analytics, please provide the 'employee.departmentId' field."

**Описание**: Рекомендуется указать идентификатор отдела для улучшения качества аналитики и дальнейшего формирования отчетов.

**Решение**:

* Заполните поле employee.departmentId
* Укажите существующий ID отдела
* Проверьте корректность идентификатора

</details>

<details>

<summary>1207 - Отсутствует обратная ссылка на владельца</summary>

**Исходное сообщение**: "1207. Attached owner entity URL is missing."

**Описание**: Отсутствует ссылка для привязки звонка к материнской сущности на стороне источника данных.

**Решение:**

* Заполните поле call.ownerBacklink
* Укажите корректную ссылку
* Проверьте доступность ресурса

</details>

<details>

<summary>1208 - Некорректный формат ссылки на владельца</summary>

**Исходное сообщение**: "1208. The field 'call.ownerBacklink' must contain a valid URL starting with 'http\://' or 'https\://'."&#x20;

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

**Решение**:

* Начните URL с http\:// или https\://
* Проверьте правильность написания URL
* Убедитесь в доступности ресурса

</details>

<details>

<summary>1209 - Отсутствует внешний номер</summary>

**Исходное сообщение**: "1209. For more comprehensive analytics, please provide the 'call.extNumber' field."

**Описание**: Рекомендуется указать внешний номер для улучшения качества аналитики.

**Решение**:

* Заполните поле call.extNumber
* Укажите действительный внешний номер
* Проверьте формат номера

</details>

<details>

<summary>1210 - Несуществующий ID элемента в aiokk</summary>

**Исходное сообщение**: "Element with ID {id} not found in aiokk"

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

**Проверяемые поля:**&#x20;

* analytics.evaluationCriteria.questionPack,
* analytics.signals,
* analytics.scripts.

**Решение**:

* Убедитесь, что элемент существует в вашем аккаунте aiokk
* Проверьте, не был ли элемент удален
* Проверьте правильность указанного в вебхуке ID элемента aiokk

</details>

<details>

<summary>1211 - Запрос архивного набора вопросов</summary>

**Исходное сообщение**: "1211. The Question Pack you requested is archived"

**Описание**: Запрашиваемый набор вопросов находится в архиве и недоступен для использования. Архивные наборы вопросов нельзя применять в активных оценках.

**Решение**:

* Убедитесь, что вы используете актуальный (не архивный) набор вопросов
* Выберите альтернативный активный набор вопросов
* Проверьте, не был ли набор вопросов недавно перемещен в архив
* При необходимости восстановите набор вопросов из архива

</details>


# Фильтрация

Чтобы не распыляться, а сконцентрироваться на важном...

<figure><img src="/files/nwrgRlWREtdvXT88XjW1" alt=""><figcaption><p>Настройки → Фильтрация. Блок "Фильтрация звонков"</p></figcaption></figure>

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

***

## Зачем нужна фильтрация звонков?

**Фильтрация звонков** — это мощный инструмент для точного и релевантного анализа взаимодействий с клиентами. Она позволяет:

1. **Сосредоточиться на ключевых данных:** Отсечь лишние и нерелевантные звонки, чтобы повысить точность аналитики и принять более обоснованные решения.
2. **Улучшить качество анализа:** Длительные звонки чаще содержат больше полезной информации, в то время как короткие могут быть неинформативны.
3. **Сэкономить ресурсы:** Исключение лишних данных позволяет сократить время обработки и анализа звонков, а также не расходовать средства на нерелевантную аналитику.
4. **Подстроить аналитику под цели бизнеса:** Настройка фильтров под ваши параметры (например, по отделам или сотрудникам) делает данные более точными и пригодными для конкретных задач, таких как оценка эффективности сотрудников или анализ работы отдельных отделов.

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

{% hint style="info" %}
**Внимание:** фильтры применяются только к звонкам, поступившим в систему после сохранения изменений. Звонки, попавшие в систему через предыдущие настройки фильтра, останутся без изменений.
{% endhint %}

***

## Основные параметры фильтрации

{% hint style="info" %}
Набор доступных параметров для фильтрации зависит от возможностей подключаемого источника данных. Как правило, максимально полнотой данных обладают CRM-системы.
{% endhint %}

1. **Направление звонка.** Выбор  для анализа исходящих, входящих, входящих с перенаправлением или заказов обратного звонков.
2. **Виртуальные номера.** Если к вашей виртуальной телефонии подключены несколько номеров, и анализировать нужно не все, то укажите те SIP-номера, которые должны участвовать в аналитике.
3. **Длительность звонка.** Фильтрация звонков по их продолжительности (например, от 60 секунд для получения достоверных данных).

{% hint style="info" %}
Для обеспечения высокой точности аналитики мы рекомендуем работать с звонками продолжительностью **от 60 секунд и более**, так как на коротких звонках вероятность получения достоверных данных значительно ниже. Однако особенности вашего бизнеса могут предполагать и иные значения.
{% endhint %}

4. **Кадровые единицы.** Определите, звонки каких сотрудников или отделов будут включены в фильтрацию.

{% hint style="warning" %}
Все фильтры работают **вместе** **одновременно**. Чрезмерно жесткие настройки могут привести к отсутствию диалогов, соответствующих заданным условиям для запуска аналитики. **Диалоги, не попавшиеся в фильтр, не будут отображаться в списке звонков.**
{% endhint %}


# Аналитика

## Технические аспекты

{% hint style="warning" %}
Для корректной и полноценной работы нашего сервиса, ваши разговоры должны записываться **в двухканальном формате**. Большинство современных телефоний поддерживает данный функционал по умолчанию - вам остается только **включить его перед началом использования** нашего сервиса.
{% endhint %}

<figure><img src="/files/sQFRQ6XgFl0HQ9KSm858" alt=""><figcaption><p>Схема аналитики звонка</p></figcaption></figure>

## Управление

<figure><img src="/files/jFQIsr6BVAaiCFJt0fgr" alt=""><figcaption><p>Блок управления аналитикой на вкладке "Настройки → Аналитика"</p></figcaption></figure>

### Включение / выключение автоматической аналитики

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

{% hint style="info" %}

1. Включение / отключение аналитики может производиться **не чаще одного раза в минуту.**
2. Если при отключении аналитики какие-то разговоры находились в активной фазе обработки, то **их анализ будет доведен до конца, и стоимость их аналитики будет списана с баланса**, а все звонки в очереди после них и последующие новые звонки будут поставлены **на паузу** до очередного включения аналитики.
3. Аналитика звонков может быть остановлена **автоматически** при условии недостостаточности средств для анализа следующего звонка в очереди. В таком случае включить аналитику вручную **не получится до пополнения баланса.**
   {% endhint %}

### Отложенный старт

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

{% hint style="warning" %}
Отложенный старт во включенном состоянии применяется ко всему аккаунту сразу, а не к отдельным правилам аналитики.
{% endhint %}

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


# Состав аналитики

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

{% hint style="info" %}
Единицей тарификации является **одна минута разговора**. При наличии секунд сверх полной минуты, длительность разговора будет **округлена вверх до целого числа** минут.
{% endhint %}

## Состав аналитики по умолчанию

Состав аналитики представляет собой **набор задач**, по которым проводится оценка разговоров по умолчанию, если разговор не подпадает ни под одно из активных [**правил**](/settings/analytics/rules). Выберите те задачи, которые наиболее соответствуют вашим бизнес-целям, чтобы создать детализированный анализ звонков.&#x20;

{% hint style="warning" %}
**Внимание!** Внесение изменений в любые настройки аналитики доступны только **в выключенном состоянии функции аналитики**.
{% endhint %}

<figure><img src="/files/JrGaEUC8Z4EFmNpvsCTh" alt=""><figcaption><p>Настройки аналитики: язык результатов и состав аналитики по умолчанию</p></figcaption></figure>

<table data-header-hidden><thead><tr><th width="342">Функция</th><th>Описание</th></tr></thead><tbody><tr><td><strong>Пересказ звонка</strong></td><td>Получите короткую выжимку с ключевыми аспектами разговора и не тратьте время на его прослушивание целиком <em>(применяется по умолчанию)</em></td></tr><tr><td><strong>Выбор языка выдачи результатов аналитики</strong></td><td>Вне зависимости от языка/ов, на которых собеседники общались во время разговора, вы можете настроить язык, на котором мы будем предоставлять результаты аналитики.</td></tr><tr><td><strong>Определение языка</strong></td><td>Воспользуйтесь данной функцией, если вам необходимо мониторить, на каких языках ведутся телефонные переговоры</td></tr><tr><td><strong>Оценка удовлетворенности клиента</strong></td><td>Высчитываем оценку от 1 до 10 на основе поведения клиента в ходе разговора</td></tr><tr><td><ul><li><strong>Развернутое обоснование оценки каждого критерия</strong></li></ul></td><td>Дополнительно предоставим краткое, но содержательное объяснение оценки по каждому критерию</td></tr><tr><td><ul><li><strong>Рекомендации по повышению общей оценки</strong></li></ul></td><td>Предоставим рекомендации по действиям, которые помогут сотруднику улучшить свои итоговые показатели в следующих разговорах</td></tr><tr><td><strong>Контроль перебиваний</strong></td><td>Подсчитаем, сколько раз в целом и каждая сторона отдельно перебила своего собеседника <em>(применяется по умолчанию)</em></td></tr><tr><td><strong>Критерии оценки сотрудника</strong></td><td>Сформулируйте до 10 вопросов для оценки качества работы сотрудника по шкале от 1 до 10 по итогам разговора</td></tr><tr><td><ul><li><strong>Развернутое обоснование оценки</strong></li></ul></td><td>Дополнительно дадим краткое, но развернутое объяснение выставленной оценке</td></tr><tr><td><ul><li><strong>Рекомендации по повышению оценки</strong></li></ul></td><td>Предоставим рекомендации по действиям, которые помогут улучшить оценку в следующий раз</td></tr><tr><td><strong>Проверка на наличие маяков</strong></td><td>Найдем и выделим ключевые слова или выражения, которые важно отслеживать: как запрещенные, так и слова по скрипту</td></tr><tr><td><strong>Продвинутые скрипты</strong></td><td>Составьте полнофункциональный скрипт с неограниченным количеством вопросов и дополнительными возможностями расчетов</td></tr><tr><td><ul><li><strong>Рекомендации по повышению оценки</strong></li></ul></td><td>Предоставим рекомендации по действиям, которые помогут улучшить оценку при работе по данному скрипту в следующий раз</td></tr><tr><td><strong>Тематические маркеры</strong></td><td>Основываясь на содержании разговора, классифицируем звонки на основе их содержания, присвоив им до трех наиболее подходящих маркеров из вашего списка </td></tr></tbody></table>

## **Показать в CRM**

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

{% hint style="warning" %}
amoCRM не поддерживает расширенную выдачу данных в своих заметках внутри сущностей. Поэтому если вы используете amoCRM, то мы будем возвращать в систему минимальный набор сведений и ссылку на карточку звонка в нашей системе, которая уже будет содержать всю расширенную информацию.
{% endhint %}

{% hint style="info" %}
Язык статичных текстов в уведомлениях, возвращаемых в вашу CRM, настраивается благодаря параметру "**Язык писем и уведомлений**" на вкладке "[**Настройки → Профиль**](/settings/profile)". Результаты аналитики и названия сущностей, указанные вами, возвращаются в том виде, как они хранятся в aiokk.
{% endhint %}


# Кастомная аналитика

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

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


# Правила

Максимальная гибкость настройки под ваш бизнес

## Общие сведения

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

{% hint style="info" %}
Доступность функционала правил зависит от технических возможностей подключенного **источника данных.**
{% endhint %}

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

## Создание правил

Для управления правилами перейдите в раздел "**Настройки → Фильтрация**". Если источник ваших данных поддерживает функционал стадий для своих сущностей, то вам будет доступен блок "**Правила фильтрации для индивидуальной аналитики**", который находится под блоком настройки фильтров.

<figure><img src="/files/RQum4qfeEw5IadVimf7C" alt=""><figcaption></figcaption></figure>

{% stepper %}
{% step %}

### Создайте новое правило

1. Нажмите кнопку добавления правила.
2. Укажите тип сущности.
3. Укажите стадию или группу стадий выбранной сущности.
   {% endstep %}

{% step %}

### Настройте аналитику для нового правила

4. Откройте диалоговое окно настройки состава аналитики со списком доступных действий.
5. Выберите нужные действия для текущего правила.&#x20;
6. В зависимости от активированных задач, стоимость минуты проанализированного разговора будет автоматически пересчитываться.
7. Если вы передумали сохранять правило, то на этом этапе его можно удалить.

<mark style="background-color:purple;">Если вы хотите создать сразу несколько правил, то повторите шаги 1-6 для каждого нового правила.</mark>
{% endstep %}

{% step %}

### Сохраните и активируйте изменения

8. Если вы создали достаточное количество правил, они полностью настроены, и вы готовы продолжить работу с системой, то нажмите кнопку "Сохранить".
9. После сохранения убедитесь, что переключатель активен. Если нет, то активируйте его и снова нажмите кнопку "Сохранить".
   {% endstep %}
   {% endstepper %}

**Готово!** Новые звонки, поступившие в систему после включения правила будут проверяться на соответствие имеющимся правилам для выбора сценария аналитики.

{% hint style="warning" %}

1. На каждую стадию сущности можно создать только **одно правило.**
2. **Пересекающиеся правила запрещены.** То есть если вы уже настроили правило на целую воронку сделок А, то вы не сможете отдельно настроить другое правило для отдельно взятой стадии сущности из этой же воронки А.&#x20;
3. **Справедливо и обратное ограничение:** если вы уже настроили правило на отдельную стадию АБВ в воронке А, то вы не сможете настроить другое правило для отдельно, охватывающие все стадии воронки А, потому что стадия АБВ из этой воронки уже задействована в другом правиле.
4. сущность Чтобы правила начали работать, не забудьте **активировать** переключатель и **сохранить**.
5. Общее количество активных правил не может превышать **100 штук**.
6. В наборе аналитики можно выбрать пункт "**Игнорировать и ничего не делать**", который **исключает** все иные проставленные галочки и обнуляет стоимость аналитики. Такие разговоры останутся в системе, т.к. прошли через фильтрацию, но не будут транскрибированы и проанализированы, потому что это было определено в соответствующем правиле.
   {% endhint %}

Если вам требуется не моментальная аналитика сразу после попадания звонка в систему, а нужно некоторые время в качестве запаса перед началом (например, чтобы сотрудники успевали заполнять карточки в CRM и переносить их на соответствующий статус перед аналитикой), то активируйте функционал [**отложенного старта**](/settings/analytics#otlozhennyi-start).

## Удаление, архивирование и восстановление правил

<mark style="color:red;">**Удаление**</mark> сохраненных правил **недоступно**, но если правило больше не актуально или вы достигли лимита в **100** правил, вы можете **заархивировать** его. Архивация позволяет освободить место для новых правил, сохраняя при этом **доступ к историческим данным**. Запрет на удаление связан с важностью сохранения прозрачности и точности аналитики — это позволяет в любой момент **вернуться к истории и достоверно понять, какие правила использовались** для анализа конкретного звонка. Такой подход гарантирует полную сохранность аналитических данных и их целостность.

Чтобы <mark style="color:orange;">**заархивировать**</mark> сохраненное правило, перейдите на вкладку “**Активные**” и нажмите на соответствующую пиктограмму в правой части строки нужного правила.

Для <mark style="color:green;">**восстановления**</mark> правила из архива откройте вкладку “**Архивные**” и нажмите на пиктограмму в правой части строки архивного правила. Этот интуитивный процесс позволяет легко управлять правилами, сохраняя их актуальность и гибкость в использовании.

**Количество архивных правил не ограничено.**

{% hint style="warning" %}
При поиске сценария для аналитики новых звонков **архивные правила не учитываются!** Это означает, что только активные правила влияют на текущую обработку данных, обеспечивая актуальность аналитики. Архивирование позволяет сохранить правила для истории, но они больше не влияют на процесс анализа звонков. Убедитесь, что все необходимые правила находятся в активном статусе для корректной работы аналитики.
{% endhint %}

## Нетиповые правила 🔥🔥🔥

Если вы используете в качестве источника данных CRM Битрикс24 или amoCRM / kommo, и вам для настройки правил не хватает стандартных условий на основе *типа сущности и статуса / воронки*, и для более точной аналитики возникает потребность учитывать дополнительные сведения из CRM, то у вас есть возможность заказать разработку **Нетиповых правил.**

Нетиповые правила позволят учитывать дополнительные условия, основанные на тех или иных значениях полей в вашей CRM, для определения подходящего сценария. Например, в Битрикс24 у вас есть собственное поле в лидах "Температура лида", и вам нужно, что холодные лиды в каком-то статусе обрабатывались особым образом, в отличие от лидов с другой "температурой". В этом случае нетиповое правило отлично решит такую задачу!

{% hint style="info" %}

1. Для разработки технического задания по Нетиповым правилам для вашего аккаунта и уточнения стоимости индивидуальной разработки, обратитесь в техническую поддержку через виджет в личном кабинете.
2. Дальнейшее добавление нетиповых правил, их архивирование или редактирование будет производиться через сотрудников технической поддержки за дополнительную плату.
   {% endhint %}


# Маркеры

Что это и почему вам они точно понадобятся

**Что такое маркеры?**

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

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

<mark style="background-color:blue;">**Чем лучше настроены маркеры, тем точнее аналитика разговоров и выше ценность данных для вашего бизнеса.**</mark>

## Как правильно составлять маркеры, чтобы система точнее их присваивала?

### ✅ Подстраивайте маркеры под бизнес-процессы

Если это банк, то “кредит”, “депозит”, “банковская карта”, “задолженность”, и т.д.

Если вы анализируете звонки в сфере недвижимости, важны маркеры типа: “ипотека”, “квартира”, “продажа”, “аренда”, “залог”.

### ✅ Используйте конкретные термины

**Хорошо:** “ипотека”, “рассрочка”, “аванс”

**Плохо:** “про ипотеку”, “возможность оформить рассрочку” (длинные фразы сложнее корректно сопоставить).

### ✅ Маркер = ключевое слово, а не фраза

**Хорошо:** “задолженность”, “рассрочка”

**Плохо:** “клиент хочет взять рассрочку” (длинные фразы неэффективны)

{% hint style="danger" %}
Перед сохранением маркера убедитесь в отсутствии орфографических ошибок в его формулировке. Система не корректирует ваши маркеры при наличии в них любых ошибок.
{% endhint %}

### ✅ Избегайте дублирования синонимов

Рассмотрим аккаунт строительной компании. Если есть маркер “квартира”, то не нужно добавлять “жильё”, “недвижимость”, если эти термины взаимозаменяемы в вашем контексте.

### ✅ Не перегружайте систему нерелевантными маркерами

Бессмысленные маркеры типа **“123”, “dsad”, “тест”** мешают корректной работе алгоритма и не принесут никакой ценности в решении этой задачи. Кроме того, вероятность присвоения такого маркера практически отсутствует, но при этом тарификация будет применена, даже если по итогам проверки системе не удалось присвоить ни один из имевшихся маркеров.

## Прочие важные аспекты по функционалу

1. Вы можете указать в системе в общей сложности **до 20 маркеров**.&#x20;
2. **Порядок расположения маркеров в общем списке никакого значения не имеет** и не влияет на приоритет маркеров в начале списка перед более поздними маркерами или наоборот.
3. Система маркеров **не учитывает регистр.** Это означает, что слова “внедорожник”, “ВНЕДОРОЖНИК” и “ВнЕдОроЖНИК” будут восприниматься как один и тот же маркер, поэтому достаточно указать одно написание.
4. Состав маркеров **редактируется.** Вы можете добавлять или удалять маркеры в списке в любое время. Присвоенные ранее маркеры в проанализированных звонках **сохранятся** в той формулировке, в которой они были изначально добавлены в карточку звонка при осуществления аналитики.&#x20;
5. Чем точнее и логичнее составлены маркеры, тем лучше система определяет тематику звонков. **Используйте короткие, ёмкие термины, избегайте "воды" и случайных слов** — и ваша аналитика станет максимально точной.
6. Результаты маркировки можно увидеть в [**основной таблице** ](/glavnaya-stranica/osnovnaya-tablica)на главной странице, а также в карточке звонка на вкладке "[**Контент**](/glavnaya-stranica/kartochka-razgovora#pereskaz)".

## Примеры маркеров для разных отраслей

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

<details>

<summary>Финансовые услуги</summary>

Кредит, Ипотека, Депозит, Рассрочка, Долг, Пеня, Комиссия, Банк, Рефинансирование, Банковская карта, Счет, Платеж, Валюта, Брокер, Инвестиции, Перевод, Лизинг, Акции, Облигации, Финансовый анализ

</details>

<details>

<summary>Страхование</summary>

Страховка, Полис, ОСАГО, КАСКО, ДМС, ОМС, Страховой случай, Выплата, Компенсация, Риски, Франшиза, Медицинская страховка, Автострахование, Жизнь, Недвижимость, Квартира, Смерть, Болезнь, Договор, Перестрахование

</details>

<details>

<summary>Грузовперевозки</summary>

Доставка, Груз, Контейнер, Склад, Таможня, Экспедирование, Международные перевозки, Отгрузка, Трек-номер, Маршрут, Карго, Логистика, Автопарк, Габариты, Фрахт, Транспортная накладная, Тариф, Диспетчер, Погрузка, Разгрузка

</details>

<details>

<summary>Пассажирские перевозки</summary>

Билет, Рейс, Опоздание, Самолет, Поезд, Автобус, Такси, Пересадка, Авиакомпания, Багаж, Регистрация, Отмена, Перенос рейса, Льготный билет, Трансфер, Вокзал, Аэропорт, Купе, Эконом, Бизнес-класс

</details>

<details>

<summary>Автомобильная индустрия</summary>

*Укажите конкретные марки автомобилей*, Тест-драйв, Дилер, Трейд-ин, Запчасти, Сервис, Гарантия, Шины, Масло, Диагностика, ТО, Лизинг, Б/у авто, Новая модель, Комплектация, Автосалон, Двигатель, Подвеска, Кузов, Электромобиль

</details>

<details>

<summary>Телекоммуникации</summary>

Тариф, Интернет, Wi-Fi, Мобильная связь, Баланс, Личный кабинет, Роуминг, Скорость, Смена тарифа, Подключение, Оператор, Домашний интернет, Телевидение, SMS, Подписки, Сбои, Поддержка, 5G, Обслуживание, Лимит

</details>

<details>

<summary>Здравоохранение и медицина</summary>

Врач, Запись, Клиника, Анализы, Диагностика, Лечение, Страховка, Полис, Операция, Симптомы, Скорая, Аптека, Таблетки, Вакцина, Прививка, Консультация, Больница, Медкарта, Медосмотр, Лекарства, Укажите к*онкретные типы услуг*

</details>

<details>

<summary>Агентства недвижимости</summary>

Покупка, Продажа, Квартира, Дом, Ипотека, Новостройка, Вторичка, Агент, Договор, Комиссия, Осмотр, Оценка, ЖК, Перепланировка, Регистрация, Объект, Торг, Аренда, Залог, Нотариус, *Укажите конкретные типы недвижимости*

</details>

<details>

<summary>Отели</summary>

Бронь, Номер, Заселение, Выселение, Завтрак, Ресепшн, Лобби, Уборка, Мини-бар, Кондиционер, Консьерж, Рейтинг, Оценка, Жалоба, Компенсация, Отмена брони, Трансфер, Спа, Фитнес, Парковка

</details>

<details>

<summary>Строительство</summary>

Подряд, Материалы, Проект, Фундамент, Ландшафт, Электрика, Водопровод, Срок сдачи, Рабочая бригада, Архитектор, Отделка, Жилой комплекс, Долевое участие, Девелопер, Планировка, Строительный контроль, Инфраструктура, Монтаж, Газификация, Земельный участок, *Укажите конкретные типы недвижимости*

</details>

<details>

<summary>Рестораны и кафе</summary>

Меню, Столик, Резерв, Официант, Счет, Кухня, Бар, Доставка, Коктейль, Банкет, Кейтеринг, Дегустация, Вино, Чаевые, Заказ, Шеф, Рецепт, Кальян, Веган, Алкоголь

</details>


# Критерии оценки

Оцифруйте качество телефонных коммуникаций своих операторов

## Общая информация

Используйте данный функционал для оценки **качества работы своих сотрудников** при телефонных коммуникациях. Сформулируйте **до 10 вопросов** для оценки качества работы сотрудника **по шкале от 1 до 10** по итогам разговора.

## Рекомендации по созданию наборов вопросов

{% hint style="info" %}
Формулировка вопросов может существенно повлиять на оценку. Рекомендуем формулировать вопросы так, чтобы они имели характеристику качественности, т.е. чтобы ответы на них можно было оценить по цифровой шкале.&#x20;
{% endhint %}

1. **Фокусируйтесь на конкретных действиях.** Не “~~Был ли звонок полезным для клиента?~~” 👎 , а *“Удалось ли сотруднику предоставить полное решение проблемы клиента?”* 👍
2. **Формулируйте вопросы так, чтобы правильное поведение и предпочтительные ответы однозначно соответствовали более высоким оценкам на шкале.** При этом заранее определите и четко опишите критерии для оценивания, чтобы исключить разночтения и обеспечить максимальную объективность интерпретации результатов.
3. **Добавляйте вопросы, которые оценивают эмпатию.** Например: *“Насколько клиент почувствовал заботу и заинтересованность оператора?”* Вопросы, касающиеся эмоционального интеллекта, помогают выявить важные аспекты взаимодействия, влияющие на лояльность клиента.
4. **Вопросы должны быть независимы друг от друга.** Каждый вопрос должен оценивать только один аспект звонка. Избегайте смешанных формулировок, вроде: “~~Был ли сотрудник вежлив и предоставил ли полезную информацию?~~”👎 Такие вопросы усложняют понимание, что именно пошло не так.
5. **Учитывайте специфику звонка.** Если звонки в вашей компании делятся по типам или целевым задачам (продажи, поддержка, консультация, "дожим", "прогрев", уведомление и т.д.), настройте вопросы под каждый сценарий.
   1. **Пример для продаж:** “Насколько развернуто сотрудник представил преимущества продукта?”
   2. **Пример для поддержки:** “Сотрудник предоставил четкое решение проблемы клиента?”
6. **Соблюдайте баланс в количестве вопросов.** Не перегружайте набор большим количеством вопросов. 3-6 вопросов — оптимальный объем, чтобы ёмко охватить ключевые аспекты звонка даже при относительно короткой длительности.

## Рекомендации для максимального использования возможностей функционала

1. **Не оценивайте только ради оценки.** Выстройте системную работу по "разбору полетов" с сотрудниками, чтобы на основе результатов оценки предпринимать конкретные шаги по повышению их эффективности.
2. **Активируйте функцию мотивации оценок.** Развернутое объяснение оценки позволит демонстрировать объективность оценивания и поможет мотивировать сотрудников совершенствоваться через понимание, в каком направлении следует работать.
3. **Активируйте функцию рекомендаций по улучшению оценки,** чтобы превратить обратную связь в мощный инструмент развития ваших сотрудников. Эта функция не просто укажет на слабые места, но и предложит конкретные действия для их исправления. Такой подход поможет каждому сотруднику понимать свои зоны роста, улучшать навыки и стремиться к более высоким показателям.
4. **Регулярно обновляйте вопросы для оценки.** Бизнес-процессы и запросы клиентов со временем меняются, поэтому пересматривайте список вопросов каждые 3-6 месяцев, чтобы они оставались актуальными и соответствовали текущим целям компании.

## Создать набор вопросов

{% stepper %}
{% step %}

### Перейдите в раздел Настройки → Критерии оценки

1. В верхнем меню наведите мышь на пункт "Настройки", на втором уровне выберите "Критерии оценки".
2. В открывшемся окне в правой части страницы (раздел "Наборы вопросов") нажмите на кнопку ➕ или "**Создать набор вопросов**" (если это первый активный набор вопросов)
   {% endstep %}

{% step %}

### Добавьте вопросы

<img src="/files/gEC20xWDrXkJEjmdi3v0" alt="" data-size="original">

1. **Введите название будущего набора вопросов.** Рекомендуем указывать "говорящее" название, отражающее суть хранящихся в нем вопросов и выделяющее его на фоне остальных наборов. Например "~~Набор 1~~" 👎 менее эффективное название, чем "*Вопросы при первичной консультации*" 👍
2. **Сформулируйте вопрос** с учетом приведенных выше рекомендаций. Его длина не должна превышать **200** символов.
3. Нажмите на кнопку ➕ для предварительного сохранения этого вопроса и перехода к работе со следующим вопросом.

<mark style="background-color:yellow;">Повторите шаги 2 и 3 по мере добавления каждого вопроса. В одном наборе может быть не более</mark> <mark style="background-color:yellow;"></mark><mark style="background-color:yellow;">**10**</mark> <mark style="background-color:yellow;"></mark><mark style="background-color:yellow;">вопросов.</mark>

<mark style="background-color:yellow;">Если вы решили переформулировать вопрос / нашли опечатку / хотите удалить вопрос / хотите взять его за основу для следующего вопроса, то в ходе работы с предсохраненными вопросами по нажатию на кнопку</mark> **⫶** <mark style="background-color:yellow;">вам доступны быстрые команды для дальнейшей работы:</mark> <mark style="background-color:yellow;"></mark><mark style="background-color:yellow;">**редактировать, копировать, удалить**</mark><mark style="background-color:yellow;">.</mark>

<img src="/files/uVqvkxgVp9Wb106dK2tK" alt="" data-size="original">

4. Когда все вопросы составлены, нажмите кнопку "**Сохранить**", чтобы сохранить набор вопросов и перейти к следующим шагам.
   {% endstep %}

{% step %}

### Присвойте набор вопросов кадровым единицам

См. инструкцию ниже.
{% endstep %}
{% endstepper %}

{% hint style="warning" %}
После сохранения набора вопросов, его **нельзя удалить.**&#x20;

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

Если данный набор вопросов уже был задействован в аналитике, но на данный момент он уже не актуален, то его нельзя будет редактировать, но можно будет **архивировать**, чтобы скрыть из общего списка активных вопросов.
{% endhint %}

## Присвоение набора вопросов кадровой единице

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

1. Нажмите на кнопку ➕ или кнопку "**Связать набор вопросов**" (кнопка видна в случае отсутствия активных связей между наборами вопросов и кадровыми единицами).
2. В левой части открывшегося окна выберите необходимые отделы или сотрудников, а в правой части выберите нужный набор вопросов. Сохраните выбор, нажав кнопку **"Присвоить".**

<figure><img src="/files/DY2oFcvAEq31W789MLz3" alt=""><figcaption><p>Окно присвоения набора вопросов кадровой единице</p></figcaption></figure>

{% hint style="info" %}

1. Одной кадровой единице можно присвоить **только один набор вопросов.**
2. Настройки по отдельному сотруднику имеют **выше приоритет над настройками отделов.** Если сотруднику А присвоен набор вопросов #1, но отделу, в котором он числится, присвоен набор вопросов #2, то диалоги сотрудника А будут оцениваться по набору #1.
   {% endhint %}

## Редактирование сохраненного набора вопросов

Пока сохраненный набор вопросов не был присвоен никаким кадровым единицам *(см. об этом в параграфе "Присвоение набора вопросов кадровой единице")* и не был задействован в аналитике, его **можно** отредактировать.

<figure><img src="/files/nAEzxtWzpfo7XhoXhlB8" alt=""><figcaption><p>Сохраненные наборы вопросов</p></figcaption></figure>

На данном примере наборы вопросов, с нулевым количеством оцененных звонков (помечены цифрой 1️⃣), доступны для **редактирования**, при условии, что к ним нет привязки по кадровым единицам.

Наборы вопросов, отмеченные цифрой 2️⃣, не доступны для редактирования (т.к. по ним уже были проанализированные звонки), но их можно **заархивировать**, если предварительно удалить активные связи с кадровыми единицами.

## Архивирование набора вопросов

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

<figure><img src="/files/NqoOfZa3HrwZGmPC0ZHY" alt=""><figcaption><p>Карточка "Набор вопросов"</p></figcaption></figure>

### Архивные наборы вопросов

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

<figure><img src="/files/Gopa3Bp7SF6NQNf3JqVS" alt=""><figcaption><p>Кнопка открытия архива наборов вопросов</p></figcaption></figure>

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

<figure><img src="/files/vmlrubr4kyuVK3gVn0oP" alt=""><figcaption><p>Карточка "Архивные наборы вопросов"</p></figcaption></figure>


# Расширенные скрипты

Для компаний, которым не достаточно аналитики на основе стандартных критериев оценки. Расширенные возможности и более тонкие настройки. Страница в работе.

## Зачем нужны продвинутые (расширенные) скрипты

Расширенные скрипты для углубленного анализа звонков помогают более многогранно оценивать звонки, а также использовать сложную логику подсчетов и другие полезные функции, чтобы вывести ваш ОКК на по-настоящему профессиональный уровень.&#x20;

### Смысловые блоки

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

{% hint style="info" %}
Количество смысловых блок как внутри скрипта, так и в целом по личному кабинеты - не ограничено.
{% endhint %}

#### Создание смысловых блоков

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

<figure><img src="/files/hAT7RcrORTX2wLerXVeI" alt="" width="375"><figcaption><p>Окно создания смыслового блока</p></figcaption></figure>

Смысловой блок будет доступен для добавления в ваши скрипты сразу после его создания в личном кабинете или на странице создания скрипта.

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

### Обязательность

Вы можете отметить любой вопрос обязательным, и тогда если данный пункт будет отсутствовать в разговоре, то автоматически будет поставлена оценка <mark style="color:red;">**-1**</mark>. То есть ответственность сотрудника за невыполнение обязательного пункта выше, чем за невыполнение НЕобязательного пункта. Более подробно логику оценивания см. на схеме ниже.

<figure><img src="/files/FsVYXdWwHlbyoraoAYsi" alt=""><figcaption><p>Логика оценивания каждого критерия в зависимости от его обязательности</p></figcaption></figure>

{% hint style="info" %}
Учитывая возможность получать минусовые оценки, есть вероятность **получить и совокупную оценку со знаком минус.**
{% endhint %}

### Обнуление

Если пункт имеет критическую важность для результативности разговора, то вы можете применить опцию **обнуления верхоуровневого результата (смысловой группы или всего скрипта).** Например, если задача представить себя и назвать компанию является критически важным пунктом в блоке "Приветствие", и она не была выполнена, то можно обнулить результат всей группы "Приветствие", в котором находится этот пункт, или даже обнулить результат всего скрипта.

{% hint style="warning" %}
При подсчетах результатов с включенным обнулением группы или скрипта, вы будете видеть оценку 0 на соответствующем уровне, однако система всё равно посчитает результат каждого пункта и поставит соответствующую оценку, хоть и верхоуровневая оценка будет обнулена.
{% endhint %}

### Коэффициенты

Не все вопросы имеют одинаковую важность в процессе анализа. Поэтому мы добавили в настройки каждого пункта **мультипликатор**, который позволяет "повысить вес" (иными словами - значимость) каждого пункта в зависимости от ваших бизнес задач. По умолчанию, ответ "Да" на вопрос равен 1 баллу, однако **вы можете повысить его значимость до 10 раз,** тогда при наличии этого пункта в разговоре оценка будет равна не 1, **1 \* мультипликатор,** например 5 вместо 1, если вы выберете повышающий коэффициент 5 для этого вопроса.

В то же время, мультипликатор работает аналогичным образом и с отрицательными оценками. Если по логике обязательности будет присвоена оценка <mark style="color:red;">**-1**</mark> на вопросе с коэффициентом 5, то и финальная оценка по данному критерию будет составлять **-5 баллов**.

### Индивидуальные диапазоны оценки

По умолчанию в нашей системе применяется система визуализации **"светофор"** на основе процентных показателей (<mark style="background-color:$danger;">**0-60%**</mark>, <mark style="background-color:yellow;">**61-89%**</mark>, <mark style="background-color:green;">**90-100%**</mark>). Однако при создании расширенного скрипта вы можете перераспределить диапазоны результатов в любых удобных вам пропорциях.&#x20;

<figure><img src="/files/HUBQHQ3PGhqyz1piTyIq" alt=""><figcaption><p>Пример индивидуальной настройки диапазона оценок</p></figcaption></figure>

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

### Рекомендации

Активируйте опцию AI-рекомендаций, чтобы система предложила пути улучшения качества работы сотрудника на основе отработанного скрипта.&#x20;

{% hint style="info" %}
**Внимание!** Рекомендация генерируется по итогам результативности всего скрипта, а не на каждый отдельный критерий.
{% endhint %}

## Карточка звонка

## Основные действия со скриптами

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

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

   <figure><img src="/files/qr1ZKnhBpO6HSrVjtmCW" alt=""><figcaption></figcaption></figure>
2. Вы перейдете на страницу создания скрипта. Где вам необходимо будет пошагово создать и настроить критерии, сгруппировав их по смысловым блокам.
3. Сохраните скрипт.

После сохранения скрипта вы сможете [**присвоить**](#prisvoenie-skripta-kadrovoi-edinice) его тем или иным кадровым единицам для применения по умолчанию, а также задействовать в нужных вам сценариях на странице [**"Фильтрация и правила"**](/settings/filtraciya).

#### Процесс создания и настройки скрипта

<figure><img src="/files/JeamafwwdsnUTzUv9HSb" alt=""><figcaption></figcaption></figure>

1. Введите **заголовок** скрипта. Используйте говорящее название, чтобы в дальнейшем не путаться между большим количеством однотипных скриптов.
2. Настройте под свои стандарты **шкалу оценки**.
3. В выпадающем списке выберите **смысловой блок** для группировки критериев. Там же внизу списка есть **кнопка для создания нового смыслового** блока.
4. Составьте критерий для оценки - это должен быть **вопрос в формате Да/Нет**, где Да - будет желаемым результатом. Прочие рекомендации по составлению вопросов см. в разделе [**Рекомендации**](#rekomendacii-po-rabote-so-skriptami).
5. Настройте **обязательность** критерия. От этого будет зависеть оценка: -1, 0 или 1. См. раздел [**Обязательность**](#obyazatelnost).
6. Настройте правила **обнуления** результата, если негативный результат по данному критерию несет критическую важность. Подробнее см. раздел [**Обнуление**](#obnulenie).
7. Добавьте **мультиплицирующий коэффициент** для повышения значимости результата. Подробнее см. раздел [**Коэффициенты**](#koefficienty).
8. Посмотрите **результат**, который может быть присвоен за этот критерий с учетом предыдущих настроек.
9. Вы можете воспользоваться кнопкой **быстрого копирования** вопроса для сохранения всех настроек и работы со следующим вопросом. Там же можно **удалить** вопрос, если он больше не нужен в текущем скрипте. <mark style="background-color:yellow;">Если данный вопрос единственный в скрипте, то происходит очистка всех полей.</mark>
10. Добавьте **следующий критерий** и повторите шаги 4-9.&#x20;
11. Вам доступны кнопки управления смысловым блоком: **удалить** блок и его содержимое (слева) и **свернуть** блок (справа).
12. Добавьте новый смысловой блок для удобной организации критериев. Подробнее о смысловых блоках см. в разделе [**Смысловые блоки**](#smyslovye-bloki).
13. Ознакомьтесь перед сохранением с **итоговыми характеристиками** скрипта.
14. Нажмите кнопку **"Сохранить"** завершить работу и выйти со страницы.

{% hint style="warning" %}
Общее ограничение длины строки в поле формулировки критерия - **300 символов с пробелами.**

Общее количество критериев как в смысловом блоке, так и в скрипте - **не ограничено.**&#x20;

Общее количество смысловых блоков внутри скрипта - **не ограничено.**

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

Вы можете менять порядок смысловых групп внутри скрипта. **Внимание: порядок расположения критериев внутри смыслового блока, а также порядок самих смысловых блоков влияет только на отображение в личном кабинете и не влияет на порядок отработки сотрудником в рамках скрипта!**
{% endhint %}

### Присвоение скрипта кадровой единице

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

1. Нажмите на кнопку ➕ или кнопку "**Присвоить скрипт**" (кнопка видна в случае отсутствия активных связей между наборами вопросов и кадровыми единицами).
2. В левой части открывшегося окна выберите необходимые отделы или сотрудников, а в правой части выберите нужный скрипт. Сохраните выбор, нажав кнопку **"Присвоить".**

<figure><img src="/files/DY2oFcvAEq31W789MLz3" alt=""><figcaption><p>Окно присвоения скрипта кадровой единице</p></figcaption></figure>

{% hint style="info" %}

1. Одной кадровой единице можно присвоить **только один скрипт.**
2. Настройки по отдельному сотруднику имеют **более высокий приоритет над настройками отделов.** Если сотруднику А присвоен скрипт #1, но отделу, в котором числится Сотрудник А, присвоен скрипт #2, то диалоги сотрудника А будут оцениваться поскрипту #1.
   {% endhint %}

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

Редактирование скриптов доступно, если по данному скрипту нет проанализированных звонков.

### Удаление

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

### Архивирование

Скоро...

## Рекомендации по работе со скриптами

{% hint style="info" %}
Формулировка вопросов может существенно повлиять на оценку. Рекомендуем формулировать вопросы так, чтобы ответы на них можно было предоставить в формате Да/Нет.&#x20;
{% endhint %}

1. **Фокусируйтесь на конкретных действиях.** Не “~~Был ли звонок полезным для клиента?~~” 👎 , а *“Удалось ли сотруднику предоставить полное решение проблемы клиента?”* 👍
2. **Формулируйте вопросы так, чтобы правильное поведение и предпочтительные ответы однозначно соответствовали ответу ДА, и за это был добавлен балл.** При этом заранее определите и четко опишите критерии для оценивания, чтобы исключить разночтения и обеспечить максимальную объективность интерпретации результатов.
3. **Добавляйте вопросы, которые оценивают эмпатию.** Например: *“Сотрудник был эмпатичен и выражал заинтересованность в решении проблемы клиента?”* Вопросы, касающиеся эмоционального интеллекта, помогают выявить важные аспекты взаимодействия, влияющие на лояльность клиента.
4. **Вопросы должны быть независимы друг от друга.** Каждый вопрос должен оценивать только один аспект звонка. Избегайте смешанных формулировок, вроде: “~~Был ли сотрудник вежлив и предоставил ли полезную информацию?~~”👎 Такие вопросы усложняют понимание, что именно пошло не так.
5. **Учитывайте специфику звонка.** Если звонки в вашей компании делятся по типам или целевым задачам (продажи, поддержка, консультация, "дожим", "прогрев", уведомление и т.д.), настройте вопросы под каждый сценарий.
   1. **Пример для продаж:** “Сотрудник представил преимущества продукта (долговечность, повышенную изностойкость и наличие дешевых расходников)?”
   2. **Пример для поддержки:** “Сотрудник предоставил четкое пошаговое решение проблемы клиента?”
6. **Будьте внимательны при перечислениях** - исходя из ваших формулировок система будет искать соответствие либо всем перечисленным условиям, либо хотя бы одному из них.

## Рекомендации для максимального использования возможностей функционала

1. **Не оценивайте только ради оценки.** Выстройте системную работу по "разбору полетов" с сотрудниками, чтобы на основе результатов оценки предпринимать конкретные шаги по повышению их эффективности.
2. **Активируйте функцию рекомендаций по улучшению оценки,** чтобы превратить обратную связь в мощный инструмент развития ваших сотрудников. Эта функция не просто укажет на слабые места, но и предложит конкретные действия для их исправления. Такой подход поможет каждому сотруднику понимать свои зоны роста, улучшать навыки и стремиться к более высоким показателям.
3. **Регулярно обновляйте вопросы для оценки.** Бизнес-процессы и запросы клиентов со временем меняются, поэтому пересматривайте список вопросов каждые 3-6 месяцев, чтобы они оставались актуальными и соответствовали текущим целям компании.


# Маяки

Подсветите ключевые слова для своего бизнеса

## Общая информация

**Поиск ключевых слов и фраз (маяков)** — это инструмент, который находит и выделяет заранее заданные слова и фразы из телефонного разговора. Он позволяет быстро находить ключевые темы, улучшая анализ качества обслуживания, понимание клиентских предпочтений и соблюдение стандартов общения. Это экономит время, исключает человеческий фактор и масштабируемо обрабатывает большие объемы данных.&#x20;

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

## Рекомендации по созданию списков маяков

1. **Определите цели списка маяков.** Сформулируйте, какие задачи вы хотите решить с помощью поиска ключевых слов в каждом списке маяков: контроль качества обслуживания, выявление жалоб, анализ упоминаний конкурентов, изучение клиентских предпочтений, измерение популярности акции и т.д. Это поможет задать релевантные слова и фразы.
2. **Используйте специфичные и релевантные слова.** Избегайте слишком общих слов, которые могут встречаться в любом контексте. Например, вместо «~~плохой~~» 👎 используйте «жалоба», «недоволен» или «не устраивает» 👍.
3. **Разделяйте маяки по категориям.** Группируйте ключевые слова по смыслу: позитивные (удовлетворенность, благодарность), негативные (жалоба, проблема), нейтральные (название продукта, уточняющие вопросы). Это упростит анализ.
4. **Добавляйте синонимы.** Учитывайте, что клиенты могут использовать разные формулировки для одних и тех же вещей. Например, для слова “проблема” можно включить “сложность”, “неудобство”, “трудности” и т.д.
5. **Регулярно обновляйте списки.** Пересматривайте и дополняйте ключевые слова на основе новых данных. Анализируйте свежие разговоры, чтобы выявлять новые важные термины.
6. **Учитывайте отраслевую специфику.** Включайте слова, которые связаны с вашей нишей или продуктом. Например, для SaaS решений это могут быть «подписка», «интеграция», «обновление», «поддержка» и т.д.
7. **Применяйте разные языки и культурные нюансы.** Если продукт используется в разных регионах, включайте ключевые слова на соответствующих языках, а также учитывайте локальные выражения.
8. **Тестируйте списки.** Протестируйте созданные списки на небольшом объеме звонков, чтобы убедиться в их эффективности. Это позволит скорректировать их перед масштабным применением.

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

## Создать список маяков

{% stepper %}
{% step %}

### Перейдите в раздел Настройки → Маяки

1. В верхнем меню наведите мышь на пункт "Настройки", на втором уровне выберите "Маяки".
2. В открывшемся окне в правой части страницы (раздел "Список маяков") нажмите на кнопку ➕ или "**Создать список маяков**" (кнопка видна, если ранее списки маяков еще не были созданы).
   {% endstep %}

{% step %}

### Добавьте ключевые слова и фразы

<img src="/files/8NEgMpW65awb2GCOQEUD" alt="" data-size="original">

1. **Введите название будущего списка маяков.** Рекомендуем указывать "говорящее" название, отражающее суть указываемых в нем ключевых слов и фраз, и выделяющее его на фоне остальных списков. Например "~~Ключевые слова 1~~" 👎 менее эффективное название, чем "*Упоминания конкурентов*" или "Слова-табу" 👍
2. **Составьте список слов и фраз** с учетом приведенных выше рекомендаций. Общая длина списка может составить до **1.000** символов. Укажите каждый новый маяк с новой строки или через запятую.
3. Когда все маяки вписаны, нажмите кнопку "**Сохранить**", чтобы сохранить список маяков и перейти к следующим шагам.
   {% endstep %}

{% step %}

### Присвойте список маяков кадровым единицам

См. инструкцию ниже.
{% endstep %}
{% endstepper %}

{% hint style="warning" %}
После сохранения списка маяков, его **нельзя ни отредактировать, ни удалить.**&#x20;
{% endhint %}

## Присвоение списка маяков кадровой единице

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

1. Нажмите на кнопку ➕ или кнопку "**Присвоить список маяков**" (кнопка видна в случае отсутствия активных связей между наборами вопросов и кадровыми единицами).
2. В левой части открывшегося окна выберите необходимые отделы или сотрудников, а в правой части выберите нужный список маяков. Сохраните выбор, нажав кнопку **"Присвоить".**

<figure><img src="/files/I5JxrZ6AOM9JmvPhqyP1" alt=""><figcaption><p>Окно присвоения списка маяков кадровым единицам</p></figcaption></figure>

{% hint style="info" %}

1. Одной кадровой единице можно присвоить **только один список маяков.**
2. **Настройки для отдельного сотрудника имеют приоритет над настройками отдела.** Если сотруднику А назначен Список маяков #1, а его отделу — Список маяков #2, то диалоги сотрудника А будут оцениваться по Списку маяков #1.
   {% endhint %}


# Профиль

## Содержимое и функциональные возможности страницы

<figure><img src="/files/XHEm7UqVlujhmpUeA9xH" alt=""><figcaption><p>Вкладка "Настройки → Профиль"</p></figcaption></figure>

1. Отображение **логина и даты регистрации** аккаунта. Справочная информация.
2. Отображение основной **страны** расположения бизнеса. Этот параметр определяет **региональный сервер**, на обслуживающий вашу учетную запись.
3. **Настройка языка интерфейса.** Данная настройка индивидуальная и меняет язык интерфейса не для всех пользователей, имеющих доступ к личному кабинету, а только для вас.
4. **Настройка языка уведомлений.** Данная настройка является общей для всего аккаунта. Уведомления, которые мы будем направлять вам, будут приходить на выбранном языке, вне зависимости от того, какой язык интерфейса выбран у пользователей, имеющих доступ к вашему личному кабинету.
5. **Настройка часового пояса.** Данная настройка является единой для всего личного кабинета и определяет часовой пояс, под который адаптируется любое значение времени на всех страницах. Например, если ваш источник данных передает время звонка как 16:00 в часовом поясе **GMT+03:00 (например, Москва)**, но в настройках указан часовой пояс **GMT+01:00 (например, Рим),** то в этом случае все врменнЫе величины будут пересчитаны на **2 часа назад.**
6. Кнопка выхода из личного кабинета


# Ролевая модель доступов

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

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

## Уровни доступа

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

**Администратор** - полный доступ ко всем частям системы, включая настройки и результаты аналитики. *Количество администраторов не ограничено.*

Супервайзер -&#x20;

Сотрудник -&#x20;

## Условия подписки

Функционал ролевой модели доступов приобретается в виде отдельной ежемесячной подписки. Стоимость подписки представлена в таблице.&#x20;

<table><thead><tr><th data-type="number">KZT</th><th data-type="number">RUR</th><th data-type="number">USD</th><th data-type="number">EUR</th></tr></thead><tbody><tr><td>30000</td><td>5000</td><td>60</td><td>50</td></tr></tbody></table>

{% hint style="danger" %}
Тарификация происходит **каждые 30 дней** с дня первичного подключения функционала. При этом списание средств происходит **даже при отсутствии новых аналитических сведений** в системе.
{% endhint %}


# Основная таблица

Главная страница сервиса состоит из нескольких частей:

* [**Верхняя строка меню**](#verkhnyaya-stroka);
* [**Ключевые метрики**](#klyuchevye-metriki) по звонкам в аккаунте и графики скользящих показателей;
* [**Основная таблица**](#osnovnaya-tablica);
* [**Нижняя часть**](#nizhnyaya-chast-stranicy) страницы.

<figure><img src="/files/2iFL8H5WraFPsI5hv81z" alt=""><figcaption><p>Главная страница aiokk</p></figcaption></figure>

## Верхняя строка

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

## Ключевые метрики

Прежде всего, мы отображаем ваш логин и подключенный источник данных.

<figure><img src="/files/lEBmnvOAlBSci9kUSUaP" alt=""><figcaption><p>Ключевые метрики аккаунта на главной странице</p></figcaption></figure>

Далее на панели представлены ключевые метрики анализа звонков за последние **30 дней** (по умолчанию). Графики отображают динамику следующих показателей, сгруппированных по дням:

1. **Проанализированные звонки за период** – количество обработанных системой звонков за выбранный период.
2. **Проанализированные минуты за период** – общее время разговоров, обработанных системой, выраженное в минутах.
3. **Количество уникальных абонентов за период** – число разных клиентов, с которыми были проведены разговоры. Учет ведется по телефонным номерам.
4. **Расходы за период** – суммарные затраты на аналитику звонков.

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

Далее следуют ключевые метрики, которые включают в себя количественные показатели по 6 статусам звонков в системе:

1. **Общее** количество звонков
2. Звонки с **проведенной** аналитикой
3. Звонки, находящиеся **в очереди** на аналитику
4. Звонки, **очищенные из очереди** на аналитику, т.е. оставленные без анализа
5. Звонки **с ошибками** аналитики
6. Звонки, **пропущенные аналитикой по требованию** правил.

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

## Основная таблица

Основная таблица включает в себя:

1. **счетчик** количества звонков, отображаемых в таблице с учетом фильтров;
2. элементы активного **управления** содержимым;
   1. **Настройка состава столбцов.** Позволяет отображать/скрывать необходимые столбцы, чтобы позволить вам фокусироваться на тех данных, которые вам необходимы. <mark style="background-color:purple;">В активном состоянии меняет состояние с черно-белого на цветное.</mark>
   2. **Фильтрация таблицы.** Раскрывающееся окно с возможностью настройки одновременно нескольких критериев для отображаемых звонков. <mark style="background-color:purple;">В активном состоянии меняет состояние с черно-белого на цветное, с добавление счетчика, отображающего количество параметров, задействованных в фильтрации. Клик по счетчку сбрасывает фильтр.</mark>
3. непосредственно **таблица** с содержимым аккаунта *(в зависимости от источника данных, состав может отличаться).*

<table data-full-width="true"><thead><tr><th width="159">Столбец</th><th width="563">Описание</th><th width="134" align="center">Сортировка</th><th>Фильтр</th></tr></thead><tbody><tr><td><strong>ID</strong></td><td>Уникальный внутренний идентификатор телефонного звонка</td><td align="center">✅ Есть</td><td></td></tr><tr><td><strong>Индикатор исключения из отчетов</strong></td><td>Соответствующая иконка отображается рядом с ID звонка</td><td align="center"></td><td></td></tr><tr><td><strong>Сотрудник</strong></td><td>Этот столбец включает в себя сразу несколько видов информации:<br>1. Пиктограмма направления звонка<br>2. Имя, фамилия и ID сотрудника, участвовавшего в звонке<br>3. Отдел сотрудника, участвовавшего в звонке</td><td align="center">✅ По имени сотрудника</td><td>✅  1, 2 и 3</td></tr><tr><td><strong>Клиент</strong></td><td>Телефонный номер клиента в международном формате</td><td align="center"></td><td>✅ Есть</td></tr><tr><td><strong>Дата звонка</strong></td><td>Дата и время совершения звонка, отображаемое в часовом поясе, выбранном вами в настройках аккаунта (Настройки → Профиль)</td><td align="center">✅ Есть</td><td>✅ Есть</td></tr><tr><td><strong>Тайминг</strong></td><td>Длительность совершенного звонка (чч:мм:сс)</td><td align="center">✅ Есть</td><td>✅ Есть</td></tr><tr><td><strong>Сценарий</strong></td><td>Условие, по которому был обработан звонок. Это может быть какое-то <em>правило</em>, если звонок подпадал под его критерии, или сценарий <em>по умолчанию,</em> если звонок не подошел ни под одно из правил.</td><td align="center"></td><td>✅ Есть</td></tr><tr><td><strong>Маркеры</strong></td><td><em>При включенном задании маркировки,</em> мы будем отображать маркеры, присвоенные данному звонку.</td><td align="center"></td><td>✅ Есть</td></tr><tr><td><strong>Результат</strong></td><td>Отображение статуса процесса аналитики включает демонстрацию результатов оценки по набору вопросов, если это предусмотрено сценарием. Мы отобразим итоговую оценку по вопросам, а также процентное соответствие разговора установленным критериям. В зависимости от уровня соответствия, процентное значение будет выделено цветом: <mark style="background-color:red;">красным (0–60%)</mark>, <mark style="background-color:yellow;">желтым (61–89%)</mark> или <mark style="background-color:green;">зеленым (90–100%)</mark>.</td><td align="center">✅ Есть</td><td>✅ По %</td></tr><tr><td><strong>Язык</strong></td><td><em>При включенном задании определения языков,</em> мы будем отображать языки, на которых происходило общение в разговоре.</td><td align="center"></td><td>✅ Есть</td></tr><tr><td><strong>Лояльность</strong></td><td><em>При включенном задании определения уровня клиентской удовлетворенности,</em> мы будем отображать числовую оценку по 10-бальной шкале с заливкой в соответствующем цвете по аналогии с результатами оценки.</td><td align="center">✅ Есть</td><td>✅ Есть</td></tr><tr><td><strong>Маяки</strong></td><td><em>При активированном поиске ключевых слов, упомянутых в разговоре,</em> мы будем отображать пиктограмму, если обнаружены соответствующие ключевые слова.</td><td align="center"></td><td>✅ Есть</td></tr><tr><td><strong>Перебивания</strong></td><td>Счетчик отображения количества перебиваний одного собеседника другим: общее количество + разбивка в скобках на две стороны.</td><td align="center">✅ Есть</td><td></td></tr><tr><td><strong>Цена</strong></td><td>Общая стоимость аналитики, выполненной по данному разговору, отображается в выбранной валюте аккаунта. Например, если разговор участвовал в переоценке, итоговая стоимость аналитики будет включать все понесенные затраты за все оценки.</td><td align="center">✅ Есть</td><td>✅ Есть</td></tr><tr><td><strong>Действия</strong></td><td><p>Быстрые действия с разговором:<br>1. Включить воспроизведение, не открывая карточку звонка.<br>2. Открыть <a href="/pages/R0Db2g5OldwnzfMb0cl7"><strong>карточку</strong></a> разговора<br>3. Меню дополнительных действий по звонку:<br> - Скачать запись звонка</p><p> - Поделиться ссылкой на аналитическую карточку звонка</p><p> - Не учитывать в аналитике / Вернуть в аналитику </p></td><td align="center"></td><td></td></tr></tbody></table>

## Нижняя часть страницы

* Переключатель количества записей на странице.
* Постраничный переключатель таблицы.
* Ссылки на сайт разработчика и публичные документы.


# Карточка разговора

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

<figure><img src="/files/rS0jXXo1lmLnXtdjYB3R" alt=""><figcaption><p>Карточка разговора</p></figcaption></figure>

Конструктивно карточку разговора можно разделить на 3 блока:

1. Общая информация о звонке
2. Панель вкладок
3. Контентное окно вкладки

## Общая информация

<figure><img src="/files/j4gqUSZY64CRAz1JBlbX" alt=""><figcaption><p>Общая информация в шапке карточки звонка</p></figcaption></figure>

<table><thead><tr><th width="65">№</th><th width="164">Элемент</th><th>Описание</th></tr></thead><tbody><tr><td>1</td><td>Кнопка "Назад"</td><td>Возвращает на предыдущую страницу, откуда была открыта карточка.</td></tr><tr><td>2</td><td>ID звонка</td><td>Всегда виден, помогает идентифицировать отдельные звонки из общей массы</td></tr><tr><td>3</td><td>Переход в подвязанную сущность</td><td>Если ваш источник данных передает информацию с ссылкой на подвязанную сущность, то по клику на эту кнопку вы напрямую перейдете в карточку подвязанной сущности на стороне  источника данных.</td></tr><tr><td>4</td><td>Поделиться</td><td>Копирует прямую внутреннюю ссылку на карточку разговора, доступ к которой может быть предоставлен только тем людям, кто авторизован в вашем личном кабинете</td></tr><tr><td>5</td><td>Закрыть окно</td><td>Убирает полностью карточку разговора с экрана пользователя</td></tr><tr><td>6</td><td>Информация о сотруднике</td><td><ol><li>Имя, фамилия и ID сотрудника</li><li>Отдел сотрудника</li></ol></td></tr><tr><td>7</td><td>Телефон клиента</td><td>Номер абонента в международном формате</td></tr><tr><td>8</td><td>Дата звонка</td><td>Отображает время звонка, адаптированное под выбранный в настройках профиля часовой пояс</td></tr><tr><td>9</td><td>Сценарий</td><td>Информация о том, по какому набору аналитики был обработан данный звонок. Варианты: по умолчанию или по правилу.</td></tr><tr><td>10</td><td>Языки</td><td>Если включена задача на распознавание языков, то мы покажем список языков, на которых происходил разговор </td></tr><tr><td>11</td><td>Маяки</td><td>Если включена задача на поиск маяков, то мы отобразим информацию о наличии либо отсутствии в разговоре заданных ключевых слов.</td></tr></tbody></table>

## Вкладки

<figure><img src="/files/JHFXgkLNjZLntpYpsfLv" alt=""><figcaption><p>Панель вкладок в карточке разговора</p></figcaption></figure>

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

### Транскрипт

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

<figure><img src="/files/zzXbeB2xDBYELi1RSjhF" alt=""><figcaption><p>Содержимое вкладки "Транскрипт" (в максимальной комплектакции)</p></figcaption></figure>

<table><thead><tr><th width="65">№</th><th width="176">Элемент</th><th>Описание</th></tr></thead><tbody><tr><td>13</td><td>Панель управления аудиозаписью</td><td>Горизонтальная панель управления аудиозаписью обладает сразу несколькими функциями (слева направо):<br>1. Кнопка воспроизведения / паузы<br>2. Тайминг воспроизведения: текущая позиция / общая длительность<br>3. Шкала воспроизведения, позволяющая по клику переходить в любую часть разговора.<br>4. Регулировка громкости<br>5. Регулировка скорости воспроизведения от от 0.5х до 2х<br>6. Кнопка скачивания аудиозаписи</td></tr><tr><td>14</td><td>Автослежение за диалогом</td><td>Когда функция активирована, диалог будет автоматически прокручиваться вниз по мере движения разговора, подсвечивая текущую реплику.</td></tr><tr><td>15</td><td>Строка поиска</td><td>Воспользуйтесь ей, чтобы быстро найти реплики с упоминанием нужных слов</td></tr><tr><td>16</td><td>Переключатель поиска</td><td>Если в разговоре присутствуют маяки, то, воспользовавшись переключателем, вы можете осуществлять поиск не только по разговору в целом, но и только среди найденных маяков. </td></tr><tr><td>17</td><td>Окно диалога</td><td>Весь диалог, разделенный на реплики с тайм-кодами и разнесенный по двум сторонам, чтобы визуально легче воспринимать разговор.</td></tr><tr><td>18</td><td>Воспроизвести реплику</td><td>Если вы хотите перейти к прослушиванию разговора с конкретной реплики, достаточно нажать на кнопку воспроизведения, расположенную перед тайм-кодом в левом верхнем углу каждой реплики. После завершения выбранной реплики, воспроизведение продолжится далее.</td></tr></tbody></table>

### Контент

Вкладка "Контент" состоит из нескольких разделов:

1. [**Маркеры**](/settings/markers)**.** Если задание на маркировку было активировано для данного разговора, то&#x20;
2. **Пересказ разговора (задание по умолчанию).** который предоставляет вам короткую выжимку по ключевым аспектам разговора, а также&#x20;

<figure><img src="/files/8xkW4DXg5lo3FGdNyJWU" alt=""><figcaption><p>Вкладка "Пересказ"</p></figcaption></figure>

### История касаний

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

<figure><img src="/files/v6Vtxa03m0Mf6t85rpXp" alt=""><figcaption><p>Вкладка "История касаний"</p></figcaption></figure>

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

<figure><img src="/files/ETbHqfI7tApYEFW4ipib" alt=""><figcaption><p>Вкладка "Удовлетворенность клиента"</p></figcaption></figure>

{% hint style="info" %}
В зависимости от сценария аналитики, по которому был обработан данный звонок, вкладки "Удовлетворенность клиента может отсутствовать", либо ее состав может отличаться от варианта в примере.
{% endhint %}

**Оценка.** *Если задание на оценку удовлетворенности клиента было предусмотрено в сценарии,* то вы увидите числовой индикатор по 10-бальной шкале, который в зависимости от результата будет закрашен в <mark style="background-color:red;">красный (0-6)</mark>, <mark style="background-color:yellow;">желтый (7-8)</mark> или <mark style="background-color:green;">зеленый (9-10)</mark> цвет. Для быстрого обзора, числовая метрика также отображается в заголовке вкладки.

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

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

### Вопросы #N

<figure><img src="/files/58kHxkZo15mGNkG0dCH7" alt=""><figcaption><p>Вкладка "Вопросы #N"</p></figcaption></figure>

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

Для быстрого обзора, числовая метрика с процентным показателем также отображается в заголовке вкладки и закрашена в <mark style="background-color:red;">красный (0-60%)</mark>, <mark style="background-color:yellow;">желтый (61-89%)</mark> или <mark style="background-color:green;">зеленый (90-100%)</mark> цвет.&#x20;

В верхней части вкладки отображаются:

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

При включенном задании с минимальным набором опций вам будет доступна только числовая оценка по 10-бальной шкале по каждому из вопросов.

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

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

### Ценообразование

<figure><img src="/files/wRg7BehzgTq4o4ivjdED" alt=""><figcaption><p>Вкладка "Ценообразование"</p></figcaption></figure>

На вкладке "Ценообразование" вы можете найти расчеты по стоимости проведенной аналитики по каждой их трех оценок.

1. В первом столбце указаны действия по аналитике, которые были произведены в рамках отработанного сценария.
2. Второй столбец показывает ценовую информацию и логику расчета стоимости, которая повторяет информацию со страницы [**Настройки → Аналитика**](/settings/analytics).
3. Третий столбец отображает количественную информацию применительно к данному конкретному разговору.
4. Четвертый столбец отображает стоимость каждого действия аналитика с итоговой суммой внизу.


# API для экспорта

Данный API предоставляет доступ к результатам анализа звонков, выполненного системой **aiokk**. С его помощью вы можете экспортировать структурированные данные по звонкам в формате JSON и использовать их для интеграции, отчётности или анализа в сторонних системах (CRM, BI, Excel и др.).

Система позволяет гибко фильтровать звонки по различным признакам, включая:

1. **Отделы** — фильтрация по названию конкретного подразделения или направления внутри компании.
2. **Операторы** — отбор звонков по имени (ФИО) сотрудника, который обработал звонок.
3. **Тип звонка** — классификация по направлению звонка:
   * Исходящий - 1&#x20;
   * Входящий - 2
   * Входящие с перенаправлением - 3&#x20;
   * Обратный звонок - 4
4. **Критерий оценки** — звонки, в которых применялся определённый скрипт/сценарий, созданный клиентом. Фильтрация производится по ID набора вопросов.
5. **Оценка удовлетворенности клиента (1–10)** — позволяет выбрать звонки, в которых аналитика дала числовую оценку удовлетворённости или лояльности клиента. Укажите значение от 1 до 10 для фильтрации.
6. **Сигналы (маяки)** — наличие ключевых слов и фраз, заранее настроенных в системе (фильтрация производится по самим ключевым словам).

### Методы API

1\) Получить результаты анализа звонков по **Отделам**

<mark style="color:green;">`POST`</mark> `/api/v1/export/dialogs/department`

**Headers**

| Name         | Value              |
| ------------ | ------------------ |
| Content-Type | `application/json` |

**Body**

| Name           | Type    | Description                                                                     |
| -------------- | ------- | ------------------------------------------------------------------------------- |
| token          | string  | Токен вы можете получить в своем кабинете aiokk на страницы "Экспорт через API" |
| department\_id | integer | ID департамента в вашей системе                                                 |

**Response**

{% tabs %}
{% tab title="200" %}

```json
[
    {
        "call": {
            "dialogId": 1138,
            "created_at": "2025-04-21T07:06:15.000000Z",
            "callerId": "+7 (777) 777 77 77",
            "callerIdClean": "7777777777",
            "callType": 1,
            "date": "2025-04-21 12:06:15+05",
            "durationSec": 64,
            "durationMin": 2
        },
        "operator": {
            "operatorId": 4,
            "fullName": "Иван Иванович",
            "intNum": 594,
            "departmentId": "84",
            "departmentName": "Отдел продаж"
        },
        "analytics": {
            "status": 3,
            "price": 150,
            "finishDate": "2025-04-18T11:59:56",
            "summary": "The conversation began with greetings from both the operator and the customer. The customer quickly expressed frustration over perceived misunderstandings, accusing the operator of not grasping their concerns, and asserted that their problem was not being addressed. Phrases such as 'вы должны понять это ваша проблема' and 'вы не понимаете' indicated the customer's dissatisfaction with the operator's responses. The operator attempted to communicate service limitations but struggled to gain the customer's trust or convey clarity. The dialogue revealed a high level of tension, with raised voices and accusations from the customer about the operator's competence.",
            "languages": [
                "ru"
            ],
            "clientLoyalty": {
                "currentGrade": 2,
                "description": "The customer expressed frustration throughout the conversation, indicating a lack of understanding and perceived lack of attention from the operator. Phrasing like 'вы ничего не понимаете' and 'вы неадекватны' suggests high dissatisfaction with the service. The operator's handling of inquiries was ineffective, leading to a strained interaction.",
                "recommendation": "Implement a follow-up communication that clarifies the service terms and assures the customer of support. Additionally, consider training on empathy techniques and effective communication strategies for handling frustrated customers."
            },
            "evaluationCriteria": {
                "evaluationId": 27,
                "evaluationTitle": "Вопросы по умолчанию",
                "eCurrentGrade": 31,
                "maxGrade": 100,
                "evaluationRecommendation": "To enhance the quality of service, operators should receive training on active listening and managing difficult conversations. Implementing a script that guides operators on how to validate customer emotions without escalating conflict can also help in future interactions.",
                "criterion1": {
                    "description1": "Although the operator greeted the customer politely, the overall tone quickly turned negative due to the operator's inability to address the customer's concerns effectively.",
                    "mark1": 3
                },
                "criterion2": {
                    "description2": "The operator struggled to communicate effectively, leading to confusion rather than clarity in addressing the customer's issues.",
                    "mark2": 4
                },
                "criterion3": {
                    "description3": "The operator did not demonstrate effective listening skills, interrupting the customer multiple times and failing to acknowledge their frustrations adequately.",
                    "mark3": 2
                },
                "criterion4": {
                    "description4": "The operator's attempts to address the customer's problem were inefficient, resulting in an unresolved situation that heightened customer dissatisfaction.",
                    "mark4": 3
                },
                "criterion5": {
                    "description5": "The operator did not show initiative or offer any additional support to help resolve the customer's problems during the interaction.",
                    "mark5": 1
                },
                "criterion6": {
                    "description6": "Professional language was used, but the delivery was overshadowed by the overall negative tone of the conversation.",
                    "mark6": 5
                },
                "criterion7": {
                    "description7": "The operator's speech was not consistently calm, especially when the customer became agitated, leading to an escalation in conflict.",
                    "mark7": 3
                },
                "criterion8": {
                    "description8": "While the operator followed company standards in greetings and protocols, adherence faltered under pressure from the customer's frustrations.",
                    "mark8": 5
                },
                "criterion9": {
                    "description9": "The customer was clearly unhappy with the interaction, emphasizing their dissatisfaction and escalating the conversation with complaints.",
                    "mark9": 2
                },
                "criterion10": {
                    "description10": "Overall service quality was poor due to ineffective communication, lack of listening skills, and insufficient resolution of the customer's issues.",
                    "mark10": 3
                }
            },
            "signals": {
                "signalsTitle": "сенсата, стоп слова",
                "count": 24,
                "mentionedSignals": "вам не подходит, у вас недостаточно средств, не перебиваете, вы не понимаете, блин, может быть, мы не можем снизить цену, гарантируем сто процентов, вы должны понять, послушайте меня, не кричите, вы кто вообще, а вы кто, почему вы кричите, почему вы так выражаетесь, зачем вы так говорите, вы ничего не понимаете, вы же не знаете, вы вышли из себя, вы не адекватны, вы ведете себя странно, некорректно, агрессивно, это ваша проблема"
            },
            "markers": []
        }
    },
    ...
]
```

{% endtab %}

{% tab title="402" %}

```json
{
  "error": "API not paid",
  "code": "Your API subscription has expired or not been paid."
}

{
  "error": "API not paid",
  "code": "Payment for API access is required. Please complete the payment to continue."
}
```

{% endtab %}

{% tab title="403" %}

```json
{
  "error": "API functionality is disabled",
  "message": "The requested API functionality has been disabled. Please contact support for more details."
}
```

{% endtab %}

{% tab title="404" %}

```json
{
  "error": "Token not found",
  "message": "The access token is missing or invalid. Please provide a valid token to authenticate the request."
}
```

{% endtab %}

{% tab title="502" %}

```
// Сервис не доступен
```

{% endtab %}
{% endtabs %}

2\) Получить результаты анализа звонков по **ФИО оператора**

<mark style="color:green;">`POST`</mark> `/api/v1/export/dialogs/operator`

**Headers**

| Name         | Value              |
| ------------ | ------------------ |
| Content-Type | `application/json` |

**Body**

| Name           | Type   | Description                                                                     |
| -------------- | ------ | ------------------------------------------------------------------------------- |
| token          | string | Токен вы можете получить в своем кабинете aiokk на страницы "Экспорт через API" |
| operator\_name | string | ФИО оператора (Иван)                                                            |

**Response**

{% tabs %}
{% tab title="200" %}

```json
[
    {
        "call": {
            "dialogId": 1138,
            "created_at": "2025-04-21T07:06:15.000000Z",
            "callerId": "+7 (777) 777 77 77",
            "callerIdClean": "7777777777",
            "callType": 1,
            "date": "2025-04-21 12:06:15+05",
            "durationSec": 64,
            "durationMin": 2
        },
        "operator": {
            "operatorId": 4,
            "fullName": "Иван Иванович",
            "intNum": 594,
            "departmentId": "84",
            "departmentName": "Отдел продаж"
        },
        "analytics": {
            "status": 3,
            "price": 150,
            "finishDate": "2025-04-18T11:59:56",
            "summary": "The conversation began with greetings from both the operator and the customer. The customer quickly expressed frustration over perceived misunderstandings, accusing the operator of not grasping their concerns, and asserted that their problem was not being addressed. Phrases such as 'вы должны понять это ваша проблема' and 'вы не понимаете' indicated the customer's dissatisfaction with the operator's responses. The operator attempted to communicate service limitations but struggled to gain the customer's trust or convey clarity. The dialogue revealed a high level of tension, with raised voices and accusations from the customer about the operator's competence.",
            "languages": [
                "ru"
            ],
            "clientLoyalty": {
                "currentGrade": 2,
                "description": "The customer expressed frustration throughout the conversation, indicating a lack of understanding and perceived lack of attention from the operator. Phrasing like 'вы ничего не понимаете' and 'вы неадекватны' suggests high dissatisfaction with the service. The operator's handling of inquiries was ineffective, leading to a strained interaction.",
                "recommendation": "Implement a follow-up communication that clarifies the service terms and assures the customer of support. Additionally, consider training on empathy techniques and effective communication strategies for handling frustrated customers."
            },
            "evaluationCriteria": {
                "evaluationId": 27,
                "evaluationTitle": "Вопросы по умолчанию",
                "eCurrentGrade": 31,
                "maxGrade": 100,
                "evaluationRecommendation": "To enhance the quality of service, operators should receive training on active listening and managing difficult conversations. Implementing a script that guides operators on how to validate customer emotions without escalating conflict can also help in future interactions.",
                "criterion1": {
                    "description1": "Although the operator greeted the customer politely, the overall tone quickly turned negative due to the operator's inability to address the customer's concerns effectively.",
                    "mark1": 3
                },
                "criterion2": {
                    "description2": "The operator struggled to communicate effectively, leading to confusion rather than clarity in addressing the customer's issues.",
                    "mark2": 4
                },
                "criterion3": {
                    "description3": "The operator did not demonstrate effective listening skills, interrupting the customer multiple times and failing to acknowledge their frustrations adequately.",
                    "mark3": 2
                },
                "criterion4": {
                    "description4": "The operator's attempts to address the customer's problem were inefficient, resulting in an unresolved situation that heightened customer dissatisfaction.",
                    "mark4": 3
                },
                "criterion5": {
                    "description5": "The operator did not show initiative or offer any additional support to help resolve the customer's problems during the interaction.",
                    "mark5": 1
                },
                "criterion6": {
                    "description6": "Professional language was used, but the delivery was overshadowed by the overall negative tone of the conversation.",
                    "mark6": 5
                },
                "criterion7": {
                    "description7": "The operator's speech was not consistently calm, especially when the customer became agitated, leading to an escalation in conflict.",
                    "mark7": 3
                },
                "criterion8": {
                    "description8": "While the operator followed company standards in greetings and protocols, adherence faltered under pressure from the customer's frustrations.",
                    "mark8": 5
                },
                "criterion9": {
                    "description9": "The customer was clearly unhappy with the interaction, emphasizing their dissatisfaction and escalating the conversation with complaints.",
                    "mark9": 2
                },
                "criterion10": {
                    "description10": "Overall service quality was poor due to ineffective communication, lack of listening skills, and insufficient resolution of the customer's issues.",
                    "mark10": 3
                }
            },
            "signals": {
                "signalsTitle": "сенсата, стоп слова",
                "count": 24,
                "mentionedSignals": "вам не подходит, у вас недостаточно средств, не перебиваете, вы не понимаете, блин, может быть, мы не можем снизить цену, гарантируем сто процентов, вы должны понять, послушайте меня, не кричите, вы кто вообще, а вы кто, почему вы кричите, почему вы так выражаетесь, зачем вы так говорите, вы ничего не понимаете, вы же не знаете, вы вышли из себя, вы не адекватны, вы ведете себя странно, некорректно, агрессивно, это ваша проблема"
            },
            "markers": []
        }
    },
    ...
]
```

{% endtab %}

{% tab title="402" %}

```json
{
  "error": "API not paid",
  "code": "Your API subscription has expired or not been paid."
}

{
  "error": "API not paid",
  "code": "Payment for API access is required. Please complete the payment to continue."
}
```

{% endtab %}

{% tab title="403" %}

```json
{
  "error": "API functionality is disabled",
  "message": "The requested API functionality has been disabled. Please contact support for more details."
}
```

{% endtab %}

{% tab title="404" %}

```json
{
  "error": "Token not found",
  "message": "The access token is missing or invalid. Please provide a valid token to authenticate the request."
}
```

{% endtab %}

{% tab title="502" %}

```
// Сервис не доступен
```

{% endtab %}
{% endtabs %}

3\) Получить результаты анализа звонков по **Типу звонка**

<mark style="color:green;">`POST`</mark> `/api/v1/export/dialogs/call_type`

**Headers**

| Name         | Value              |
| ------------ | ------------------ |
| Content-Type | `application/json` |

**Body**

| Name       | Type    | Description                                                                                               |
| ---------- | ------- | --------------------------------------------------------------------------------------------------------- |
| token      | string  | Токен вы можете получить в своем кабинете aiokk на страницы "Экспорт через API"                           |
| call\_type | integer | <p>Исходящий - 1 </p><p>Входящий - 2</p><p>Входящие с перенаправлением - 3 </p><p>Обратный звонок - 4</p> |

**Response**

{% tabs %}
{% tab title="200" %}

```json
[
    {
        "call": {
            "dialogId": 1138,
            "created_at": "2025-04-21T07:06:15.000000Z",
            "callerId": "+7 (777) 777 77 77",
            "callerIdClean": "7777777777",
            "callType": 1,
            "date": "2025-04-21 12:06:15+05",
            "durationSec": 64,
            "durationMin": 2
        },
        "operator": {
            "operatorId": 4,
            "fullName": "Иван Иванович",
            "intNum": 594,
            "departmentId": "84",
            "departmentName": "Отдел продаж"
        },
        "analytics": {
            "status": 3,
            "price": 150,
            "finishDate": "2025-04-18T11:59:56",
            "summary": "The conversation began with greetings from both the operator and the customer. The customer quickly expressed frustration over perceived misunderstandings, accusing the operator of not grasping their concerns, and asserted that their problem was not being addressed. Phrases such as 'вы должны понять это ваша проблема' and 'вы не понимаете' indicated the customer's dissatisfaction with the operator's responses. The operator attempted to communicate service limitations but struggled to gain the customer's trust or convey clarity. The dialogue revealed a high level of tension, with raised voices and accusations from the customer about the operator's competence.",
            "languages": [
                "ru"
            ],
            "clientLoyalty": {
                "currentGrade": 2,
                "description": "The customer expressed frustration throughout the conversation, indicating a lack of understanding and perceived lack of attention from the operator. Phrasing like 'вы ничего не понимаете' and 'вы неадекватны' suggests high dissatisfaction with the service. The operator's handling of inquiries was ineffective, leading to a strained interaction.",
                "recommendation": "Implement a follow-up communication that clarifies the service terms and assures the customer of support. Additionally, consider training on empathy techniques and effective communication strategies for handling frustrated customers."
            },
            "evaluationCriteria": {
                "evaluationId": 27,
                "evaluationTitle": "Вопросы по умолчанию",
                "eCurrentGrade": 31,
                "maxGrade": 100,
                "evaluationRecommendation": "To enhance the quality of service, operators should receive training on active listening and managing difficult conversations. Implementing a script that guides operators on how to validate customer emotions without escalating conflict can also help in future interactions.",
                "criterion1": {
                    "description1": "Although the operator greeted the customer politely, the overall tone quickly turned negative due to the operator's inability to address the customer's concerns effectively.",
                    "mark1": 3
                },
                "criterion2": {
                    "description2": "The operator struggled to communicate effectively, leading to confusion rather than clarity in addressing the customer's issues.",
                    "mark2": 4
                },
                "criterion3": {
                    "description3": "The operator did not demonstrate effective listening skills, interrupting the customer multiple times and failing to acknowledge their frustrations adequately.",
                    "mark3": 2
                },
                "criterion4": {
                    "description4": "The operator's attempts to address the customer's problem were inefficient, resulting in an unresolved situation that heightened customer dissatisfaction.",
                    "mark4": 3
                },
                "criterion5": {
                    "description5": "The operator did not show initiative or offer any additional support to help resolve the customer's problems during the interaction.",
                    "mark5": 1
                },
                "criterion6": {
                    "description6": "Professional language was used, but the delivery was overshadowed by the overall negative tone of the conversation.",
                    "mark6": 5
                },
                "criterion7": {
                    "description7": "The operator's speech was not consistently calm, especially when the customer became agitated, leading to an escalation in conflict.",
                    "mark7": 3
                },
                "criterion8": {
                    "description8": "While the operator followed company standards in greetings and protocols, adherence faltered under pressure from the customer's frustrations.",
                    "mark8": 5
                },
                "criterion9": {
                    "description9": "The customer was clearly unhappy with the interaction, emphasizing their dissatisfaction and escalating the conversation with complaints.",
                    "mark9": 2
                },
                "criterion10": {
                    "description10": "Overall service quality was poor due to ineffective communication, lack of listening skills, and insufficient resolution of the customer's issues.",
                    "mark10": 3
                }
            },
            "signals": {
                "signalsTitle": "сенсата, стоп слова",
                "count": 24,
                "mentionedSignals": "вам не подходит, у вас недостаточно средств, не перебиваете, вы не понимаете, блин, может быть, мы не можем снизить цену, гарантируем сто процентов, вы должны понять, послушайте меня, не кричите, вы кто вообще, а вы кто, почему вы кричите, почему вы так выражаетесь, зачем вы так говорите, вы ничего не понимаете, вы же не знаете, вы вышли из себя, вы не адекватны, вы ведете себя странно, некорректно, агрессивно, это ваша проблема"
            },
            "markers": []
        }
    },
    ...
]
```

{% endtab %}

{% tab title="402" %}

```json
{
  "error": "API not paid",
  "code": "Your API subscription has expired or not been paid."
}

{
  "error": "API not paid",
  "code": "Payment for API access is required. Please complete the payment to continue."
}
```

{% endtab %}

{% tab title="403" %}

```json
{
  "error": "API functionality is disabled",
  "message": "The requested API functionality has been disabled. Please contact support for more details."
}
```

{% endtab %}

{% tab title="404" %}

```json
{
  "error": "Token not found",
  "message": "The access token is missing or invalid. Please provide a valid token to authenticate the request."
}
```

{% endtab %}

{% tab title="502" %}

```
// Сервис не доступен
```

{% endtab %}
{% endtabs %}

4\) Получить результаты анализа звонков по ID набора **Критерия оценки**

<mark style="color:green;">`POST`</mark> `/api/v1/export/dialogs/question_pack`

**Headers**

| Name         | Value              |
| ------------ | ------------------ |
| Content-Type | `application/json` |

**Body**

| Name   | Type    | Description                                                                     |
| ------ | ------- | ------------------------------------------------------------------------------- |
| token  | string  | Токен вы можете получить в своем кабинете aiokk на страницы "Экспорт через API" |
| qp\_id | integer | ID набора **критерия оценки**, можно получить на странице "Критерии оценки"     |

**Response**

{% tabs %}
{% tab title="200" %}

```json
[
    {
        "call": {
            "dialogId": 1138,
            "created_at": "2025-04-21T07:06:15.000000Z",
            "callerId": "+7 (777) 777 77 77",
            "callerIdClean": "7777777777",
            "callType": 1,
            "date": "2025-04-21 12:06:15+05",
            "durationSec": 64,
            "durationMin": 2
        },
        "operator": {
            "operatorId": 4,
            "fullName": "Иван Иванович",
            "intNum": 594,
            "departmentId": "84",
            "departmentName": "Отдел продаж"
        },
        "analytics": {
            "status": 3,
            "price": 150,
            "finishDate": "2025-04-18T11:59:56",
            "summary": "The conversation began with greetings from both the operator and the customer. The customer quickly expressed frustration over perceived misunderstandings, accusing the operator of not grasping their concerns, and asserted that their problem was not being addressed. Phrases such as 'вы должны понять это ваша проблема' and 'вы не понимаете' indicated the customer's dissatisfaction with the operator's responses. The operator attempted to communicate service limitations but struggled to gain the customer's trust or convey clarity. The dialogue revealed a high level of tension, with raised voices and accusations from the customer about the operator's competence.",
            "languages": [
                "ru"
            ],
            "clientLoyalty": {
                "currentGrade": 2,
                "description": "The customer expressed frustration throughout the conversation, indicating a lack of understanding and perceived lack of attention from the operator. Phrasing like 'вы ничего не понимаете' and 'вы неадекватны' suggests high dissatisfaction with the service. The operator's handling of inquiries was ineffective, leading to a strained interaction.",
                "recommendation": "Implement a follow-up communication that clarifies the service terms and assures the customer of support. Additionally, consider training on empathy techniques and effective communication strategies for handling frustrated customers."
            },
            "evaluationCriteria": {
                "evaluationId": 27,
                "evaluationTitle": "Вопросы по умолчанию",
                "eCurrentGrade": 31,
                "maxGrade": 100,
                "evaluationRecommendation": "To enhance the quality of service, operators should receive training on active listening and managing difficult conversations. Implementing a script that guides operators on how to validate customer emotions without escalating conflict can also help in future interactions.",
                "criterion1": {
                    "description1": "Although the operator greeted the customer politely, the overall tone quickly turned negative due to the operator's inability to address the customer's concerns effectively.",
                    "mark1": 3
                },
                "criterion2": {
                    "description2": "The operator struggled to communicate effectively, leading to confusion rather than clarity in addressing the customer's issues.",
                    "mark2": 4
                },
                "criterion3": {
                    "description3": "The operator did not demonstrate effective listening skills, interrupting the customer multiple times and failing to acknowledge their frustrations adequately.",
                    "mark3": 2
                },
                "criterion4": {
                    "description4": "The operator's attempts to address the customer's problem were inefficient, resulting in an unresolved situation that heightened customer dissatisfaction.",
                    "mark4": 3
                },
                "criterion5": {
                    "description5": "The operator did not show initiative or offer any additional support to help resolve the customer's problems during the interaction.",
                    "mark5": 1
                },
                "criterion6": {
                    "description6": "Professional language was used, but the delivery was overshadowed by the overall negative tone of the conversation.",
                    "mark6": 5
                },
                "criterion7": {
                    "description7": "The operator's speech was not consistently calm, especially when the customer became agitated, leading to an escalation in conflict.",
                    "mark7": 3
                },
                "criterion8": {
                    "description8": "While the operator followed company standards in greetings and protocols, adherence faltered under pressure from the customer's frustrations.",
                    "mark8": 5
                },
                "criterion9": {
                    "description9": "The customer was clearly unhappy with the interaction, emphasizing their dissatisfaction and escalating the conversation with complaints.",
                    "mark9": 2
                },
                "criterion10": {
                    "description10": "Overall service quality was poor due to ineffective communication, lack of listening skills, and insufficient resolution of the customer's issues.",
                    "mark10": 3
                }
            },
            "signals": {
                "signalsTitle": "сенсата, стоп слова",
                "count": 24,
                "mentionedSignals": "вам не подходит, у вас недостаточно средств, не перебиваете, вы не понимаете, блин, может быть, мы не можем снизить цену, гарантируем сто процентов, вы должны понять, послушайте меня, не кричите, вы кто вообще, а вы кто, почему вы кричите, почему вы так выражаетесь, зачем вы так говорите, вы ничего не понимаете, вы же не знаете, вы вышли из себя, вы не адекватны, вы ведете себя странно, некорректно, агрессивно, это ваша проблема"
            },
            "markers": []
        }
    },
    ...
]
```

{% endtab %}

{% tab title="402" %}

```json
{
  "error": "API not paid",
  "code": "Your API subscription has expired or not been paid."
}

{
  "error": "API not paid",
  "code": "Payment for API access is required. Please complete the payment to continue."
}
```

{% endtab %}

{% tab title="403" %}

```json
{
  "error": "API functionality is disabled",
  "message": "The requested API functionality has been disabled. Please contact support for more details."
}
```

{% endtab %}

{% tab title="404" %}

```json
{
  "error": "Token not found",
  "message": "The access token is missing or invalid. Please provide a valid token to authenticate the request."
}
```

{% endtab %}

{% tab title="502" %}

```
// Сервис не доступен
```

{% endtab %}
{% endtabs %}

5\) Получить результаты анализа звонков по **Оценки удовлетворенности клиента**

<mark style="color:green;">`POST`</mark> `/api/v1/export/dialogs/client_loyalty`

**Headers**

| Name         | Value              |
| ------------ | ------------------ |
| Content-Type | `application/json` |

**Body**

| Name            | Type    | Description                                                                     |
| --------------- | ------- | ------------------------------------------------------------------------------- |
| token           | string  | Токен вы можете получить в своем кабинете aiokk на страницы "Экспорт через API" |
| client\_loyalty | integer | <p>Введите любое значение от</p><p>1-10</p>                                     |

**Response**

{% tabs %}
{% tab title="200" %}

```json
[
    {
        "call": {
            "dialogId": 1138,
            "created_at": "2025-04-21T07:06:15.000000Z",
            "callerId": "+7 (777) 777 77 77",
            "callerIdClean": "7777777777",
            "callType": 1,
            "date": "2025-04-21 12:06:15+05",
            "durationSec": 64,
            "durationMin": 2
        },
        "operator": {
            "operatorId": 4,
            "fullName": "Иван Иванович",
            "intNum": 594,
            "departmentId": "84",
            "departmentName": "Отдел продаж"
        },
        "analytics": {
            "status": 3,
            "price": 150,
            "finishDate": "2025-04-18T11:59:56",
            "summary": "The conversation began with greetings from both the operator and the customer. The customer quickly expressed frustration over perceived misunderstandings, accusing the operator of not grasping their concerns, and asserted that their problem was not being addressed. Phrases such as 'вы должны понять это ваша проблема' and 'вы не понимаете' indicated the customer's dissatisfaction with the operator's responses. The operator attempted to communicate service limitations but struggled to gain the customer's trust or convey clarity. The dialogue revealed a high level of tension, with raised voices and accusations from the customer about the operator's competence.",
            "languages": [
                "ru"
            ],
            "clientLoyalty": {
                "currentGrade": 2,
                "description": "The customer expressed frustration throughout the conversation, indicating a lack of understanding and perceived lack of attention from the operator. Phrasing like 'вы ничего не понимаете' and 'вы неадекватны' suggests high dissatisfaction with the service. The operator's handling of inquiries was ineffective, leading to a strained interaction.",
                "recommendation": "Implement a follow-up communication that clarifies the service terms and assures the customer of support. Additionally, consider training on empathy techniques and effective communication strategies for handling frustrated customers."
            },
            "evaluationCriteria": {
                "evaluationId": 27,
                "evaluationTitle": "Вопросы по умолчанию",
                "eCurrentGrade": 31,
                "maxGrade": 100,
                "evaluationRecommendation": "To enhance the quality of service, operators should receive training on active listening and managing difficult conversations. Implementing a script that guides operators on how to validate customer emotions without escalating conflict can also help in future interactions.",
                "criterion1": {
                    "description1": "Although the operator greeted the customer politely, the overall tone quickly turned negative due to the operator's inability to address the customer's concerns effectively.",
                    "mark1": 3
                },
                "criterion2": {
                    "description2": "The operator struggled to communicate effectively, leading to confusion rather than clarity in addressing the customer's issues.",
                    "mark2": 4
                },
                "criterion3": {
                    "description3": "The operator did not demonstrate effective listening skills, interrupting the customer multiple times and failing to acknowledge their frustrations adequately.",
                    "mark3": 2
                },
                "criterion4": {
                    "description4": "The operator's attempts to address the customer's problem were inefficient, resulting in an unresolved situation that heightened customer dissatisfaction.",
                    "mark4": 3
                },
                "criterion5": {
                    "description5": "The operator did not show initiative or offer any additional support to help resolve the customer's problems during the interaction.",
                    "mark5": 1
                },
                "criterion6": {
                    "description6": "Professional language was used, but the delivery was overshadowed by the overall negative tone of the conversation.",
                    "mark6": 5
                },
                "criterion7": {
                    "description7": "The operator's speech was not consistently calm, especially when the customer became agitated, leading to an escalation in conflict.",
                    "mark7": 3
                },
                "criterion8": {
                    "description8": "While the operator followed company standards in greetings and protocols, adherence faltered under pressure from the customer's frustrations.",
                    "mark8": 5
                },
                "criterion9": {
                    "description9": "The customer was clearly unhappy with the interaction, emphasizing their dissatisfaction and escalating the conversation with complaints.",
                    "mark9": 2
                },
                "criterion10": {
                    "description10": "Overall service quality was poor due to ineffective communication, lack of listening skills, and insufficient resolution of the customer's issues.",
                    "mark10": 3
                }
            },
            "signals": {
                "signalsTitle": "сенсата, стоп слова",
                "count": 24,
                "mentionedSignals": "вам не подходит, у вас недостаточно средств, не перебиваете, вы не понимаете, блин, может быть, мы не можем снизить цену, гарантируем сто процентов, вы должны понять, послушайте меня, не кричите, вы кто вообще, а вы кто, почему вы кричите, почему вы так выражаетесь, зачем вы так говорите, вы ничего не понимаете, вы же не знаете, вы вышли из себя, вы не адекватны, вы ведете себя странно, некорректно, агрессивно, это ваша проблема"
            },
            "markers": []
        }
    },
    ...
]
```

{% endtab %}

{% tab title="402" %}

```json
{
  "error": "API not paid",
  "code": "Your API subscription has expired or not been paid."
}

{
  "error": "API not paid",
  "code": "Payment for API access is required. Please complete the payment to continue."
}
```

{% endtab %}

{% tab title="403" %}

```json
{
  "error": "API functionality is disabled",
  "message": "The requested API functionality has been disabled. Please contact support for more details."
}
```

{% endtab %}

{% tab title="404" %}

```json
{
  "error": "Token not found",
  "message": "The access token is missing or invalid. Please provide a valid token to authenticate the request."
}
```

{% endtab %}

{% tab title="502" %}

```
// Сервис не доступен
```

{% endtab %}
{% endtabs %}

6\) Получить результаты анализа звонков по **Сигналам (маяки)**

<mark style="color:green;">`POST`</mark> `/api/v1/export/dialogs/signals`

**Headers**

| Name         | Value              |
| ------------ | ------------------ |
| Content-Type | `application/json` |

**Body**

| Name         | Type    | Description                                                                     |
| ------------ | ------- | ------------------------------------------------------------------------------- |
| token        | string  | Токен вы можете получить в своем кабинете aiokk на страницы "Экспорт через API" |
| signal\_word | integer | Введите любое слова из пакета маяков (Пример: дорого)                           |

**Response**

{% tabs %}
{% tab title="200" %}

```json
[
    {
        "call": {
            "dialogId": 1138,
            "created_at": "2025-04-21T07:06:15.000000Z",
            "callerId": "+7 (777) 777 77 77",
            "callerIdClean": "7777777777",
            "callType": 1,
            "date": "2025-04-21 12:06:15+05",
            "durationSec": 64,
            "durationMin": 2
        },
        "operator": {
            "operatorId": 4,
            "fullName": "Иван Иванович",
            "intNum": 594,
            "departmentId": "84",
            "departmentName": "Отдел продаж"
        },
        "analytics": {
            "status": 3,
            "price": 150,
            "finishDate": "2025-04-18T11:59:56",
            "summary": "The conversation began with greetings from both the operator and the customer. The customer quickly expressed frustration over perceived misunderstandings, accusing the operator of not grasping their concerns, and asserted that their problem was not being addressed. Phrases such as 'вы должны понять это ваша проблема' and 'вы не понимаете' indicated the customer's dissatisfaction with the operator's responses. The operator attempted to communicate service limitations but struggled to gain the customer's trust or convey clarity. The dialogue revealed a high level of tension, with raised voices and accusations from the customer about the operator's competence.",
            "languages": [
                "ru"
            ],
            "clientLoyalty": {
                "currentGrade": 2,
                "description": "The customer expressed frustration throughout the conversation, indicating a lack of understanding and perceived lack of attention from the operator. Phrasing like 'вы ничего не понимаете' and 'вы неадекватны' suggests high dissatisfaction with the service. The operator's handling of inquiries was ineffective, leading to a strained interaction.",
                "recommendation": "Implement a follow-up communication that clarifies the service terms and assures the customer of support. Additionally, consider training on empathy techniques and effective communication strategies for handling frustrated customers."
            },
            "evaluationCriteria": {
                "evaluationId": 27,
                "evaluationTitle": "Вопросы по умолчанию",
                "eCurrentGrade": 31,
                "maxGrade": 100,
                "evaluationRecommendation": "To enhance the quality of service, operators should receive training on active listening and managing difficult conversations. Implementing a script that guides operators on how to validate customer emotions without escalating conflict can also help in future interactions.",
                "criterion1": {
                    "description1": "Although the operator greeted the customer politely, the overall tone quickly turned negative due to the operator's inability to address the customer's concerns effectively.",
                    "mark1": 3
                },
                "criterion2": {
                    "description2": "The operator struggled to communicate effectively, leading to confusion rather than clarity in addressing the customer's issues.",
                    "mark2": 4
                },
                "criterion3": {
                    "description3": "The operator did not demonstrate effective listening skills, interrupting the customer multiple times and failing to acknowledge their frustrations adequately.",
                    "mark3": 2
                },
                "criterion4": {
                    "description4": "The operator's attempts to address the customer's problem were inefficient, resulting in an unresolved situation that heightened customer dissatisfaction.",
                    "mark4": 3
                },
                "criterion5": {
                    "description5": "The operator did not show initiative or offer any additional support to help resolve the customer's problems during the interaction.",
                    "mark5": 1
                },
                "criterion6": {
                    "description6": "Professional language was used, but the delivery was overshadowed by the overall negative tone of the conversation.",
                    "mark6": 5
                },
                "criterion7": {
                    "description7": "The operator's speech was not consistently calm, especially when the customer became agitated, leading to an escalation in conflict.",
                    "mark7": 3
                },
                "criterion8": {
                    "description8": "While the operator followed company standards in greetings and protocols, adherence faltered under pressure from the customer's frustrations.",
                    "mark8": 5
                },
                "criterion9": {
                    "description9": "The customer was clearly unhappy with the interaction, emphasizing their dissatisfaction and escalating the conversation with complaints.",
                    "mark9": 2
                },
                "criterion10": {
                    "description10": "Overall service quality was poor due to ineffective communication, lack of listening skills, and insufficient resolution of the customer's issues.",
                    "mark10": 3
                }
            },
            "signals": {
                "signalsTitle": "сенсата, стоп слова",
                "count": 24,
                "mentionedSignals": "вам не подходит, у вас недостаточно средств, не перебиваете, вы не понимаете, блин, может быть, мы не можем снизить цену, гарантируем сто процентов, вы должны понять, послушайте меня, не кричите, вы кто вообще, а вы кто, почему вы кричите, почему вы так выражаетесь, зачем вы так говорите, вы ничего не понимаете, вы же не знаете, вы вышли из себя, вы не адекватны, вы ведете себя странно, некорректно, агрессивно, это ваша проблема"
            },
            "markers": []
        }
    },
    ...
]
```

{% endtab %}

{% tab title="402" %}

```json
{
  "error": "API not paid",
  "code": "Your API subscription has expired or not been paid."
}

{
  "error": "API not paid",
  "code": "Payment for API access is required. Please complete the payment to continue."
}
```

{% endtab %}

{% tab title="403" %}

```json
{
  "error": "API functionality is disabled",
  "message": "The requested API functionality has been disabled. Please contact support for more details."
}
```

{% endtab %}

{% tab title="404" %}

```json
{
  "error": "Token not found",
  "message": "The access token is missing or invalid. Please provide a valid token to authenticate the request."
}
```

{% endtab %}

{% tab title="502" %}

```
// Сервис не доступен
```

{% endtab %}
{% endtabs %}

Данный API предоставляет доступ к результатам анализа звонков, выполненного системой **aiokk**. С его помощью вы можете экспортировать структурированные данные по звонкам в формате JSON и использовать их для интеграции, отчётности или анализа в сторонних системах (CRM, BI, Excel и др.).

Система позволяет гибко фильтровать звонки по различным признакам, включая:

1. **Отделы** — фильтрация по названию конкретного подразделения или направления внутри компании..
2. **Операторы** — отбор звонков по имени (ФИО) сотрудника, который обработал звонок.
3. **Portal Number** — фильтрация по номеру телефона, через который поступил звонок (актуально при использовании нескольких SIP-номеров).
4. **Тип звонка** — классификация по направлению звонка:
   * Исходящий - 1&#x20;
   * Входящий - 2
   * Входящие с перенаправлением - 3&#x20;
   * Обратный звонок - 4
5. **Набор вопросов** — звонки, в которых применялся определённый скрипт/сценарий, созданный клиентом. Фильтрация производится по ID набора вопросов.
6. **Оценка клиента (1–10)** — позволяет выбрать звонки, в которых аналитика дала числовую оценку удовлетворённости или лояльности клиента. Укажите значение от 1 до 10 для фильтрации.
7. **Сигналы (маяки)** — наличие ключевых слов и фраз, заранее настроенных в системе (фильтрация производится по самим ключевым словам).

API защищён авторизацией через токен и поддерживает фильтрацию, пагинацию, ограничение по дате


# Экспорт в Albato

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

<figure><img src="/files/1aXzsRE9kGTg4zY7psE3" alt=""><figcaption></figcaption></figure>

Первым действием вам надо авторизоваться на платформе Albato. Если вы еще не зарегистрированы, то зарегистрируйтесь.&#x20;

1. Пройдите на страницу **Подключения**, как показано на скриншоте.
2. Нажмите на кнопку **Добавить подключение.**

Далее откроется окно с выбором доступных приложений для подключения. В поисковой строке введите **aiokk.**&#x20;

<figure><img src="/files/C3mF12G8o9tAlkY0cszM" alt=""><figcaption><p>Добавление нового подключения в Albato</p></figcaption></figure>

На следующем шаге нужно будет вписать данные из личного кабинета aiokk - логин и токен. **Токен** доступа является инструментом защиты ваших данных. <mark style="background-color:red;">Не сообщайте токен экспорта третьим лицам!</mark>

<figure><img src="/files/7ig8TaOmLztY3Az7vAzI" alt=""><figcaption></figcaption></figure>

* Включите **тумблер** возле заголовка **API для экспорта**
* Токен доступа (вы можете получить с страницы **Экспорт через API**)
* Логин (введите ваш логин вашего аккаунта **aiokk**)

<figure><img src="/files/A1Qs3Slm6qkBRfH6rZtE" alt=""><figcaption></figcaption></figure>

После заполнения данных нажмите кнопку **Далее. На открывшейся странице** скопируйте содержимое поля **Webhook.**&#x20;

<figure><img src="/files/BGL2cS2N576kmETGpbA5" alt=""><figcaption></figcaption></figure>

Перейдите в кабинете aiokk в раздел **Настройки → API для экспорта** и вставьте скопированную ссылку в поле **Ссылка на вебхук**.&#x20;

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

## Распространенные кейсы интеграции

### **Зачем клиенту интеграции aiokk с другими системами через Albato?**&#x20;

#### 📈 Повышение ценности и возврата от каждого звонка

Интеграции дают не просто “техническую связку”, а реальный прирост эффективности бизнеса. Ниже — ключевые деловые преимущества, которые получает компания при подключении aiokk к экосистеме через Albato:

#### 🔥 Превращение аналитики в действия

🟢 **Без интеграции:** аналитика живёт «внутри» aiokk и требует ручной обработки.

🟢 **С интеграцией:** каждый сигнал автоматически триггерит нужное действие — например, плохой звонок = задача в Trello, хороший звонок = добавление в аудиторию рекламы, “готов купить” = встреча в CRM.

#### 📣 Автоматизация маркетинга по итогам диалога

aiokk → Ads / соцсети: клиенты попадают в точные аудитории на основе смысла звонка, а не просто факта обращения.&#x20;

> 🎯 Например: звонок с темой “ипотека” → реклама по ипотеке. Не надо вручную сегментировать или настраивать сценарии — всё происходит автоматически.

Это **повышает конверсию в 2–3 раза,** т.к. человек получает именно то, о чём говорил.

#### 🧠 Контроль менеджеров без лишнего времени руководителя

Если стандартных возможностей нашей интеграции с Telegram не достаточно,  Cлабый звонок = уведомление, ошибка → комментарий, сильный звонок → поощрение. Всё без ручной проверки.&#x20;

> ⏱ Это экономит до 70% времени супервайзеров, сохраняя высокий контроль над качеством.

#### 📊 Накопление знаний для обучения и найма

aiokk → Google Sheets / Airtable: строятся живые таблицы по сотрудникам, темам, ошибкам.

Можно видеть, кто владеет ситуацией, а кто нет, и обучать точечно.

> 💡 Это основа для постоянного роста конверсии, даже при том же бюджете.

#### 📬 Улучшение клиентского опыта

aiokk → WhatsApp / SMS.RU: клиент получает follow-up именно с той информацией, которую запрашивал — без ожидания, путаницы и звонков “ещё раз”.

> Это уменьшает отток и увеличивает лояльность, особенно в конкурентных нишах.

#### 💼 Снижение зависимости от сотрудников

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

#### 🧩 Единая цифровая экосистема

Все данные (звонки, оценки, темы, номера) попадают в нужные системы без повторного ввода. Не нужно “копировать-вставить”, не теряется информация, не возникает двойных звонков.

> Это особенно критично в компаниях с несколькими отделами или филиалами.


# Telegram уведомления

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

## Как подключить уведомления в Telegram

Чтобы получать уведомления в Telegram, выполните следующие шаги:

{% stepper %}
{% step %}

### Перейдите в раздел «Настройки → Telegram»

На странице откроется интерфейс подключения. Здесь вы сможете связать ваш Telegram-аккаунт с системой уведомлений.
{% endstep %}

{% step %}

### Активируйте нашего бота в Telegram

3.1. В блоке подключения Telegram нажмите кнопку «**Открыть чат с ботом**».\
3.2. Telegram откроется в новом окне — нажмите Start или введите команду `/start`.\
3.3. Бот поприветствует вас и запросит ваш логин с платформы. Введите его.\
3.4. После этого вы получите сообщение об успешной привязке аккаунта вашего аккаунта Telegram к аккаунту aiokk и начнёте получать уведомления в соответствии с включенными событиями.

{% hint style="info" %}
Вы можете добавить нашего бота в группу, чтобы предоставить доступ к уведомлениям своим коллегам. Добавьте бота в группу в качестве администратора группы с доступом к сообщениям.

Далее выполните выше описанные шаги по аналогии с прямой подпиской на бота. Обратите внимание, что бот может отправлять уведомление только в один чат.
{% endhint %}
{% endstep %}

{% step %}

### Включите уведомления о необходимых событиях

2.1. Включите нужные уведомления, передвинув соответствующие тумблеры в активное состояние.\
2.2. При необходимости разверните дополнительные настройки в правом столбце, чтобы задать недостающие параметры.
{% endstep %}
{% endstepper %}

## Типы уведомлений

* **Уведомление о не успешно анализированным звонка для перезапуска на оценку;**\
  (Данное уведомление оповестит вас о том что определенный звонок не прошел анализ и не получил результат аналитики).
* **Уведомление о пополнений и о том что баланс приходит к концу и о том что баланс исчерпан;**\
  (Данное уведомление информирует вас о каждом факте пополнения баланса, а также предупреждает, когда остаток средств приближается к нулю или полностью израсходован. Это позволяет избежать прерывания сервиса).
* **Сводка за день;**\
  (Уведомление отправляется в установленное время с указанным часовым поясом и содержит обобщённые данные за сутки: количество звонков, результаты анализа, удовлетворённость клиентов, количество инцидентов и другие ключевые метрики).
* **Уведомление о низкой удовлетворенности клиента;**\
  (Если система фиксирует низкий уровень удовлетворённости клиента по результатам анализа звонка, вы получите уведомление с ссылкой на звонок для проверки).
* **Уведомление о низкой удовлетворенности клиента;**\
  (Если система фиксирует низкий уровень удовлетворённости клиента по результатам анализа звонка, вы получите уведомление с ссылкой на звонок для проверки).
* **Уведомление о низкой уровне отработки по скриптам;**\
  (Если система фиксирует низкий результат по скрипту, вы получите уведомление с ссылкой на звонок для проверки).
* **Уведомления по установленным сигналам (маяки);**\
  (Вы получите уведомление при срабатывании заранее настроенных сигналов — ключевых слов или фраз, которые система автоматически находит в разговорах. Настройка списка сигналов "маяки" осуществляется вручную в системе аналитики).

## Как подключить уведомления в Telegram:

Чтобы получать уведомления в Telegram, выполните следующие шаги:

1. Перейдите в раздел **«Настройки -> Telegram»**\
   На странице откроется интерфейс подключения — здесь вы сможете связать ваш Telegram-аккаунт с системой уведомлений.
2. Активируйте уведомления:\
   2.1. Включите нужные уведомления, передвинув соответствующие **тумблеры** в активное состояние.

   2.2. При необходимости разверните **дополнительные настройки** (нажмите на стрелку справа — «аккордеон»), чтобы задать параметры.<br>

   <figure><img src="/files/fxRZNkkiveZZDYt0X9Tx" alt=""><figcaption></figcaption></figure>
3. Подключите Telegram:\
   3.1. В блоке подключения Telegram нажмите кнопку **«Открыть чат с ботом»**.\
   3.2. Telegram откроется в новом окне — нажмите **Start** или введите команду `/start`.\
   3.3. Бот запросит ваш **логин с платформы** — введите его.\
   3.4. После этого вы получите сообщение об успешной привязке аккаунта — Telegram начнёт получать уведомления в соответствии с включёнными событиями.\ <br>


# Расширенные дашборды

Нельзя улучшить то, что нельзя измерить. Превратите инсайты в измеримые показатели.

Мы понимаем, что в отличие от отчета по CSI, критерии оценки являются сугубо индивидуальными настройками для каждой компании, поэтому в разделе Аналитики мы не размещаем никаких "стандартных" расширенных отчетов, а **собираем их индивидуально под ваш аккаунт.**&#x20;

Если в вашей команде нет специалиста, который мог бы автоматизировать экспорт данных из нашей системы и настроить их визуализацию в какой-нибудь системе BI-аналитики, или вам нужно развернуть быстрое и качественное решение, то мы предлагаем для своих клиентов подключение интерактивного аналитического дашборда на базе **Microsoft Power BI**.

## **Преимущества нашего дашборда**

1. Запускается без усилий с вашей стороны в течение 1 дня.
2. Интегрируется прямо в карточку приложения (для Битрикс24/amoCRM). Вы можете настроить доступ к дашборду с учетом вашей оргструктуры и корпоративной политики.
3. Доступен бесплатный демо-период 3 дня для изучения функционала дашборда. <mark style="background-color:blue;">Для активации дашборда на вашем аккаунте необходимо обратиться в техподдержку из личного кабинета.</mark>
4. Автоматическое ежедневное обновление. Мы устанавливаем по согласованию с вами до двух таймеров на автообновление в день.
5. Данные в дашбордах интерактивные. Вы можете кликать на любой элемент графиков, таблиц и иных визуальных элементов, при этом связанные метрики в других визуальных элементах будут пересчитываться, исходя из вашего выбора.
6. Метрики в дашборде собраны нашими профессиональными BI-аналитиками и призваны максимально прозрачно продемонстрировать "пульс" системы, отображая данные под различным углом, что позволяет изучать тренды и метрики разносторонне, делая процесс принятия решений более точным.
7. При необходимости, дашборд может быть дополнительно кастомизирован под вас.&#x20;

## Демо-стенд

<mark style="background-color:blue;">Мы скоро его подключим сюда</mark>

## Стоимость

Дашборд приобретается в виде отдельной ежемесячной подписки. Стоимость подписки представлена в таблице.&#x20;

<table><thead><tr><th data-type="number">KZT</th><th data-type="number">RUR</th><th data-type="number">USD</th><th data-type="number">EUR</th></tr></thead><tbody><tr><td>30000</td><td>5000</td><td>60</td><td>50</td></tr></tbody></table>

{% hint style="danger" %}
Тарификация происходит **каждые 30 дней** с дня первичного подключения дашборда, и списание средств за дашборд происходит **даже при отсутствии новых аналитических сведений** в системе.
{% endhint %}


# Page 3


# Баланс

Следите за финансовым состоянием своего аккаунта

Раздел “**Финансы**” позволяет вам управлять средствами, доступными для оплаты услуг. Здесь доступны:&#x20;

* различные способы [**пополнения**](#popolnenie) баланса,&#x20;
* инструменты [**управления очередью**](#ochistka-ocheredi) звонков;
* [**бюджетный калькулятор**](/finances/budgeting) для прогнозирования будущих расходов.

## Пополнение

Вы можете [**пополнить счёт** ](/finances/topup)аккаунта несколькими способами, в зависимости от валюты кабинета.

1. Банковской картой через Forte Bank - KZT, USD, EUR кабинеты
2. Счет на оплату (для Казахстана) - KZT, USD, EUR кабинеты
3. Robokassa (для России) - RUB кабинеты

## История пополнений

Получите детализированную информацию о всех транзакциях, связанных с вашим аккаунтом. Здесь вы можете:

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

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

## Очистка очереди

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

{% hint style="info" %}
Очистка очереди звонков доступна только если аналитика звонков выключена на вкладке "[**Настройки → Аналитика**](/settings/analytics#upravlenie)" и активные задачи по аналитике завершены.
{% endhint %}


# Бюджетирование

Быстро и прозрачно прогнозируйте бюджет на аналитику с высокой точностью

Оптимизируйте расходы и принимайте решения на основе нашего бюджетного калькулятора! Перейдите в личном кабинете на вкладку **Финансы → Бюджетирование** и произведите предварительные расчеты.

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

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

По готовности расчетов нажмите на кнопку "**Скачать коммерческое предложение**" и дождитесь загрузки документа.


# Рекуррентная оплата


# Пополнение баланса

## Пополнение баланса

## Закрывающие документы


# Page 5


# ПУБЛИЧНЫЕ ДОКУМЕНТЫ

Соблюдение законов - безусловный приоритет команды aiokk.

Мы работаем с клиентами в различных юрисдикциях и для нас важно **гармонизировать** с местными законами и международными нормами свои рабочие процессы и взаимодействие с Клиентами, чтобы обеспечить беспрепятственное использование нашего сервиса.&#x20;

Поэтому наши основные документы - **Лицензионное соглашение** и **Политика конфиденциальности** - для некоторых стран адаптированы под местные требования. Вы можете ознакомиться с ними в разделах ниже 👇&#x20;

{% tabs %}
{% tab title="Россия и Беларусь" %}
{% embed url="<https://aiokk.io/Ru-ru/privacy>" %}

{% embed url="<https://aiokk.io/Ru-ru/eula>" %}
{% endtab %}

{% tab title="Другие страны" %}
{% embed url="<https://aiokk.io/ru/privacy>" %}

{% embed url="<https://aiokk.io/ru/eula>" %}
{% endtab %}
{% endtabs %}


# Welcome to aiokk!

You’ve Found What You’ve Been Searching For! A lightning-fast setup, powerful functionality, and responsive customer support—all in one app.

In today’s fast-paced world, businesses need to improve the quality of their phone communications. However, traditional quality control methods come with significant limitations. These challenges inspired us to create **aiokk** — a revolutionary service designed to change the way businesses analyze and improve their calls.

* **Limited Staff Availability.** Quality control personnel are restricted by working hours and the number of conversations they can physically analyze each day.
  * How can you ensure 24/7 monitoring?
  * How many calls can one specialist realistically analyze in a single day?
* **Selective Monitoring.** Due to time and resource constraints, businesses often resort to partial monitoring, risking missed opportunities and oversight.
  * What criteria should you use to select calls for analysis?
  * How do you ensure important conversations don’t slip through the cracks?
* **Human Factor Challenges.** Even experienced evaluators can struggle with bias, lack of industry-specific expertise, or inconsistency.
  * How do you ensure objectivity and productivity?
  * How can industry-specific nuances be accurately accounted for?

### If you’re feeling bored, you can jump straight to another section.

<table data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-cover data-type="files"></th><th data-hidden></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><strong>Important information</strong></td><td>We highly recommend you don’t skip this page.</td><td></td><td></td><td><a href="/pages/TaIvNyZsb0KJJmVsg8qs">/pages/TaIvNyZsb0KJJmVsg8qs</a></td></tr><tr><td><strong>Creating an account</strong></td><td>It's a must—there’s no way around it! </td><td></td><td></td><td><a href="/pages/bORzNWxNHJ2FTsIBfe3S">/pages/bORzNWxNHJ2FTsIBfe3S</a></td></tr><tr><td><strong>Setting up the product</strong></td><td>Get Started with Connecting the Service</td><td></td><td></td><td><a href="/pages/PZZC0zds4QLC6AJoVtO3">/pages/PZZC0zds4QLC6AJoVtO3</a></td></tr></tbody></table>

### …or stick around for a couple of quick paragraphs 😉

**aiokk** is an automated, professional speech analytics system for businesses, powered by artificial intelligence.

The name “**aiokk**” is a play on words: “**AI**” (short for Artificial Intelligence) and “**OKK**” (Russian abbreviation for “Quality Control Department”). This reflects the core purpose of the product: ensuring high-quality phone communications for businesses using cutting-edge AI technologies.

For more information feel free to visit our web page 👇

{% embed url="<https://aiokk.io/en?utm_source=aiokk_gitbook>" %}

The system operates 24/7, analyzing **unlimited** phone calls **non-stop**, making this communication channel completely transparent, extracting valuable insights, providing analytics, and boosting your business’s conversion rates.


# Important information!

Don’t Skip This Page – It’s Important!

To ensure our system operates correctly and your investment works for you, there are a few important conditions to keep in mind:

1. **Compatible Call Sources.** Your call source (CRM, standalone telephony, custom-built system, etc.) must be on our list of compatible platforms. This guarantees smooth integration between systems.

   If your system isn’t currently supported but you’d like it to be, submit a request to our team [**via this link**](https://aiokk.io/en/request?utm_source=aiokk_gitbook). We’ll review your request and, if feasible, include it in our development plan.
2. **Two-Channel Call Recording.** Your conversations must be recorded in a two-channel format. Most modern telephony systems support this feature by default—you just need to enable it.
3. **Caution: Highly Addictive!** The ease of use and extensive functionality of our service quickly make it an essential tool for managers, analysts, and marketers. Expect to see noticeable improvements in your company’s performance from day one!
4. **Terms of Use Agreement.** By using our service, you agree to comply with our [**License Agreement**](https://aiokk.io/en/eula?utm_source=aiokk_gitbook), [**Privacy Policy**](https://aiokk.io/en/privacy?utm_source=aiokk_gitbook), and all other official documents referenced therein. We recommend taking a moment to ensure these conditions are met for a seamless and successful experience with our service!                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          &#x20;


# Advantages and features

It’s better to try it once than to read about it multiple times!

## Why Choose aiokk?

* **24/7 Automated Analytics:** Works nonstop without breaks, holidays, or overtime.
* **Simple Onboarding:** Easy registration and a seamless setup process.
* **Unbiased & Efficient:** Removes human subjectivity to ensure transparency.
* **Smart Call Filtering:** Flexible tools to prioritize the most critical calls.
* **Parallel Processing:** Analyze multiple conversations simultaneously.
* **Fast Results:** Analytics for calls of any length are delivered in seconds—or just a few minutes.
* **Industry Expertise with AI Training (Coming Soon):** Tailored insights with AI that adapts to your business’s unique needs.
* **Advanced Customization:** A wide range of analytics settings with support for 20+ languages.

Order a presentation of our product for your company right now 👇

{% embed url="<https://aiokk.io/en/request?utm_source=aiokk_gitbook>" %}

## Features

We are continuously working to expand the functional capabilities of our service, improving the quality of its results and broadening the range of applications for our solutions.

You can view the current list of features on the “[**Default Analytics**](/en/settings/analytics/default-analytics)” page.

### Additional features that enhance the overall efficiency of the service

<table><thead><tr><th width="205">Feature</th><th width="405">Description</th><th>Status</th></tr></thead><tbody><tr><td><strong>Multiservice Authorization</strong></td><td>Use an account from other services to create your profile.</td><td>🔧 In progress</td></tr><tr><td><strong>Custom Analytics Rules</strong></td><td>If your data source supports entity statuses, you can set up different analytics configurations for calls made at various stages. This feature has a higher priority than the default analytics setup. Don’t forget to enable the toggle and activate this function after configuration.</td><td>✅ Available</td></tr><tr><td><strong>Light and Dark Mode</strong></td><td>Choose between light or dark interface themes for better usability in different lighting conditions. Reduce eye strain and customize the service’s appearance to your preference.</td><td>🔧 In progress</td></tr><tr><td><strong>Multilingual Interface</strong></td><td>We are expanding the list of supported languages to make the service convenient for users worldwide. Select the appropriate language in your profile settings.</td><td>✅ Available<br>🔧 New languages soon</td></tr><tr><td><strong>Summary Analytics and Dashboards</strong></td><td>A tool for visualizing key data in the form of clear tables and graphs. Track metrics, analyze results, and make decisions based on up-to-date information—all in one place.</td><td>🔧 In progress</td></tr><tr><td><strong>Reevaluations</strong></td><td>Reevaluate individual or batch-analyzed calls using new criteria to view the same conversation from different perspectives.</td><td>🔧 In progress</td></tr><tr><td><strong>Event Logging</strong></td><td>A dedicated page for recording important events in your account.</td><td>🔧 In progress</td></tr><tr><td><strong>Notification Center</strong></td><td>View all important notifications and service updates in one place. Don’t miss a thing!</td><td>🔧 In progress</td></tr><tr><td><strong>Customizable Homepage Table</strong></td><td>Use adjustable columns to hide/show specific ones and focus on the most important information.</td><td>✅ Available</td></tr><tr><td><strong>Export to Excel</strong></td><td>Export call pools in clean or filtered formats to conduct deeper analysis in Microsoft Excel or BI systems compatible with exported files.</td><td>🔧 In progress</td></tr><tr><td><strong>CRM Entity Integration</strong></td><td><ol><li>Navigate to the entity card directly from the call card in aiokk.</li><li>Transfer analytics results directly into the entity timeline linked to the conversation.</li></ol></td><td>✅ Available</td></tr><tr><td><strong>Telegram Notifications</strong></td><td>Receive notifications about important analytics results and key events from your account directly in Telegram. A convenient way to stay informed wherever you are.</td><td>🔧 In progress</td></tr></tbody></table>

***


# Pricing

We have not only created an outstanding analytics functionality that no one else can offer, but we have also developed a flexible pricing policy that allows you to pay for the service in proportion to

## Tariff Logic and Pricing

Within the system, the billing unit is one **minute of analyzed conversation**. If there are extra seconds beyond the last full minute, the duration of the conversation will be **rounded up** to the nearest whole minute.

The system is highly customizable, so **the cost per minute of conversation analytics depends on the tasks** the system is required to perform for each conversation.

<figure><img src="/files/lvF4KcMJKToHDmJfuaHi" alt=""><figcaption><p>Analytics scope and service costs</p></figcaption></figure>

Most analytics tasks are priced using the formula ***(P1+P2+PN)\*M***, where P1, P2, and PN are the prices for each active analytics task, and M is the number of minutes. For example, for a 4-minute conversation that needs a **summary** ($0.012/minute) and customer satisfaction assessment ($0.005/minute), the cost is calculated as **($0.012 + $0.005) \* 4 minutes = $0.068** for the entire conversation, based on a total price of **$0.017 per minute** of conversation.

There are several tasks that are priced using a multiplier coefficient. For example, you can include operator quality assessment based on your own criteria, which costs **$0.005 per criterion**. Using the same 4-minute conversation example, if you add employee quality assessment with **3 criteria**, the analytics price per minute will be **\[$0.012 + $0.005 + ($0.005 \* 3 questions)] \* 4 minutes = $0.128** for the entire conversation, based on a total price of **$0.032 per minute** of conversation.

Pricing is calculated similarly for accounts using different currencies.

## Analytics cost per minute of call in different currencies

<table data-full-width="false"><thead><tr><th>Scope</th><th width="100">KZT</th><th width="100">RUB</th><th width="100">USD</th><th width="100">EUR</th><th width="100">AED</th></tr></thead><tbody><tr><td><strong>Call Summary</strong></td><td>5,00</td><td>1,00</td><td>0,012</td><td>0,010</td><td>0,040</td></tr><tr><td><strong>Language Detection</strong></td><td>5,00</td><td>1,00</td><td>0,012</td><td>0,010</td><td>0,040</td></tr><tr><td><strong>Customer Satisfaction Score</strong></td><td>2,00</td><td>0,40</td><td>0,005</td><td>0,004</td><td>0,016</td></tr><tr><td><strong>Score Improvement Recommendations</strong></td><td>3,00</td><td>0,60</td><td>0,007</td><td>0,006</td><td>0,024</td></tr><tr><td><strong>Score Detailed Justification</strong></td><td>5,00 </td><td>1,00</td><td>0,012</td><td>0,010</td><td>0,040</td></tr><tr><td><strong>Employee Evaluation Criteria</strong></td><td>2,00</td><td>0,40</td><td>0,005</td><td>0,004</td><td>0,016</td></tr><tr><td><strong>Overall Score Improvement Recommendations</strong></td><td>3,00</td><td>0,60</td><td>0,007</td><td>0,006</td><td>0,024</td></tr><tr><td><strong>Detailed Justification of Each Criterion Score</strong></td><td>2,00</td><td>0,40</td><td>0,005</td><td>0,004</td><td>0,016</td></tr><tr><td><strong>Signals Detection</strong></td><td>3,00</td><td>0,60</td><td>0,007</td><td>0,006</td><td>0,024</td></tr></tbody></table>

{% hint style="danger" %}
The pricing table is for reference only and may differ from the prices displayed in your Personal Account. In case of discrepancies, **the analytics cost indicated in your Personal Account takes precedence over this table.**
{% endhint %}

{% hint style="warning" %}
The billing and invoicing currency is selected once during initial account registration and cannot be changed later.
{% endhint %}

For your convenience, we have developed a [**Budget Calculator**](/en/finances/budgeting) that will help forecast analytics costs based on calculations for the most common combinations of analytics tasks. Check it out now! 👇

{% content-ref url="/pages/OtysXJMRQA8bkTlJsDdL" %}
[Budgeting](/en/finances/budgeting)
{% endcontent-ref %}

This way, you can manage your expenses within predictable limits and customize the analytics composition individually for different types of calls to maximize results and optimize your budget.&#x20;

After analytics is completed, a "[**Budgeting**](/en/finances/budgeting)" tab becomes available inside the conversation card, where the calculations shown above are displayed for each specific call.


# Частые вопросы

<details>

<summary></summary>

</details>


# Changelog

We are constantly working to improve the product and develop new features, and here we briefly and concisely reflect their history.

**If you have ideas or suggestions for enhancing our service and improving its performance, please contact us through this form 👇**

{% embed url="<https://aiokk.io/en/request?utm_source=aiokk_gitbook>" %}

## 2024

### 🎄 Major December Update

Exciting details and great news are coming soon…

### 30.11.2024 (Major Customer Development #1)

#### What’s New

1. New elements in the [**call details window**](/en/main-page/call-details-window): Call script and the date of analytics processing have been added.
2. Significant updates to [**rules**](/en/settings/analytics/rules):

* A new option, *“**Ignore and do nothing**”*, has been added to the list of actions within a rule. Avoid unnecessary costs if a call meets filter criteria but doesn’t require analysis.
* The cost per minute of analytics for each scenario is now **visible during rule configuration**.
* Rule [**archiving**](/en/settings/analytics/rules#udalenie-arkhivirovanie-i-vosstanovlenie-pravil): Historical data preservation is now possible, and you can continue working with rules even after they are deactivated.

3. [**Delayed start**](/en/settings/analytics#otlozhennyi-start) feature: Added for scheduling analytics to start at a later time.

#### What’s Improved or Redesigned

1. Increased character limit for questions: The limit per question has been raised **from 140 to 200 characters**, allowing for more detailed and accurate formulations in your question sets, which is expected to enhance evaluation quality.
2. Cosmetic changes in the [**main table**](/en/main-page/main-table):&#x20;

* Added percentage-based ratings derived from question set evaluations.
* Moved the analytics cost to a separate column.
* Added a column for the call ID.
* Reorganized call management buttons to the beginning of the table.

3. Cosmetic changes in the [**call details window**](/en/main-page/call-details-window):

* Displaying the call direction next to the phone number.
* Showing percentage-based quality scores instead of numerical values on the evaluation tab.
* Displaying the satisfaction score in the “Customer Satisfaction” tab header.

If you’ve read this far and still have questions, requests, or suggestions, feel free to write to us 👇

{% embed url="<https://aiokk.io/en/request?utm_source=aiokk_gitbook>" %}


# Team

**MASNAGET** is a company specializing in the development of innovative IT solutions aimed at automating and enhancing the efficiency of business processes. **Since 2015**, we have been creating and integrating cutting-edge products that help companies achieve their goals in sales and marketing automation while remaining a trusted technology partner you can rely on.

{% embed url="<https://masnaget.digital/?utm_source=aiokk_gitbook>" %}
Go to the Company's web site
{% endembed %}

If you’d like to submit a request about our product, feel free to reach out to us 👇

{% embed url="<https://aiokk.io/en/request?utm_source=aiokk_gitbook>" %}

If you want to become part of our team’s success story, let us know! We’re always happy to welcome passionate and highly efficient professionals to our ranks!

{% embed url="<https://astana.hh.kz/employer/3541099>" %}
Open the list of job vacancies on hh
{% endembed %}


# Signing up and onboarding

If you need assistance with setting up and implementing the product, feel free to contact us 👇

{% embed url="<https://aiokk.io/en/request?utm_source=aiokk_gitbook>" %}

## Registration Process

{% stepper %}
{% step %}

### Enter initial registration details

1. Open the page [**https://my.aiokk.io**](https://my.aiokk.io/signup?utm_source=aiokk_gitbook) in your browser
2. Enter your email address, create a password, and confirm the password according to security requirements to proceed to the next step.
3. If you have a promo code, enter it during registration. Your bonus will be credited after email verification.

<div data-full-width="false"><figure><img src="/files/KEex8AGPrg6ikjLWWm00" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}

### Select your country and accept the terms of service

<div data-full-width="false"><figure><img src="/files/NTA3p5DOL0DAntSTSIQT" alt=""><figcaption></figcaption></figure></div>

After this step, you will receive an email with a link to confirm your account within a few minutes.
{% endstep %}

{% step %}

### Confirm your account

Click the link in the email to activate your account and gain access to your personal account.
{% endstep %}

{% step %}

### Log in to your new account

Enter the login and password you used during registration and click the “Login” button.
{% endstep %}

{% step %}

### Provide basic details and marketing information

Fill in the requested information to help us prepare your account. **Note:** Once this window is closed, only the time zone and analytics result language will remain [**editable**](/en/settings/profile) later.

<div data-full-width="false"><figure><img src="/files/7K1B2Zq36tBo7aSWE4mr" alt=""><figcaption></figcaption></figure></div>

Done! If you activated a promo code we’ll credit you with a welcome bonus so you can start using the service right after setup.

<figure><img src="/files/qUKcbnTcEyvKRsK89w47" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Complete a short step-by-step service tutorial

Go through the technical onboarding to familiarize yourself with the system’s features and setup stages.
{% endstep %}

{% step %}

### Start configuring the system

Now you’re ready to get to work!
{% endstep %}
{% endstepper %}


# Promocodes

Activate a promo code during account registration to receive additional bonuses in the system.

{% hint style="warning" %}
**Important!** Only one promo code can be applied per account.
{% endhint %}

## Steps to Receive a Bonus via Promo Code

1. Enter a valid promo code during standard email registration (third-party authorization services are not allowed).
2. Confirm your email by clicking the link sent to the email address you provided during registration.
3. Log in to your newly created account.
4. Fill in the initial questionnaire.

<figure><img src="/files/MTlR8ZePo56sLjJxsKpp" alt=""><figcaption></figcaption></figure>

5. 🎉 Receive your bonus! The bonus amount depends on the specific promo code.

<figure><img src="/files/7snRpkFvVdRzqGY29wFM" alt=""><figcaption><p>Example of an Increased Bonus When Activating a Promo Code of a Corresponding Value</p></figcaption></figure>

## Promo Code Activation Terms

1. **Activation deadline:** Promo codes must be activated within the designated time frame; otherwise, they expire.
2. **Limited quantity:** Some promo codes are issued in limited quantities, e.g., 100 codes. This means the promo code can be used for a maximum of 100 accounts.
3. **Combined limitations:** For special cases, high-demand promo codes may require activation within a specified period and can only be applied to a limited number of accounts as per the promo code’s conditions.

## How to Use the Bonus

You can use the credited funds to analyze a greater number of telephone conversation minutes within our system. To forecast future expenses and plan your budget, you can use the [**budget calculator**](/en/finances/budgeting).


# Data Sources

<mark style="background-color:red;">Before You Start Using the System Please review the “</mark>[<mark style="background-color:red;">**Important Information**</mark>](/en/aiokk/important-information)<mark style="background-color:red;">” section if you haven’t done so already.</mark>

{% content-ref url="/pages/TaIvNyZsb0KJJmVsg8qs" %}
[Important information!](/en/aiokk/important-information)
{% endcontent-ref %}

**Preparation for Maximum Results:** To achieve optimal outcomes, we recommend making the necessary adjustments to your data source settings **before** integration. While the requirements are minimal, they are critically important.

If dual-channel recording is enabled and our system supports your data source, you can proceed with the connection.

## ❗️❗️❗️Key Information Before Connecting

Each of the data sources listed below has its own unique features, limitations, and capabilities for integration with our system.

{% hint style="info" %}
**Functionality Dependence on the Data Source:** Depending on the connected data source, some features in aiokk may be unavailable.
{% endhint %}

{% hint style="warning" %}
**Data Source Lock-In After Initial Connection:** Once a data source is connected and **at least one conversation has been analyzed**, you will **not** be able to connect a different type of data source or another source of the same type to the same account.

For instance, if you initially connected **amoCRM with the domain domain.amocrm.ru** and analyzed **at least one call**, you **cannot add another domain in amoCRM or any other data source type to this account.** This restriction is implemented to maintain data consistency and avoid confusion or conflicts.
{% endhint %}

{% hint style="danger" %}
**Domain Ownership Limitations:** The same domain **cannot be connected to two different accounts.**

For instance, if your **Bitrix24 portal with the domain domain.bitrix24.com** is connected to the account **<1@mail.ru>**, this domain **cannot be connected to another account until the link to <1@mail.ru> is disconnected**.
{% endhint %}


# Compatible Data Sources

Currently Supported Data Sources are listed below

## Data Sources Already Available in the System

### CRM Systems

<table data-view="cards"><thead><tr><th></th><th data-hidden data-card-target data-type="content-ref"></th><th data-hidden data-card-cover data-type="files"></th></tr></thead><tbody><tr><td><p><strong>Bitrix24</strong></p><p>Rules Support: <strong>YES</strong></p><p></p><p>Go to Instructions</p></td><td><a href="/pages/ELV9KnspfBx9KmTIBfSx">/pages/ELV9KnspfBx9KmTIBfSx</a></td><td><a href="/files/qb3zOhIMmeh6apT1J2J2">/files/qb3zOhIMmeh6apT1J2J2</a></td></tr><tr><td><p><strong>amoCRM / Kommo</strong></p><p>Rules Support: <strong>YES</strong></p><p></p><p>Go to Instructions</p></td><td><a href="/pages/JtI1yu0dtP3UPlgesvF0">/pages/JtI1yu0dtP3UPlgesvF0</a></td><td><a href="/files/O1y6ScJmWbKKLEpdVGrZ">/files/O1y6ScJmWbKKLEpdVGrZ</a></td></tr></tbody></table>

### Virtual Telephony

<table data-view="cards"><thead><tr><th></th><th data-hidden data-card-target data-type="content-ref"></th><th data-hidden data-card-cover data-type="files"></th></tr></thead><tbody><tr><td><p><strong>SipUni</strong></p><p>Rules Support: <strong>NO</strong></p><p></p><p>Go to Instructions</p></td><td><a href="/pages/yVJ9Vk3jH9HXtMKv6oTj">/pages/yVJ9Vk3jH9HXtMKv6oTj</a></td><td><a href="/files/60bsJC7MyDgsSiGzpP3x">/files/60bsJC7MyDgsSiGzpP3x</a></td></tr><tr><td><p><strong>Online PBX</strong></p><p>Rules Support: <strong>NO</strong></p><p></p><p>Go to Instructions</p></td><td><a href="/pages/kZ7o3n7nVZeZMv1IXwrr">/pages/kZ7o3n7nVZeZMv1IXwrr</a></td><td><a href="/files/dgc9B5oXbkWcEgMJCzo0">/files/dgc9B5oXbkWcEgMJCzo0</a></td></tr></tbody></table>

### Universal Webhook

This integration method is suitable for companies that use less common systems not currently supported by us, including custom-built ERP systems, CRM systems, SIP telephony, or other services.

<table data-view="cards"><thead><tr><th></th><th data-hidden data-card-cover data-type="files"></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td>Go to Instructions</td><td><a href="/files/dqLv2hFbcAFBbF6zuGS4">/files/dqLv2hFbcAFBbF6zuGS4</a></td><td><a href="/pages/BXZ5aUFibAqXX9ypmYj3">/pages/BXZ5aUFibAqXX9ypmYj3</a></td></tr></tbody></table>

## Integration with New Data Sources

We are continuously working on expanding the list of supported data sources for integration with aiokk.

If your system is not included in the list of supported data sources but you would like this capability to be added, you can submit a request to our technical department 👇&#x20;

{% embed url="<https://aiokk.io/en/request?utm_source=aiokk_gitbook>" %}

We will review your request and, if possible, add it to our implementation plan.


# CRM-systems

<table data-view="cards"><thead><tr><th></th><th data-hidden data-card-target data-type="content-ref"></th><th data-hidden data-card-cover data-type="files"></th></tr></thead><tbody><tr><td><p><strong>Bitrix24</strong></p><p>Rules Support: <strong>YES</strong></p><p></p><p>Go to instructions</p></td><td><a href="/pages/ELV9KnspfBx9KmTIBfSx">/pages/ELV9KnspfBx9KmTIBfSx</a></td><td><a href="/files/qb3zOhIMmeh6apT1J2J2">/files/qb3zOhIMmeh6apT1J2J2</a></td></tr><tr><td><p><strong>amoCRM / Kommo</strong></p><p>Rules Support: <strong>YES</strong></p><p></p><p>Go to instructions</p></td><td><a href="/pages/JtI1yu0dtP3UPlgesvF0">/pages/JtI1yu0dtP3UPlgesvF0</a></td><td><a href="/files/O1y6ScJmWbKKLEpdVGrZ">/files/O1y6ScJmWbKKLEpdVGrZ</a></td></tr></tbody></table>


# Bitrix24

This page is under construction...

## Requirements for Integration with Bitrix24

To ensure a successful connection, the **following requirements must be met**:

1. To integrate aiokk with Bitrix24, you need an **active Bitrix24 portal**. Whether it’s cloud-based or self-hosted, it doesn’t matter.
   1. **Don’t have a Bitrix24 account yet?** Fix this by [**registering your own cloud-based Bitrix24**](https://www.bitrix24.kz/create.php?p=8068335\&utm_source=aiokk_gitbook). If you prefer the self-hosted version, the MASNAGET Digital Studio team can assist you. Just [**submit a request**](https://masnaget.digital/bitrix24.html?utm_source=aiokk.gitbook) on our website!
   2. **For self-hosted Bitrix24 users:** Ensure you have an active subscription. Confirm that your portal has internet access and is not operating within a closed network.
2. **Necessary permissions:** You must have the right to install applications from the Bitrix24 Marketplace.
3. **aiokk account:** You must have a registered aiokk account. If you don’t have one yet, create an account following the instructions 👇

{% content-ref url="/pages/bORzNWxNHJ2FTsIBfe3S" %}
[Signing up and onboarding](/en/lets-start/signing-up-and-onboarding)
{% endcontent-ref %}

## Steps for Installing the Application

<figure><img src="/files/m3uld23V1uOjasilyuiB" alt=""><figcaption><p>Cloud-Based Bitrix24 Connection establishing guide</p></figcaption></figure>

{% stepper %}
{% step %}

### Select “Bitrix24” as a Data Source

1. Navigate to **Settings → Data Source**.
2. Select **Bitrix24** from the available sources.
3. Enter your **existing Bitrix24 domain** in the appropriate field.
   1. **For Cloud-Based Bitrix24 Portals:** Click the “**Check Connection**” button, then click “**Establish Connection**”.
   2. **For Self-Hosted Bitrix24 Portals:** You will need to additionally specify the **licensing country of your portal.** This ensures that we direct you to the **correct regional page** for our application in the Bitrix24 Marketplace.

      <figure><img src="/files/e0ZExwux5GJT8b0Feuez" alt=""><figcaption><p>Self-Hosted Bitrix24 Connection establishing guide</p></figcaption></figure>

{% endstep %}

{% step %}

### Install the aiokk Application from the Bitrix24 Marketplace

1. We will verify your Bitrix24 domain and **open** the portal in the current browser window.
2. If required, **log in** to the portal. If you’re already logged in, the aiokk application page in the Bitrix24 Marketplace will open directly.
3. On the aiokk application page, click “**Install**”, review and accept the terms and conditions, and click “**Install**” again.

<figure><img src="/files/45VKVwKLggBolVBIW2gT" alt=""><figcaption></figcaption></figure>

4. **Open the aiokk Application:** After installation, click “**Open**” in the installation window or refresh the page and access it from the left menu.
   {% endstep %}

{% step %}

### Establish Connection with Your aiokk Account

1. Open the application after installation and wait for it to fully load.
2. If the application has been installed correctly and the connection with your aiokk account is established, you will see the connection status and your login in the bottom left corner.

<figure><img src="/files/L2YOdA3FxLHJLq9dWZS5" alt=""><figcaption></figcaption></figure>

3. Great! The data source is connected. Return to your account in our service and continue the setup.
   {% endstep %}
   {% endstepper %}


# amoCRM / Kommo

The Connection Process is Identical for amoCRM and Kommo

## Successful Connection Requirements

To ensure a correct connection, **the following requirements must be met**:

1. You must have an **active amoCRM portal**.
2. You must have **permission to install applications** from amoMarket.
3. You must have a registered **aiokk account**. If you don’t have one, create an account following the instructions below 👇

{% content-ref url="/pages/bORzNWxNHJ2FTsIBfe3S" %}
[Signing up and onboarding](/en/lets-start/signing-up-and-onboarding)
{% endcontent-ref %}

## Connection Process

{% stepper %}
{% step %}

### Select “amoCRM” as the Data Source

1. Go to **Settings → Data Source** section.
2. Select **amoCRM** from the list of available sources.
3. Enter your **existing amoCRM domain** in the corresponding field.
4. Click the “**Establish Connection**” button.
5. If everything is done correctly, you will see further instructions for the next steps in amoCRM. Follow them carefully.

At this stage, the connection status will temporarily be “**Not Connected**”.
{% endstep %}

{% step %}

### Install the aiokk Application from amoMarket

1. Go to amoMarket.
2. Find the application “**aiokk | Professional AI-based voice calls analytics**” using the search bar or by navigating to the “**Analytics**” section.
3. Check the box to agree to the Policy terms and click “**External Payment**” in the app card. 💡 *Don't worry! The application is installed for free; no charges will be made.*
4. Open the newly installed aiokk app in your amoCRM account. If all steps were followed correctly, you will see your **aiokk account login** in the top right corner of the app.

<figure><img src="https://docs.aiokk.io/~gitbook/image?url=https%3A%2F%2F1446581478-files.gitbook.io%2F~%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FgNMA1d5zBCBazT9E0OTt%252Fuploads%252FpcCTCazADvRvjdLdcUV3%252F2024-11-23_22-53-13.png%3Falt%3Dmedia%26token%3D97d372ce-f3b8-46b3-88c8-216c9545e915&#x26;width=768&#x26;dpr=4&#x26;quality=100&#x26;sign=2a201ee1&#x26;sv=2" alt=""><figcaption><p>aiokk Interface Inside amoCRM</p></figcaption></figure>

5. Go back to “**Settings → Data Source**” and refresh the page. The connection status will change to “**Connected**”.
6. 🎉 Done! The data source is successfully connected. You can now proceed with further account setup!
   {% endstep %}
   {% endstepper %}

{% content-ref url="/pages/ClEOOFYxUbrxxDLZBLIX" %}
[Filtering](/en/settings/filtering)
{% endcontent-ref %}


# SIP telephony

<table data-view="cards"><thead><tr><th></th><th data-hidden data-card-cover data-type="files"></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><p><strong>SipUni</strong></p><p>Rules suppoert: <strong>NO</strong></p><p></p><p>Go to instruction</p></td><td><a href="/files/60bsJC7MyDgsSiGzpP3x">/files/60bsJC7MyDgsSiGzpP3x</a></td><td><a href="/pages/yVJ9Vk3jH9HXtMKv6oTj">/pages/yVJ9Vk3jH9HXtMKv6oTj</a></td></tr><tr><td><p><strong>Online PBX</strong></p><p>Rules suppoert: <strong>NO</strong></p><p></p><p>Go to instruction</p></td><td><a href="/files/dgc9B5oXbkWcEgMJCzo0">/files/dgc9B5oXbkWcEgMJCzo0</a></td><td><a href="/pages/kZ7o3n7nVZeZMv1IXwrr">/pages/kZ7o3n7nVZeZMv1IXwrr</a></td></tr></tbody></table>


# SipUni

This page is under construction...

**Documentation is in progress. Valuable information will be available here soon 🤗**


# Online PBX

**Documentation is in progress. Valuable information will be available here soon 🤗**


# Webhook

This page is under construction...

If your system is not listed among the supported data sources, but you have the technical capability to send POST requests from your system, you can use our Universal Webhook as a “bridge” to connect your data source to our system.

> **What is a Webhook?** A webhook is a method for automatically exchanging information between systems. It allows one system (e.g., your database, telephony, ERP, or CRM system) to send data to another system (e.g., aiokk) as soon as an event occurs. In our case, the event should be the completion of a phone call.

## How It Works

Set up your system to send us information about a new call via the webhook every time a phone call ends. You can configure your system to send data to our webhook only where it aligns with your business processes.

## Setup in the account

### Initial Configuration

To connect a third-party system via webhook, follow these steps in your personal account:

1\. Go to **Settings → Data Source** and select **Universal Webhook** as the data source.

2\. Copy the **token**, which you’ll use to generate the URL for POST requests.

{% hint style="warning" %}
**Important Notes**

1. Access to the data in your account is secured through verification with a unique token visible only in your personal account.
2. Never share your token with third parties! **Technical support will never ask for your account token.**
   {% endhint %}

### Token Replacement

If you need to change the token for any reason, use the dedicated button to generate a new one.

{% hint style="danger" %}
**Critical Note:** If you previously used the old token in your requests, the **webhooks with the old token will stop working after regeneration**. To restore functionality, you’ll need to r**eplace the old token with the new one** in all scenarios where the old webhook was used.
{% endhint %}

## Composing the Request

<mark style="color:green;">`POST`</mark> **`https://{my.aiokk.domain}/api/v1/{token}/call/new`**

This method is designed to create a new call entry with detailed information about the call, employee, analytics tasks, and related data.

### Preparing the Endpoint URL

To compose a correct endpoint URL, replace the following two placeholders in the provided URL: `https://{my.aiokk.domain}/api/v1/{token}/call/new`

1. **{my.aiokk.domain}:** This corresponds to the domain where your aiokk account is registered. To find your domain, log in to your aiokk account and check the domain in your browser’s address bar.

<figure><img src="/files/kWwQUhIkL8fWvo7R6PcI" alt=""><figcaption></figcaption></figure>

Example: In this case, it is **my.aiokk.kz**

2. **{token}:** This is the unique access token visible only on the **Settings → Data Source** page when the webhook is selected as the data source.

### **Headers**

| Name         | Value              |
| ------------ | ------------------ |
| Content-Type | `application/json` |

### **Request Body**

The request body is a JSON object consisting of three main blocks: **call, employee, and analytics.**

| Name | Type | Description |
| ---- | ---- | ----------- |
|      |      |             |
|      |      |             |

**Response**

{% tabs %}
{% tab title="200" %}

```json
{
}
```

{% endtab %}

{% tab title="400" %}

```json
{
}
```

{% endtab %}
{% endtabs %}


# Filtering

To stay focused on what matters most…

<figure><img src="/files/D4Gu1iMNO70bQEhRV2tx" alt=""><figcaption><p>Settings → Filtering. Call Filtering Block</p></figcaption></figure>

On this page, you can configure filters to analyze calls according to your business needs. By activating filtering, you set conditions for the system to automatically **evaluate only those conversations that meet the specified parameters.**

***

## Why Call Filtering is Important

**Call filtering** is a powerful tool for accurate and relevant analysis of customer interactions. It helps you:

1. **Focus on key data:** Eliminate irrelevant calls to enhance analytics accuracy and make better-informed decisions.
2. **Improve analysis quality:** Longer calls often contain more valuable information, while shorter ones may lack substance.
3. **Save resources:** Excluding unnecessary data reduces processing time and costs for analyzing irrelevant calls.
4. **Align analytics with business goals:** Setting filters tailored to your parameters (e.g., by departments or employees) makes data more precise and useful for specific tasks, such as evaluating employee performance or analyzing the operations of individual departments.

Call filtering ensures effective analytics, allowing you to focus on meaningful conversations, optimize processes, and make data-driven decisions.

{% hint style="info" %}
**Important Note:** Filters apply only to calls received by the system after the changes are saved. Calls that entered the system under previous filter settings will remain unchanged.
{% endhint %}

***

## Key Filtering Parameters

{% hint style="info" %}
The range of available filtering parameters depends on the capabilities of the connected data source. CRM systems typically provide the most comprehensive data.
{% endhint %}

1. **Call Direction:** Select calls for analysis, such as outgoing, incoming, redirected incoming, or callback requests.
2. **Virtual Numbers:** If multiple numbers are connected to your virtual telephony but not all need analysis, specify the SIP numbers to include in the analytics.
3. **Call Duration:** Filter calls based on their length (e.g., from 60 seconds and longer for reliable data).

{% hint style="info" %}
To ensure high-quality analytics, we recommend working with calls lasting **60 seconds or more.** Shorter calls may significantly lower data reliability, though your business specifics might require different thresholds.
{% endhint %}

4. **Personnel Units:** Define which employees’ or departments’ calls will be included in the filtering.

{% hint style="warning" %}
**How Filters Work:** All filters are applied **simultaneously**. Overly strict settings may result in no calls meeting the conditions for analysis. **Conversations excluded by the filters will not appear in the call list.**
{% endhint %}


# Analytics

## Technical Aspects

{% hint style="warning" %}
For the proper and complete functionality of our service, your calls must be recorded in **dual-channel format**. Most modern telephony systems support this feature by default—you just need to **enable it before starting to use our service**.
{% endhint %}

<figure><img src="/files/dkORHhVNFa9d2CZEj8oi" alt=""><figcaption><p>Call analytics algorythm</p></figcaption></figure>

## Control

<figure><img src="/files/zwsw4XuEnN9k7VJEoDxo" alt=""><figcaption><p>Analytics Management Block on the “Settings → Analytics” Tab</p></figcaption></figure>

Manage the status of automatic call analysis. Disabling analytics does not affect the recording of subsequent calls that pass the filters. These calls will be saved and queued for analysis, which will automatically start when the feature is re-enabled, provided the account balance is positive.

### Enable/Disable Automatic Analytics

Manage the status of automatic call analysis. Disabling analytics does not affect the recording of subsequent calls that pass the filters. These calls will be saved and queued for analysis, which will automatically start when the feature is re-enabled, provided the account balance is positive.

{% hint style="info" %}

1. Analytics can be enabled or disabled no more than **once per minute.**
2. If analytics is disabled while some calls are in the active processing phase, **their analysis will be completed, and the associated cost will be deducted from the balance.** All subsequent calls in the queue, along with new calls, will be **paused** until analytics is re-enabled.
3. Call analytics may stop **automatically** if the account balance is insufficient to process the next call in the queue. In such cases, analytics **cannot be manually re-enabled until the balance is replenished.**
   {% endhint %}

## Delayed Start

Activate the delayed analytics feature if analysis **needs to start with a 2-minute delay after the call ends rather than immediately.**

{% hint style="warning" %}
The delayed start applies to the entire account and cannot be configured for individual analytics rules.
{% endhint %}

This feature is particularly useful when the analytics scenario depends on **post-call changes**, such as moving an entity to a different stage/status. Two minutes are typically sufficient to input new data into the system and accurately capture the current status. This function ensures more precise and relevant analysis, tailored to dynamic workflows.


# Default analytics

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

{% hint style="info" %}
Единицей тарификации является **одна минута разговора**. При наличии секунд сверх полной минуты, длительность разговора будет **округлена вверх до целого числа** минут.
{% endhint %}

## Состав аналитики по умолчанию

Состав аналитики представляет собой **набор задач**, по которым проводится оценка разговоров по умолчанию, если разговор не подпадает ни под одно из активных [**правил**](/en/settings/analytics/rules). Выберите те задачи, которые наиболее соответствуют вашим бизнес-целям, чтобы создать детализированный анализ звонков.&#x20;

{% hint style="warning" %}
**Внимание!** Внесение изменений в любые настройки аналитики доступны только **в выключенном состоянии функции аналитики**.
{% endhint %}

<figure><img src="/files/wWW67lqXwTZ6mufVcLCJ" alt=""><figcaption><p>Настройки аналитики: язык результатов и состав аналитики по умолчанию</p></figcaption></figure>

<table data-header-hidden><thead><tr><th width="342">Функция</th><th>Описание</th></tr></thead><tbody><tr><td><strong>Выбор языка выдачи результатов аналитики</strong></td><td>Вне зависимости от языка/ов, на которых собеседники общались во время разговора, вы можете настроить язык, на котором мы будем предоставлять результаты аналитики.</td></tr><tr><td><strong>Определение языка</strong></td><td>Воспользуйтесь данной функцией, если вам необходимо мониторить, на каких языках ведутся телефонные переговоры</td></tr><tr><td><strong>Пересказ звонка</strong></td><td>Получите короткую выжимку с ключевыми аспектами разговора и не тратьте время на его прослушивание целиком</td></tr><tr><td><strong>Оценка удовлетворенности клиента</strong></td><td>Высчитываем оценку от 1 до 10 на основе поведения клиента в ходе разговора</td></tr><tr><td><ul><li><strong>Развернутое обоснование оценки каждого критерия</strong></li></ul></td><td>Дополнительно предоставим краткое, но содержательное объяснение оценки по каждому критерию</td></tr><tr><td><ul><li><strong>Рекомендации по повышению общей оценки</strong></li></ul></td><td>Предоставим рекомендации по действиям, которые помогут сотруднику улучшить свои итоговые показатели в следующих разговорах</td></tr><tr><td><strong>Критерии оценки сотрудника</strong></td><td>Сформулируйте до 10 вопросов для оценки качества работы сотрудника по шкале от 1 до 10 по итогам разговора</td></tr><tr><td><ul><li><strong>Развернутое обоснование оценки</strong></li></ul></td><td>Дополнительно дадим краткое, но развернутое объяснение выставленной оценке</td></tr><tr><td><ul><li><strong>Рекомендации по повышению оценки</strong></li></ul></td><td>Предоставим рекомендации по действиям, которые помогут улучшить оценку в следующий раз</td></tr><tr><td><strong>Проверка на наличие маяков</strong></td><td>Найдем и выделим ключевые слова или выражения, которые важно отслеживать: как запрещенные, так и слова по скрипту</td></tr></tbody></table>

При активированной функции "**Показать в CRM**" мы будем транслировать результаты выбранных задач в ваш источник данных, при условии поддержки им данного функционала.


# Rules

Максимальная гибкость настройки под ваш бизнес

## Общие сведения

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

{% hint style="info" %}
Доступность функционала правил зависит от технических возможностей подключенного **источника данных.**
{% endhint %}

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

## Создание правил

Для управления правилами перейдите в раздел "**Настройки → Фильтрация**". Если источник ваших данных поддерживает функционал стадий для своих сущностей, то вам будет доступен блок "**Правила фильтрации для индивидуальной аналитики**", который находится под блоком настройки фильтров.

<figure><img src="/files/RQum4qfeEw5IadVimf7C" alt=""><figcaption></figcaption></figure>

{% stepper %}
{% step %}

### Создайте новое правило

1. Нажмите кнопку добавления правила.
2. Укажите тип сущности.
3. Укажите стадию или группу стадий выбранной сущности.
   {% endstep %}

{% step %}

### Настройте аналитику для нового правила

4. Откройте диалоговое окно настройки состава аналитики со списком доступных действий.
5. Выберите нужные действия для текущего правила.&#x20;
6. В зависимости от активированных задач, стоимость минуты проанализированного разговора будет автоматически пересчитываться.
7. Если вы передумали сохранять правило, то на этом этапе его можно удалить.

<mark style="background-color:purple;">Если вы хотите создать сразу несколько правил, то повторите шаги 1-6 для каждого нового правила.</mark>
{% endstep %}

{% step %}

### Сохраните и активируйте изменения

8. Если вы создали достаточное количество правил, они полностью настроены, и вы готовы продолжить работу с системой, то нажмите кнопку "Сохранить".
9. После сохранения убедитесь, что переключатель активен. Если нет, то активируйте его и снова нажмите кнопку "Сохранить".
   {% endstep %}
   {% endstepper %}

**Готово!** Новые звонки, поступившие в систему после включения правила будут проверяться на соответствие имеющимся правилам для выбора сценария аналитики.

{% hint style="warning" %}

1. На каждую стадию сущности можно создать только **одно правило.**
2. **Пересекающиеся правила запрещены.** То есть если вы уже настроили правило на целую воронку сделок А, то вы не сможете отдельно настроить другое правило для отдельно взятой стадии сущности из этой же воронки А.&#x20;
3. **Справедливо и обратное ограничение:** если вы уже настроили правило на отдельную стадию АБВ в воронке А, то вы не сможете настроить другое правило для отдельно, охватывающие все стадии воронки А, потому что стадия АБВ из этой воронки уже задействована в другом правиле.
4. сущность Чтобы правила начали работать, не забудьте **активировать** переключатель и **сохранить**.
5. Общее количество активных правил не может превышать **50 штук**.
6. В наборе аналитики можно выбрать пункт "**Игнорировать и ничего не делать**", который **исключает** все иные проставленные галочки и обнуляет стоимость аналитики. Такие разговоры останутся в системе, т.к. прошли через фильтрацию, но не будут транскрибированы и проанализированы, потому что это было определено в соответствующем правиле.
   {% endhint %}

## Удаление, архивирование и восстановление правил

<mark style="color:red;">**Удаление**</mark> сохраненных правил **недоступно**, но если правило больше не актуально или вы достигли лимита в 50 правил, вы можете **заархивировать** его. Архивация позволяет освободить место для новых правил, сохраняя при этом **доступ к историческим данным**. Запрет на удаление связан с важностью сохранения прозрачности и точности аналитики — это позволяет в любой момент **вернуться к истории и достоверно понять, какие правила использовались** для анализа конкретного звонка. Такой подход гарантирует полную сохранность аналитических данных и их целостность.

Чтобы <mark style="color:orange;">**заархивировать**</mark> сохраненное правило, перейдите на вкладку “**Активные**” и нажмите на соответствующую пиктограмму в правой части строки нужного правила.

Для <mark style="color:green;">**восстановления**</mark> правила из архива откройте вкладку “**Архивные**” и нажмите на пиктограмму в правой части строки архивного правила. Этот интуитивный процесс позволяет легко управлять правилами, сохраняя их актуальность и гибкость в использовании.

**Количество архивных правил не ограничено.**

{% hint style="warning" %}
При поиске сценария для аналитики новых звонков **архивные правила не учитываются!** Это означает, что только активные правила влияют на текущую обработку данных, обеспечивая актуальность аналитики. Архивирование позволяет сохранить правила для истории, но они больше не влияют на процесс анализа звонков. Убедитесь, что все необходимые правила находятся в активном статусе для корректной работы аналитики.
{% endhint %}

## Отложенный старт

Активируйте функцию отложенной аналитики, если требуется проводить анализ **не сразу после завершения разговора, а с задержкой в 2 минуты.** Перейдите в раздел "**Настройка → Аналитика**" для ее активации.

{% hint style="warning" %}
Отложенный старт во включенном состоянии применяется ко всему аккаунту сразу, а не к отдельным правилам аналитики.
{% endhint %}

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


# Markers

This page is under construction


# Evaluation Criteria

Оцифруйте качество телефонных коммуникаций своих операторов

## Общая информация

Используйте данный функционал для оценки **качества работы своих сотрудников** при телефонных коммуникациях. Сформулируйте **до 10 вопросов** для оценки качества работы сотрудника **по шкале от 1 до 10** по итогам разговора.

## Рекомендации по созданию наборов вопросов

{% hint style="info" %}
Формулировка вопросов может существенно повлиять на оценку. Рекомендуем формулировать вопросы так, чтобы они имели характеристику качественности, т.е. чтобы ответы на них можно было оценить по цифровой шкале.&#x20;
{% endhint %}

1. **Фокусируйтесь на конкретных действиях.** Не “~~Был ли звонок полезным для клиента?~~” 👎 , а *“Удалось ли сотруднику предоставить полное решение проблемы клиента?”* 👍
2. **Формулируйте вопросы так, чтобы правильное поведение и предпочтительные ответы однозначно соответствовали более высоким оценкам на шкале.** При этом заранее определите и четко опишите критерии для оценивания, чтобы исключить разночтения и обеспечить максимальную объективность интерпретации результатов.
3. **Добавляйте вопросы, которые оценивают эмпатию.** Например: *“Насколько клиент почувствовал заботу и заинтересованность оператора?”* Вопросы, касающиеся эмоционального интеллекта, помогают выявить важные аспекты взаимодействия, влияющие на лояльность клиента.
4. **Вопросы должны быть независимы друг от друга.** Каждый вопрос должен оценивать только один аспект звонка. Избегайте смешанных формулировок, вроде: “~~Был ли сотрудник вежлив и предоставил ли полезную информацию?~~”👎 Такие вопросы усложняют понимание, что именно пошло не так.
5. **Учитывайте специфику звонка.** Если звонки в вашей компании делятся по типам или целевым задачам (продажи, поддержка, консультация, "дожим", "прогрев", уведомение и т.д.), настройте вопросы под каждый сценарий.
   1. **Пример для продаж:** “Насколько развернуто сотрудник представил преимущества продукта?”
   2. **Пример для поддержки:** “Сотрудник предоставил четкое решение проблемы клиента?”
6. **Соблюдайте баланс в количестве вопросов.** Не перегружайте набор большим количеством вопросов. 3-6 вопросов — оптимальный объем, чтобы ёмко охватить ключевые аспекты звонка даже при относительно короткой длительности.

## Рекомендации для максимального использования возможностей функционала

1. **Не оценивайте только ради оценки.** Выстройте системную работу по "разбору полетов" с сотрудниками, чтобы на основе результатов оценки предпринимать конкретные шаги по повышению их эффективности.
2. **Активируйте функцию мотивации оценок.** Развернутое объяснение оценки позволит демонстрировать объективность оценивания и поможет мотивировать сотрудников совершенствоваться через понимание, в каком направлении следует работать.
3. **Активируйте функцию рекомендаций по улучшению оценки,** чтобы превратить обратную связь в мощный инструмент развития ваших сотрудников. Эта функция не просто укажет на слабые места, но и предложит конкретные действия для их исправления. Такой подход поможет каждому сотруднику понимать свои зоны роста, улучшать навыки и стремиться к более высоким показателям.
4. **Регулярно обновляйте вопросы для оценки.** Бизнес-процессы и запросы клиентов со временем меняются, поэтому пересматривайте список вопросов каждые 3-6 месяцев, чтобы они оставались актуальными и соответствовали текущим целям компании.

## Создать набор вопросов

{% stepper %}
{% step %}

### Перейдите в раздел Настройки → Критерии оценки

1. В верхнем меню наведите мышь на пункт "Настройки", на втором уровне выберите "Критерии оценки".
2. В открывшемся окне в правой части страницы (раздел "Наборы вопросов") нажмите на кнопку ➕ или "**Создать набор вопросов**" (если это первый активный набор вопросов)
   {% endstep %}

{% step %}

### Добавьте вопросы

<img src="/files/gEC20xWDrXkJEjmdi3v0" alt="" data-size="original">

1. **Введите название будущего набора вопросов.** Рекомендуем указывать "говорящее" название, отражающее суть хранящихся в нем вопросов и выделяющее его на фоне остальных наборов. Например "~~Набор 1~~" 👎 менее эффективное название, чем "*Вопросы при первичной консультации*" 👍
2. **Сформулируйте вопрос** с учетом приведенных выше рекомендаций. Его длина не должна превышать **200** символов.
3. Нажмите на кнопку ➕ для предварительного сохранения этого вопроса и перехода к работе со следующим вопросом.

<mark style="background-color:yellow;">Повторите шаги 2 и 3 по мере добавления каждого вопроса. В одном наборе может быть не более</mark> <mark style="background-color:yellow;"></mark><mark style="background-color:yellow;">**10**</mark> <mark style="background-color:yellow;"></mark><mark style="background-color:yellow;">вопросов.</mark>

<mark style="background-color:yellow;">Если вы решили переформулировать вопрос / нашли опечатку / хотите удалить вопрос / хотите взять его за основу для следующего вопроса, то в ходе работы с предсохраненными вопросами по нажатию на кнопку</mark> **⫶** <mark style="background-color:yellow;">вам доступны быстрые команды для дальнейшей работы:</mark> <mark style="background-color:yellow;"></mark><mark style="background-color:yellow;">**редактировать, копировать, удалить**</mark><mark style="background-color:yellow;">.</mark>

<img src="/files/uVqvkxgVp9Wb106dK2tK" alt="" data-size="original">

4. Когда все вопросы составлены, нажмите кнопку "**Сохранить**", чтобы сохранить набор вопросов и перейти к следующим шагам.
   {% endstep %}

{% step %}

### Присвойте набор вопросов кадровым единицам

См. инструкцию ниже.
{% endstep %}
{% endstepper %}

{% hint style="warning" %}
После сохранения набора вопросов, его **нельзя удалить.**&#x20;

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

Если данный набор вопросов уже был задействован в аналитике, но на данный момент он уже не актуален, то его нельзя будет редактировать, но можно будет **архивировать**, чтобы скрыть из общего списка активных вопросов.
{% endhint %}

## Присвоение набора вопросов кадровой единице

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

1. Нажмите на кнопку ➕ или кнопку "**Связать набор вопросов**" (кнопка видна в случае отсутствия активных связей между наборами вопросов и кадровыми единицами).
2. В левой части открывшегося окна выберите необходимые отделы или сотрудников, а в правой части выберите нужный набор вопросов. Сохраните выбор, нажав кнопку **"Присвоить".**

<figure><img src="/files/cohHaFRoODB0sZq1om7l" alt=""><figcaption><p>Окно присвоения набора вопросов</p></figcaption></figure>

{% hint style="info" %}

1. Одной кадровой единице можно присвоить **только один набор вопросов.**
2. Настройки по отдельному сотруднику имеют **выше приоритет над настройкам отделов.** Если сотруднику А присвоен набор вопросов #1, но отделу, в котором он числится, присвоен набор вопросов #2, то диалоги сотрудника А будут оцениваться по набору #1.
   {% endhint %}

## Редактирование сохраненного набора вопросов

Пока сохраненный набор вопросов не был присвоен никаким кадровым единицам *(см. об этом в параграфе "Присвоение набора вопросов кадровой единице")* и не был задействован в аналитике, его **можно** отредактировать.

<figure><img src="/files/nAEzxtWzpfo7XhoXhlB8" alt=""><figcaption><p>Сохраненные наборы вопросов</p></figcaption></figure>

На данном примере наборы вопросов, с нулевым количеством оцененных звонков (помечены цифрой 1️⃣), доступны для **редактирования**, при условии, что к ним нет привязки по кадровым единицам.

Наборы вопросов, отмеченные цифрой 2️⃣, не доступны для редактирования (т.к. по ним уже были проанализированные звонки), но их можно **заархивировать**, если предварительно удалить активные связи с кадровыми единицами.

## Архивирование набора вопросов

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

<figure><img src="/files/NqoOfZa3HrwZGmPC0ZHY" alt=""><figcaption><p>Карточка "Набор вопросов"</p></figcaption></figure>

### Архивные наборы вопросов

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

<figure><img src="/files/Gopa3Bp7SF6NQNf3JqVS" alt=""><figcaption><p>Кнопка открытия архива наборов вопросов</p></figcaption></figure>

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

<figure><img src="/files/vmlrubr4kyuVK3gVn0oP" alt=""><figcaption><p>Карточка "Архивные наборы вопросов"</p></figcaption></figure>


# Signals

Подсветите ключевые слова для своего бизнеса

Общая информация

**Поиск ключевых слов и фраз (маяков)** — это инструмент, который находит и выделяет заранее заданные слова и фразы из телефонного разговора. Он позволяет быстро находить ключевые темы, улучшая анализ качества обслуживания, понимание клиентских предпочтений и соблюдение стандартов общения. Это экономит время, исключает человеческий фактор и масштабируемо обрабатывает большие объемы данных.&#x20;

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

## Рекомендации по созданию списков маяков

1. **Определите цели списка маяков.** Сформулируйте, какие задачи вы хотите решить с помощью поиска ключевых слов в каждом списке маяков: контроль качества обслуживания, выявление жалоб, анализ упоминаний конкурентов, изучение клиентских предпочтений, измерение популярности акции и т.д. Это поможет задать релевантные слова и фразы.
2. **Используйте специфичные и релевантные слова.** Избегайте слишком общих слов, которые могут встречаться в любом контексте. Например, вместо «~~плохой~~» 👎 используйте «жалоба», «недоволен» или «не устраивает» 👍.
3. **Разделяйте маяки по категориям.** Группируйте ключевые слова по смыслу: позитивные (удовлетворенность, благодарность), негативные (жалоба, проблема), нейтральные (название продукта, уточняющие вопросы). Это упростит анализ.
4. **Добавляйте синонимы.** Учитывайте, что клиенты могут использовать разные формулировки для одних и тех же вещей. Например, для слова “проблема” можно включить “сложность”, “неудобство”, “трудности” и т.д.
5. **Регулярно обновляйте списки.** Пересматривайте и дополняйте ключевые слова на основе новых данных. Анализируйте свежие разговоры, чтобы выявлять новые важные термины.
6. **Учитывайте отраслевую специфику.** Включайте слова, которые связаны с вашей нишей или продуктом. Например, для SaaS решений это могут быть «подписка», «интеграция», «обновление», «поддержка» и т.д.
7. **Применяйте разные языки и культурные нюансы.** Если продукт используется в разных регионах, включайте ключевые слова на соответствующих языках, а также учитывайте локальные выражения.
8. **Тестируйте списки.** Протестируйте созданные списки на небольшом объеме звонков, чтобы убедиться в их эффективности. Это позволит скорректировать их перед масштабным применением.

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

## Создать список маяков

{% stepper %}
{% step %}

### Перейдите в раздел Настройки → Маяки

1. В верхнем меню наведите мышь на пункт "Настройки", на втором уровне выберите "Маяки".
2. В открывшемся окне в правой части страницы (раздел "Список маяков") нажмите на кнопку ➕ или "**Создать список маяков**" (кнопка видна, если ранее списки маяков еще не были созданы).
   {% endstep %}

{% step %}

### Добавьте ключевые слова и фразы

<img src="/files/8NEgMpW65awb2GCOQEUD" alt="" data-size="original">

1. **Введите название будущего списка маяков.** Рекомендуем указывать "говорящее" название, отражающее суть указываемых в нем ключевых слов и фраз, и выделяющее его на фоне остальных списков. Например "~~Ключевые слова 1~~" 👎 менее эффективное название, чем "*Упоминания конкурентов*" или "Слова-табу" 👍
2. **Составьте список слов и фраз** с учетом приведенных выше рекомендаций. Общая длина списка может составить до **1.000** символов. Укажите каждый новый маяк с новой строки или через запятую.
3. Когда все маяки вписаны, нажмите кнопку "**Сохранить**", чтобы сохранить список маяков и перейти к следующим шагам.
   {% endstep %}

{% step %}

### Присвойте список маяков кадровым единицам

См. инструкцию ниже.
{% endstep %}
{% endstepper %}

{% hint style="warning" %}
После сохранения списка маяков, его **нельзя ни отредактировать, ни удалить.**&#x20;
{% endhint %}

## Присвоение списка маяков кадровой единице

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

1. Нажмите на кнопку ➕ или кнопку "**Присвоить список маяков**" (кнопка видна в случае отсутствия активных связей между наборами вопросов и кадровыми единицами).
2. В левой части открывшегося окна выберите необходимые отделы или сотрудников, а в правой части выберите нужный список маяков. Сохраните выбор, нажав кнопку **"Присвоить".**

<figure><img src="/files/I5JxrZ6AOM9JmvPhqyP1" alt=""><figcaption><p>Окно присвоения списка маяков кадровым единицам</p></figcaption></figure>

{% hint style="info" %}

1. Одной кадровой единице можно присвоить **только один список маяков.**
2. **Настройки для отдельного сотрудника имеют приоритет над настройками отдела.** Если сотруднику А назначен Список маяков #1, а его отделу — Список маяков #2, то диалоги сотрудника А будут оцениваться по Списку маяков #1.
   {% endhint %}


# Account settings

## Содержимое и функциональные возможности страницы

1. Отображение логина и даты регистрации аккаунта
2. Отображение основной страны расположения бизнеса
3. Настройка языка интерфейса
4. Настройка языка уведомлений
5. Кнопка выхода из личного кабинета


# Main table

Главная страница сервиса состоит из нескольких частей:

* Верхняя строка меню;
* Ключевые метрики по звонкам в аккаунте;
* Основная таблица;
* Нижняя часть страницы.

<figure><img src="/files/2iFL8H5WraFPsI5hv81z" alt=""><figcaption><p>Главная страница aiokk</p></figcaption></figure>

## Верхняя строка

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

## Ключевые метрики

Прежде всего, мы отображаем ваш логин и подключенный источник данных.

Далее следуют ключевые метрики, которые включают в себя количественные показатели по 6 статусам звонков в системе:

1. **Общее** количество звонков
2. Звонки с **проведенной** аналитикой
3. Звонки, находящиеся **в очереди** на аналитику
4. Звонки, **очищенные из очереди** на аналитику, т.е. оставленные без анализа
5. Звонки **с ошибками** аналитики
6. Звонки, **пропущенные аналитикой по требованию** правил.

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

## Основная таблица

Основная таблица включает в себя:

1. **счетчик** количества звонков, отображаемых в таблице с учетом фильтров;
2. элементы активного **управления** содержимым;
   1. **Настройка состава столбцов.** Позволяет отображать/скрывать необходимые столбцы, чтобы позволить вам фокусироваться на тех данных, которые вам необходимы. <mark style="background-color:purple;">В активном состоянии меняет состояние с черно-белого на цветное.</mark>
   2. **Фильтрация таблицы.** Раскрывающееся окно с возможностью настройки одновременно нескольких критериев для отображаемых звонков. <mark style="background-color:purple;">В активном состоянии меняет состояние с черно-белого на цветное, с добавление счетчика, отображающего количество параметров, задействованных в фильтрации. Клик по счетчку сбрасывает фильтр.</mark>
3. непосредственно **таблица** с содержимым аккаунта *(в зависимости от источника данных, состав может отличаться).*

<table data-full-width="true"><thead><tr><th width="154">Столбец</th><th width="563">Описание</th><th width="134" align="center">Сортировка</th><th>Фильтр</th></tr></thead><tbody><tr><td><strong>ID</strong></td><td>Уникальный внутренний идентификатор телефонного звонка</td><td align="center">✅ Есть</td><td></td></tr><tr><td><strong>Сотрудник</strong></td><td>Этот столбец включает в себя сразу несколько видов информации:<br>1. Пиктограмма направления звонка<br>2. Имя, фамилия и ID сотрудника, участвовавшего в звонке<br>3. Отдел сотрудника, участвовавшего в звонке</td><td align="center">✅ По имени сотрудника</td><td>✅  1, 2 и 3</td></tr><tr><td><strong>Клиент</strong></td><td>Телефонный номер клиента в международном формате</td><td align="center"></td><td>✅ Есть</td></tr><tr><td><strong>Дата звонка</strong></td><td>Дата и время совершения звонка, отображаемое в часовом поясе, выбранном вами в настройках аккаунта (Настройки → Профиль)</td><td align="center">✅ Есть</td><td>✅ Есть</td></tr><tr><td><strong>Тайминг</strong></td><td>Длительность совершенного звонка (чч:мм:сс)</td><td align="center">✅ Есть</td><td>✅ Есть</td></tr><tr><td><strong>Сценарий</strong></td><td>Условие, по которому был обработан звонок. Это может быть какое-то <em>правило</em>, если звонок подпадал под его критерии, или сценарий <em>по умолчанию,</em> если звонок не подошел ни под одно из правил.</td><td align="center"></td><td>✅ Есть</td></tr><tr><td><strong>Результат</strong></td><td>Отображение статуса процесса аналитики включает демонстрацию результатов оценки по набору вопросов, если это предусмотрено сценарием. Мы отобразим итоговую оценку по вопросам, а также процентное соответствие разговора установленным критериям. В зависимости от уровня соответствия, процентное значение будет выделено цветом: <mark style="background-color:red;">красным (0–60%)</mark>, <mark style="background-color:yellow;">желтым (61–89%)</mark> или <mark style="background-color:green;">зеленым (90–100%)</mark>.</td><td align="center">✅ Есть</td><td>✅ По %</td></tr><tr><td><strong>Язык</strong></td><td><em>При включенном задании определения языков,</em> мы будем отображать языки, на которых происходило общение в разговоре.</td><td align="center"></td><td>✅ Есть</td></tr><tr><td><strong>Лояльность</strong></td><td><em>При включенном задании определения уровня клиентской удовлетворенности,</em> мы будем отображать числовую оценку по 10-бальной шкале с заливкой в соответствующем цвете по аналогии с результатами оценки.</td><td align="center">✅ Есть</td><td>✅ Есть</td></tr><tr><td><strong>Маяки</strong></td><td><em>При активированном поиске ключевых слов, упомянутых в разговоре,</em> мы будем отображать пиктограмму, если обнаружены соответствующие ключевые слова.</td><td align="center"></td><td>✅ Есть</td></tr><tr><td><strong>Цена</strong></td><td>Общая стоимость аналитики, выполненной по данному разговору, отображается в выбранной валюте аккаунта. Например, если разговор участвовал в переоценке, итоговая стоимость аналитики будет включать все понесенные затраты за все оценки.</td><td align="center">✅ Есть</td><td>✅ Есть</td></tr><tr><td><strong>Действия</strong></td><td>Быстрые действия с разговором:<br>1. Включить воспроизведение, не открывая карточку звонка.<br>2. Скачать запись разговора<br>3. Открыть <a href="/pages/R0Db2g5OldwnzfMb0cl7">карточку</a> разговора</td><td align="center"></td><td></td></tr></tbody></table>

## Нижняя часть страницы

* Переключатель количества записей на странице.
* Постраничный переключатель таблицы.
* Ссылки на сайт разработчика и публичные документы.


# Call details window

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

<figure><img src="/files/rS0jXXo1lmLnXtdjYB3R" alt=""><figcaption><p>Карточка разговора</p></figcaption></figure>

Конструктивно карточку разговора можно разделить на 3 блока:

1. Общая информация о звонке
2. Панель вкладок
3. Контентное окно вкладки

## Общая информация

<figure><img src="/files/j4gqUSZY64CRAz1JBlbX" alt=""><figcaption><p>Общая информация в шапке карточки звонка</p></figcaption></figure>

<table><thead><tr><th width="65">№</th><th width="164">Элемент</th><th>Описание</th></tr></thead><tbody><tr><td>1</td><td>Кнопка "Назад"</td><td>Возвращает на предыдущую страницу, откуда была открыта карточка.</td></tr><tr><td>2</td><td>ID звонка</td><td>Всегда виден, помогает идентифицировать отдельные звонки из общей массы</td></tr><tr><td>3</td><td>Переход в подвязанную сущность</td><td>Если ваш источник данных передает информацию с ссылкой на подвязанную сущность, то по клику на эту кнопку вы напрямую перейдете в карточку подвязанной сущности на стороне  источника данных.</td></tr><tr><td>4</td><td>Поделиться</td><td>Копирует прямую внутреннюю ссылку на карточку разговора, доступ к которой может быть предоставлен только тем людям, кто авторизован в вашем личном кабинете</td></tr><tr><td>5</td><td>Закрыть окно</td><td>Убирает полностью карточку разговора с экрана пользователя</td></tr><tr><td>6</td><td>Информация о сотруднике</td><td><ol><li>Имя, фамилия и ID сотрудника</li><li>Отдел сотрудника</li></ol></td></tr><tr><td>7</td><td>Телефон клиента</td><td>Номер абонента в международном формате</td></tr><tr><td>8</td><td>Дата звонка</td><td>Отображает время звонка, адаптированное под выбранный в настройках профиля часовой пояс</td></tr><tr><td>9</td><td>Сценарий</td><td>Информация о том, по какому набору аналитики был обработан данный звонок. Варианты: по умолчанию или по правилу.</td></tr><tr><td>10</td><td>Языки</td><td>Если включена задача на распознавание языков, то мы покажем список языков, на которых происходил разговор </td></tr><tr><td>11</td><td>Маяки</td><td>Если включена задача на поиск маяков, то мы отобразим информацию о наличии либо отсутствии в разговоре заданных ключевых слов.</td></tr></tbody></table>

## Вкладки

<figure><img src="/files/JHFXgkLNjZLntpYpsfLv" alt=""><figcaption><p>Панель вкладок в карточке разговора</p></figcaption></figure>

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

### Транскрипт

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

<figure><img src="/files/zzXbeB2xDBYELi1RSjhF" alt=""><figcaption><p>Содержимое вкладки "Транскрипт" (в максимальной комплектакции)</p></figcaption></figure>

<table><thead><tr><th width="65">№</th><th width="176">Элемент</th><th>Описание</th></tr></thead><tbody><tr><td>13</td><td>Панель управления аудиозаписью</td><td>Горизонтальная панель управления аудиозаписью обладает сразу несколькими функциями (слева направо):<br>1. Кнопка воспроизведения / паузы<br>2. Тайминг воспроизведения: текущая позиция / общая длительность<br>3. Шкала воспроизведения, позволяющая по клику переходить в любую часть разговора.<br>4. Регулировка громкости<br>5. Регулировка скорости воспроизведения от от 0.5х до 2х<br>6. Кнопка скачивания аудиозаписи</td></tr><tr><td>14</td><td>Автослежение за диалогом</td><td>Когда функция активирована, диалог будет автоматически прокручиваться вниз по мере движения разговора, подсвечивая текущую реплику.</td></tr><tr><td>15</td><td>Строка поиска</td><td>Воспользуйтесь ей, чтобы быстро найти реплики с упоминанием нужных слов</td></tr><tr><td>16</td><td>Переключатель поиска</td><td>Если в разговоре присутствуют маяки, то, воспользовавшись переключателем, вы можете осуществлять поиск не только по разговору в целом, но и только среди найденных маяков. </td></tr><tr><td>17</td><td>Окно диалога</td><td>Весь диалог, разделенный на реплики с тайм-кодами и разнесенный по двум сторонам, чтобы визуально легче воспринимать разговор.</td></tr><tr><td>18</td><td>Воспроизвести реплику</td><td>Если вы хотите перейти к прослушиванию разговора с конкретной реплики, достаточно нажать на кнопку воспроизведения, расположенную перед тайм-кодом в левом верхнем углу каждой реплики. После завершения выбранной реплики, воспроизведение продолжится далее.</td></tr></tbody></table>

### Пересказ

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

<figure><img src="/files/8xkW4DXg5lo3FGdNyJWU" alt=""><figcaption><p>Вкладка "Пересказ"</p></figcaption></figure>

### История касаний

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

<figure><img src="/files/v6Vtxa03m0Mf6t85rpXp" alt=""><figcaption><p>Вкладка "История касаний"</p></figcaption></figure>

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

<figure><img src="/files/ETbHqfI7tApYEFW4ipib" alt=""><figcaption><p>Вкладка "Удовлетворенность клиента"</p></figcaption></figure>

{% hint style="info" %}
В зависимости от сценария аналитики, по которому был обработан данный звонок, вкладки "Удовлетворенность клиента может отсутствовать", либо ее состав может отличаться от варианта в примере.
{% endhint %}

**Оценка.** *Если задание на оценку удовлетворенности клиента было предусмотрено в сценарии,* то вы увидите числовой индикатор по 10-бальной шкале, который в зависимости от результата будет закрашен в <mark style="background-color:red;">красный (0-6)</mark>, <mark style="background-color:yellow;">желтый (7-8)</mark> или <mark style="background-color:green;">зеленый (9-10)</mark> цвет. Для быстрого обзора, числовая метрика также отображается в заголовке вкладки.

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

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

### Вопросы #N

<figure><img src="/files/58kHxkZo15mGNkG0dCH7" alt=""><figcaption><p>Вкладка "Вопросы #N"</p></figcaption></figure>

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

Для быстрого обзора, числовая метрика с процентным показателем также отображается в заголовке вкладки и закрашена в <mark style="background-color:red;">красный (0-60%)</mark>, <mark style="background-color:yellow;">желтый (61-89%)</mark> или <mark style="background-color:green;">зеленый (90-100%)</mark> цвет.&#x20;

В верхней части вкладки отображаются:

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

При включенном задании с минимальным набором опций вам будет доступна только числовая оценка по 10-бальной шкале по каждому из вопросов.

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

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

### Ценообразование

<figure><img src="/files/wRg7BehzgTq4o4ivjdED" alt=""><figcaption><p>Вкладка "Ценообразование"</p></figcaption></figure>

На вкладке "Ценообразование" вы можете найти расчеты по стоимости проведенной аналитики по каждой их трех оценок.

1. В первом столбце указаны действия по аналитике, которые были произведены в рамках отработанного сценария.
2. Второй столбец показывает ценовую информацию и логику расчета стоимости, которая повторяет информацию со страницы [Настройки → Аналитика](/en/settings/analytics).
3. Третий столбец отображает количественную информацию применительно к данному конкретному разговору.
4. Четвертый столбец отображает стоимость каждого действия аналитика с итоговой суммой внизу.


# Page 2


# Page 3


# Balance


# Budgeting


# Balance topup


# Page 5