Asterisk setup manual

Инструкция по настройке
Asterisk (FreePBX) для работы
с виртуальной АТС
Youmagic.pro
2013 год

+7 800 333 31 40, www.youmagic.pro
Оглавление
Перечень условий, необходимых для подключения услуги Youmagic.pro..............................3
Правила предоставления тестового доступа Youmagic.pro ...................................................7
Памятка для подключения YMPro............................................................................................8
Личный кабинет администратора YMPro..................................................................................10
Настройка подключения SIP ID YMPro .......................................................................................11
1. Настройка личного кабинета YMPro ...............................................................................11
1.1. Настраиваем сотрудника..........................................................................................11
1.2. Настраиваем входящие вызовы...............................................................................11
1.3. Настраиваем определяемый номер при звонках с данного лицевого счета
YMPro.....................................................................................................................................12
2. Настройка Asterisk.............................................................................................................13
2.1. Настройка транка YMPro SIP ID.................................................................................13
2.2. Настройка исходящей маршрутизации для вызовов по YMPro SIP ID. ................15
2.3. Настройка входящей маршрутизации для вызовов по YMPro SIP ID. ..................17
Настройка подключения VOIP-Static YMPro ..............................................................................19
1. Настройка личного кабинета YMPro ...............................................................................19
1.1. Настраиваем сотрудника / Определяемый номер. ...............................................19
1.2. Настраиваем входящие вызовы...............................................................................20
2. Настройка Asterisk.............................................................................................................21
2.1. Настройка транка VOIP-Static YMPro........................................................................21
2.2. Настройка исходящей маршрутизации для вызовов по VOIP-Static YMPro. .......23
2.3. Настройка входящей маршрутизации для вызовов по VOIP-Static YMPro. .........25
Настройка динамической подстановки «А-номеров» (определяемых номеров) с Asterisk27

Перечень условий, необходимых для подключения услуги
Youmagic.pro
1. Наличие порта доступа к сети Интернет, минимальная пропускная способность для
гарантированной работы услуги VoIP не менее 128 Кбит/с;
2. Доступ к сети Интернет должен быть обеспечен с присвоением оборудованию VoIP
публичного или приватного (через NAT) IP адреса;
3. При условии использования Firewall, на нем должны быть открыты следующие
порты:
! Достаточно открыть пропуск трафика только на тот адрес МТТ, по которому происходит
подключение – voip.mtt.ru (80.75.132.66).
 Сигнальный трафик
5060 UDP/ TCP для сигнального трафика SIP;
! Для использования TCP, необходимо завести обращение в «Поддержку» из личного
кабинета с просьбой включить TCP.
! Если вы используете нестандартный sip порт, Вам необходимо для работы входящих
вызовов сделать перенаправление трафика с порта 5060 от voip.mtt.ru на Ваш порт
Asterisk.
Для настроек iptables:
iptables -t nat -A PREROUTING -s voip.mtt.ru -i ethX (Ваш сетевой интерфейс) -p udp -m udp
--dport 5060 -j REDIRECT --to-ports Ваш sip порт
Например,
iptables -t nat -A PREROUTING -s voip.mtt.ru -i eth0 -p udp -m udp --dport 5060 -j REDIRECT --
to-ports 6050
 Голосовой трафик
Диапазон портов RTP 10000-20000 UDP.
! По умолчанию asterisk для rtp использует порты 10000-20000, необходимо обязательно
проверить в файле /etc/asterisk/rtp.conf.

4. Для работы оборудования за NAT потребуется не только открытие голосовых
портов на firewall, но и безусловное перенаправление голосового трафика с
устройства NAT на Ваш сервер Asterisk. Без перенаправления вы столкнетесь с
проблемой односторонней слышимости.
! Обратите внимание: для корректной работы asterisk – сервер asterisk должен находиться
не более чем за одним NAT.
5. Если сервер Asterisk находится за NAT, рекомендуется добавить:
nat=yes (версия asterisk ≥1.8)
nat= force_rport (версия asterisk ≤10)
qualify=3000
directmedia=no
6. Кодеки, используемые для совершения звонков – G.711a, G.711u, G.729, G.723.
! При настройке следует обратить внимание, что кодеки G.729 и G.723 не входят в
стандартную сборку Asterisk. Скачать необходимые модули кодеков для Asterisk можно
на сайте http://asterisk.hosting.lv/.
Для того, чтобы проверить, установленные на Вашем Asterisk кодеки, необходимо в
командной строке linux выполнить команду asterisk -rx "core show translation".
В настройках FreePBX:
Admin -> Asterisk CLI -> core show translation -> Execute.

В настройках Elastix:
PBX ->Tools -> Asterisk CLI -> core show translation -> Execute.
7. IP-адрес - voip.mtt.ru (80.75.132.66).
8. При подключении к услугам YMPro существует ограничение в 10 одновременных
инициаций вызовов (10 cps). Пожалуйста, учитывайте это в работе, особенно, если
у Вас есть функции автоматического обзвона клиентов.
9. ! Нельзя на одном клиентском IP-адресе подключать несколько лицевых счетов
YMPro, один из которых YMPro SIP Static.
10. Правила набора номера. Вызовы необходимо совершать в международном
формате Е.164.

 Для звонка по России номер необходимо набирать в формате
+7 + код города + номер абонента (либо 8 + код города + номер
абонента), например, +78003333140 (либо 88003333140);
 Для звонка на международные направления номер необходимо набирать
в формате
+код страны + код города + номер абонента (либо 810 + код страны +
код города + номер абонента), например, для звонка на Украину (код страны
380) +3800975797979 (либо 8103800975797979);
11. Факсы работают по протоколу Т.38;
12. ! При написании данной инструкции использовалась конфигурация Debian 7.2,
Asterisk 11.6.0, FreePBX 2.11.0;
13. Термины:
NAT (от англ. Networ kAddress Translation — «преобразование сетевых адресов») — это
механизм в сетях TCP/IP, позволяющий преобразовывать IP-адреса транзитных пакетов.
Firewall (Межсетевой экран или сетевой экран) — комплекс аппаратных или программных
средств, осуществляющий контроль и фильтрацию проходящих через него сетевых
пакетов в соответствии с заданными правилами. Основной задачей сетевого экрана
является защита компьютерных сетей или отдельных узлов от несанкционированного
доступа. Также сетевые экраны часто называют фильтрами, так как их основная задача —
не пропускать (фильтровать) пакеты, не подходящие под критерии, определённые в
конфигурации. Некоторые сетевые экраны также позволяют осуществлять трансляцию
адресов — динамическую замену внутри сетевых (серых) адресов или портов на внешние,
используемые за пределами ЛВС.

Правила предоставления тестового доступа Youmagic.pro
! Тестовые минуты на youmagic.pro можно получить только при подключении через
менеджера ОАО «МТТ».
! При самостоятельной регистрации тестовые минуты не начисляются, для тестирования
услуги необходимо пополнить счёт YMPro.
! Сессия = Количество одновременных разговоров.
 При подключении через менеджера ОАО МТТ предоставляется на период
тестирования 300 минут по России и СНГ, исключая страны Балтии;
 Количество одновременных сессий неограниченно;
 IP-адрес МТТ voip.mtt.ru (80.75.132.66).
При предоставлении тестового доступа, аккаунт остается активным в течение 14 дней.
При подключении через менеджера ОАО МТТ предоставляется на период тестирования
300 минут по России и СНГ, исключая страны Балтии.
В случае неоплаты счета, аккаунт блокируется. Через месяц аккаунт удаляется.

Памятка для подключения YMPro
YMPro (youmagic.pro)
IP-адрес
voip.mtt.ru (80.75.132.66)
Правила набора номера МГ направления (Россия)
Звонки необходимо набирать в формате
+7 + код города + номер абонента (либо 8 + код города + номер абонента)
Правила набора номера МН направления
810 + Код страны + Код города + Номер абонента
+ Код страны + Код города + Номер абонента
SIP STATIC SIP ID
Тип подключения
Без регистрации, подключение точка-точка. Подключение с регистрацией. Пароль
должен быть не менее 8 знаков.
Настройка входящих вызовов
В личном кабинете администратора. Настройка -> Обработка вызовов -> Добавить
переадресацию.
-> На номер -> В поле прописать Ваш IP-
адрес, на который открыт доступ.
-> На сотрудника -> Выбрать сотрудника,
который зарегистрирован на АТС.
Определяемый номер (для всего лицевого счета YMPo)
Определяемый номер по умолчанию всегда один
Настройка -> Сотрудники -> Выбрать
необходимый IP -> Редактировать -> Прописать
определяемый номер при звонках с данного
лицевого счета.
Настройка -> Ваши номера -> Если
куплено несколько номеров, выбрать
определяемый номер, путем
перетаскивания вверх необходимого.
В настройках Asterisk нигде номер для определения указывать не нужно.

Идентификатор входящего вызова (DID номер)
По умолчанию для всех городских номеров
будет приходить идентификатор 7111
! Разделение DID номеров осуществляется по
заявлению через менеджера ОАО «МТТ» на
этапе включения. При самостоятельном
подключении через личный кабинет
администратора -> Поддержка.
Каждый купленный номер в настройках
обработки вызова необходимо направлять
на разных сотрудников. В качестве DID
будет приходить логин сотрудника (15
знаков).
! Если направить все входящие вызовы (в
настройках обработки вызова) на одного
сотрудника, DID, для всех направленных на
данного сотрудника номеров, будет
приходить как логин сотрудника (15
знаков).
Подстановка любого существующего А-номера номера РФ в качестве
определяемого номера при звонках с YMPro. Подстановка осуществляется на стороне
клиентского оборудования.
Делается по заявлению через менеджера ОАО «МТТ» на этапе включения. При
самостоятельном подключении через личный кабинет администратора -> Поддержка.
В Asterisk за подстановку номера отвечает параметр в транке fromuser, при динамическом
АОН параметр callerid в настройках dial plan. Номер необходимо указывать в формате
(7ХХХХХХХХХХ) - 11 цифр, где Х – любая цифра существующего номера РФ.
Более подробно тут.
Подстановка существующего А-номера номера РФ в качестве определяемого
номера при звонках с YMPro. Подстановка осуществляется на стороне ОАО «МТТ».
Делается по заявлению через менеджера ОАО «МТТ» на этапе включения. При
самостоятельном подключении через личный кабинет администратора -> Поддержка.
В запросе указать с какого IP-адреса какой
номер должен определяться.
В запросе указать с какого сотрудника (SIP
ID) какой номер должен определяться.
В настройках Asterisk нигде номер для определения указывать не нужно.

Личный кабинет администратора YMPro
Для начала работы с виртуальной АТС YMPro необходимо настроить личный кабинет.
Инструкция по настройке личного кабинета открывается сразу при входе.
Минимальной настройкой для работы входящих звонков является создание сотрудника и
настройка меню «обработка вызовов», для перенаправления входящего звонка на
определенного сотрудника.
Для входа в личный кабинет администратора зайдите на сайт http://youmagic.pro/ru/.
Далее в верхней части страницы нажмите Вход и введите ваш логин и пароль для входа в
кабинет администратора.
! Доступ приходит на контактный e-mail.

Настройка подключения SIP ID YMPro
1. Настройка личного кабинета YMPro
1.1. Настраиваем сотрудника.
Настройки -> Сотрудники / SIP ID -> Свойства сотрудника -> Заполняем
необходимые поля -> Запоминаем пароль оборудования -> Сохранить.
! Обратите внимание, учётные данные для настройки VoIP оборудования находятся
справа - блок «Настройки оборудования».
Учетные данные сотрудника
1.2. Настраиваем входящие вызовы.
Настройки -> Обработка вызовов -> Добавить переадресацию -> На сотрудника
-> Выбираем сотрудника, который будет
зарегистрирован на Asterisk -> Сохранить.

Маршрутизация входящих вызовов
1.3. Настраиваем определяемый номер при звонках с данного
лицевого счета YMPro.
Настройки -> Ваши номера -> Перетащить определяемый номер вверх ->
Сохранить.
! Внимание, по умолчанию со всего лицевого счета (6ти-значный номер) при исходящих
вызовах всегда будет определяться номер, который выбран в настройках «Ваши номера»,
вне зависимости, сколько куплено номеров в данном лицевом счете.
Изменить определяемые номера для определенных сотрудников можно по заявлению
через менеджера ОАО «МТТ» на этапе включения/тестирования. При самостоятельном
подключении через личный кабинет администратора -> Поддержка.
Настройка на Asterisk определяемых номеров описана в разделе «Настройка
динамической подстановки «А-номеров» (определяемых номеров) с Asterisk».
Настройка определяемого номера

2. Настройка Asterisk
2.1. Настройка транка YMPro SIP ID.
Создаём транк YMPro SIP ID.
Для этого необходимо пройти:
Connectivity -> Trunks -> Add SIP Trunk -> Настраиваем транк -> Submit Changes -> Apply
Config.
 Пример стандартной конфигурации транка:
PEER Details:
type=peer
defaultuser=логин
fromuser=логин
secret=пароль
nat=no (yes)
qualify=3000
insecure=invite,port - данный параметр необходим для входящих вызовов
host=voip.mtt.ru
fromdomain=voip.mtt.ru
dtmfmode=rfc2833
directmedia=no
disallow=all
allow=alaw,ulaw,g729
Register String:
логин:пароль@voip.mtt.ru/логин

Настройка транка YMPro SIP ID

2.2. Настройка исходящей маршрутизации для вызовов по YMPro SIP
ID.
Создаём правило исходящей маршрутизации.
Connectivity -> Outbound Routes -> Add Route -> Настраиваем правила маршрутизации
для исходящих вызовов (Dial Patterns that will use this Route) -> Trunk Sequence for
Matched Routes -> Submit Changes -> Apply Config.
 Для удобства набора номера с Asterisk сделаем возможность набора номера через
7, 8 и +7;
 Можно ограничить возможность совершать исходящие вызовы только
определенным внутренним номерам – за это отвечает параметр “CallerID” в “Dial
Patterns that will use this Route”;
 В данном примере все звонки по России для 3х-значных внутренних номеров,
начиная с 7, 8 или +7 будут проходить через YMPro SIP ID;
 Обратите внимание, что маршруты обрабатываются в порядке приоритета;
 Рекомендуется ограничить маршрут для исходящих вызовов временной группой,
т.е. в какое время можно совершать вызовы по данному маршруту – за это
отвечает параметр “Time Group”;
 Для оптимизации записей разговоров рекомендуется выставить параметр Call
Recording – “Record on Answer”, т.е. записывать только отвеченные вызовы.

Настройка правила для исходящей маршрутизации с YMPro SIP ID

2.3. Настройка входящей маршрутизации для вызовов по YMPro SIP ID.
Создаём правило входящей маршрутизации для приёма вызовов на номер YMPro.
Connectivity -> Inbound Routes -> Add Incoming Route -> Указываем DID Number -> Set
Destination -> Submit Changes -> Apply Config.
 Параметр “DID Number” равняется Логину сотрудника (SIP ID);
 В данном примере все входящие вызовы на номер YMPro направлены на IVR;
Recording – “Record on Answer”, т.е. записывать только отвеченные вызовы;
 Для удобства идентификации и анализа входящих вызовов каждому номеру
можно назначить префикс – за это отвечает параметр “CID name prefix”. К примеру,
если мы назначим номеру YMPro префикс ym, входящие вызовы с данного номера
будут определяться как ym+номер звонящего.

Настройка маршрута для входящих вызовов на номер YMPro SIP ID

Настройка подключения VOIP-Static YMPro
1. Настройка личного кабинета YMPro
1.1. Настраиваем сотрудника / Определяемый номер.
Настройки -> Сотрудники / SIP ID -> Свойства VOIP-static -> При
необходимости меняем отображаемый номер (номер, который будет
определяться при звонках с данного лицевого счета) -> Сохранить.
! Обратите внимание, новые IP-адреса можно открыть только по заявлению в ОАО «МТТ»,
самостоятельно из личного кабинета добавить новый IP-адрес – нельзя.
! Внимание, по умолчанию со всего лицевого счета (6ти-значный номер) при исходящих
вызовах всегда будет определяться номер, который прописан в настройках сотрудника
VOIP-static, вне зависимости, сколько куплено номеров в данном лицевом счете.
Изменить определяемые номера для определенных сотрудников можно по заявлению
через менеджера ОАО «МТТ» на этапе включения/тестирования. При самостоятельном
подключении через личный кабинет администратора -> Поддержка.
Настройка на Asterisk определяемых номеров описана в разделе «Настройка
динамической подстановки «А-номеров» (определяемых номеров) с Asterisk».
Настройка определяемого номера

1.2. Настраиваем входящие вызовы.
Настройки -> Обработка вызовов -> Добавить переадресацию -> На номер
-> Прописываем внешний IP-адрес Asterisk, на
который открыт доступ YMPro -> Сохранить.
Маршрутизация входящих вызовов

2. Настройка Asterisk
2.1. Настройка транка VOIP-Static YMPro.
Создаём транк YMPro SIP ID.
Connectivity -> Trunks -> Add SIP Trunk -> Настраиваем транк -> Submit Changes -> Apply
Config.
 Данное подключение не требует регистрации вашего оборудования на стороне
МТТ. Строка регистрации должна быть пустой;
 Пример стандартной конфигурации транка:
PEER Details:
type=peer
nat=no (yes)
insecure=invite,port - данный параметр необходим для входящих вызовов
qualify=3000
host=voip.mtt.ru
dtmfmode=rfc2833
directmedia=no
disallow=all
allow=alaw,ulaw,g729
! Строка регистрации должна быть пустой.

Настройка транка YMPro VOIP-Static

2.2. Настройка исходящей маршрутизации для вызовов по VOIP-Static
YMPro.
Создаём правило исходящей маршрутизации.
Connectivity -> Outbound Routes -> Add Route -> Настраиваем правила маршрутизации
для исходящих вызовов (Dial Patterns that will use this Route) -> Trunk Sequence for
Matched Routes -> Submit Changes -> Apply Config.
 Для удобства набора номера с Asterisk сделаем возможность набора номера через
7, 8 и +7;
 Можно ограничить возможность совершать исходящие вызовы только
определенным внутренним номерам – за это отвечает параметр “CallerID”в “Dial
Patterns that will use this Route”;
 В данном примере все звонки по России для 3х-значных внутренних номеров,
начиная с 7, 8 или +7 будут проходить через YMPro VOIP-Static;
 Обратите внимание, что маршруты обрабатываются в порядке приоритета;
 Рекомендуется ограничить маршрут для исходящих вызовов временной группой,
т.е. в какое время можно совершать вызовы по данному маршруту – за это
отвечает параметр “Time Group”;
Recording – “Record on Answer”, т.е. записывать только отвеченные вызовы.

Настройка правила для исходящей маршрутизации с YMPro VOIP-Static

2.3. Настройка входящей маршрутизации для вызовов по VOIP-Static
YMPro.
Создаём правило входящей маршрутизации для приёма вызовов на номер YMPro.
Connectivity -> Inbound Routes -> Add Incoming Route -> Указываем DID Number -> Set
Destination -> Submit Changes -> Apply Config.
 Параметр “DID Number” при подключении к YMPro VOIP-static всегда равняется 711
для всех приобретенных номеров в данном лицевом счете YMPro;
 ! Разделение DID номеров осуществляется по заявлению через менеджера ОАО
«МТТ» на этапе включения/тестирования. При самостоятельном подключении
через личный кабинет администратора -> Поддержка.
 В данном примере все входящие вызовы на номер YMPro направлены на IVR;
Recording – “Record on Answer”, т.е. записывать только отвеченные вызовы;
 Для удобства идентификации и анализа входящих вызовов каждому номеру
можно назначить префикс – за это отвечает параметр “CID name prefix”. К примеру,
если мы назначим номеру YMPro префикс ym, входящие вызовы с данного номера
будут определяться как ym+номер звонящего.

Настройка маршрута для входящих вызовов на номер YMPro VOIP-Static

Настройка динамической подстановки «А-номеров»
(определяемых номеров) с Asterisk
! Если для Вашего лицевого счета YMPro включили пропуск «А-номеров» номеров с
оборудования клиента (настройка выполняется по заявлению на стороне ОАО «МТТ»), то
в настройках Asterisk Вы можете прописать любой существующий номер РФ для
определения при исходящих вызовах.
 «А-номер» – это определяемый номера при исходящих вызовах. Обязательно
существующий телефонный номер РФ;
 Необходимо ОБЯЗАТЕЛЬНО указать «А-номер» в соответствующем поле настройки
в формате E.164, например, 78003333140. Номер можно указать любой, но
реальный, т.е. нельзя указать 70000000000;
 Если Вам требуется подстановка единого определяемого номера при исходящих
вызовов – в настройках транка необходимо добавить поле fromuser=А-номер; т.е.
fromuser – это определяемый номер при всех исходящих вызовах через данный
транк;
 ! Обратите внимание, при настройках SIP ID YMPro необходимо обязательно
изменить параметр fromuser, иначе будет определяться внутренний номер
сотрудника (15ти-значный логин);
 Также в настройках транка можно указать определяемый номер в поле “Outbound
CallerID” при этом, если в
правилах маршрутизации указан другой CallerID, то определяться будет номер
именно он [из настроек Outbound Routes -> Route CID
]. В данном случае
параметр fromuser в транке будет отсутствовать;
 Если, для каждого внутреннего абонента Asterisk требуется подстановка
индивидуального А-номера, необходимо в настройках “Extension” в поле
Outbound CID прописать необходимый А-номер номер, при этом в “Outbound
Routes” параметр “Override Extension” должен остаться пустым
;
 В данном примере при звонках с внутреннего номера 100 будет определяться
номер 78003333140:

Подстановка «А-номера» для внутреннего номера в параметре Outbound CID
 ! Обратите внимание, в настройках исходящей маршрутизации на параметр
Override Extension – если активировать данный режим (поставить галку ), будет
определяться номер из поля Route CID;
 В данном примере при звонках по выбранному правилу маршрутизации будет
определяться номер 74997090111, вне зависимости, что прописано в настройках
внутреннего номера в поле “Outbound CID”
Подстановка «А-номера» в Outbound Routes для вызовов со всех внутренних номеров
 В данном примере при звонках по выбранному правилу маршрутизации будет
определяться номер 74997090111, кроме вызовов с внутренних номеров, где
указан “Outbound CID”:
Подстановка «А-номера» в Outbound Routes для вызовов с внутренних номеров, в
которых не указан параметр Outbound CID
Компания ОАО «МТТ» желает Вам приятного общения!

Asterisk setup manual

More Related Content

What's hot (11)

Viewers also liked (6)

Similar to Asterisk setup manual (10)

Asterisk setup manual