Asterisk™: будущее телефонии Второе издание - Джим Меггелен

Directory(vm-к.онтек.с^, контекст-набора[,опции]])

Предоставляет пользователям справочник добавочных номеров, которые они могут выбирать по имени абонента. Список имен и добавочных номеров можно найти в файле voicemail.conf. Аргумент vm-контекст является обязательным; он определяет используемый контекст voicemail.conf. Аргумент контекст-набора - это контекст, используемый для выполнения звонков абонентам. Если не задан, по умолчанию принимается значение vm-контекст. Если для аргумента опции задано значение f, Asterisk будет искать соответствующий номер в справочнике на основании имени, указанного в файле voicemail.conf, а не фамилии абонента. Если задана опция e, кроме имени абонента, Asterisk будет выполнять поиск также и по добавочному номеру.

Если пользователь вводит 0 (нуль) и в текущем контексте есть добавочный номер o (или строчная буква о), управление вызовом перейдет в этот добавочный номер. Введение * обеспечит аналогичный выход, но только в добавочный номер a, что очень похоже на поведение Voicemail(). exten => *,1,Directory(default,incoming) exten => #,1,Directory(default,incoming,f) exten => 9,1,Directory(default,incoming,fe)

Смотрите также

voicemail.conf

DISA()

Direct Inward System Access (Прямой внутрисистемный доступ): позволяет внешним абонентам выполнять исходящие звонки

DISA(пароль[, контекст[, callerid[, почтовыйящик.[@утк.онтек.ст]]]]) DISA(файл-пароля[, callerid[, почтовыйящик[@утконтекст]]])

Позволяет внешним абонентам получать «внутренний» тональный сигнал системы и совершать вызовы с АТС так, как будто они являются ее локальными пользователями. Абоненту предоставляется тональный сигнал, после чего он должен ввести свой секретный код и нажать в конце кнопку #. Если секретный код правильный, абонент услышит тональный сигнал системы и сможет выполнять звонки.

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

Аргумент пароль - это числовой секретный код, который абонент должен ввести, чтобы получить возможность выполнять исходящие звонки. Используя этот синтаксис, все абоненты данного добавочного номера будут применять один пароль. Чтобы абоненты могли использовать DISA() без пароля, напишите вместо пароля строку no-password (пароль не нужен).

Аргумент контекст определяет контекст, в котором абонент будет набирать номер. Если контекст не задан, по умолчанию приложение DISA() использует контекст disa.

Аргумент callerid определяет новую строку Caller ID, которая будет использоваться для исходящего звонка.

Аргумент почтовыйящик - это номер почтового ящика (и необязательный контекст голосовой почты, утконтекст) голосовой почты. Если в указанном ящике голосовой почты есть новые сообщения, вызывающий абонент будет слышать прерывистый тональный сигнал. Кроме того, можно использовать альтернативный синтаксис и передавать вместо аргументов пароль и контекст имя глобального файла паролей. В каждой строке файла может содержаться или секретный код, или секретный код и контекст, разделенные символом вертикальной черты (| ). Если контекст не задан, приложение по умолчанию использует контекст disa.

Если регистрация абонента прошла успешно, приложение проводит синтаксический разбор набранного номера в заданном контексте:

; позволяем внешним абонентам звонить на номера 1-800, ; если они знают секретный код. Задаем им Caller ID, чтобы ; создать впечатление, что они звонят из компании [incoming]

exten => 123,1,DISA(4569,disa,"Company ABC" <(234) 123-4567>) [disa]

exten => _1800NXXXXXX,1,Dial(Zap/4/${EXTEN})

Смотрите также

Authenticate(), VMAuthenticate()

DumpChan()

Выводит информацию о вызывающем канале в консоль

DumpCha.n([минимaльный_уровень_детaльности])

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

Если задано несколько переменных канала, DumpChan() покажет только первые 1024 символа списка переменных вашего канала.

exten => s,1,Answer() exten => s,2,DumpChan()

exten => s,3,Background(enter-ext-of-person)

Смотрите также

NoOp(), Verbose()

EAGI()

См. AGI().

Echo()

Воспроизводит вызывающему абоненту то, что он говорит

Echo()

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

exten => 123,1,Echo()

exten => 123,2,Playback(vm-goodbye)

Смотрите также

Milliwatt()

EndWhile()

Завершает цикл while

EndWhile()

Возвращается к ранее вызванному приложению While(). Полную информацию о том, как использовать цикл while, можно найти в описании приложения While().

exten => 123,1,Set(COUNT=1) exten => 123,2,While($[ ${COUNT} < 5 ]) exten => 123,3,SayNumber(${COUNT}) exten => 123,4,Set(COUNT=$[${COUNT} + 1] exten => 123,5,EndWhile()

Смотрите также

While(), ExitWhile(), GotoIf()

Exec()

Динамически выполняет приложение Asterisk

Ex.ec(имяприложения(aргументы))

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

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

exten => 123,1,Set(MYAPP=SayDigits(12345)) exten => 123,2,Exec(${MYAPP})

Смотрите также

EVAL, TryExec(), ExecIf()

ExecIf()

Выполняет приложение Asterisk по условию

ExecIf(выражение,приложение, аргументы)

Если выражение истинно, выполняет заданное приложение, передавая в него аргументы, и возвращает результат. Больше информации о выражениях Asterisk можно найти в главе 6 или в файле channelvariables. txt в подпапке doc/ папки исходного кода Asterisk. Если выражение ложно, выполнение продолжается со следующего приоритета.

exten => 123,1,ExecIf($[ ${CALLERIDNUM} = 101 ],SayDigits,12345) exten => 123,2,SayDigits(6789)

Смотрите также

EVAL, Exec(), TryExec()

ExitWhile()

Выполняет выход из цикла While() независимо от того, было удовлетворено условие или нет

ExitWhile()

Завершит цикл While() независимо от того, было ли удовлетворено условие в выражении.

exten => 123,1,Set(COUNT=1)123,1,Set(COUNT=1) exten => 123,n,While($[${COUNT} < 5]) exten => 123,n,GotoIf($[${COUNT} != 3]?continue) exten => 123,n,ExitWhile() exten => 123,n(continue),NoOp() exten => 123,n,SayNumber(${COUNT}) exten => 123,n,Set(COUNT=$[${COUNT} + 1]) exten => 123,n,EndWhile()

Смотрите также

While(), ContinueWhile(), EndWhile()

ExtenSpy()

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

ExtenSpy([добавочныйномер@контекст[, опции]])

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

При прослушивании канала могут выполняться следующие действия:

• Набор # циклически меняет уровень громкости.

• Набор * заставит приложение перейти к прослушиванию следующего доступного канала.

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

Прослушивать только соединенные каналы.

g(группа)

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

q

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

r[(базовоеимя)]

Записывает разговор, ведущийся по каналу, в папку очереди для записей разговоров (обычно это /var/spool/asterisk/monitor). Необязательный аргумент базовоеимя задает базовое имя файла для записей, значение по умолчанию - chanspy.

v([значение])

Настраивает громкость прослушиваемого аудиосигнала. Значение должно быть в диапазоне от 4 до -4. Отрицательное значение сделает звук тише, тогда как положительное - громче.

w

Режим шепота. Позволяет прослушивающему каналу «говорить» с прослушиваемым каналом. При этом ни один другой соединенный канал не сможет слышать этот разговор.