База знаний

• База знаний
• Пример файла конфигурации XML для Cisco 8851 phone
• Пример файла конфигурации XML для Cisco 7970 phone
• Пример файла конфигурации XML для Cisco 9971
• Отладка VoIP звонка с Wireshark
• Книги
• Использование поля Diversion в SIP пакете
• Астериск и Н.323
• ISDN release cause codes
• Пример файла конфигурации голосового шлюза Cisco
• Пример конфигурации интерфейса E1 PRI в голосовом шлюзе Cisco
• Аналоговое зло
• Интернациональные телефонные коды стран
• Практикум по интеграции Астериск в комплексе с OpenBSC/Osmocom
• Факс по IP

Команда Dial()

Назначение

Описание

Параметры

• Новое в Asterisk v1.2.0: Если Вы не хотите модифицировать параметры для каждой команды, в которой используется механизм перехода на команду, со смещенным относительно нее, приоритетом, то Вы можете задать параметр "priorityjumping=yes" в секции [general] файла extensions.conf, с помощью которой глобально будет установлено поведение, как в предыдущих версиях. Поскольку мы рассматриваем команду Dial(), то Вы можете управлять данным поведением этой команды, используя параметр 'j' (смотри ниже).
• Новое в Asterisk v1.2.0: Теперь, в качестве значения Caller*ID для исходящего плеча соединения, используется номер вызываемого екстеншена, а не значение Caller*ID входящего плеча вызова. Вы можете использовать флаг "o", для команды Dial для восстановления старого алгоритма, если пожелаете. Обратите внимание, что если Вам нужен номер вызывающего абонента, получаемый в событии интерфейса управления, то для этого добавлено новое событие, генерируемое этим интерфейсом, с именем "Dial", которое предоставляет нам информацию о входящем и исходящем канале и о номерах вызывающего и вызываемого абонента.

• type - тип канала. Должно быть значением зарегистрированного в системе типом канала, например, "Zap", "SIP", "IAX2", и т.д.
• identifier- "номер телефона", который вызывается через этот канал. Формат "номера телефона" зависит от используемого канала и может содержать дополнительные параметры (например, параметры, определяющие тип звонка), которые можно найти в описании модуля канала. Команда Dial просто пересылает этот identifier в модуль канала, а он уже разбирается, что надо с ним делать. Для того чтобы определить нужный формат поля ''identifier' обратитесь к документации по необходимому Вам каналу, там же вы найдете и опции, которые Вы можете применять в этой команде. Если Вам необходимо сделать паузу при наборе номера, то Вы можете вставить символ w в то место, где нужно ее сделать.
• Если вы определите несколько вызываемых каналов для команды Dial, то запомните, что вызов будет производиться по всем каналам одновременно. Разделяйте описания каналов символом &. Типы каналов могут различаться. Смотри примеры ниже.
• Параметр timeout необязателен. Если не задан, то команда Dial будет совершать вызов неопределенно долго, и закончит свое выполнение, если только по вызывающему каналу будет разорвана связь или на всех вызываемых каналах будет определено состояние "занято". Если этот параметр задан, то он определяет максимальное время в секундах, указывающий, сколько времени команда Dial будет ждать ответа на вызов.
• Параметр options также опциональный, это строка, содержащая ни одного или несколько нижеприведенных флагов и параметров:

• t: Разрешает ответившему пользователю перевести звонок
  • Если Вы установили значение переменной GOTO_ON_BLINDXFR , тогда при переводе вызова, будет совершен переход в указанную в переменной точку плана набора "context|exten|pri" (Для указания символа "|", при установки значения переменной, Вы можете использовать символ ^ , чтобы избежать проблем с экранированием специальных символов), пример: SetVar(GOTO_ON_BLINDXFR=ontransfer^s^1) . Это работает как с параметром "t", так и с параметром "T''.
  • ОБРАТИТЕ ВНИМАНИЕ: переменной с именем: GOTO_ON_TRANSFER нет и не будет ни в какой из версий сервера ASTERISK! Имя переменной - GOTO_ON_BLINDXFR смотри: http://svn.digium.com/view/asterisk?rev=5495&view=rev и http://bugs.digium.com/view.php?id=4056 для подробностей.

• T: Разрешает звонящему пользователю перевести звонок
• r: Генерировать сигналы вызова звонящему абоненту (ложный КПВ). Audio потоки не соединяются с вызываемым каналом до тех пор, пока хотя бы на одном из вызываемых каналов не ответят на вызов. Используйте этот параметр с осторожностью и не вставляйте его где попало в эту команду, т.к. при этом состояние вызова будет уже как бы "соединенное", и для вызывающего абонента, если, например, звонок междугородний и тарифицируется, уже будет отсчитываться время разговора и, соответственно, деньги. В реальности, этот параметр почти во всех случаях Вам не понадобиться. Asterisk будет сам генерировать сигналы КПВ в тех случаях, где это необходимо. Использование параметра "r" может быть оправдано в тех случаях, когда нужно оставить сигналы КПВ после команды Dial, в процессе выполнении других команд.
• R: Указывает состояние вызова "ringing" вызывающему абоненту, когда вызываемый абонент указывает, что у него звонит телефон "ringing", audio потоки не соединяются с вызываемым каналом до момента соединения. Этот параметр доступен только с использованием bristuff от kapejod.
• m: Проигрывать звонящему абоненту музыку ожидания (Music on Hold) до тех пор, пока на вызов не ответят. Этот параметр абсолютно взаимоисключающий с параметром 'r'. Используйте m(class) для обозначения, из какого подкласса выбрать эту музыку.
• n: (в Asterisk 1.1 и более поздних версиях) July 2005 bug 752 был включен в CVS (Asterisk 1.1) и значительно расширяет возможности privacy manager'a. Являясь частью патча, для флага 'n' команды Dial было изменено его значение, и теперь он используется, как часть возможностей privacy manager'a, вместо старого 'не переходить по смещению +101'. Теперь для этих целей используется флаг 'j'.
• o: Восстановить алгоритм работы с CallerId, как в версии v1.0, для Asterisk v1.2.
• j: Для Asterisk 1.2 и более поздних версий: перейти на команду с приоритетом n+101, если все из вызываемых каналов заняты (как стандартное поведение в Asterisk 1.0.x)
• M(x): Заставляет выполнить macro (x) в момент ответа на вызов
• h: Разрешает ответившему пользователю повесить трубку нажатием *
• H: Разрешает звонящему абоненту повесить трубку нажатием *
• i: (появилась, начиная с версии 1.4) Asterisk будет игнорировать все попытки вызываемых абонентов перенаправить вызов на другой номер для данной попытки вызова. Очень удобно, когда Вы пытаетесь вызвать группу абонентов, и у одного из них установлена на телефоне переадресация вызовов на голосовую почту или на его сотовый телефон или еще куда, что мешает нормальному функционированию и мешает вызову проходить на другие телефоны группы.
• C: Заставляет сбросить CDR (Call Detail Record) запись для этого вызова. Имеет такой же эффект, как применение команды NoCDR
• p: Эта опция включает режим "экранирования" (screening mode). Он в основном базируется на работе PrivacyManager, но без запоминания, как обрабатывать входящие вызовы. В этом режиме ищется файл sounds/priv-callerintros/${IF($[ "${CALLERID(num)}" != "" ]?${CALLERID(num)}:NOCALLERID_${EXTEN}${CUT(CHANNEL,/,1)}=${CUT(CHANNEL,/,2)})}.gsm и, если он не найден, звонящему проигрывается приглашение с просьбой представиться. Далее вызов будет направлен адресату и ему будут проиграны файлы: sounds/priv-callpending, sounds/priv-callerintros/<см. описание выше>, и sounds/screen-callee-options. Если вызываемый абонент нажмет 1, то вызов будет принят, если 2 - команда DIAL закончит свое выполнение и в переменной канала ${DIALSTATUS} будет установлено значение NOANSWER, если 3, выход со значением этой переменной - TORTURE и 4 - со значением DONTCALL. Если не будет выбран ни один из правильных вариантов, команда DIAL закончит свое выполнение со значением в переменной ${DIALSTATUS} равным ANSWER. Проверка уже существующего файла с записанным представлением звонящего абонента может быть совсем не тем, что Вам нужно. Например, когда множество людей использует один и тот же номер для совершения исходящих вызовов, и нет возможности сопоставить этот номер с каким-либо конкретным человеком, но в этом случае файл уже существует и новый файл не будет записан. Так как эти файлы никогда не удаляются, Вы можете сами удалять их командой плана набора: System(rm /var/lib/asterisk/sounds/priv-callerintros/${IF($[ "${CALLERID(num)}" != "" ]?${CALLERID(num)}:NOCALLERID_${EXTEN}${CUT(CHANNEL,/,1)}=${CUT(CHANNEL,/,2)})}.*) , перед тем как вызвать команду Dial или удалять старые записи по крону.
• P(x): Заставляет использовать PrivacyManager, используя x, как базу данных (x указывать не обязательно)
• g: Когда вызываемый абонент вешает трубку, продолжить выполнение команд далее по текущему контексту.
• G: G(context^exten^pri) - Если на вызов ответили, перекидываем обоих абонентов в заданное место плана набора; однако, имеется в виду, что вызывающий (звонящий) абонент будет отправлен к приоритету x, а вызываемый (отвечающий) - к приоритету x+1 (новая опция в версии v1.2)
• A(x): Заставляет команду проиграть анонс (из файла x.gsm) вызываемой стороне.
• S(n): Прервать звонок после n секунд, отсчитываемых после поднятия трубки вызываемым абонентом.
• d: Этот флаг расширяет возможности параметра 'H' и позволяет перехватывать любые dtmf посылки, в процессе ожидания, пока вызываемый абонент ответит на вызов, и возвращает набранное значение. Это позволяет Вам набрать номер екстеншена для выхода пока, вызываемый Вами абонент, еще не ответил на вызов. Смотри описание команды: RetryDial
• D(digits): Заставляет после снятия трубки на удаленной стороне, отправить строку digits в виде DTMF последовательности, затем соединить голосовые потоки обеих сторон.
• L( x[:y][:z] ): Ограничить звонок временем в 'x' ms, проиграть предупреждение, когда осталось 'y' ms, повторять предупреждение каждые 'z' ms. Только параметр 'x' является обязательным, 'y' и 'z' не обязательны. Нижеприведенные специальные переменные могут быть опционально, использоваться для ограничения вызовов: (используются в app_dial.c)
  • LIMIT_PLAYAUDIO_CALLER - yes|no (по умолчанию yes) - Проигрывать звуковой файл вызывающему абоненту.
  • LIMIT_PLAYAUDIO_CALLEE - yes|no - Проигрывать звуковой файл звонящему пользователю.
  • LIMIT_TIMEOUT_FILE - Проигрываемый файл, когда время вышло.
  • LIMIT_CONNECT_FILE - Проигрываемый файл в начале вызова.
  • LIMIT_WARNING_FILE - Проигрываемый файл предупреждения, когда задан параметр 'y'. Если значение LIMIT_WARNING_FILE не определено, тогда будет использован специальный звуковой макрос для проговаривания оставшегося времени ("У Вас осталось [XX минут] YY секунд").
• f: насильно устанавливает callerid, как номер екстеншена, который совершает исходящий вызов или перевод вызова. Например, некоторые АТС не позволяют использовать callerids с другими номерами, кроме тех, что выделены для Вас.
• w: Разрешает ответившему пользователю начать запись разговора после нажатия *1 или той последовательности, что определена в features.conf (Asterisk > v1.0.x)
• W: Разрешает "звонящему" абоненту начать запись разговора после нажатия *1 или той последовательности, что определена в features.conf (Asterisk > v1.0.x)
• k: (появилась, начиная с версии 1.4) Разрешает "ответившему" пользователю произвести парковку вызова, путем отправки DTMF последовательности, заданной для парковки вызовов в файле конфигурации features.conf
• K: (появилась, начиная с версии 1.4) Разрешает "звонящему" пользователю произвести парковку вызова, путем отправки DTMF последовательности, заданной для парковки вызовов в файле конфигурации features.conf

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

Макросы в команде Dial