Урок 28 Служебный сценарий обработки контента — различия между версиями

Материал из Oktell
Перейти к: навигация, поиск
 
(не показаны 22 промежуточные версии этого же участника)
Строка 14: Строка 14:
 
Контент линии - это идентификационная информация по линии, абоненту, времени, а также перечень всех коммутаций с указанием имени сценария, идентификатора и имени оператора, времени начала, времени конца, продолжительности и пр. Контент линии существует только у внешних линий,  начинает заполняться с момента поступления звонка по каналу и сбрасывается при завершении этого звонка. Иными словами, данная информация существует только во время звонка. Контент линии помогает отследить все действия внешнего абонента, по каким сценариям IVR он проходил, какие операторы говорили с ним, а какие операторы пропустили звонок.  
 
Контент линии - это идентификационная информация по линии, абоненту, времени, а также перечень всех коммутаций с указанием имени сценария, идентификатора и имени оператора, времени начала, времени конца, продолжительности и пр. Контент линии существует только у внешних линий,  начинает заполняться с момента поступления звонка по каналу и сбрасывается при завершении этого звонка. Иными словами, данная информация существует только во время звонка. Контент линии помогает отследить все действия внешнего абонента, по каким сценариям IVR он проходил, какие операторы говорили с ним, а какие операторы пропустили звонок.  
  
 +
<blockquote>Рассмотрим следующую ситуацию: клиент позвонил в компанию и соединился с секретарем Марией. Мария осуществляет консультативный перевод на сотрудника Станислава, заранее предупреждая его о переключении. Клиент соединяется со Станиславом и после разговора, попадает в сценарий вместо отбоя, где оценивает качество консультации. </blockquote>
  
[[Файл:Урок 28 -001+.png]]
+
После того как линия положит трубку в контент линии попадут 4 коммутации:  
 +
*соединение абонента с главным IVR сценарием
 +
*разговор абонента с секретарем Марией
 +
*разговор абонента с сотрудником Станиславом
 +
*соединение абонента со сценарием вместо отбоя
 +
Следует отметить, что коммутация между сотрудниками Марией и Станиславом в контент линии не попадет, потому как в этом разговоре не участвовала внешняя линия абонента. В контент линии попадают только те разговоры, в которых участвовала линия клиента. Далее показан пример контента линии для указанной ситуации (повторяющиеся моменты вырезаны).
  
  
 +
[[Файл:Урок 28 -001+.png|center]]
  
Наряду с контентом линии, в Oktell существует контент цепочки коммутаций. Контент цепочки существует в рамках цепочки коммутаций и в отличие от предыдущего аналога, его можно получить как для внешних, так и для внутренних линий.
 
  
Следует отметить, что контенты линии и цепочки коммутаций отличаются друг от друга. Рассмотрим следующую пример: клиент позвонил в компанию и соединился с секретарем Марией. Мария осуществляет консультативный перевод на сотрудника Станислава, заранее предупреждая его о переключении. Клиент соединяется со Станиславом и после разговора, попадает в сценарий вместо отбоя, где оценивает качество консультации. В итоге в контент линии попадут две коммутации — абонента с секретарем и абонента с сотрудником, потому что только в этих разговорах участвовала внешняя линия. В контент цепочки коммутации в данном случае попадут три коммутации - абонента с секретарем, секретаря с сотрудником и абонента с сотрудником, потому как все три вызова были сделаны в рамках одной цепочки. Помимо этого в оба контента попадет информация о пройденных IVR сценариях.
 
  
 +
Наряду с контентом линии, в Oktell существует ''контент цепочки коммутаций'' (еще его называют ''контент сессии''). Контент сессии существует в рамках цепочки коммутаций и в отличие от контента линии его можно получить как для внешних, так и для внутренних линий.
  
[[Файл:Урок 28 -001++.png]]
+
Следует отметить, что контенты линии и сессии отличаются друг от друга. В контент сессии для данной ситуации попадет еще разговор секретаря Марии с сотрудником Станиславом во время консультативного перевода, потому как этот вызов, как и другие был сделан в рамках одной цепочки. Также в контенте цепочки коммутаций фиксируется информация о пройденных очередях ожидания. Ниже показан пример контента цепочки коммутаций для того же примера (повторяющиеся моменты вырезаны).
  
  
Получить контент линии или цепочки коммутаций можно в любой момент с помощью одноименных функций для линий и для сессий в компоненте "Статус объекта" (действие — определить).  
+
[[Файл:Урок 28 -001++.png|center]]
  
  
 +
Получить контент линии или цепочки коммутаций можно в любой момент с помощью одноименных функций в компоненте "'''Статус объекта'''" (действие — определить). Для линии вы можете определить как контент линии (XML), так и цепочки коммутаций (XML, Json). Для сессии (цепочки) доступно только определение контента цепочки коммутаций.
  
В контентах линии и цепочки коммутаций есть специальные пользовательские поля, куда вы можете заносить свою информацию. Иногда эту нужно для передачи некоторых параметров между сценариями. Вставить свои значения в эти пользовательские поля вы можете с помощью одноименных функций для линий и для сессий в компоненте "Статус объекта" (действие — установить).
 
  
 +
[[Файл:Урок 28 -002.png|1000px|center]]
  
  
==Сценарий обработки контента ==
+
В каждом из представленных контентов есть специальные пользовательские поля, куда вы можете заносить свою информацию. Иногда эту нужно для указания служебных данных или передачи некоторых параметров между сценариями, которые запускаются не в рамках одной сессии. В контенте линии пользовательское поле располагается в заголовке (показано на рисунке выше):
 +
:<code><property_cdata key="custominfo"><![CDATA[''Любые данные'']]></property_cdata></code>
  
Запуск данного сценария происходит автоматически после окончания звонка.  Какой именно служебный сценарий будет отвечать за обработку контента выбираем и назначаем в разделе Администрирование / Общие настройки / Сценарии АТС / Служебный сценарий обработки контента.
+
В контенте цепочки коммутаций это несколько полей — одно в заголовке контента сессии и по одному на каждую коммутацию (показано на рисунке выше):
 +
:<code><property_cdata key="custom"><![CDATA[''Любые данные'']]></property_cdata></code>
 +
:<code><property_cdata key="custom"><![CDATA[''Любые данные'']]></property_cdata></code>
  
Прежде чем обрабатывать контент,нужно ознакомиться в каком виде он нам становиться доступным. Для этого создадим простой служебный сценарий - "обработка контента".
+
Определить и установить свои значения в эти пользовательские поля вы можете с помощью одноименных функций в компоненте "'''Статус объекта'''". Для линии доступны пользовательские поля обоих типов контентов, для сессии доступен только контент цепочки.
  
  
[[Файл:con01.png|center]]
+
[[Файл:Урок 28 -003.png|1000px|center]]
  
  
В компоненте старт, выбираем параметры запуска, а точнее создаем переменную в которую система передаст эти самые параметры запуска,в нашем случае это и будет контент.
+
==Сценарий обработки контента ==
  
 +
Как было сказано в начале, сценарий обработки контента запускается автоматически после окончания звонка на внешней линии. На вход в качестве параметра запуска сценарию поступает контент линии в формате XML. Получить контент линии можно также с помощью функции "''Входной параметр 1''". Далее в сценарии вы можете проанализировать эту структуру и определить различные параметры звонка. Рассмотрим этот процесс на примере задачи.
  
[[Файл:con02.png|center]]
+
'''Задача:''' необходимо определять пропущенные звонки от клиентов и реализовать автоматическую отправку email директору с указанием номера абонента (callerid), набранного номера (calledid) и времени звонка. Пропущенным звонком в данной задаче будем считать такой, у которого не было ни одного соединения с оператором.
  
Далее используем компонент "Сохранение контента" для того что бы создать физический файл в который сохраниться наш контент. Для этого,в качестве контента указываем нашу переменную "Контент", затем для удобства последующего просмотра выбираем тип - txt.  
+
Чтобы решить эту задачу, нужно посмотреть на различие контентов между звонками, в которых были соединения с операторами и в которых их не было.
  
Файл - выбираем категорию где наш файл создастся и указываем название файла. После этого сохраняем сценарий,назначаем его в качестве "Служебного сценария сбора контента", после чего производим звонок.
+
[[Файл:Урок 28 -009.png|center]]
  
Переходим в категорию,которую указали для сохранения контента и раскрываем с помощью блокнота.
 
  
 +
Как видно из рисунка, соединения с операторами отмечается дополнительным тегом <code><abonent index="1"></code> внутри основного тега <code><commutation index="1"></code>. Исходя из этого, если количество таких тегов равняется нулю, звонок можно считать пропущенным. Остальные параметры — направление звонка, CallerId, CalledId и время звонка можно также посмотреть из контента, на рисунке они отмечены синим цветом.
  
[[Файл:con1.png|center]]
+
Итоговый сценарий выглядит следующим образом:  
  
  
Как видно из данного файла - весь контент "обрамлен" в xml. Соответственно для последующего разбора данных мы будем использовать компонент парсер текста, с использованием поискового языка OQuery.  
+
[[Файл:Урок 28 -004.png|center]]
  
Давайте рассмотрим структуру более подробно. Для примера возьмем строчку из контента:
 
  
:'''<property_simple key="idchain" value="21819d69-6d1e-40b5-898b-a6c387a555bc" />'''
+
Компонент "'''Старт'''". Сохраняет контент линии в переменную '''content'''.
 +
* Параметр запуска - переменная '''content''' (строковая)
  
В данной строке property_simple - является тегом,
 
key="idchain" - уточняющий атрибут,
 
value="21819d69-6d1e-40b5-898b-a6c387a555bc" - конкретизирующий атрибут.
 
  
Таким образом для того что бы получить значение ID цепочки коммутации строим следующий поисковый запрос:
+
Компонент "'''Вывод контента'''". Отладочное уведомление для вывода контента линии.
 +
* Текст - переменная '''content'''.
 +
* Способ оповещения - Всплывающее уведомление
 +
* Ключ получателя - внутренний номер администратора. Указать ключ в таком виде намного легче, чем выбирать пользователя в свойстве "Адресат".
  
:'''property_simple[key="idchain"]'''
 
  
Где, следуя синтаксису OQuery, property_simple - тег,[key="idchain"] - атрибут с известным нам значением и названием.
+
Компонент "'''Количество коммутаций'''". Парсер определяет из контента количество коммутаций с абонентами. Поскольку контент представляет из себя XML структуру, используется алгоритм OQuery.
 +
* Документ - переменная '''content'''
 +
* Алгоритм - Язык OQuery для HTML
 +
* Поисковый запрос - строка
 +
<code>commutation:has(property_simple[name='abonent'])</code>
 +
Запрос ищет все теги ''commutation'', внутри который есть тег ''property_simple'' с атрибутом ''name="abonent"''
 +
* Функция - Количество элементов
 +
* Результат в переменную - переменная '''count''' (строковая)
 +
* Переход и Переход, неудача - на компонент "Пропущенный?". Переход по неудаче сделан для случая, если в контенте не будет ни одной коммутации с абонентом. Дело в том, что если парсер не находит нужных тегов, он возвращает ошибку.
  
Далее рассмотрим служебный сценарий сбора контента, в котором используя последовательный парсинг контента, мы получим необходимые значения и сохраним все в БД.
+
[[Файл:Урок 28 -005.png|center]]
  
Во первых создадим таблицу в БД, в которую будем в итоге складировать все полученные данные. В ходе примера получим следующие данные:
 
*ID цепочки коммутации,
 
*Номер внешней линии,
 
*CallerID,
 
*CalledID,
 
*Время начала,
 
*Время конца,
 
*Имя пользователя, обслужившего вызов последним,
 
*Номер линии,обслужившей вызов последней,
 
*ID пользователя,обслужившего вызов последним.
 
  
Из такого набора данным все поля делаем NVarchar,кроме Время начала,Время конца,которые создаем как Date/time.
+
Компонент "'''Пропущенный?'''". Если парсер не нашел нужных тегов, то он перейдет по неудаче, а в переменную он возвратит пустое значение. Компонент сравнивает переменную '''count''' с пустой строкой, тем самым определяя пропущенный это звонок или нет.
 +
* Аргумент 1 - переменная '''count'''
 +
* Аргумент 2 - пустая строка
 +
* Тип сравнение - "="
 +
* Переход, если правда - на компонент "Определяем направление"
 +
* Переход, если ложь - на компонент "Стоп 1"
  
  
[[Файл:con7.png|center]]
+
Компонент "'''Определяем направление'''". Определяет направление звонка - входящий или исходящий. Требуемое значение находится в теге <code><property_simple key="direction" value="1" name="cdIncoming" /></code> в атрибуте name.
 +
* Документ - переменная '''content'''
 +
* Алгоритм - Язык OQuery для HTML
 +
* Поисковый запрос - строка
 +
<code>property_simple[key='direction']</code>
 +
Запрос ищет все теги property_simple с атрибутом key="direction"
 +
* Функция - Значение атрибута
 +
* Номер элемента - 1
 +
* Атрибут - строка "name"
 +
* Результат в переменную - переменная '''direction''' (строковая)
 +
* Переход и Переход, неудача - на компонент "Входящий звонок?".
  
  
Далее переходим непосредственно к нашему сценарию.
+
Компонент "'''Входящий звонок?'''". Поскольку в задании требуется определять только входящие звонки, у которых не было ни одной коммутации, компонент сравнивает полученное направление со строкой "cdIncoming".
 +
* Аргумент 1 - переменная '''direction'''
 +
* Аргумент 2 - строка "cdIncoming"
 +
* Тип сравнение - "="
 +
* Переход, если правда - на компонент "CallerId"
 +
* Переход, если ложь - на компонент "Стоп 2"
  
[[Файл:con2.png|center]]  
+
[[Файл:Урок 28 -006.png|center]]
  
Рассмотрим настройки компонента "Парсер"
 
*Документ - переменная "Контент".
 
*Алгоритм - Язык OQuery
 
*Поисковый запрос - property_simple[key="idchain"]
 
*Функция - что нужно нам найти в документе - значение атрибута.
 
*Номер элемента - оставляем пустым.
 
*Атрибут - value
 
*Результат в переменную - указываем переменную в которую будем сохранять результат парсера.
 
  
[[Файл:con3.png|center]]
+
Компонент "'''CallerId'''". Определяет CallerId. Требуемое значение находится в теге <code><property_simple key="callerid" value="88432110000" /></code> в атрибуте value.
 +
* Документ - переменная '''content'''
 +
* Алгоритм - Язык OQuery для HTML
 +
* Поисковый запрос - строка
 +
<code>property_simple[key='callerid']</code>
 +
Запрос ищет все теги property_simple с атрибутом key="callerid"
 +
* Функция - Значение атрибута
 +
* Номер элемента - 1
 +
* Атрибут - строка "value"
 +
* Результат в переменную - переменная '''callerid''' (строковая)
 +
* Переход и Переход, неудача - на компонент "CalledId".
  
Таким же образом настраиваем и все последующие парсеры,не забывая изменять значение атрибута
 
key в поисковом запросе на соответствующий нашему запросу, т.е. следующий парсер будет уже искать
 
номер линии соответственно: property_simple[key="linenumber"]
 
а так же указываем другую переменную.
 
  
Стоит отметить, что парсер позволяет сохранить информацию только в текстовом виде, соответственно
+
Компонент "'''CalledId'''". Определяет CalledId. Требуемое значение находится в теге <code><property_simple key="calledid" value="88001112233" /></code> в атрибуте value.
при получении временных данных, их прежде всего сохраняем в строковую переменную,а затем при
+
* Документ - переменная '''content'''
необходимости преобразуем в переменную типа Дата/время.
+
* Алгоритм - Язык OQuery для HTML
 +
* Поисковый запрос - строка
 +
<code>property_simple[key='calledid']</code>
 +
Запрос ищет все теги property_simple с атрибутом key="calledid"
 +
* Функция - Значение атрибута
 +
* Номер элемента - 1
 +
* Атрибут - строка "value"
 +
* Результат в переменную - переменная '''calledid''' (строковая)
 +
* Переход и Переход, неудача - на компонент "TimeStart".
  
Так же для того что бы найти первый тег можно использовать указательный суффикс ":first" и для поиска последнего значения ":last".
 
Таким образом для поиска времени поступления звонка воспользуемся суффиксом :first, поисковый запрос будет выглядеть так:
 
:'''(property_simple[key="timestart"]):first'''.
 
  
 +
Компонент "'''TimeStart'''". Определяет время начала звонка. Требуемое значение находится в теге <code><property_simple key="timestart" value="06.05.2015 10:06:43.462" /></code> в атрибуте value.
 +
* Документ - переменная '''content'''
 +
* Алгоритм - Язык OQuery для HTML
 +
* Поисковый запрос - строка
 +
<code>property_simple[key='timestart']</code>
 +
Запрос ищет все теги property_simple с атрибутом key="timestart"
 +
* Функция - Значение атрибута
 +
* Номер элемента - 1
 +
* Атрибут - строка "value"
 +
* Результат в переменную - переменная '''timestart''' (строковая)
 +
* Переход и Переход, неудача - на компонент "Вывод параметров".
  
[[Файл:con4.png|center]]
+
[[Файл:Урок 28 -007.png|center]]
  
  
А для поиска времени окончания коммутации используем суффикс ":last" - '''(property_simple[key="timestop"]):last'''.
+
Компонент "'''Вывод параметров'''". Отладочное уведомление для вывода всех найденных параметров звонка
 +
* Текст - выражение:
 +
'ПРОПУЩЕННЫЙ ЗВОНОК'+endline+
 +
'[callerid] '+[callerid]+endline+
 +
'[calledid] '+[calledid]+endline+
 +
'[timestart] '+[timestart]+endline+
 +
'[direction] '+[direction]
 +
* Способ оповещения - Всплывающее уведомление
 +
* Ключ получателя - внутренний номер администратора.
  
  
[[Файл:con5.png|center]]
+
Компонент "'''Отправка Email'''". Отправляет электронное письмо по пропущенному звонку.
 +
* Почтовый сервер - Согласно общим настройкам. Используются данные для подключения из модуля ''Общие настройки / Настройки E-mail''
 +
* Кому - строка ''director@oktell.ru''
 +
* От кого - строка ''info@oktell.ru'', как правило совпадает с логином для подключения к SMTP-серверу.
 +
* Тема - строка ''Пропущенный звонок''
 +
* Формат - текст
 +
* Содержание письма - выражение:
 +
'ПРОПУЩЕННЫЙ ЗВОНОК'+endline+
 +
'Номер абонента: '+[callerid]+endline+
 +
'Набранный номер: '+[calledid]+endline+
 +
'Время: '+[timestart]
  
 +
[[Файл:Урок 28 -008.png|center]]
  
Так же суффиксом ":last" воспользуемся,для того что бы определить имя последнего оператора,принявшего звонок, его id и номер его линии.
 
  
Затем произведем преобразование строчной даты и времени в тип Дата\время и произведем запись в БД,в нашу таблицу.
+
'''Скачать сценарий:''' [http://wiki.oktell.ru/images/a/aa/%D0%A1%D1%86%D0%B5%D0%BD%D0%B0%D1%80%D0%B8%D0%B9_%D0%BE%D0%B1%D1%80%D0%B0%D0%B1%D0%BE%D1%82%D0%BA%D0%B8_%D0%BA%D0%BE%D0%BD%D1%82%D0%B5%D0%BD%D1%82%D0%B0.oscr Сценарий обработки контента.oscr] (''собран на версии 2.12.0.150423'')
  
  
[[Файл:con6.png|center]]
+
==Назначение сценария==
  
 +
Сценарий обработки контента назначается в модуле ''Администрирование/Общие настройки'' на вкладке "'''Сценарии АТС'''". Для того, чтобы назначить сценарий выберите его в выпадающем списке напротив соответствующей строки и поставьте крестик для его активации, затем сохраните настройки. Выбранный сценарий в списке обозначается серым цветом.
  
После чего сохраним сценарий на сервере и совершим тестовый звонок. Открыв нашу таблицу мы увидим данные,которые мы собрали с помощью служебного сценария сбора контента.
 
  
 +
[[Файл:Урок 28 -010.png |center|700px]]
  
[[Файл:con8.png|center]]
 
 
 
Пример сценария:
 
 
[[Файл:Content.zip]]
 
  
  
Строка 158: Строка 213:
  
 
== Вопросы и задания ==
 
== Вопросы и задания ==
 
+
* Зачем нужен сценарий обработки контента? Что такое контент, какие виды контента существуют?
 
+
* Дополните данный сценарий информацией о том, какой внутренний номер пропустил данный звонок. Передать значение из главного сценария в сценарий контента вы можете с помощью сессионной переменной, либо через пользовательское поле в контенте. Попробуйте оба варианта.
 +
* Реализуйте в сценарии определение параметров успешного звонка: CallerId, CalledId, время звонка, номер внешней линии, имя и идентификатор последнего обслужившего сотрудника. Все найденные параметры сохраняйте в базу данных.
 +
* Настройте сценарий обработки контента для отправки всех записей разговоров в цепочке коммутаций на электронную почту. Таким образом, если клиент разговаривал с несколькими сотрудниками, в письмо должны быть вложены все разговоры клиента. Используйте статью: [http://wiki.oktell.ru/Отправка_записей_разговоров_на_e-mail Отправка записей разговоров на e-mail]. Модифицируйте сценарий для отправки записей разговоров только в тех случаях, когда клиент поставил оценку 1 или 2 в сценарии вместо отбоя.
  
 
{|cellpadding="10" cellspacing="0" border="0"
 
{|cellpadding="10" cellspacing="0" border="0"

Текущая версия на 10:10, 6 мая 2015

Наверх К предыдущему уроку К следующему уроку

Введение

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

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

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

После того как линия положит трубку в контент линии попадут 4 коммутации:

  • соединение абонента с главным IVR сценарием
  • разговор абонента с секретарем Марией
  • разговор абонента с сотрудником Станиславом
  • соединение абонента со сценарием вместо отбоя

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


Урок 28 -001+.png


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

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


Урок 28 -001++.png


Получить контент линии или цепочки коммутаций можно в любой момент с помощью одноименных функций в компоненте "Статус объекта" (действие — определить). Для линии вы можете определить как контент линии (XML), так и цепочки коммутаций (XML, Json). Для сессии (цепочки) доступно только определение контента цепочки коммутаций.


Урок 28 -002.png


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

<property_cdata key="custominfo"><![CDATA[Любые данные]]></property_cdata>

В контенте цепочки коммутаций это несколько полей — одно в заголовке контента сессии и по одному на каждую коммутацию (показано на рисунке выше):

<property_cdata key="custom"><![CDATA[Любые данные]]></property_cdata>
<property_cdata key="custom"><![CDATA[Любые данные]]></property_cdata>

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


Урок 28 -003.png


Сценарий обработки контента

Как было сказано в начале, сценарий обработки контента запускается автоматически после окончания звонка на внешней линии. На вход в качестве параметра запуска сценарию поступает контент линии в формате XML. Получить контент линии можно также с помощью функции "Входной параметр 1". Далее в сценарии вы можете проанализировать эту структуру и определить различные параметры звонка. Рассмотрим этот процесс на примере задачи.

Задача: необходимо определять пропущенные звонки от клиентов и реализовать автоматическую отправку email директору с указанием номера абонента (callerid), набранного номера (calledid) и времени звонка. Пропущенным звонком в данной задаче будем считать такой, у которого не было ни одного соединения с оператором.

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

Урок 28 -009.png


Как видно из рисунка, соединения с операторами отмечается дополнительным тегом <abonent index="1"> внутри основного тега <commutation index="1">. Исходя из этого, если количество таких тегов равняется нулю, звонок можно считать пропущенным. Остальные параметры — направление звонка, CallerId, CalledId и время звонка можно также посмотреть из контента, на рисунке они отмечены синим цветом.

Итоговый сценарий выглядит следующим образом:


Урок 28 -004.png


Компонент "Старт". Сохраняет контент линии в переменную content.

  • Параметр запуска - переменная content (строковая)


Компонент "Вывод контента". Отладочное уведомление для вывода контента линии.

  • Текст - переменная content.
  • Способ оповещения - Всплывающее уведомление
  • Ключ получателя - внутренний номер администратора. Указать ключ в таком виде намного легче, чем выбирать пользователя в свойстве "Адресат".


Компонент "Количество коммутаций". Парсер определяет из контента количество коммутаций с абонентами. Поскольку контент представляет из себя XML структуру, используется алгоритм OQuery.

  • Документ - переменная content
  • Алгоритм - Язык OQuery для HTML
  • Поисковый запрос - строка
commutation:has(property_simple[name='abonent'])

Запрос ищет все теги commutation, внутри который есть тег property_simple с атрибутом name="abonent"

  • Функция - Количество элементов
  • Результат в переменную - переменная count (строковая)
  • Переход и Переход, неудача - на компонент "Пропущенный?". Переход по неудаче сделан для случая, если в контенте не будет ни одной коммутации с абонентом. Дело в том, что если парсер не находит нужных тегов, он возвращает ошибку.
Урок 28 -005.png


Компонент "Пропущенный?". Если парсер не нашел нужных тегов, то он перейдет по неудаче, а в переменную он возвратит пустое значение. Компонент сравнивает переменную count с пустой строкой, тем самым определяя пропущенный это звонок или нет.

  • Аргумент 1 - переменная count
  • Аргумент 2 - пустая строка
  • Тип сравнение - "="
  • Переход, если правда - на компонент "Определяем направление"
  • Переход, если ложь - на компонент "Стоп 1"


Компонент "Определяем направление". Определяет направление звонка - входящий или исходящий. Требуемое значение находится в теге <property_simple key="direction" value="1" name="cdIncoming" /> в атрибуте name.

  • Документ - переменная content
  • Алгоритм - Язык OQuery для HTML
  • Поисковый запрос - строка
property_simple[key='direction']

Запрос ищет все теги property_simple с атрибутом key="direction"

  • Функция - Значение атрибута
  • Номер элемента - 1
  • Атрибут - строка "name"
  • Результат в переменную - переменная direction (строковая)
  • Переход и Переход, неудача - на компонент "Входящий звонок?".


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

  • Аргумент 1 - переменная direction
  • Аргумент 2 - строка "cdIncoming"
  • Тип сравнение - "="
  • Переход, если правда - на компонент "CallerId"
  • Переход, если ложь - на компонент "Стоп 2"
Урок 28 -006.png


Компонент "CallerId". Определяет CallerId. Требуемое значение находится в теге <property_simple key="callerid" value="88432110000" /> в атрибуте value.

  • Документ - переменная content
  • Алгоритм - Язык OQuery для HTML
  • Поисковый запрос - строка
property_simple[key='callerid']

Запрос ищет все теги property_simple с атрибутом key="callerid"

  • Функция - Значение атрибута
  • Номер элемента - 1
  • Атрибут - строка "value"
  • Результат в переменную - переменная callerid (строковая)
  • Переход и Переход, неудача - на компонент "CalledId".


Компонент "CalledId". Определяет CalledId. Требуемое значение находится в теге <property_simple key="calledid" value="88001112233" /> в атрибуте value.

  • Документ - переменная content
  • Алгоритм - Язык OQuery для HTML
  • Поисковый запрос - строка
property_simple[key='calledid']

Запрос ищет все теги property_simple с атрибутом key="calledid"

  • Функция - Значение атрибута
  • Номер элемента - 1
  • Атрибут - строка "value"
  • Результат в переменную - переменная calledid (строковая)
  • Переход и Переход, неудача - на компонент "TimeStart".


Компонент "TimeStart". Определяет время начала звонка. Требуемое значение находится в теге <property_simple key="timestart" value="06.05.2015 10:06:43.462" /> в атрибуте value.

  • Документ - переменная content
  • Алгоритм - Язык OQuery для HTML
  • Поисковый запрос - строка
property_simple[key='timestart']

Запрос ищет все теги property_simple с атрибутом key="timestart"

  • Функция - Значение атрибута
  • Номер элемента - 1
  • Атрибут - строка "value"
  • Результат в переменную - переменная timestart (строковая)
  • Переход и Переход, неудача - на компонент "Вывод параметров".
Урок 28 -007.png


Компонент "Вывод параметров". Отладочное уведомление для вывода всех найденных параметров звонка

  • Текст - выражение:
'ПРОПУЩЕННЫЙ ЗВОНОК'+endline+
'[callerid] '+[callerid]+endline+
'[calledid] '+[calledid]+endline+
'[timestart] '+[timestart]+endline+
'[direction] '+[direction]
  • Способ оповещения - Всплывающее уведомление
  • Ключ получателя - внутренний номер администратора.


Компонент "Отправка Email". Отправляет электронное письмо по пропущенному звонку.

  • Почтовый сервер - Согласно общим настройкам. Используются данные для подключения из модуля Общие настройки / Настройки E-mail
  • Кому - строка director@oktell.ru
  • От кого - строка info@oktell.ru, как правило совпадает с логином для подключения к SMTP-серверу.
  • Тема - строка Пропущенный звонок
  • Формат - текст
  • Содержание письма - выражение:
'ПРОПУЩЕННЫЙ ЗВОНОК'+endline+
'Номер абонента: '+[callerid]+endline+
'Набранный номер: '+[calledid]+endline+
'Время: '+[timestart]
Урок 28 -008.png


Скачать сценарий: Сценарий обработки контента.oscr (собран на версии 2.12.0.150423)


Назначение сценария

Сценарий обработки контента назначается в модуле Администрирование/Общие настройки на вкладке "Сценарии АТС". Для того, чтобы назначить сценарий выберите его в выпадающем списке напротив соответствующей строки и поставьте крестик для его активации, затем сохраните настройки. Выбранный сценарий в списке обозначается серым цветом.


Урок 28 -010.png


Поздравляем! Теперь вы знаете как проанализировать звонок после соединения. Можете переходить к следующему уроку.

Техническая документация: Сценарии АТС


Вопросы и задания

  • Зачем нужен сценарий обработки контента? Что такое контент, какие виды контента существуют?
  • Дополните данный сценарий информацией о том, какой внутренний номер пропустил данный звонок. Передать значение из главного сценария в сценарий контента вы можете с помощью сессионной переменной, либо через пользовательское поле в контенте. Попробуйте оба варианта.
  • Реализуйте в сценарии определение параметров успешного звонка: CallerId, CalledId, время звонка, номер внешней линии, имя и идентификатор последнего обслужившего сотрудника. Все найденные параметры сохраняйте в базу данных.
  • Настройте сценарий обработки контента для отправки всех записей разговоров в цепочке коммутаций на электронную почту. Таким образом, если клиент разговаривал с несколькими сотрудниками, в письмо должны быть вложены все разговоры клиента. Используйте статью: Отправка записей разговоров на e-mail. Модифицируйте сценарий для отправки записей разговоров только в тех случаях, когда клиент поставил оценку 1 или 2 в сценарии вместо отбоя.
Наверх К предыдущему уроку К следующему уроку