Различия

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

--- module-smart-i-v-r [2019/08/15 10:34]
Портнов Алексей старая версия восстановлена (2019/06/11 13:06)
+++ module-smart-i-v-r [2022/01/31 07:49] (текущий)
Портнов Алексей
@@ Строка 1: / Строка 1: @@
-====== Модуль умной маршрутизации вызовов (Smart IVR) ======
+====== Модуль умной маршрутизации для MikoPBX======
-[[:pbx-extension-modules|Обратно к инструкциям]]
+Суть работы модуля в накоплении информации о взаимодействиях между клиентами и сотрудниками компании, после чего модуль для каждого клиента формирует персональное голосовое приветствие. При входящем звонке телефонная система обращается к 1С для получения текста приветствия, с помощью сервисов генерации речи оно преобразуется в IVR меню, которое произносится клиенту при звонке.
-Обзор модуля в [[http://www.telefon1c.ru/products/smart-transfer/ |статье на нашем сайте]].
+Если абонент не выбирает ни один из предложенных вариантов - звонок переадресуется на номер по-умолчанию, например в отдел продаж. Если происходит сбой при генерации речи или при обращении к 1С в момент звонка, вызов переадресуется на аварийный номер, например статическое IVR меню.
-<note warning>В этом разделе будет описана последовательность действий для настройки модуля. Обратите внимание на [[https://wiki.telefon1c.ru/astpanel:statistic:system_requirements|системные требования к модулю]].  \\ \\
-**Важно** - все web-сервисы должны быть опубликованы и доступны по протоколу **http**! </note>.
-===== Настройка 1С:Предприятие =====
-<note important>Модуль умной маршрутизации идет в поставке с [[https://wiki.telefon1c.ru/astpanel:statistic|модулем журнала звонков]]. Встраивание модуля в конфигурацию 1С следует выполнить по [[https://wiki.telefon1c.ru/astpanel:statistic:integr_settings|инструкции]]. </note>
+====== Настройка модуля ======
-==== Активация сервиса ====
+<note important>Перед настройкой модуля на стороне телефонной системы, необходимо выполнить [[https://wiki.telefon1c.ru/smartivr|инструкцию по встраиваню]] модуля в 1С:Предприяите</note>
-  - Перейдите в раздел "**МИКО: Телефония**" - "**Настройки маршрутизации**" \\ {{ :rout_command_settings.png |}}\\ \\
-  - На вкладке "**Основные**" включите использование модуля \\ {{ :use_rout_module.png |}}\\ \\
-  - Выберите поставщика услуги "Генерация речи". На текущий момент есть возможность использования [[https://tech.yandex.ru | Yandex]] и [[https://voicefabric.ru | ЦРТ]].\\ \\
-  - Укажите ключ к API, его следует получить у поставщика услуги https://voicefabric.ru и https://tech.yandex.ru/
-=== CRT API Key ===
+  - Данный модуль использует канал связи от модулей АТС "**Панель телефонии 1.0 для 1С**" либо **Панель телефонии 2.0 для 1С**. Поэтому сначала вам нужно установить и настроить соответствующий модуль "Панель телефонии" на АТС. \\ Для модуля "Панель телефонии 2.0 для 1С" -  [[https://wiki.telefon1c.ru/nightbird:prepare-mikopbx|инструкция]] .
-  - Авторизуйтесь в личном кабинете [[https://voicefabric.ru/main]]
+  - Перейдите в web-интерфейс MikoPBX в раздел **Модули** -> **Управление модулями**. Установите или обновите модуль умной маршрутизации вызовов (Smart IVR), чтобы он стал доступным для настройки. \\ {{ :umn_marshrut_0.png?nolink |}}\\ \\
-  - Прежде чем использовать API ключ, нужно выбрать тариф из раздела [[https://voicefabric.ru/main/tariffs]]
+  - Включите модуль и перейдите в настройки данного модуля для указания параметров подключения к базе 1С.\\ {{ :umn_marshrut_1.png?nolink |}}\\
-  - Скопируйте ключ API {{ :show_file_php_2_408_1_730_piks.png |}}\\ \\
+  * "**Версия подсистемы интеграции на стороне 1С**" - укажите от какой версий "панели телефонии для 1С" будет использован канал связи.
-=== Yandex API Key ===
+  * "**Количество повторов IVR меню перед переводом звонка номер по-умолчанию**" - сколько раз диктор произнесет приветствие прежде чем вызов переведется на номер по-умолчанию.
-  - Переходим в кабинет разработчика [[https://developer.tech.yandex.ru/keys/]]
+  * "**Номер по-умолчанию**" -  номер на который будет переведен вызов если в течении установленного количества повторов приветствия абанент не наберет добавочный номер.
-  - Выполните действие "Получить ключ"
+  * "**Номер, куда отправим звонок в случае сбоев связи с 1С и TTS.**" - если происходит сбой при генерации речи или при обращении к 1С в момент звонка.
-  - Выберите тип ключа "SpeechKit Cloud"
+  * "**Количество минут, за которое следует анализировать CDR для поиска ответственного**" - опция относится к упрощенной функци перехвата на ответственного. Если с клиентом кто либо уже разговаривал за последние N минут, то вызов сразу поступит на "ответственного".
-  - Заполните анкету
+  * "**Количество секунд, как долго звонить последнему ответственному**" - опция относится к упрощенной функци перехвата на ответственного.
-  - Скопируйте ключ API {{ :yandex_api_key.png |}}\\ \\
-==== Настройка списка сотрудников ====
-  - Перейдите на вкладку "**Сотрудники**" \\ {{ :rout_users.png |}}\\
-  - **Укажите пол** каждого сотрудника
-  - Выполните действие "**Просклонять ФИО всех**"
-<note tip>В первой колонке есть возможность установить / снять флаг. В голосовом меню будут участвовать только пользователи с включенным флажком. \\ В последней колонке "**Период использования**" устанавливается дата окончания работы сотрудника. \\ Флаг "**Показывать только активных пользователей**" позволяет отобразить только действующих сотрудников.</note>
+В случае **успешного** подключения модуля будет выдано сообщение:\\
+{{ :umn_marshrut_2.png?nolink |}}\\
-==== Настройка контактной информации ====
+В случае **отсутствия** подключения модуля будет выдано сообщение:\\
+{{ :umn_marshrut_3.png?nolink |}}\\
-Для сотрудников необходимо заполнить номера внутренних телефонов:
-{{ :rout_user_number.png |}}
-Только внутренние номера сотрудников будут участвовать в голосовом меню.
-<note important>Внутренними считаются все номера короче пяти символов.</note>
-==== Текст оповещения ====
-Перейдите на вкладку "**Текст оповещения**":
-{{ :rout_text_for_voice.png |}}
-На странице необходимо указать тест голосового меню:
-  * "**Ответственного нет**" - если ответственный по клиенту не найден, будет использоваться это сообщение
-  * Определен ответственный, "**Текст начала сообщения**" - начало голосового меню
-  * "**Сотрудники**" - список ответственных сотрудников будет проговорен следом за текстом начала сообщения
-  * "**Текст окончания сообщения**" - это завершающая фраза, обычно в ней предлагают дождаться ответа оператора
-Действия
-  * "**Прослушать**" - функция доступна при использовании продукта "Панель телефонии для 1С", на телефон поступит звонок, после поднятия трубке вы услышите пример приветствия
-  * "**Изменить состав имени**" - вы можете указать что следует произносить клиенту, полное имя сотрудника или только имя и фамилию
-  * "**Изменить падеж**" - укажите падеж склонения ФИО сотрудника
-==== Регистрируемые события ====
-По умолчанию, на маршрутизацию вызовов влияют только документы истории звонков модуля статистики. Клиенту будет предложено пообщаться с сотрудником, с которым состоялся разговор ранее.
-Существует возможность расширить набор "Регистрируемых событий".
-=== Пример ===
-Необходимо, чтобы клиент соединялся с сотрудником, который ведет его заказы.
-=== Решение ===
-  - В форме настроек модуля маршрутизации необходимо перейти на страницу "**Регистрируемые события**" {{ :rout_registr_events.png |}}
-  - Создайте новый элемент. На странице "**Основные параметры**" следует указать "**Вид события**" - "**Документ**"
-  - В поле "**Документ**" указать тип документа
-  - Заполнить значение "**Исходный вес**" (приоритет), "**Срок действия**" (в днях)
-  - На вкладке "**Настройки документа**" необходимо задать параметры заполнения таблицы маршрутизации {{ :rout_registr_event_filtr_params.png |}}
-  - Есть возможность установить отбор по документам
-===== Публикация web-сервисов 1С =====
-При входящем вызове, АТС будет обращаться к web-сервисам 1С. Сервисы должны быть опубликованы на web-сервере:\\
-{{ :2018-12-28_112949.png |}}\\ \\
-Создайте нового пользователя 1С с произвольным логином и паролем. Пользователю 1С должна быть назначена роль "**Телефония: Права для web сервиса генерации IVR меню для умной маршрутизации**".\\
-{{ :2018-12-28_113246.png |}}\\
-<note warning>**Сервисы должны быть доступны по протоколу http**</note>
-==== Проверка публикации (windows) ====
-  - Скачайте дистрибутив по [[http://files.miko.ru/public.php?service=files&t=34c4c04a00e42465fac2f0247adef1be | ссылке]]
-  - Распакуйте архив
-  - В текстовом редакторе откройте файл "**test_soap_1c_smartivr.bat**"
-  - Поправьте параметры подключения: <code>set login_pass=smartadmin:askozia
-set path_to_1c=http://192.168.1.115/DemoTrd/
-set number=74952293042
-</code>
-  - Запустите файл "**test_soap_1c_smartivr.bat**" на исполнение
-  - Пример результата, в случае успеха \\  {{ :2018-12-28_113735.png |}}\\ \\
-  * "**smartadmin:askozia**" - имя пользователя и пароль к 1С
-  * "**http://192.168.1.115/DemoTrd/**" - путь, по которому доступен web клиент 1С
-  * "**74952293042**" - номер телефона, по которому производим запрос
-==== Проверка публикации (Linux) ====
-<code>curl -u smartadmin:askozia --header "Content-Type: text/xml; charset=utf-8" -d "<?xml version='1.0' encoding='UTF-8'?><soap:Envelope xmlns:soap='http://schemas.xmlsoap.org/soap/envelope/'><soap:Body><m:identify xmlns:m='http://wiki.miko.ru/doc:1cajam:identifynumber'><m:Number>74952293042</m:Number></m:identify></soap:Body></soap:Envelope>" "http://192.168.1.115/DemoTrd/ws/1C_MIKO_identify_number.1cws"</code>
-<code>curl -u smartadmin:askozia --header "Content-Type: text/xml; charset=utf-8" -d '<?xml version="1.0" encoding="UTF-8"?><soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"><soap:Body><m:getivrtext xmlns:m="http://wiki.miko.ru/doc:1cajam:smarttransfer"><m:Number>74952293042</m:Number></m:getivrtext></soap:Body></soap:Envelope>' 'http://192.168.1.115/DemoTrd/ws/MIKO_IVRGenerator4SmartTransfer.1cws'</code>
-  * "**smartadmin:askozia**" - имя пользователя и пароль к 1С
-  * "**http://192.168.1.115/DemoTrd/**" - путь, по которому доступен web клиент 1С
-  * "**74952293042**" - номер телефона, по которому производим запрос
-===== Настройка АТС =====
-  - Перейдите в web-интерфейс Askozia 6 в раздел **Модули** -> **Управление модулями**. Установите или обновите модуль умной маршрутизации вызовов (Smart IVR), чтобы он стал доступным для настройки. \\ {{ :2018-12-28_114401.png |}}\\ \\
-  - Перейдите в настройки данного модуля для указания параметров подключения к базе 1С.\\ {{ :2018-12-28_114254.png |}}\\
-  * "**Адрес и порт сервера 1С**" - укажите адрес и порт, где опубликованы web-сервисы 1С
-  * "**Имя публикации**" - имя базы 1С, заданное на этапе публикации на web-сервере
-  * "**Логин для веб-сервиса 1С**" -  имя пользователя 1С для доступа опубликованным web-сервисам
-  * "**Пароль для авторизации в 1С**" - пароль пользователя 1С для доступа опубликованным web-сервисам
-  * "**Маршрут при ошибке связи с модулем в 1С**" - обязательно заполните значение, на этот номер будет переадресован вызов при возникновении сбоя / ошибки в модулей умной маршрутизации.
-В случае **удачного** подключения модуля будет выдано сообщение:\\
-{{ :2018-12-28_114310.png |}}\\
-В случае **неудачного** подключения модуля будет выдано сообщение:\\
-{{ :2018-12-28_114302.png |}}\\
 [[:pbx-extension-modules|Обратно к инструкциям]]

MikoPBX WIKI

Инструменты пользователя

Инструменты сайта

Различия

Инструменты страницы