Здесь показаны различия между двумя версиями данной страницы.
Предыдущая версия справа и слева Предыдущая версия Следующая версия | Предыдущая версия | ||
module-smart-i-v-r [2019/11/06 13:58] Портнов Алексей [Yandex SpeechKit API] |
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|страницу сервиса]]. Пройдите **регистрацию** или используйте уже имеющуюся учетную запись яндекса.\\ | + | |
- | {{ ::1_start.png |}}\\ \\ | + | |
- | 2. Сразу после регистрации Вам будет доступна [[https://console.cloud.yandex.ru/|консоль управления облачными сервисами]].\\ \\ | + | |
- | 3. Перед работой с сервисами необходимо создать платежный аккаунт. Внимательно ознакомьтесь с условиями пробного периода. Для создания платежного аккаунта перейдите в раздел **Биллинг** и добавьте аккаунт.\\ | + | |
- | {{ ::2019-02-18_120155.png |}}\\ | + | |
- | + | ||
- | === Получение авторизационных данных === | + | |
- | Для подключения модуля умной маршрутизации потребуются следующие данные: | + | |
- | * Идентификатор каталога в облаке | + | |
- | * Идентификатор сервисного аккаунта yandex | + | |
- | * Идентификатор авторизационного ключа сервисного аккаунта | + | |
- | * Данные закрытого авторизационного ключа сервисного аккаунта | + | |
- | + | ||
- | - **Идентификатор каталога в облаке**. \\ \\ По умолчанию в Яндекс.Облаке уже есть каталог. Вы можете открыть страницу этого каталога в консоли управления, либо [[https://cloud.yandex.ru/docs/speechkit/concepts/auth|создать новый каталог]]. Получить идентификатор каталога можно из URL страницы каталога в консоли управления.\\ {{ ::2019-02-18_113350.png |}}\\ \\ | + | |
- | - **Идентификатор сервисного аккаунта yandex**. \\ \\ Для имеющегося каталога необходимо создать [[https://cloud.yandex.ru/docs/iam/operations/iam-token/create-for-sa|идентификатор сервисного аккаунта]].\\ {{ ::2019-02-18_113455.png |}}\\ Откройте аккаунт для редактирования, в общих сведениях найдете **идентификатор** сервисного аккаунта.\\ {{ ::2019-02-18_113531.png |}}\\ \\ | + | |
- | - **Данные закрытого авторизационного ключа сервисного аккаунта**. \\ \\ Для сервисного аккаунта создайте [[https://cloud.yandex.ru/docs/iam/operations/iam-token/create-for-sa#keys-create|авторизованный ключ]]. Выберите алгоритм шифрования и задайте описание ключа, чтобы потом было проще найти его в консоли управления. Сохраните значение закрытого ключа.\\ {{ ::2019-02-18_113611.png |}}\\ {{ ::2019-02-18_113633.png |}}\\ {{ ::2019-02-18_113701.png |}}\\ | + | |
- | - **Идентификатор авторизационного ключа сервисного аккаунта**\\ \\ После создания авторизованного ключа для сервисного аккаунта, станет доступна информация об идентификаторе авторизованного ключа.\\ {{ ::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|Обратно к инструкциям]] |