Текст книги "Asterisk™: будущее телефонии Второе издание"

Автор книги: Джим Меггелен

Соавторы: Джаред Смит,Лейф Мадсен
сообщить о нарушении

Текущая страница: 15 (всего у книги 41 страниц)

щих вызовов. В приоритете 1 с помощью синтаксиса ${EXTEN:1} от набранного добавочного номера отбрасывается цифра 9 и делается попытка дозвониться на этот номер по каналу, указанному переменной OUTBOUNDTRUNK. Если удается дозвониться, абонент соединяется с исходящим каналом. Если вызов заканчивается неудачей (например, канал занят или невозможно набрать номер по какой-то другой причине), вызывается приложение Congestion() (перегрузка), которое воспроизводит «короткие гудки» (тональный сигнал перегрузки линии), сообщая абоненту, что дозвониться не удалось.

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

[outbound-local]

exten => _9NXXXXXX,1,Dial(${OUTBOUNDTRUNK}/${EXTEN:1}) exten => _9NXXXXXX,n,Congestion() exten => _9NXXXXXX,n,Hangup()

exten => 911,1,Dial(${OUTBOUNDTRUNK}/911)

exten => 9911, 1, Dial (${OUTBOUNDTRUNK}/911) ; Чтобы тот, кто набрал первую "9",

; тоже мог дозвониться

Опять же, в данном примере предполагается, что мы находимся в США или Канаде. Если вы проживаете в другой стране, замените, пожалуйста, 911 номером экстренных служб, используемым в вашем регионе. Это то, о чем ни в коем случае нельзя забывать при создании своего ди– алплана!

Далее добавим контекст для междугородних звонков:

[outbound-long-distance]

exten => _91NXXNXXXXXX,1,Dial(${OUTBOUNDTRUNK}/${EXTEN:1}) exten => _91NXXNXXXXXX,n,Playtones(congestion) exten => _91NXXNXXXXXX,n,Hangup()

Теперь, когда у нас есть два новых контекста, как предоставить возможность внутренним абонентам их использовать? Необходим какой-то способ использовать функциональность одного контекста из другого.

Выражения include

Asterisk предоставляет возможность использовать добавочные номера из одного контекста в другом контексте с помощью директивы include (включить). Так можно управлять доступом к различным разделам диалплана. Мы будем применять функциональность включения, чтобы дать возможность пользователям из контекста [employees] делать исходящие звонки. Но сначала давайте рассмотрим синтаксис. Выражение include имеет следующий вид, где контекст – имя удаленного контекста, который требуется включить в текущий: include => контекст

При включении контекстов друг в друга необходимо внимательно продумать порядок их включения. Asterisk сначала будет пытаться найти

соответствие набранному добавочному номеру в текущем контексте. В случае неудачи она будет рассматривать контекст, включенный первым (в том числе все включенные в него контексты), а затем будет переходить от одного контекста к другому в порядке их включения. На данный момент в нашем диалплане есть два контекста для исходящих вызовов, но абоненты из контекста [employees] не могут их использовать. Исправим это, включив оба исходящих контекста в контекст [employees], как показано в примере: [globals] JOHN=Zap/1 JANE=SIP/Jane OUTBOUNDTRUNK=Zap/4

[incoming]

exten => 123,1,Answer()

exten => 123,n,Background(enter-ext-of-person) exten => 123,n,WaitExten()

exten => 1,1,Dial(${JOHN},10) exten => 1,n,Playback(vm-nobodyavail) exten => 1,n,Hangup()

exten => 2,1,Dial(${JANE},10) exten => 2,n,Playback(vm-nobodyavail) exten => 2,n,Hangup()

exten => i,1,Playback(pbx-invalid) exten => i,n,Goto(incoming,123,1)

exten => t,1,Playback(vm-goodbye) exten => t,n,Hangup()

[employees]

include => outbound-local include => outbound-long-distance

exten => 101,1,Dial(${JOHN}) exten => john,1,Dial(${JOHN}) exten => 102,1,Dial(${JANE}) exten => jane,1,Dial(${JANE})

[outbound-local]

exten => _9NXXXXXX,1,Dial(${OUTBOUNDTRUNK}/${EXTEN:1}) exten => _9NXXXXXX,n,Congestion() exten => _9NXXXXXX,n,Hangup()

exten => 911,1,Dial(${OUTBOUNDTRUNK}/911) exten => 9911,1,Dial(${OUTBOUNDTRUNK}/911)

[outbound-long-distance]

exten => _91NXXNXXXXXX,1,Dial(${OUTBOUNDTRUNK}/${EXTEN:1})

exten => _91NXXNXXXXXX,n,Playtones(congestion) exten => _91NXXNXXXXXX,n,Hangup()

Эти два выражения include обеспечивают абонентам из контекста [employees] возможность осуществлять исходящие вызовы. Также нужно заметить следующее: в целях безопасности всегда необходимо убедиться в том, что контекст [inbound] (входящие) не допускает возможности исходящих звонков. (Если вдруг это стало бы возможным, люди могли бы дозваниваться в вашу систему, а затем делать исходящие платные звонки за ваш счет!)

Заключение

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

Если какие-то части данного диалплана вызывают у вас вопросы, вероятно, вам следует вернуться немного назад и перечитать раздел или два, прежде чем переходить к следующей главе. Крайне важно понимать все эти основные принципы и их применение, потому что они являются основой для изучения следующих глав.6

Дополнительные концепции диалплана

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

– Элис Кан

Отлично. Основные принципы диалплана рассмотрены, но многое впереди. Если вы еще не до конца разобрались с предыдущей главой, пожалуйста, вернитесь назад и перечитайте ее. Мы собираемся переходить к более сложным вопросам.

Выражения и работа с переменными

Поскольку мы начинаем погружение в более глубокие аспекты диал– плана, пришло время представить несколько инструментов, которые могут значительно увеличить его мощь. Эти структуры невероятно усложнят логику диалплана, обеспечив ему возможность принимать решения на основании различных задаваемых критериев. Итак, собрались с мыслями – и начнем.

Элементарные выражения

Выражения – это сочетания переменных, операторов и значений, объединяемые для получения результата. Выражение может тестировать значения, изменять строки или выполнять вычисления. Допустим, имеется переменная COUNT. Возьмем два возможных выражения, составленных с использованием этой переменной: «COUNT плюс 1» и «COUNT разделить на 2». Каждое из этих выражений имеет конкретный результат или значение, зависящие от значения данной переменной.

В Asterisk выражения всегда начинаются со знака доллара ($) и открывающей квадратной скобки и заканчиваются закрывающей квадратной скобкой:

$[выражение]

Таким образом, упомянутые выше примеры будут записаны так:

$[${COUNT} + 1] $[${COUNT} / 2]

Когда Asterisk встречает в диалплане выражение, она заменяет его результирующим значением. Важно отметить, что это происходит после подстановки переменных. Чтобы продемонстрировать это, посмотрим на следующий фрагмент кода¹:

exten => 321,1,Set(COUNT=3)

exten => 321,n,Set(NEWCOUNT=$[${COUNT} + 1])

exten => 321,n,SayNumber(${NEWCOUNT})

В первом приоритете переменной COUNT присваивается значение 3. Во втором приоритете участвует только одно приложение, Set(), но фактически выполняется три действия:

1. Asterisk подставляет в выражении вместо ${COUNT} число 3. Выражение, в сущности, превращается в следующее:

exten => 321,n,Set(NEWCOUNT=$[3 + 1])

2. Asterisk вычисляет выражение, суммируя 1 и 3, и заменяет его вычисленным значением, 4:

exten => 321,n,Set(NEWCOUNT=4)

3. Приложение Set() присваивает значение 4 переменной NEWCOUNT. Третий приоритет просто вызывает приложение SayNumber(), которое воспроизводит текущее значение переменной ${NEWCOUNT} (ей было присвоено значение 4 во втором приоритете).

Попробуйте это в своем диалплане.

Операторы

Код диалплана Asterisk записывается на специальном языке сценариев. Это означает, что язык диалплана Asterisk, как любой язык программирования, распознает символы, называемые операторами, которые позволяют оперировать переменными. Рассмотрим типы операторов, используемые в Asterisk: Логические (булевы) операторы

Эти операторы оценивают истинность выражения. С точки зрения вычислений это, по сути, означает, является ли выражение чем-то или оно является ничем (отличный от нуля или нуль, истина или ложь, включен или выключен и т. д.). К логическим операторам относятся:

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

expr1 | expr2

Этот оператор (называемый оператором ИЛИ) в случае истинности выражения expr1 (не пустая строка и не нуль) возвращает результат его вычисления. В противном случае он возвращает результат вычисления выражения expr2.

expr1 & expr2

Это оператор (называемый оператором И) возвращает результат вычисления expr1, если оба выражения истинны (то есть если ни одно из выражений не дает в результате пустой строки или нуля). В противном случае возвращается нуль. expr1 {=, >, >=, <, <=, ! = } expr2

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

Арифметические операторы

Хотите выполнить вычисление? Вам потребуется один из следующих операторов: expr1 {+, -} expr2

Эти операторы возвращают результаты сложения или вычитания целочисленных аргументов. expr1 {*, /, %} expr2

Эти операторы возвращают результаты умножения, целочисленного деления или остаток от деления целочисленных аргументов соответственно.

Оператор регулярного выражения

Также в Asterisk может использоваться оператор регулярного выражения:

expr1 : expr2

Этот оператор сравнивает выражение expr1 с expr2, где последнее должно быть регулярным выражением¹. Регулярное выражение привязывается к началу строки посредством явного задания ².

Больше информации о регулярных выражениях можно найти в полном справочнике Джеффри Е. Ф. Фридла (Jeffrey E. F. Friedl) «Mastering Regular Expressions» (издательство O'Reilly) или по адресу http://www.regula.r– expressions.info.

Если вы не знаете, что делает ~ с регулярными выражениями, вы просто обязаны достать экземпляр книги «Mastering Regular Expressions». Она изменит вашу жизнь!

Если соответствие установлено и шаблон содержит по крайней мере одну подстроку регулярного выражения, ( ... ), возвращается строка, соответствующая 1; в противном случае оператор сопоставления возвращает число совпавших символов. Если соответствия не выявлено и шаблон не содержит подстроку регулярного выражения, возвращается нулевая строка; в противном случае, возвращается 0. Синтаксический анализатор Asterisk версии 1.0 был довольно прост, поэтому обязательным требованием было отделение операторов от всех остальных значений как минимум одним пробелом. Соответственно, следующая запись не обеспечивала бы желаемого результата:

exten => 123,1,Set(TEST=$[2+1]) Такая запись привела бы к присвоению переменной TEST строки 2+1, а не значения 3. Чтобы исправить это, надо поставить пробелы перед оператором и после него:

exten => 234,1,Set(TEST=$[2 + 1]) В Asterisk 1.2 или 1.4 это уже не является обязательным требованием, потому что синтаксический анализатор выражений был доработан с учетом таких типов сценариев. Однако ради удобства чтения по-прежнему рекомендуется отделять операторы пробелами. Чтобы добавить текст в начало или конец переменной, просто поместите его в выражении рядом:

exten => 234,1,Set(NEWTEST=$[blah${TEST}])

Функции диалплана

Функции диалплана делают выражения более мощными; их можно рассматривать как интеллектуальные переменные. Функций диалпла– на позволяют вычислять длины строк, даты и время, контрольные суммы MD5 и т. д., и все в рамках выражения диалплана.

Синтаксис

Функции диалплана имеют следующий основной синтаксис:

ИМЯ_ФУНКЦИИ( аргумент) Как и для переменных, ссылка на имя функции выполняется, как показано выше, а чтобы использовать значение функции, необходимо поставить впереди знак доллара и заключить функцию в фигурные скобки:

$ {ИМЯ_ФУНКЦИИ( аргумент)} Также функции могут инкапсулировать (содержать в себе) другие функции:

${ ИМЯ_ФУНКЦИИ(${ ИМЯ_ФУНКЦИИ( аргумент)})}

2 3 4 4321

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

Примеры функций диалплана

Часто функции используются в сочетании с приложением Set() для получения или задания значения переменной. В качестве простого примера рассмотрим функцию LEN(). Эта функция вычисляет длину строки, заданной в качестве ее аргумента. Вычислим длину строки переменной и воспроизведем это значение для абонента: exten => 123,1,Set(TEST=example) exten => 123,n,SayNumber(${LEN(${TEST})})

Приведенный пример определит, что строка example содержит семь символов, задаст это значение как длину переменной и воспроизведет это число пользователю с помощью приложения SayNumber().

Рассмотрим еще один простой пример. Если бы мы захотели задать время ожидания для одного из каналов, то могли бы использовать функцию TIMEOUT(). Функция TIMEOUT() принимает один из трех аргументов: absolute (абсолютное), digit (между цифрами) и response (ответ). Чтобы задать максимальный промежуток времени между вводом цифр с помощью функции TIMEOUT(), можно воспользоваться приложением Set():

exten => s,1,Set(TIMEOUT(digit)=30) Обратите внимание на то, что функция не заключена в символы ${ }. Как и присвоение значения переменной, присвоение значения функции выполняется без использования символов ${ }.

Полный список доступных функций можно получить, введя команду core show functions в интерфейсе командной строки Asterisk. Также они представлены в приложении F.

Выполнение переходов по условию

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

Приложение GotoIf()

Ключ к выполнению переходов по условию – приложение GotoIf(). GotoIf() вычисляет выражение и отправляет абонента в соответствующее место назначения в зависимости от истинности или ложности выражения.

GotoIf() использует особый синтаксис, который часто называют условным:

GotoIf(выражение?местоназначения1:местоназначения2) Если выражение истинно (возвращает значение true), абонент направляется на местоназначения1. Если выражение ложно (возвращает значение false), абонент направляется по второму адресу. Итак, что обеспечивает возвращение значения true или false? Пустая строка и номер 0 обеспечивают false, все остальное – true. В качестве места назначения может быть задано следующее:

• Метка приоритета в рамках того же добавочного номера, например weasels.

• Добавочный номер и метка приоритета в рамках того же контекста, например 123,weasels.

• Контекст, добавочный номер и метка приоритета, например incoming,123,weasels.

Любое из мест назначения может быть опущено, но не оба одновременно. Если согласно вычислениям переход должен осуществляться по месту назначения, которое не задано, Asterisk просто переходит к следующему приоритету текущего добавочного номера.

Применим GotoIf() в примере:

exten => 345,1,Set(TEST=1)

exten => 345,n,GotoIf($[${TEST} = 1]?weasels:iguanas)

exten => 345,n(weasels),Playback(weasels-eaten-phonesys)

exten => 345,n,Hangup()

exten => 345,n(lguanas),Playback(office-iguanas)

exten => 345,n,Hangup()

Вы заметите, что за каждым приложением Playback() следует приложение Hangup(). Это делается для того, чтобы при переходе на метку weasels вызов заканчивался до того, как начинается воспроизведение звукового файла office-ig'uanas. Все чаще можно увидеть добавочные номера, разбитые на несколько компонентов (разделенных между собой командой Hangup()), каждый из которых представляет собой этапы, выполняемые следом за GotoIf().

Обычно при такой схеме, когда требуется оградить Asterisk от выполнения следующего приоритета после выполнения перехода, вероятно, лучше в качестве места назначения использовать другие добавочные номера, а не метки приоритетов. Во всяком случае, это делает диал– план несколько понятнее. Предыдущий фрагмент диалплана можно было бы переписать следующим образом: exten => 345,1,Set(TEST=1)

exten => 345,n,GotoIf($[${TEST} = 1]?weasels,1:iguanas,1); теперь переход

; выполняется к добавочному номеру,приоритету

exten => weasels,1,Playback(weasels-eaten-phonesys); это НЕ метка.

Предоставление условного перехода только на случай ложности выражения

Предыдущий пример можно было бы записать следующим образом:

exten => 345,1,Set(TEST=1)

exten => 345,n,GotoIf($[${TEST} = 1]?:iguanas) ; здесь больше нет ; метки weasels, но это будет по-прежнему работать exten => 345,n,Playback(weasels-eaten-phonesys) exten => 345,n,Hangup()

exten => 345,n(iguanas),Playback(office-iguanas) exten => 345,n,Hangup()

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

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

; Это другой добавочный номер

exten => weasels,n,Hangup()

exten => iguanas,1,Playback(office-iguanas)

exten => iguanas,n,Hangup()

При изменении значения, присваиваемого TEST в первой строке, сервер Asterisk должен воспроизводить разные приветствия. Рассмотрим другой пример выполнения переходов по условию. На этот раз будем использовать оба приложения, и Goto(), и GotoIf(). Выполним счет в обратном направлении от 10 и повесим трубку: exten => 123,1,Set(COUNT=10)

exten => 123,n(start),GotoIf($[${COUNT} > 0]?:goodbye)

exten => 123,n,SayNumber(${COUNT})

exten => 123,n,Set(COUNT=$[${COUNT} – 1])

exten => 123,n,Goto(start)

exten => 123,n(goodbye),Hangup()

Проанализируем этот пример. В первом приоритете переменной COUNT присваивается значение 10. Далее COUNT сравнивается с 0. Если ее значение больше нуля, мы переходим к следующему приоритету. (Не забываем, что, если место назначения в приложении GotoIf() опущено, управление передается вниз следующему приоритету.) С этого момента воспроизводится номер, из COUNT вычитается 1 и управление опять возвращается к приоритету start (начало). Если значение COUNT меньше или равно 0, управление передается приоритету goodbye (до свидания) и вызов завершается.

Классический пример выполнения переходов по условию с нежностью называют «логикой для защиты от любимой девушки». Если номер Caller ID (ID звонящего) входящего вызова совпадает с номером телефона бывшей девушки абонента, Asterisk выдает сообщение, отличающееся от того, которым он обычно встречает звонки от других абонентов. Несмотря на простоту и примитивность, это хороший пример для изучения переходов по условию в диалплане Asterisk. В этом примере используется функция CALLERID, которая позволяет извлекать информацию о Caller ID (ID звонящего) входящего вызова. Пусть для данного случая номер телефона жертвы будет 888-555-1212: exten => 123,1,GotoIf($[${CALLERID(num)} = 8885551212]?reject:allow) exten => 123,n(allow),Dial(Zap/4) exten => 123,n,Hangup()

exten => 123,n(reject),Playback(abandon-all-hope) exten => 123,n,Hangup()

В приоритете 1 вызывается приложение GotoIf(). Оно указывает Asterisk перейти к метке приоритета reject (отклонить), если номер Caller ID (ID звонящего) соответствует 8885551212, а в противном случае перейти к метке приоритета allow (можно было бы опустить имя метки, позволяя GotoIf() просто передать управление далее). Если номер Caller ID (ID звонящего) совпадает с указанным, управление вызовом передается приоритету reject, который воспроизводит нежелательному абоненту неприветливое сообщение. В противном случае делается попытка вызова получателя по каналу Zap/4.

Переходы по условию с временным критерием с помощью GotoIfTime()

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

Самое очевидное применение этого приложения – предоставление абонентам разных приветствий до начала рабочего времени и после его окончания.

Приложение GotoIfTime() имеет следующий синтаксис:

GotoIfTime( tlmes,days_of_week,days_of_month,months? label)

Одним словом, GotoIfTime() передает вызов в заданную метку label, если текущие дата и время соответствуют критерию, заданному параметрами times (время), days_of_week (дни недели), days_of_month (дни месяца) и months (месяцы). Рассмотрим каждый аргумент более подробно:

times

Это список из одного или более временных диапазонов, записанных в 24-часовом формате. Например, период с 9:00 утра до 5:00 вечера

будет задан так: 09:00-17:00. День начинается с 0:00 и заканчивается в 23:59.

Следует отметить, что times прекрасно выполняет циклические переходы. Поэтому, если требуется задать период, когда офис закрыт, в параметре times можно указать 18:00-9:00 – и все будет работать, как ожидается. Обратите внимание, что данная техника применима и для других компонентов GotoIfTime(). Например, описать выходные дни можно, задав sat-sun (суббота– воскресенье).

days_of_week

Это список из одного или более дней недели. Дни должны быть заданы как mon, tue, wed, thu, fri, sat и/или sun. Период с понедельника по пятницу можно задать как mon-fri. Вторник и четверг были бы представлены как tue&thu.

Обратите внимание, что можно задавать сочетание диапазонов и отдельных дней, например sun-mon&wed&fri-sat или проще,

wed&fri-mon.

days_of_month

Это список дней месяца. Дни задаются числами от 1 до 31. Период с 7-го до 12-го числа будет представлен как 7-12, а 15-е и 30-е числа месяца будут записаны как 15&30.

months

Это список из одного или более месяцев года. Диапазон месяцев должен быть записан как jan-apr, а если требуется указать месяцы, идущие не по порядку, они записываются через амперсанд, например jan&mar&jun. Также можно комбинировать диапазоны и отдельные месяцы: jan-apr&jun&oct-dec. Если необходимо выбрать все возможные значения для любого из этих аргументов, просто задайте * для него.

В качестве аргумента label может быть задано любое из следующих значений:

• Метка приоритета в рамках того же добавочного номера, например

time_has_passed (время прошло).

• Добавочный номер и приоритет в рамках того же контекста, например 123,time_has_passed.

• Контекст, добавочный номер и приоритет, например incoming,123, time_has_passed.

Теперь, после того как мы ознакомились с синтаксисом, рассмотрим несколько примеров. Следующий пример соответствует промежутку времени с 9:00 утра до 5:59 вечера, с понедельника по пятницу, любого дня месяца, в любой месяц года:

exten => s,1,GotoIfTime(09:00-17:59,mon-fri,*,*?open,s,1)

Если абонент звонит в данные часы, вызов будет направлен в первый приоритет добавочного номера s контекста open. Если вызов поступает в другое время, вне заданного промежутка, он будет направлен в следующий приоритет текущего добавочного номера. Это позволяет выполнять переходы по условию с несколькими временными критериями, как показано в примере ниже (обратите внимание, что более конкретизированные временные диапазоны всегда должны быть указаны перед менее конкретными):

; Если это любой час любого дня недели, который ; является четвертым днем месяца июля, мы закрыты exten => s,1,GotoIfTime(*,*,4,jul?open,s,1)

; В рабочие часы вызовы направляются в контекст open exten => s,n,GotoIfTime(09:00-17:59|mon-fri|*|*?open,s,1) exten => s,n,GotoIfTime(09:00-11:59|sat|*|*?open,s,1)

; В противном случае мы закрыты exten => s,n,Goto(closed,s,1)

Возможна ситуация, когда для интервала задано конечное время 17:58, а текущее время – 17:59, но диалплан не меняет своего поведения. Для такого случая следует заметить, что степень дискретизации приложения GotoIfTime() равна двум минутам. Поэтому, если в качестве времени завершения периода задано 18:00, система изменит свое поведение только в 18:01:59.

Голосовая почта

Одной из самых популярных (или, возможно, непопулярных) функций любой современной системы телефонной связи является голосовая

почта. Естественно, Asterisk обладает достаточно гибкой системой голосовой почты. Среди ее возможностей можно упомянуть:

• Неограниченные по размеру защищенные паролем ящики голосовой почты, в каждом из которых содержатся почтовые папки для организации сообщений голосовой почты.

• Различные приветствия для состояний «занято» и «недоступен».

• Стандартные и специальные приветствия.

• Возможность связывать телефоны с несколькими почтовыми ящиками, а почтовые ящики – с несколькими телефонами.

• Уведомление о поступлении сообщения голосовой почты по электронной почте с возможностью прикрепления сообщения голосовой почты в виде звукового файла¹.

• Пересылка и широковещательные рассылки голосовой почты.

Нет, за это действительно не надо платить, и да, это действительно работает.

• Индикатор ожидающих сообщений (мигающий световой индикатор или прерывистый тональный сигнал) во многих типах телефонов.

• Каталог ящиков голосовой почты служащих компании.

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

Конфигурация голосовой почты описывается в конфигурационном файле voicemail.conf. Этот файл содержит набор настроек, которые могут использоваться для приведения системы голосовой почты в соответствие конкретным требованиям. Рассмотреть все доступные опции voicemail.conf в одной главе было бы просто невозможно, но образец конфигурационного файла хорошо задокументирован и прост для понимания. Пока что давайте посмотрим в конец файла, где описываются контексты и ящики голосовой почты.

Контексты диалплана просто разделяют разные части диалплана, контексты голосовой почты позволяют определять разные, изолированные друг от друга, наборы почтовых ящиков. Это обеспечивает возможность хранить голосовую почту нескольких разных компаний или офисов на одном сервере. Контексты голосовой почты определяются так же, как и контексты диалплана: с помощью имени контекста, заключенного в квадратные скобки. В примерах данной книги будет использоваться контекст голосовой почты [default].

Создание почтовых ящиков

Внутри каждого контекста голосовой почты определяются разные почтовые ящики. Для описания почтового ящика используется следующий синтаксис:

почтовыйящик. => пароль,имя[,email[,email_пейджера[,опции]]]

Поясним назначение каждой части описания почтового ящика:

почтовыйящик

Это номер почтового ящика. Обычно он соответствует добавочному номеру ассоциированного с ним телефонного аппарата.

пароль

Числовой пароль, который будет использоваться владельцем почтового ящика для доступа к своей голосовой почте. Если пользователь изменит свой пароль, система обновит это поле в файле voicemail.conf.

имя

Это имя владельца почтового ящика. Текст данного поля используется в телефонном справочнике компании для обеспечения возможности абонентам при вызове применять имена пользователей.

email

Это адрес электронной почты владельца ящика голосовой почты. Asterisk может посылать уведомления о получении голосовой почты (включая само сообщение голосовой почты) на заданный ящик электронной почты.

emall_пейджера

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

опции

Это список опций, определяющих часовой пояс, в котором находится владелец почтового ящика, и переопределяющих глобальные настройки голосовой почты. Существует девять допустимых опций: attach, serveremail, tz, saycid, review, operator, callback, dialout и exitcontext. Эти опции определяются парами опция=значение, разделяемыми символами вертикальной черты (| ). Опция tz задает часовой пояс пользователя соответственно часовому поясу, определенному ранее в разделе [zonemessages] файла voicemail.conf. Остальные восемь опций переопределяют соответствующие их именам глобальные настройки голосовой почты.

Вот типовое описание почтового ящика:

101 => 1234,Joe Public,jpublic@somedomain.com,jpublic@pagergateway.net, tz=central|attach=yes

Продолжая создание нашего диалплана из последней главы, зададим ящики голосовой почты для Джона и Джейн. Для Джона определим пароль 1234, а для Джейн – 4444 (помните, это делается в файле voicemail. conf, а не в extensions.conf):

[default]

• => 1234,John Doe,john@asteriskdocs.org,jdoe@pagergateway.tld

• => 4444,Jane Doe,jane@asteriskdocs.org,jane@pagergateway.tld

Добавление голосовой почты в диалплан

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

Приложение VoiceMail() направляет вызывающего абонента на заданный почтовый ящик, чтобы он мог оставить сообщение. Почтовый ящик должен быть описан так: почтовыйящик@контекст, где контекст – имя контекста голосовой почты. Сюда также могут быть добавлены буквы b или u для запроса типа приветствия. Если используется буква b, абонент услышит сообщение о занятости владельца почтового ящика. Если используется буква u, абонент услышит сообщение о недоступности владельца почтового ящика (если таковое существует). Применим это в нашем диалплане. Ранее в контексте [internal] располагалась следующая строка, обеспечивающая возможность звонить Джону:

exten => 101,1,Dial(${JOHN})

Теперь давайте добавим сообщение о недоступности, которое услышит вызывающий абонент, если Джон не ответит на звонок в течение 10 с. Помните, второй аргумент в приложении Dial() – время ожидания. Если до истечения времени ожидания ответа на вызов не последовало, звонок перенаправляется в следующий приоритет. Зададим время ожидания 10 с и добавим приоритет для перевода абонента на голосовую почту, в случае если Джон не отвечает на звонок вовремя:

exten => 101,1,Dial(${J0HN},10) exten => 101,n,VoiceMail(101@default,u)

Теперь скорректируем это так, чтобы, если Джон занят (в другом звонке), абонент перенаправлялся на голосовую почту, где слышал бы сообщение о занятости. Для этого воспользуемся переменной ${DIALSTATUS}, в которой содержится одно из значений статуса (список всех возможных значений можно получить в консоли Asterisk с помощью команды core show application dial):