База знаний

• База знаний
• Пример файла конфигурации 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

Автоматизация вызовов абонентов в Asterisk.

• С использованием .call файлов. Это текстовые файлы, которые при помещении их в определенную директорию заставляют Asterisk совершить исходящий вызов.
• Использую Интерфейс управления сервером Asterisk для инициации исходящего вызоваl. См. описание команды: Originate.
• С использованием CLI интерфейса.
• В Asterisk 1.4 и выше. При помощи команды плана набора FollowMe. Так как при помощи этой команды можно совершать несколько вызовов одновременно, ее можно задействовать “не по назначению” для совершения исходящих вызовов.

.call файлы

• Просто помещаем наш call файл в директорию (по умолчанию): /var/spool/asterisk/outgoing
• Если в файле конфигурации modules.conf установлено: autoload=no, убедитесь, что у Вас загружен модуль pbx_spool.so, иначе работа с .call файлами производиться не будет .
• При обнаружении .call файла, Asterisk немедленно создаст канал для вызова, который будет соединен с указанным екстеншеном и приоритетом из плана набора. Все эти параметры будут взяты из .call файла.
• Если дата модификации .call файла больше текущей даты на сервере, то Asterisk отложит обработку данного файла до тех пор, пока время модификации этого файла не сравняется или не станет больше текущего времени.
• В качестве примера См.: "sample.call", который идет в составе дистрибутива.

Синтаксис .call файлов

• Определяем куда и как нужно совершить вызов
  • Channel: : Канал, который будет использоваться для исходящего вызова.
  • CallerID: Name CallerID, please note that it may not work if you do not respect the format: CallerID: Some Name <1234>
  • MaxRetries: Количество попыток перед тем, как вызов будет считаться неудачным (не включая первую попытку, т.е. 0 = означает совершить 1 попытку вызова). Значение по умолчанию: 0.
  • RetryTime: Количество секунд между попытками вызова, не стоит очень часто ломиться на недоступный телефон. Значение по умолчанию: 300 (5 минут)
  • WaitTime: Количество секунд для ожидания ответа на вызов. Значение по умолчанию: 45.
  • Account: Установка поля “account code”для записи в CDR.
• Если первый участник вызова ответил, то далее описываем с кем и как его соединить
  • Context: Контекст в файле extensions.conf.
  • Extension: Название екстеншена в extensions.conf..
  • Priority: Номер приоритета для екстеншена, с которого нужно начать выполнение.
  • Set: Установка переменных канала для использования их в логике обработки вызова на заданный екстеншен (например: file1=/tmp/to ).
  • Application: Имя приложения Asterisk, которое необходимо выполнить (используется вместо параметров context, extension и priority).
  • Data: Параметры для запускаемого приложения.
• Новое (?) в Asterisk 1.4
  • AlwaysDelete: Yes/No – Если время модификации .call файла больше текущего, то этот файл не будет удален.
  • Archive: Yes/No – Переносить или нет .call файл в поддиректорию "outgoing_done" с установленным значением поля "Status: значение", где значение может быть: Completed, Expired или Failed.

Специальный екстеншен 'failed'

• Замечание 1: Это работает, если вы совершаете вызов с использованием полей context, extension и priority, и естественно не будет работать, если используется приложение для совершения вызовов.
• Замечание 2: В этом екстеншене довольно удобно обрабатывать CDR поле UserField, занося туда номер телефона, до которого не удалось дозвониться, с помощью команды: SetCDRUserfield(). Сервер Asterisk (например: 1.2.10) никуда не заносит имя канала, по которому совершался вызов (например: IAX2/15551234567), следовательно, чтобы получить его имя в этом екстеншене, используйте поле Set: в.call файле.
• Замечание 3: Переменная канала ${REASON} принимает значение, которое определяет причину, по которой попытка вызова закончилась неудачей. Подробней можно почитать на странице: Переменная Asterisk: Reason.

Пример:

Пространство видимости переменных

• Не забывайте к переменным добавлять префикс “_” или “__” , для того, чтобы они были видимы в создаваемых (“дочерних”) каналах!
• Используйте приложения DBGet и DBPut, если возникают проблемы с передачей значений переменных.

Создание и перемещение .call файлов.

• Создайте Ваш . call файл в какой-либо другой временной директории, например, в: /var/spool/asterisk/temp1234
• Установите владельца и группу для этого файла, командой: chown asterisk:asterisk /var/spool/asterisk/temp1234 (если файл temp1234 создан от пользователя root, а Asterisk работает от системного пользователя asterisk).
• Переместите этот файл, командой: mv /var/spool/asterisk/temp1234 /var/spool/asterisk/outgoing

VB Scripts для создания .call файлов из простого текстового файла и перемещения готового .call файла в spool директорию сервера asterisk, используя команду pscp.

;!!!!!!!!!!!!!!!!!!!!!
; Создаем текстовый файл с номерами телефонов по одному на строке
; например: phonenumbers.txt
; 1234567890
; 2134567890
; если текстовый файл содержит только вышеописанные две строки (без символов двоеточия),
; то в качестве результата работы скрипта будут созданы два текстовых файла, 
; по одному на каждый номер.
; Вы можете скопировать этот текст и вставить его код в какой-нибудь .vbs файл в  windows,
; а потом попробовать его выполнить.
; поместите его в туже директорию, где находиться файл с номерами телефонов.

Set objFSO = CreateObject("Scripting.FileSystemObject")
Set objFilePhones = objFSO.OpenTextFile("C:\calls\Phone.txt",1) ;измените на путь к вашему файлу
strfname=1
strcnt=1
Set objFolders=objFSO.CreateFolder(strfname)
Do While objFilePhones.AtEndOfStream = False
	If strcnt=20 then; Вы можете изменить это значение на любое другое,
; если требуется другое число одновременных вызовов.
		strfname=strfname+1

		Set objFolders=objFSO.CreateFolder(strfname)
		strcnt=1
	end if
	strLine = objFilePhones.ReadLine

	strFullName = objFSO.BuildPath(strfname, strLine)
	Set objFileCalls = objFSO.CreateTextFile(strFullName)
	objFileCalls.close
	Set objFileCalls = objFSO.OpenTextFile(strFullName,2)
	objFileCalls.Write("Channel: ") ;сюда поместите информацию о Вашем канале
	objFileCalls.WriteLine(strLine)
	objFileCalls.WriteLine("CallerID: Name <1234>") ;укажите тут требуемое значение для  caller id 
	objFileCalls.WriteLine("MaxRetries: 0"); укажите тут требуемое значение попыток
	objFileCalls.WriteLine("RetryTime: 3")
	objFileCalls.WriteLine("WaitTime: 30") ;тут укажите время ожидания ответа
	objFileCalls.WriteLine("Context: test") ;Тут укажите название контекста
	objFileCalls.WriteLine("Extension: 800") ; Тут укажите название екстеншена
	objFileCalls.WriteLine("Priority: 1") ; Тут укажите  номер приоритета
	objFileCalls.Close
	strcnt=strcnt+1
Loop
;конец кода первого скрипта, который создает .call файлы.

;следующий скрипт переносит файлы в spool директорию сервера asterisk spool.
; Предполагается, что pscp находиться в c:\pscp.exe и 
;имя сохраненной сессии в putty до Вашего asterisk сервера - asterisk.

Set objFSO = CreateObject("Scripting.FileSystemObject")

strcnt=1
strfldr="C:\calls\"&strcnt

for i=1 to 1000  ;предполагается, что у Вас не более 1000 директории и не более 20000 файлов
If objFSO.FolderExists(strfldr) Then
	strfldr="C:\calls\"&strcnt ; поменяйте путь на тот, который Вам необходим
	Set objShell = CreateObject("WScript.Shell")
	strcmd="C:\pscp -pw passwordhere c:\calls\"&strcnt&"\* root@asterisk:/var/spool/asterisk/outgoing"
        ;поменяйте username и password на нужные, а также путь до pscp и .call файлов
	objShell.Run strcmd
	strcnt=strcnt+1

else
	exit for
End If

wscript.sleep(36000)
next
;конец кода

Примеры

Пример 1

Пример 2

Пример 3

Пример 4

Пример 5

Пример 6: Использование Asterisk в качестве системы оповещения.

Как задать выполнение .call файла в определенное время.

Замечания по работе с большим количеством одновременных исходящих вызовов.

.call файлы и CDR записи

• Предотвращение отсутствия CDR записей при использовании .call файлов

• a) Используйте параметры Context/Extension/Priority в .call файле вместо непосредственного указания приложения для выполнения: Application/Data.
• b) Совершайте вызовы через локальный канал вместо непосредственного указания имени канала для вызова абонента.

• Номер вызываемого абонента не будет сохранен в CDR записи. Если Вам необходима эта информация в последующей обработке CDR записей, Вы можете установить поле CallerID в .call файле в значение этого номера и он будет сохранен в CDR записи. Однако, в этом случае, абоненту, которого Вы вызываете, будет высвечиваться, что ему звонит он сам (его же номер телефона), что не имеет особого смысла и может вводить их в заблуждение. Лучшем решением этой задачи будет указание этого номера в переменной канала, при помощи параметра “Set:” в.call файле с последующим занесением его в поле UserField CDR записи в логике плана набора отвечающей за вызов абонентов.

Советы и замечания

• Создавайте .call файлы там, где Вам удобно и только после этого переносите их (не рекомендуется использовать команду копирования файлов по причинам, изложенным выше) в директорию, где их обрабатывает сервер asterisk. Asterisk очень агрессивно проверяет директорию, где он ищет эти файлы и, если вы будете создавать файлы непосредственно в этой директории, то скорее всего Вы будете очень часто получать сообщения asterisk о неправильном формате .call файлов, т.к. велика вероятность того, что он будет считывать не до конца сформированные файлы.
• .call файлы должны иметь того же владельца файла или быть в одной группе с соответствующими правами для группы, от которого запущен сервер asterisk , иначе asterisk не сможет получить доступ к ним или удалить их, а Вы будете получать сообщения о невозможности доступа к файлу.
• Если вы используете аналоговые внешние (городские) линии, подключенные через FXO интерфейсы, то, скорее всего, Вы столкнетесь с проблемой определения момента, когда вызываемый абонент снял трубку, особенно это касается вызовов на сотовые телефоны. Когда сервер Asterisk совершает вызов через FXO интерфейс (в момент, когда набор номера завершен и пошли тональные сигналы вызова), система считает, что вызов перешел в состояние 'отвечено', и продолжает выполнение дальнейших операций. Это означает, что Ваши голосовые сообщения будут проигрываться, когда с той стороны идут вызывные гудки, а когда абонент поднимет трубку, то он услышит только тишину, т.к. все приветствия были проиграны ранее.

• В файле chan_dahdi.conf (zapata.conf), попробуйте добавить параметр callprogress=yes до определения ваших FXO каналов директивой: “channel => n”. Обратите внимание, что эта установка распространяется на все каналы, которые будут описаны далее в этом файле__, перед описанием каналов, для которых это не нужно, не забудьте сбросить этот параметр директивой: callprogress=no !
  • Эта функциональность отмечена как: “HIGHLY EXPERIMENTAL“, если она используется, то необходимо выставить правильное значение параметра “progzone”, который определяет, набор тональных сигналов (их частота и отношение сигнал/пауза) какой страны используется для распознавания различных состояний аналоговых линий.
  • В некоторых случаях, включение callprogress=yes приводит к ложному срабатыванию детектора коротких гудков (сигнала отбоя), и вызов может беспричинно прерываться в середине разговора.
• Как второй вариант, можно периодически повторять ваше сообщение. Например, установив, командой Set(TIMEOUT(response)=2), паузу между повторами в 2 секунды и переходить на повтор сообщения по команде: GoTo(s,1).
• Еще один метод, состоит в использовании команды "WaitForSilence", которая будет ждать заданный промежуток времени, в течение которого в канале присутствует тишина, перед проигрыванием сообщения. В asterisk 1.2 существует проблема с данной командой, смотри описание багрепорта #2467 на issues.asterisk.org.
• Для определения автоответчика можно попробовать использовать приложение: app_machinedetect.c. Работает с каналами: PRI, VoIP, или на FXO интерфейсах с включенным callprogress.

Что еще можно делать при помощи .call файлов.

• Дозвон в определенно время при помощи cron'a.
• Вы можете использовать некий екстеншен для проверки наличия зарегистрированного пользователя в системе (chanIsAvailable) и если это так, позвонить ему и напомнить ему, что надо выйти из системы и идти домой :-)
• Другие приложения могут создавать .call файлы для систем оповещения и тревоги.
• Вызов группы, куда включены агенты, обрабатывающие входящие вызовы.
• Создание системы с обратным вызовом на основе DISA. Абонент звонит на определенный екстеншен, asterisk отбивает вызов и перезванивает абоненту, соединяя его с DISA и генерируя абоненту диалтон.

Ссылки по теме

• Asterisk CLI: Команда originate
• Команда Asterisk Manager API: Originate
• Asterisk manager dialout
• План набора - extensions.conf
• Переменные в Asterisk
• Автодозвон и отправка сообщений
• Asterisk