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

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


module-smart-i-v-r

Различия

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

Ссылка на это сравнение

Предыдущая версия справа и слева Предыдущая версия
Следующая версия
Предыдущая версия
module-smart-i-v-r [2019/11/06 13:51]
Портнов Алексей
module-smart-i-v-r [2022/01/31 07:49] (текущий)
Портнов Алексей
Строка 1: Строка 1:
-====== ​Умная маршрутизация и генерация IVR меню ​======+====== ​Модуль умной маршрутизации ​для MikoPBX======
  
-<note important>​[[https://​wiki.mikopbx.com/​module-smart-i-v-r | Документация по Askozia ​была перенесена... ]]</​note>​+Суть работы модуля в накоплении информации о взаимодействиях между клиентами и сотрудниками компании,​ после чего модуль для каждого клиента формирует ​персональное голосовое приветствие. При входящем звонке телефонная система ​обращается к 1С для получения текста приветствия,​ с помощью сервисов генерации речи оно преобразуется в IVR меню, которое произносится клиенту при звонке.
  
-====== Умная маршрутизация и генерация IVR меню ​======+Если абонент не выбирает ни один из предложенных вариантов - звонок переадресуется на номер по-умолчанию, например в отдел продаж. Если происходит сбой при генерации речи или при обращении к 1С в момент звонка,​ вызов переадресуется на аварийный номер, например статическое ​IVR меню.
  
-Обзор модуля в [[http://​www.telefon1c.ru/​products/​smart-transfer/​ |статье на нашем сайте]]. ​ 
-<note warning>​В этом разделе будет описана последовательность действий для настройки модуля. Обратите внимание на [[https://​wiki.telefon1c.ru/​astpanel:​statistic:​system_requirements|системные требования]]. ​ \\ **Важно** - все web сервисы должны быть опубликованы и доступны по протоколу **http**.</​note>​. 
  
-===== Сервисы синтеза речи ===== +====== Настройка модуля ​======
-==== CRT API ====+
  
-<note important>​CRT API используется в модулях **FreePBX** ​и **Askozia 6.5.9+**, а также в **Askozia 5 Miko Edition**.</​note>​+<note important>​Перед настройкой модуля на стороне телефонной системы, необходимо выполнить [[https://​wiki.telefon1c.ru/​smartivr|инструкцию по встраиваню]] ​модуля ​в 1С:​Предприяите</​note>​
  
-Модуль умной маршрутизации поддерживает работу с API, которое предоставляет[[https://​cp.speechpro.com/​home|ЦРТ]] для синтеза речи. ​ 
-  - Пройдите регистрацию в [[https://​cp.speechpro.com/​home|личном кабинете ЦРТ]]\\ {{ ::​2019-02-11_161841.png |}}\\  
-  - Заполните форму регистрации на сайте\\ ​ {{ ::​2019-02-11_162010.png |}}\\  
-  - Подтвердите свой e-mail\\ {{ ::​2019-02-11_162025.png |}}\\  
-  - После подтверждения задайте новый пароль и авторизуйтесь на сайте ЦРТ\\ {{ ::​2019-02-11_162123.png |}}\\ {{ ::​2019-02-11_162149.png |}}\\  
-  - В личном кабинете ЦРТ перейдите в раздел "​**Учетные данные**",​ для работы модуля умной маршрутизации далее Вам понадобятся "​**Логин**",​ "​**Идентификатор домена в платформе обработки**"​ и "​**Пароль пользователя платформы**"​. Сохраните эти данные.\\ {{ ::​2019-02-11_162449.png |}} 
  
-==== Yandex SpeechKit API ====+  - Данный модуль использует канал связи от модулей АТС "​**Панель телефонии 1.0 для 1С**" либо **Панель телефонии 2.0 для 1С**. Поэтому сначала вам нужно установить и настроить соответствующий модуль "​Панель телефонии"​ на АТС. \\ Для модуля "​Панель телефонии 2.0 для 1С" -  [[https://​wiki.telefon1c.ru/​nightbird:​prepare-mikopbx|инструкция]] .  
 +  - Перейдите в web-интерфейс MikoPBX в раздел **Модули** -> **Управление модулями**. Установите или обновите модуль умной маршрутизации вызовов (Smart IVR), чтобы он стал доступным для настройки. \\ {{ :​umn_marshrut_0.png?​nolink |}}\\ \\  
 +  - Включите модуль и перейдите в настройки данного модуля для указания параметров подключения к базе 1С.\\ {{ :​umn_marshrut_1.png?​nolink |}}\\  
 +  * "​**Версия подсистемы интеграции на стороне 1С**" - укажите от какой версий "​панели телефонии для 1С" будет использован канал связи. 
 +  * "​**Количество повторов IVR меню перед переводом звонка номер по-умолчанию**"​ - сколько раз диктор произнесет приветствие прежде чем вызов переведется на номер по-умолчанию. 
 +  * "​**Номер по-умолчанию**"​ -  номер на который будет переведен вызов если в течении установленного количества повторов приветствия абанент не наберет добавочный номер. 
 +  * "​**Номер,​ куда отправим звонок в случае сбоев связи с 1С и TTS.**"​ - если происходит сбой при генерации речи или при обращении к 1С в момент звонка. 
 +  * "​**Количество минут, за которое следует анализировать CDR для поиска ответственного**"​ - опция относится к упрощенной функци перехвата на ответственного. Если с клиентом кто либо уже разговаривал за последние N минут, то вызов сразу поступит на "​ответственного"​.  
 +  * "​**Количество секунд,​ как долго звонить последнему ответственному**"​ - опция относится к упрощенной функци перехвата на ответственного.
  
-<note tip>​Официальная документация по **Yandex SpeechKit** ​доступна по [[https://​cloud.yandex.ru/​docs/​speechkit/​|ссылке]].</​note>​+В случае **успешного** подключения модуля будет выдано сообщение:\\  
 +{{ :​umn_marshrut_2.png?nolink |}}\\ 
  
-<note important>​Yandex SpeechKit API используется в модулях **FreePBX** и **Askozia 6.5.9+**</​note>​ +В случае **отсутствия** подключения модуля будет выдано сообщение:​\\  
- +{{ :umn_marshrut_3.png?nolink ​|}}\\ 
-=== Регистрация в сервисе === +
-1. Перейдите на [[https://​cloud.yandex.ru|страницу сервиса]]. Пройдите **регистрацию** или используйте уже имеющуюся учетную запись яндекса.\\  +
-{{ :​astpanel:​statistic:​1_start.png |}}\\ \\  +
-2. Сразу после регистрации ​Вам будет доступна [[https://​console.cloud.yandex.ru/​|консоль управления облачными сервисами]].\\ \\  +
-3. Перед работой с сервисами необходимо создать платежный аккаунт. Внимательно ознакомьтесь с условиями пробного периода. Для создания платежного аккаунта перейдите в раздел ​**Биллинг** и добавьте аккаунт.\\  +
-{{ :​astpanel:​statistic:​2019-02-18_120155.png |}}\\  +
- +
-=== Получение авторизационных данных === +
-Для подключения модуля умной маршрутизации потребуются следующие данные:​ +
-  * Идентификатор каталога в облаке +
-  * Идентификатор ​сервисного аккаунта yandex +
-  * Идентификатор авторизационного ключа сервисного аккаунта +
-  * Данные закрытого авторизационного ключа сервисного аккаунта +
- +
-  - **Идентификатор каталога в облаке**. \\ \\ По умолчанию в Яндекс.Облаке уже есть каталог. Вы можете открыть страницу этого каталога в консоли управления, либо [[https://​cloud.yandex.ru/​docs/​speechkit/​concepts/​auth|создать новый каталог]]. Получить идентификатор каталога можно из URL страницы каталога в консоли управления.\\ {{ :​astpanel:​statistic:​2019-02-18_113350.png |}}\\ \\  +
-  - **Идентификатор сервисного аккаунта yandex**. \\ \\ Для имеющегося каталога необходимо создать [[https://​cloud.yandex.ru/​docs/​iam/​operations/​iam-token/​create-for-sa|идентификатор сервисного аккаунта]].\\ {{ :​astpanel:​statistic:​2019-02-18_113455.png |}}\\ Откройте аккаунт для редактирования,​ в общих сведениях найдете **идентификатор** сервисного аккаунта.\\ ​ {{ :​astpanel:​statistic:​2019-02-18_113531.png |}}\\ \\  +
-  - **Данные закрытого авторизационного ключа сервисного аккаунта**. \\ \\  Для сервисного аккаунта создайте [[https://​cloud.yandex.ru/​docs/​iam/​operations/​iam-token/​create-for-sa#​keys-create|авторизованный ключ]]. Выберите алгоритм шифрования и задайте описание ключа, чтобы потом было проще найти его в консоли управления. Сохраните значение закрытого ключа.\\ {{ :​astpanel:​statistic:​2019-02-18_113611.png |}}\\ {{ :​astpanel:​statistic:​2019-02-18_113633.png |}}\\ {{ :​astpanel:​statistic:​2019-02-18_113701.png |}}\\  +
-  - **Идентификатор авторизационного ​ключа сервисного аккаунта**\\ \\ После создания ​авторизованного ключа для сервисного аккаунта,​ станет доступна информация об идентификаторе авторизованного ключа.\\ {{ :​astpanel:​statistic:​2019-02-18_113759.png |}} +
- +
- +
- +
- +
-Обзор ​модуля ​в [[http://​www.telefon1c.ru/​products/​smart-transfer/​ |статье на нашем сайте]].  +
-<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>​ +
- +
-==== Активация сервиса ==== +
- +
-  - Перейдите в раздел "​**МИКО:​ Телефония**"​ - "​**Настройки маршрутизации**"​ \\ {{ :​rout_command_settings.png |}}\\ \\  +
-  - На вкладке "​**Основные**"​ включите использование модуля \\ {{ :​use_rout_module.png |}}\\ \\  +
-  - Выберите поставщика услуги "Генерация речи". На текущий момент есть возможность использования [[https://​tech.yandex.ru | Yandex]] и [[https://​voicefabric.ru | ЦРТ]].\\ ​\\  +
- +
- +
- +
-  +
-==== Настройка списка сотрудников ==== +
-  - Перейдите на вкладку "​**Сотрудники**"​ \\ {{ :rout_users.png |}}\\    +
-  - **Укажите пол** каждого сотрудника +
-  - Выполните действие "​**Просклонять ФИО всех**"​ +
- +
-<note tip>В первой колонке есть возможность установить / снять флаг. В голосовом меню будут участвовать только пользователи с включенным флажком. \\ В последней колонке "​**Период использования**"​ устанавливается дата окончания работы сотрудника. \\ Флаг "​**Показывать только активных пользователей**"​ позволяет отобразить только действующих сотрудников.</​note>​ +
- +
-==== Настройка контактной информации ==== +
- +
-Для сотрудников необходимо заполнить номера внутренних телефонов:​ +
-{{ :​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:​Bash>​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:​Bash>​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|Обратно к инструкциям]] [[:​pbx-extension-modules|Обратно к инструкциям]]
module-smart-i-v-r.1573048308.txt.gz · Последние изменения: 2019/11/06 13:51 — Портнов Алексей