====== Шаблоны Редактора маршрута вызовов ======

===== Обзор =====

Редактор маршрута вызовов АТС Askozia включает в себя несколько шаблонов маршрутов вызовов для ознакомления пользователем.
Выберите **Templates** в верхней части окна и вы увидите выпадающий список шаблонов маршрутов вызовов, как показано на рисунке ниже.

{{ :handbook:cfe:obzor.png |Обзор шаблонов}}


{{:handbook:cfe:note_sign.png|}}Помните, перед выбором нового шаблона, уже созданный маршрут вызова должен быть сохранен или задублирован. 


===== Basic =====

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


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


==== Основные операции с вызовами ====

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

Выберите внутренний номер в модуле [[handbook:cfe:modules?&#extension|Extension]]. Для того, чтобы телефон появился в выпадающем меню модуля [[handbook:cfe:modules?&#extension|Extension]], его необходимо предварительно создать в разделе [[handbook:accounts#uchetnye_zapisi_telefonov|Учетные записи телефонов]]. 

{{ :handbook:cfe:osnovnye_operacii_s_vyzovami.png |Основные операции с вызовами}}

Каждый маршрут вызова должен начинаться с модуля [[handbook:cfe:modules?&#start|Start]], к которому необходимо присоединить модуль [[handbook:cfe:modules?&#answer|Answer]] для ответа на вызов. Длительность вызова телефона выбрана 10 секунд в модуле [[handbook:cfe:modules?&#extension|Extension]]. Конец маршрута вызова обозначается модулем [[handbook:cfe:modules?&#hangup|Hangup]], который разрывает канал принудительно.
==== Ограничить количество одновременных звонков ====

Данный шаблон ограничивает количество параллельных вызовов до 1. Если поступает больше одного вызова, вызывающий абонент будет слышать сигнал "занято" в течении 3 секунд, затем вызов разорвется. В противоположном случае, маршрут вызова перейдет к модулю [[handbook:cfe:modules?&#extension|Extension ]]. Если на вызов не ответят в течение 10 секунд, звонок будет сброшен. 

{{ :handbook:cfe:ogranichit_kolichestvo_odnovremennyx_zvonkov.png |Ограничить количество одновременных звонков}}

Подробнее об этом вы можете прочитать в модуле [[handbook:cfe:modules?&#maximumcalls|MaximumCalls]].
==== Перенаправить с приветствием ====

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

{{ :handbook:cfe:perenapravit_s_privetstviem.png |Перенаправить с приветствием}}

Выберите телефон и нажмите кнопку **Записать сейчас** в модуле [[handbook:cfe:modules?&#playback|Playback]], зазвонит выбранный телефон и можно будет записать сообщение. Так же вы можете загрузите файл, нажав на кнопку **Загрузить файл**. Модуль [[handbook:cfe:modules?&#playback|Playback]] проиграет файл полностью, а затем вернет вас в маршрут вызова к модулю [[handbook:cfe:modules?&#extension|Extension]]. Если в течении 10 секунд на вызов не будет ответа, он будет сброшен.
==== Записывать телефонные звонки и отправлять на почту ====

Данный маршрут вызова показывает, как автоматически отправлять записи телефонных разговоров на указанный электронный адрес.
 
{{ :handbook:cfe:zapisyvat_telefonnye_zvonki_i_otpravljat_na_pochtu.png |Записывать телефонные звонки и отправлять на почту}}

Как только маршрут вызова пройдет модуль [[handbook:cfe:modules?&#monitor|Monitor]], телефонный разговор начнет записываться. После разъединения соединения, запись этого телефонного разговора будет направлена на email, указанный в модуле [[handbook:cfe:modules?&#monitorstop|MonitorStop]].
==== Записать сообщение и разъединится ====

В данном примере пользователь может оставить сообщение, которое будет отправлено на указанный в модуле [[handbook:cfe:modules?&#recordemail|RecordEmail]] email.

{{ :handbook:cfe:zapisat_soobschenie_i_razedinitsja.png |Записать сообщение и разъединится}}

Это альтернатива голосовой почте([[handbook:cfe:modules?&#voicemail|Voicemail]]).
Используйте модуль [[handbook:cfe:modules?&#recordemail|RecordEmail]], если вы не хотите использовать ящик голосовой почты существующего телефона.
==== Звонящий может ввести внутренний номер и соединиться с ним ====

В этом примере мы попросим пользователя ввести внутренний номер.

{{ :handbook:cfe:zvonjaschij_mozhet_vvesti_vnutrennij_nomer_i_soedinitsja_s_nim.png |Звонящий может ввести внутренний номер и соединиться с ним}}

Сообщение для пользователя будет сформировано модулем [[handbook:cfe:modules?&#text2speech|Text2Speech]].  Введенный внутренний номер будет сохранен в переменной  **'INTEXTEN'** модуля [[handbook:cfe:modules?&#read|Read]]. Максимальная длина переменной - 4 цифры. Кроме того, в модуле [[handbook:cfe:modules?&#read|Read]] можно задать количество попыток ввода номера для пользователя(в данном примере 2) и время тайм аута(в данном примере 30 секунд). Как только пользователь введет внутренний номер, модуль [[handbook:cfe:modules?&#dialnumber|DialNumber]] считает значение переменной  **'INTEXTEN'** и соединит абонента с выбранным внутренним номером.
==== Перенаправить звонящего на внутреннее приложение ====

Данный пример показывает как можно использовать модуль [[handbook:cfe:modules#dialnumber|DialNumber]]. Он позволяет соединиться как с внутренним или внешним телефоном, так и с любым [[handbook:dialplan#prilozhenija|Приложением]].

{{ :handbook:cfe:perenapravit_zvonjaschego_na_vnutrennee_prilozhenie.png |Перенаправить звонящего на внутреннее приложение}}

В данном примере модуль [[handbook:cfe:modules#dialnumber|DialNumber]] соединит вас с номером **'000047'**, который соответствует приложению, которое сообщит вам IP адрес вашей телефонной системы.
==== Возврат в очередь ====

Шаблон **Возврат в очередь** это простой пример использования модуля [[handbook:cfe:modules#queue|Queue]] в сочетание с модулем [[handbook:cfe:modules#if|If]].

{{ :handbook:cfe:vozvrat_v_ochered.png |Возврат в очередь}}

Если внутренний номер, выбранный в модуле [[handbook:cfe:modules#extension|Extension]] не отвечает в течение заданного времени(в данном примере 10 секунд), то вызов сбросится.
В противном случае, вызов перейдет к модулю [[handbook:cfe:modules#queue|Queue]]. Помните, что для модуля [[handbook:cfe:modules#queue|Queue]] необходимо задать хотя бы одного агента очереди(модулем [[handbook:cfe:modules#queuemember|QueueMember]]).
==== Простой пример маршрутизации по времени суток  ====

Модуль [[handbook:cfe:modules#time_switch|TimeSwitch]] может изменять маршрут вызова в зависимости от времени суток,например, в нерабочее время. Для настройки данного временных интервалов и дней недели нажмите {{:handbook:cfe:askozia_options.png|}}.

{{ :handbook:cfe:prostoj_primer_marshrutizacii_po_vremeni_sutok.png |Простой пример маршрутизации по времени суток}}

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

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

Оба сообщения сформированы модулем [[handbook:cfe:modules?&#text2speech|Text2Speech]].



==== Возможность управления телефонной станцией посредством тональных сигналов с телефона(DISA)====

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

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

{{ :handbook:cfe:vozmozhnost_upravlenija_telefonnoj_stanciej_posredstvom_tonalnyx_signalov_s_telefona_disa_.png |Возможность управления телефонной станцией посредством тональных сигналов с телефона(DISA)}}

Пользователь должен ввести PIN код, указанный в модуле [[handbook:cfe:modules?&#authenticate|Authenticate]]. После ввода PIN кода, система попросит пользователя ввести внутренний номер. Сообщение будет сформировано модулем [[handbook:cfe:modules?&#text2speech|Text2Speech]].
 
Введенный внутренний номер будет сохранен в переменной  **'INTEXTEN'** модуля [[handbook:cfe:modules?&#read|Read]]. Максимальная длина переменной - 4 цифры. Кроме того, в модуле [[handbook:cfe:modules?&#read|Read]] можно задать количество попыток ввода номера для пользователя(в данном примере 2) и время тайм аута(в данном примере 30 секунд). 

<note important>Для соединения с внешним номером, должны быть настроены [[handbook:accounts#shablony_isxodjaschix_vyzovov|Шаблоны исходящих вызовов]] для провайдера.</note>

Как только пользователь введет номер, модуль [[handbook:cfe:modules?&#dialnumber|DialNumber]] считает значение переменной  **'INTEXTEN'** и соединит абонента с выбранным номером.

===== IVR =====

Блок **IVR** шаблонов включает в себя примеры маршрутов вызовов, в которых используется интерактивное голосовое меню(IVR).

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


==== Базовый пример IVR ====

Шаблон **Базовый пример IVR** показывает, как использовать интерактивное голосовое меню(IVR). 

{{ :handbook:cfe:bazovyj_primer_ivr.png |Базовый пример IVR}}

Загрузите или запишите сообщение-меню для пользователей с помощью 
[[handbook:cfe:modules?&#pressextensionmusic|PressExtensionMusic]], например: "Нажмите **1** для соединения с отделом продаж, **2** - для соединения с отделом внедрения".
Пользователь может соединиться с внутренним номером **1** или **2**.

Если пользователь введет номер, который не используется в голосовом меню(неправильный номер), то маршрут вызова перейдет к модулю [[handbook:cfe:modules?&#extensioni|ExtensionI]].
Если пользователь не введет номер в течение 5 секунд, маршрут вызова перейдет к модулю [[handbook:cfe:modules?&#extensiont|ExtensionT]].

В последних 2 случаях, пользователь услышит сигнал "занято", а спустя 3 секунды вызов будет прекращен.


==== Базовый пример IVR с механизмом генерации речи ====

Шаблон показывает простой пример использования интерактивного голосового меню(IVR) с модулем [[handbook:cfe:modules?&#text2speech|Text2Speech]].

{{ :handbook:cfe:bazovyj_primer_ivr_s_mexanizmom_generacii_rechi.png |Базовый пример IVR с механизмом генерации речи}}

В примере все сообщение(приветственное и IVR меню) создано с помощью модуля [[handbook:cfe:modules?&#text2speech|Text2Speech]]. После прослушивания у пользователя будет 5 секунд для ввода внутреннего номера(этот параметр задается в модуле [[handbook:cfe:modules?&#pressextension|PressExtension]]). 
Если введен корректный номер, пользователь соединиться с внутренний номером, если нет - услышит сигнал "занято", и вызов будет завершен.

==== Простой пример очереди ====

Шаблон показывает использование очереди с 3 агентами(модуля [[handbook:cfe:modules?&#queue|Queue]] с 3 модулями [[handbook:cfe:modules?&#queuemember|QueueMember]]). Так же указан путь маршрута вызова в случае истечения времени тайм-аута.

{{ :handbook:cfe:prostoj_primer_ocheredi.png |Простой пример очереди}}

Все телефоны, подключенные к очереди звонят одновременно. Сообщение для пользователя повторяется каждые 20 секунд. У каждого агента очередь есть перерыв в 30 секунд до ответа на следующей вызов. Если никто не ответил на вызов в течение заданного времени(в примере - 300 секунд), маршрут вызова пойдет по пути тайм аута, а пользователь услышит сигнал "занято", вызов будет завершен.



==== Пример выбора языка ====

Шаблон **Пример выбора языка** показывает использование модулей  [[handbook:cfe:modules?&#text2speech|Text2Speech]], [[handbook:cfe:modules?&#set_language|Set Language]] и [[handbook:cfe:modules?&#voicemail|Voicemail]] с IVR.

{{ :handbook:cfe:primer_vybora_jazyka.png |Пример выбора языка}}

В примере пользователю предлагается выбрать русский язык(соответствует цифре **1**) или английский(цифре **2**). Если пользователь выберет **1**, то будет установлен Русский язык, в противном случае - Английский. После выбора звонящий услышит сообщение голосовой почты на выбранном языке.

Для выбора языка у пользователя будет 5 секунд(этот параметр задается в модуле [[handbook:cfe:modules?&#pressextension|PressExtension]], после этого вызов будет завершен.


===== Complex =====

Блок **Complex ** шаблонов посвящен модулям [[handbook:cfe:modules?&#if|If]],[[handbook:cfe:modules?&#switch|Switch]], [[handbook:cfe:modules?&#goto|Goto]],[[handbook:cfe:modules?&#read|Read]] и [[handbook:cfe:modules?&#saydigits|SayDigits]].

В данной главе мы рассмотрим шаблоны в порядке их расположения в Редакторе маршрута вызовов.
==== Пример с ChanIsAvailable и Switch ====

Шаблон иллюстрирует простой пример использования [[handbook:cfe:modules?&#chanisavailable|ChanIsAvailable]] и [[handbook:cfe:modules?&#switch|Switch]] модулей.

{{ :handbook:cfe:primer_s_chanisavailable_i_switch.png |Пример с ChanIsAvailable и Switch}}

Маршрут вызова пойдет по метке, связанной с истинным условием модуля [[handbook:cfe:modules?&#switch|Switch]]. Если ни одно из условий не выполняется, маршрут вызова пойдет по метке, заданной по умолчанию(Default).
В данном примере, входные данные для модуля [[handbook:cfe:modules?&#switch|Switch]] приходят из модуля [[handbook:cfe:modules?&#chanisavailable|ChanIsAvailable]]. Если телефон, указанный в этом модуле - занят, то пользователь услышит сигнал "занято", и вызов завершается. Если телефон недоступен, то пользователь услышит музыку на удержание(10 секунд), которая будет проиграна модулем [[handbook:cfe:modules?&#waitmusiconhold|WaitMusicOnHold]], далее модуль [[handbook:cfe:modules?&#goto|GoTo]] вернет маршрут вызова к модулю [[handbook:cfe:modules?&#chanisavailable|ChanIsAvailable]].
Если же все условия ложны, то маршрут вызова пойдет по **Default** метке, а пользователь услышит сигнал "Занято".
==== Пример с чтением и проговариванием цифр ====

Этот пример иллюстрирует использование модулей [[handbook:cfe:modules#read|Read]] и [[handbook:cfe:modules#saydigits|SayDigits]]. Пользователю разрешено ввести 2 цифры, которые маршрут вызова ему прочитает.

{{ :handbook:cfe:primer_s_chteniem_i_progovarivaniem_cifr.png |Пример с чтением и проговариванием цифр}}

Модуль [[handbook:cfe:modules#read|Read]] сохранит цифры в переменную **"test"**. Максимальная длина этой переменной - 2 символа. Максимальное количество попыток ввода равно 3, а время тайм аута - 30 секундам. Модуль [[handbook:cfe:modules#saydigits|SayDigits]] прочитает пользователю значение переменной **"test"**, и звонок сбросится.
==== Пример с чтением, установкой языка и проговариванием цифр ====

В данном примере пользователь может ввести 2 цифры и прослушать их на выбранном языке.

{{ :handbook:cfe:primer_s_chteniem_ustanovkoj_jazyka_i_progovarivaniem_cifr.png |Пример с чтением, установкой языка и проговариванием цифр}}

Модуль [[handbook:cfe:modules#read|Read]] сохранит цифры в переменную **"test"**. Максимальная длина этой переменной - 2 символа. Максимальное количество попыток ввода равно 3, а время тайм аута - 30 секундам. Выберите язык в модуле [[handbook:cfe:modules#set_language|Set Language]], и модуль [[handbook:cfe:modules#saydigits|SayDigits]] прочитает пользователю значение переменной **"test"** на выбранном языке, и звонок сбросится.
==== Пример использования Условия ====

Шаблон **Пример использования Условия** иллюстрирует базовый пример использования модуля [[handbook:cfe:modules#if|If]].

{{ :handbook:cfe:primer_ispolzovanija_uslovija.png |Пример использования Условия}}

Модуль [[handbook:cfe:modules#if|If]] получает входные данные из модуля [[handbook:cfe:modules#extension|Extension]]. Если на вызов ответят до истечения времени тайм аута(10 секунд), маршрут вызова пойдет по зеленой метке, вызов будет завершен. В противном случае, маршрут вызова пойдет по красной метке, и пользователь будет перенаправлен на [[handbook:cfe:modules#voicemail|VoiceMail]].